slack-agent-bridge

# Slack 代理桥 <p align="center"> <img src="docs/assets/app-icon.png" width="128" height="128" alt="Slack 代理桥应用图标"> </p> <p align="center"> <strong>在您的 macOS 上运行的本地菜单栏应用程序，将 Cursor、Claude 和 Cowork 连接到您的 Slack 会话。</strong><br> 存档超出 Slack 免费限制的消息 · AI 代理的 MCP 工具 · 自动化 · 无需工作区管理员审批。 </p> <p align="center"> <a href="https://gtarafdar.github.io/slack-agent-bridge/">官网</a> · <a href="https://github.com/Gtarafdar/slack-agent-bridge/releases">下载 .dmg</a> · <a href="#quick-start">快速入门</a> · <a href="docs/SECURITY.md">安全</a> </p> <p align="center"> <a href="https://github.com/Gtarafdar/slack-agent-bridge/stargazers"><img src="https://img.shields.io/github/stars/Gtarafdar/slack-agent-bridge?style=flat&logo=github" alt="GitHub stars"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a> <img src="https://img.shields.io/badge/macOS-13%2B-black?logo=apple" alt="macOS 13+"> <img src="https://img.shields.io/badge/Slack-desktop%20required-4A154B?logo=slack&logoColor=white" alt="需要 Slack 桌面版"> </p> --- ## 为什么存在 将 Slack 连接到 AI 代理比想象中更难。 - **工作区管理员审批** 通常需要安装 Slack 应用程序或机器人。 - **OAuth 和 Marketplace 应用程序** 需要安全审查、范围辩论和持续信任。 - **Slack 机器人** 可以总结频道，但它们存在于云中，具有工作区范围的权限。 - **Slack 免费版** 停止服务旧消息（约 90 天），因此代理即使在您仍然关心时也会丢失历史记录。 您仍然想要： - 搜索和总结您的频道中发生了什么 - 让代理设置提醒、发布笔记到您的直接消息、安排消息和运行本地自动化 - 保留消息的私有副本用于摘要和关键词监视 - 在 **Cursor 或 Claude** 中执行所有操作，而无需为另一个 Slack 集成求助于 IT **Slack 代理桥** 在您的 Mac 上运行，重用现有的 Slack 桌面登录（与 [Auto AFK Slack](https://github.com/Gtarafdar/auto-afk-slack) 相同的方法），并在 `127.0.0.1` 上公开一个本地 **MCP 服务器**，以便代理可以调用 Slack 工具，并具有明确的能力门控。 无需管理员工单。无需工作区目录中的机器人用户。只有您、您的 Mac 和您信任的代理。 --- ## 下载（推荐） **[从 GitHub Releases 获取最新的 `.dmg`](https://github.com/Gtarafdar/slack-agent-bridge/releases/latest)** [gtarafdar.github.io/slack-agent-bridge](https://gtarafdar.github.io/slack-agent-bridge) 官网也会自动获取最新的版本。 | 项目 | 值 | |------|--------| | macOS | 13.0 Ventura 或更高版本 | | 芯片 | Apple Silicon 或 Intel（通用） | | Slack | 已安装并登录桌面版 | | 大小 | ≈ 3.4 MB `.dmg` | | 价格 | **免费且开源** | --- ## 截图 <p align="center"> <img src="docs/assets/quick-setup.png" width="720" alt="快速设置向导和完成的检查清单"> </p> <p align="center"><em>快速设置向导引导您完成连接、工作区、频道和代理令牌。</em></p> <table> <tr> <td width="50%"><img src="docs/assets/connection.png" alt="连接面板"><br><em>连接和 MCP 状态</em></td> <td width="50%"><img src="docs/assets/agent-access.png" alt="代理访问面板"><br><em>代理令牌和 mcp.json 用于 Cursor</em></td> </tr> <tr> <td><img src="docs/assets/capabilities.png" alt="工作区功能"><br><em>15 个功能开关，每个工作区</em></td> <td><img src="docs/assets/channel-access.png" alt="频道访问和自动化交付"><br><em>存档与代理频道</em></td> </tr> <tr> <td><img src="docs/assets/archive.png" alt="存档面板"><br><em>本地存档同步和保留</em></td> <td><img src="docs/assets/automations.png" alt="自动化面板"><br><em>摘要和关键词监视</em></td> </tr> <tr> <td><img src="docs/assets/dm-self.png" alt="个人直接消息测试"><br><em>代理发布到您的 notes-to-self 直接消息</em></td> <td><img src="docs/assets/slackbot-inbox.png" alt="Slackbot 自动化收件箱"><br><em>通过 Slackbot 直接消息交付自动化</em></td> </tr> </table> 更多截图和引导游览： **[gtarafdar.github.io/slack-agent-bridge](https://gtarafdar.github.io/slack-agent-bridge/)** --- ## macOS 首次启动（重要） Slack 代理桥是 **免费且开源** 的。它是 **临时签名的**，而非使用付费 Apple 开发者 ID 签名（99 美元/年）。macOS 会警告您一次。如果您从此仓库下载了它，这是正常的。如果应用程序安全，可以打开。 ### 如果 macOS 说应用程序“无法打开”或开发者无法验证 这 **不是恶意软件**。这意味着应用程序未使用 Apple 的付费开发者计划证书签名。您可以安全地打开它： **选项 A（最简单）：** 1. 打开 `.dmg` 并将 **Slack 代理桥** 拖到 **应用程序**。 2. 在 Finder 中，转到 **应用程序**。 3. **右键单击** （或 Control-click） **Slack 代理桥** → **打开**。 4. 在对话框中单击 **打开**。您只需要执行此操作 **一次**。 **选项 B（如果选项 A 不出现）：** 1. 尝试正常打开应用程序（macOS 会阻止它）。 2. 打开 **系统设置 → 隐私和安全**。 3. 向下滚动。您应该会看到一条关于 Slack 代理桥被阻止的消息。 4. 点击 **仍然允许**，然后确认 **打开**。 **选项 C（终端，一行）：** ```bash xattr -dr com.apple.quarantine "/Applications/Slack Agent Bridge.app" ``` 然后像平常一样双击应用程序。 ### Keychain 提示：点击 **始终允许** 当您连接 Slack 时，macOS 可能会要求访问 Keychain（通常标记为 **Slack 安全存储** 或登录 Keychain 密码）。 | 按钮 | 会发生什么 | |--------|----------------| | **始终允许** | 推荐。应用程序可以读取您的本地 Slack 会话，而无需在每次 MCP 调用时再次询问。 | | **允许**（一次） | 有效期较短，但 macOS 可能会再次提示，代理可能会在任务中失败。 | | **拒绝** | 连接失败。您必须重置访问权限（如下所述）。 | **如果您错误地点击了拒绝：** 1. 打开 **Keychain 访问**（Spotlight → "Keychain 访问"）。 2. 搜索 **Slack 安全存储** 或 **slackagentbridge**。 3. 删除被拒绝的条目，或右键单击 → **获取信息** → **访问控制** → 允许 **Slack 代理桥**。 4. 退出并重新打开应用程序，然后点击 **始终允许**。 应用程序内 **连接**、**代理访问** 和 **隐私** 窗格也提醒您使用 **始终允许**。 ### 快速安装检查清单 1. 从 [Releases](https://github.com/Gtarafdar/slack-agent-bridge/releases/latest) 下载 `.dmg`。 2. 将应用程序拖到 **应用程序**。 3. **右键单击 → 打开 → 打开**（仅限首次启动）。 4. 在 Keychain 提示中单击 **始终允许**。 5. 连接 Slack → 启用工作区 → 创建代理令牌 → 粘贴 `mcp.json` 到 Cursor 或 Claude。 ### 分发说明 此应用程序是 **临时签名的**，并且 **未经 notarization**（无付费 Apple 开发者账户），这就是为什么需要上述一次性 Gatekeeper 步骤。我以这种方式发布它，以便项目 **免费**，而无需每年支付 Apple 费用。要在没有此提示的情况下发布，维护者需要开发者 ID 证书和 notarization。 --- ## 功能 ### 连接和工作区 - **无需管理员审批** - 重用本地 Slack 桌面会话（`xoxc` + cookie） - **多工作区** - 显式启用工作区；默认拒绝 - **快速设置向导** - 带有 MCP 连接测试的引导式检查清单 - **会话刷新** - 按定时器、唤醒睡眠和身份验证错误重新导入 ### 存档和搜索 - **本地 SQLite 存档**，支持全文搜索（FTS5） - **90 天诚实** - Slack 免费版不会显示旧消息；此应用程序保留可搜索的本地副本 - **每个频道的存档切换** - 选择存储内容 - **保留** - 工作区可选择 3 / 6 / 12 / 24 个月或永久 - **导出和清除** - 完全控制本地数据 - **同步控制** - 暂停、间隔、手动同步、存储警告 ### 代理访问（MCP） - **`http://127.0.0.1:47821/mcp`** 上的 **MCP 服务器**（仅限回环） - **可撤销的 bearer 令牌** - 存储时进行 SHA-256 哈希；为 Cursor 或 Claude 复制 `mcp.json` 片段 - **令牌轮换** - 轮换并复制更新的配置；旧令牌的密码保护恢复 - **每个工作区的功能标志** - 请参见下面的完整列表（默认拒绝） - **代理频道允许列表** - 与存档列表分开；代理仅查看您标记的 **代理** 的频道 - **丰富的代理人体工程学** - `since` / `until` / `days` / `hours` 过滤器，`from_user` 和 `user_id` 搜索，`summarize_channel`，丰富的有效载体（`posted_at`，`channel_name`，`user_display_name`，`text_plain`） - **清晰的代理错误** - 结构化的 MCP 错误代码（`agent_token_unauthorized`，`channel_not_allowed_for_agents` 等） - **单实例守护进程** - 每个 Mac 一个菜单栏应用程序 ### 工作区功能（全部 15 个切换） 每个工作区都有明确的功能门控。代理需要 **令牌** 和 **工作区** 来允许某个标志。 | 功能 | 允许什么 | |------------|----------------| | 读取频道 | 列出代理允许的频道，读取历史记录，搜索，总结 | | 存档频道 | 将消息同步到本地 SQLite 存档 | | 发布到我的直接消息 | `send_dm_to_self` 和自动化交付到您的 notes-to-self 直接消息 | | 发布到直接消息（代理允许） | `send_dm` 到代理允许列表中的 IM 频道 | | 发布到频道（代理允许） | `send_channel` 到代理允许列表中的频道 | | 发布到群组直接消息（自动化收件箱） | 群组直接消息收件箱，`create_automation_group_dm` | | 调度消息（直接消息/频道） | `schedule_message`，列出和删除已调度的消息 | | 设置提醒 | `create_reminder`（Slack 提醒您自己） | | 设置状态 | `set_status`（表情符号 + 文本 + 过期） | | 添加反应 | 在代理允许的消息上添加 `add_reaction` | | 删除反应 | 在您的反应上删除 `remove_reaction` | | 固定消息 | 在代理允许的频道中 `pin_message` | | 取消固定消息 | 在代理允许的频道中 `unpin_message` | | 编辑消息 | 对您发布的消息进行 `update_message` | | 删除消息 | 对您发布的消息进行 `delete_message` | ### 编写工具（功能门控） - 发布到 **您自己的直接消息** (`send_dm_to_self`) - 发布到 **允许的直接消息和频道** - **调度消息** （列表、创建、删除） - **编辑和删除** 您的消息 - **反应、固定状态、提醒** - **自动化收件箱** - 为交付创建 Slackbot 群组直接消息 ### 自动化（本地） - **每日摘要** 来自存档消息（可选发布到 Slack） - **关键词监视** 存档流量中的警报 - **任务草稿** 从最近的消息 (`draft_task_list`) - **交付模式** - 自我直接消息、Slackbot 收件箱（群组直接消息）、私有频道或仅限 Mac - **Mac 通知** 和可选的 Slackbot 提醒 - **在 Slack 中加星标** 和自定义收件箱线程标签 - **启动时启动** 可选 - 代理可以调用 `run_automation` 通过 MCP（功能门控） ### 设置面板 | 面板 | 目的 | |------|---------| | 快速设置 | 带有进度检查和 MCP 链接测试的引导式向导 | | 连接 | 会话状态、MCP 端口、存档统计数据、刷新/断开 | | 工作区 | 启用工作区、功能、频道访问、自动化交付 | | 存档 | 同步间隔、暂停、保留、导出、清除 | | 自动化 | 摘要规则、关键词监视、测试交付 | | 代理访问 | MCP 切换、令牌创建/轮换/撤销、 `mcp.json` 模板 | | 隐私 | 数据位置、CLI 选择加入、令牌撤销、Keychain | ### 隐私和安全 - 凭证在 **macOS Keychain** （仅限此设备） - **无遥测** - 仅与 `slack.com` 通过 HTTPS 通信 - **审计日志** 用于 MCP 工具调用 - **禁用头less CLI** （默认禁用） - 应用程序支持硬化为 `0700`；存档 DB `0600` 请参阅 [docs/SECURITY.md](docs/SECURITY.md) 以获取完整的威胁模型](https://docs/SECURITY.md) 以获取完整的威胁模型。 --- ## 快速入门 1. 在应用程序中 **连接 Slack 会话**（连接面板）。 2. 在工作区下 **启用一个工作区**。关闭写入功能，直到您需要它们。 3. **刷新频道列表** → 标记 **存档** 和 **代理** 每个频道。 4. **代理访问** → 启用 MCP 服务器 → **创建令牌** → 复制 `mcp.json` 模板。 5. 将其粘贴到 Cursor 或 Claude 的 MCP 设置中并进行测试。 ```json { "mcpServers": { "slack-agent-bridge": { "url": "http://127.0.0.1:47821/mcp", "headers": { "Authorization": "Bearer <您的令牌>" } } } } ``` --- ## MCP 工具 | 工具 | 目的 | |------|---------| | `list_workspaces` | 已启用的工作区 | | `list_agent_channels` | 代理允许的频道（优选用于读取） | | `list_channels` | 与 `list_agent_channels` 相同（仅限代理允许列表） | | `search_messages` | 存档 FTS + 可选的实时 Slack 搜索 | | `get_channel_history` | 允许频道的历史记录 | | `get_thread` | 允许频道中的线程 | | `get_user` | 用户资料 | | `list_mentions` | 最近在允许的频道中被 @ 提及 | | `summarize_day` | 跨允许频道的本地摘要 | | `summarize_channel` | 频道的总结，可选过滤器 | | `create_reminder` | Slack 提醒您自己 | | `send_dm_to_self` | 发布到您自己的直接消息 | | `send_dm` | 发布到允许的直接消息 | | `send_channel` | 发布到允许的频道 | | `schedule_message` | 安排消息 | | `list_scheduled_messages` | 列出已调度的消息 | | `delete_scheduled_message` | 取消已调度的消息 | | `update_message` / `delete_message` | 编辑或删除您的消息 | | `add_reaction` / `remove_reaction` | 表情符号反应 | | `pin_message` / `unpin_message` | 固定消息管理 | | `set_status` | 设置 Slack 状态 | | `draft_task_list` | 从存档中提取任务 | | `create_automation_group_dm` | 创建 Slackbot 自动化收件箱 | | `list_automations` / `run_automation` | 本地自动化规则 | 频道访问： 在 **工作区 → 配置** 下，分别标记 **存档**（本地存储）和 **代理**（MCP 读取）。 --- ## 从源代码构建 ```bash git clone https://github.com/Gtarafdar/slack-agent-bridge.git cd slack-agent-bridge ./scripts/build_app.sh ./scripts/make_dmg.sh open "dist/SlackAgentBridge-1.0.dmg" ``` ### 测试 ```bash ./scripts/dry_run.sh ``` 构建应用程序，验证临时签名和通用二进制文件，启动，探测 MCP，封装 DMG。 --- ## 重要答案 | 问题 | 答案 | |----------|--------| | 旧的 (>90 天) 免费消息是否会重新出现在 Slack 中？ | **否**。此应用程序保留一个 **本地** 可搜索的存档。Slack 本身不会显示它们。 | | 它会填满我的磁盘吗？ | 默认保留期为 **12 个月**，每个工作区。您可以随时导出或清除。 | | Apple 开发者费用？ | **不需要**。像许多免费 Mac 实用程序一样使用临时签名。 | | 代理如何给我发送直接消息？ | 启用 **发布到我的直接消息**。仅使用来自 `auth.test` 的您的用户 ID。 | | Slack 桌面更新破坏了身份验证？ | 使用 **刷新本地会话**。应用程序还会按定时器重新导入。 | 详情： [docs/FREE_TIER_AND_RETENTION.md](docs/FREE_TIER_AND_RETENTION.md) --- ## GitHub Pages（官网） 营销网站位于 [`docs/`](docs/)。要发布： 1. 将此仓库推送到 `github.com/Gtarafdar/slack-agent-bridge` 2. **设置 → Pages → 从分支构建 → `/docs` → 保存** 3. 网站网址： `https://gtarafdar.github.io/slack-agent-bridge/` 下载按钮在您发布新版本时会自动调用 GitHub Releases API 并选择最新的 `.dmg` 资产。 --- ## 发布版本 ```bash ./scripts/build_app.sh ./scripts/make_dmg.sh ``` 将 `dist/SlackAgentBridge-1.0.dmg`（或脚本生成的版本名称）上传到新的 GitHub 版本。使用 `Resources/Info.plist` 中的版本进行标记。 --- ## Gobinda Tarafdar 的其他 Slack 工具 如果您喜欢基于本地、无需管理员的 Slack 实用程序的 macOS 版本，这些工具来自同一个工作坊： | 应用程序 | 功能 | 链接 | |-----|----------------|------| | **Auto AFK Slack** | 锁定您的 Mac，Slack 状态变为 AFK；解锁清除。仅限菜单栏。 | [gtarafdar.github.io/auto-afk-slack](https://gtarafdar.github.io/auto-afk-slack/) · [GitHub](https://github.com/Gtarafdar/auto-afk-slack) | | **Slack Teammate Time** | 在 Slack 桌面版中，在名称旁边内联显示每个队友的本地时间。 | [gtarafdar.github.io/slack-teammate-local-time](https://gtarafdar.github.io/slack-teammate-local-time/) · [GitHub](https://github.com/Gtarafdar/slack-teammate-local-time) | | **Slack 代理桥** | 此应用程序：MCP 桥接器，用于 Cursor/Claude，本地存档，自动化。 | 您在这里 | 所有三个都重用现有的 Slack 桌面会话。无需工作区管理员审批或 Marketplace 安装。 --- ## 关于作者 **Gobinda Tarafdar** - 按照职业来说是 WordPress 产品营销人员，按照习惯来说是固执的问题解决者，按照心来说是终身的哈利波特粉丝。 白天，我是 [WPBakery](https://wpbakery.com/) 的 **产品营销专家**，帮助单一插件突破 **400,000+ 个活跃用户**。在日常工作之余，我会摆弄自己的小型工作坊中的各种咒语。Slack 代理桥便是其中之一。 <p align="center"> <img src="https://raw.githubusercontent.com/Gtarafdar/auto-afk-slack/main/docs/assets/gobinda.png" width="120" alt="Gobinda Tarafdar"> </p> ### 来自工作坊的其他项目 | 项目 | 描述 | |---------|-------------| | [WPBakery](https://wpbakery.com/) | 我负责产品营销的页面构建器 | | [Docscriber](https://thedocscriber.com/) | 文档，召唤而来 | | [TheRecaller](https://therecaller.com/) | 网络上遗忘内容的记忆辅助工具 | | [TheEditra](https://theeditra.com/) | AI 视频编辑器 | | [The Quill Press](https://thequillpress.com/) | 科技新闻，以每日先知风格呈现 | | [Costlas](https://costlas.com/) | 140+ 个国家的生活成本 | | [Auto AFK Slack](https://gtarafdar.github.io/auto-afk-slack/) | 锁定 Mac，Slack 变为 AFK | | [Slack Teammate Time](https://gtarafdar.github.io/slack-teammate-local-time/) | Slack 中内联显示队友的本地时间 | | [FinderFlow](https://gtarafdar.github.io/FinderFlow/) | 带有内置编辑器的 Mac 文件管理器 | --- ## 支持该项目 如果 Slack 代理桥为您节省了一个管理员工单或一次手动 Slack 搜索： - **[在 GitHub 上加星标](https://github.com/Gtarafdar/slack-agent-bridge/stargazers)** - 帮助其他人发现它 - **[捐赠](https://gtarafdar.com/donate)** - 维持工作坊的运营 - **[在 X 上关注](https://x.com/Gtarafdarr)** · **[LinkedIn](https://www.linkedin.com/in/gobinda-tarafdar/)** --- ## 免责声明 **Slack 代理桥** 是一个独立项目，由 Gobinda Tarafdar 创建。 它与 Slack Technologies, LLC **无关、未被 Slack Technologies, LLC 认可或赞助**。 **Slack** 是 Slack Technologies, LLC 的商标。 此应用程序使用非官方的本地会话路径（与同类 Slack 个人实用程序相同）。请自行判断并遵守您的工作区政策。 --- ## 许可 MIT © 2026 Gobinda Tarafdar。查看 [LICENSE](LICENSE)。