CC-Connect
把本地 AI 编程代理接入常用聊天平台，随时远程处理开发任务。
README 显示了多用户权限、/permit、权限模式、Bridge 启用时强制令牌，以及长任务取消和强制终止机制；CI 还验证 Go 模块校验和。这些是实质性的权限与供应链控制，因此最小权限和依赖安全获得中等分。但材料没有说明平台凭据如何存储、日志是否脱敏、消息和代码向哪些服务传输，也没有证明高影响命令逐次确认。产品明确允许远程检查或修改代码、运行命令和执行自动化，而恢复机制只体现取消、超时和会话控制，没有文件或命令回滚方案。仓库、模块路径和联系渠道提供了来源归属，但发布者身份仍未经验证。
README 的平台与代理主张、go.mod 的实现依赖和分阶段 CI 大体形成一致的产品图景。CI 包含构建、竞态测试、覆盖率、冒烟、回归和性能阶段，依赖也有明确版本与校验和验证，因此自洽性和依赖可获得性处理较好。扣分在于没有提供执行结果，部分功能主张仅来自 README；失败消息方面只看到拒绝无令牌 Bridge、超时停止以及要求用户附上错误信息，未展示系统性、可操作的运行时错误设计。
目标用户、远程开发场景、支持的代理和消息平台都描述得很清楚。功能矩阵逐平台标注完整、部分和不支持，并补充公网地址、语音配置及非官方 QQ 桥接限制，足以获得能力边界满分。斜杠命令、@mention 权限关键字和兼容别名说明了触发方式，但没有完整的冲突、误触发或群聊路由规则。环境适配覆盖多平台及无公网 IP 场景，但给定材料没有展示完整安装矩阵、操作系统差异或全部配置前提。
README 通过新版摘要、平台矩阵、价值说明和平台指南链接形成了可用的信息结构。版本 1.3.3、beta 演进、行为变更、兼容别名和专门 changelog 都记录得很好。已知限制尤其具体，因此该项满分。扣分在于所给片段没有实际安装步骤、端到端示例或 FAQ；MIT 只由徽章和链接声明，未提供 LICENSE 正文，且对象元数据也标为未知。维护方面有仓库所有者、邮箱和社区渠道，但没有明确维护团队、支持承诺或安全更新责任。
将本地编码代理接入现有聊天平台、支持会话控制、文件和流式回复，能产出直接可消费的聊天结果；统一接入十余种代理和平台相较分别构建桥接具有明显增量价值。扣分在于输出质量、消息保真度和实际工作流效果没有静态实例佐证，成本说明也不完整：公网要求有所区分，但资源占用、平台费用、凭据管理成本及部署复杂度未被量化。
主要功能附有版本号、问题编号、行为变更、平台矩阵和 CI 配置，可追溯性达到中等水平。go.mod 与 CI 能交叉支持这是一个可构建、依赖广泛的 Go 项目，但没有源代码、测试文件、配置样例或 changelog 正文来交叉验证大多数功能。README 能区分部分支持和限制，但大量赞助商性能、价格、稳定性与规模主张混在产品文档中，且未与项目自身证据明确隔离，因此事实与推断分离较弱。
- 该工具可将远程聊天输入转化为本地代码修改、命令执行和自动化操作；部署前应限制允许的发送者、工作目录、权限模式和可调用命令。
- 给定材料没有说明平台令牌、代理凭据、消息内容、代码片段和日志的存储、加密、保留或脱敏策略。
- 取消和超时不等同于回滚；远程命令或代理修改造成的文件、数据库及外部系统变更可能需要独立备份和恢复措施。
- MIT 许可证仅由 README 徽章和链接声明，本次材料未包含许可证正文，应在采用前核对固定修订中的 LICENSE 文件。
- 大量赞助商和 API 中继服务声明不是项目安全性或可靠性的证据，也不应视为项目方验证或背书。
这个 Agent 能做什么，适合哪些场景？
CC-Connect 是一个自托管桥接服务，将本机运行的 Claude Code、Codex、Cursor Agent、Gemini CLI、Kimi CLI 等编程代理连接到即时通信平台。它通过 WebSocket、长轮询、Socket Mode、Gateway、Stream 或 Webhook 等方式接收聊天消息，并把请求交给所选代理在配置的工作目录中执行。结果会以流式或分块文本返回聊天窗口；部分平台还支持图片、文件、语音、卡片和代理生成附件。一个进程可以管理多个项目、代理与平台组合，并提供会话切换、模型和提供商切换、权限模式、工作目录管理、定时任务及多机器人转发。服务运行在用户自己的机器上，多数平台不需要公网 IP，但仍依赖外部聊天平台、已认证的代理 CLI，以及相应的网络连接。
服务从 Feishu/Lark、DingTalk、WPS 协作、Telegram、Slack、Discord、LINE、企业微信、个人微信、微博、QQ、QQ Bot 或 Matrix 接收消息，将其路由到项目中配置的本地代理 CLI，并在指定的 work_dir 内延续或创建会话。用户可通过 /new、/list、/switch、/current 管理会话，通过 /dir 或 /cd 切换工作目录，通过 /model、/provider 和 /mode 调整模型、API 提供商与工具审批方式。它还能用 /cron 创建定时任务，用 /timer 安排一次性延迟任务，并用 /cancel 中断当前轮次。代理产生的文本会回传到聊天平台；Feishu 和 Telegram 明确支持通过 cc-connect send --image 或 --file 回传本地附件，配置语音服务后还可用 --tts 发送合成语音。Web 管理界面默认位于 http://localhost:9820，用于创建项目、配置平台凭据、管理提供商并与代理聊天。
- 开发者离开电脑时，通过 Telegram、Slack 或飞书让本机 Codex、Claude Code 等代理检查代码、修改文件或运行命令。
- 同时维护多个代码库的个人或团队，用单个 CC-Connect 进程为每个项目绑定独立的工作目录、代理和聊天机器人。
- 需要在群聊中交叉使用多个模型的团队，把多个机器人绑定到同一群组，让 Claude、Gemini 等代理在一次讨论中转发协作。
- 运维或研发人员通过 /cron 设置周期性任务，例如每天汇总 GitHub Trending，并让执行结果直接返回聊天窗口。
- 对文件隔离有要求的 Linux 或 macOS 团队，为 Claude Code 项目设置 run_as_user，并在启动前运行 cc-connect doctor user-isolation 检查跨用户访问。
- 需要移动端输入截图或语音的用户，利用平台的图片转发以及可选的 STT/TTS 配置向本地代理提供多模态上下文。
这个 Agent 有哪些优点和局限？
- 同时覆盖 10 种以上本地编程代理，并通过 ACP 接入其他兼容代理，避免把聊天入口锁定在单一代理产品上。
- 内置 13 个聊天平台，多数采用 WebSocket、长轮询、Socket Mode 或 Gateway，因此通常无需配置公网 IP。
- 具备多项目、会话轮换、工作目录切换、定时任务、多机器人转发以及模型和提供商热切换等完整远程控制能力。
- 提供 Web 管理界面、npm、Homebrew、预编译二进制和 Go 源码构建等多种部署与配置路径。
- Linux/macOS 上为 Claude Code 提供 run_as_user 隔离，并带有启动前的 user-isolation 检查和泄漏探测。
- 它不是托管式代理：必须保持本机或自有服务器在线，并预先安装、认证至少一个受支持的代理 CLI。
- 仍需逐个平台创建机器人和管理令牌；LINE Webhook 与企业微信 Webhook 模式需要公网 URL。
- 平台能力不一致，例如 WPS 协作不支持图片和文件，微博不支持此类媒体，LINE 的卡片、文件和群聊能力仅为部分支持。
- 语音功能通常还要配置额外的 STT/TTS 提供商；并非所有平台均支持语音。
- 附件回传首批仅明确支持 Feishu 和 Telegram，且默认限制为 50 MiB。
- v1.3.3 改变了若干默认行为，包括 30 分钟空闲会话重置、Telegram/Discord 紧凑进度样式，以及启用 Bridge 时必须配置令牌，升级前需要检查现有配置。
如何安装或部署这个 Agent？
- 先安装至少一个受支持的代理 CLI，例如
npm install -g @openai/codex、npm install -g @anthropic-ai/claude-code或npm install -g @google/gemini-cli。 - 交互式完成代理认证，例如运行
codex login或claude login，并用codex --version、claude --version等确认命令位于 PATH。 - 安装 CC-Connect：
npm install -g cc-connect，或在 macOS/Linux 使用brew install cc-connect；也可下载发布版二进制。源码构建需要 Go 1.22+，命令为git clone https://github.com/chenhg5/cc-connect.git、cd cc-connect、make build。 - 运行
cc-connect。首次启动会创建~/.cc-connect/config.toml，管理界面默认显示为http://localhost:9820；端口冲突时可使用--web-port 9821。 - 在管理界面创建项目，添加至少一个聊天平台，并填入该平台开发者控制台提供的机器人令牌。注意
cc-connect web只打开配置界面，不会启动后台服务。
如何使用这个 Agent？
保持 cc-connect 服务运行，然后向已配置的机器人发送消息，消息会被转交给项目绑定的本地代理。使用 /new [name] 创建会话、/list 查看会话、/switch <id> 切换会话；使用 /dir <path> 更改下一会话的工作目录，管理命令需要在项目的 admin_from 中授权用户 ID。可用 /model switch <alias>、/provider switch <name> 和 /mode default|yolo 调整模型、提供商与审批策略。定时执行可发送 /cron add 0 6 * * * Summarize GitHub trending。代理生成文件后，可运行 cc-connect send --file /absolute/path/to/report.pdf 或 cc-connect send --image /absolute/path/to/chart.png 回传；首批明确支持该附件流程的平台是 Feishu 和 Telegram，默认附件上限为 50 MiB。
常见问题
是否必须有公网 IP？
CC-Connect 是否包含 Codex、Claude Code 等代理本身？
谁可以切换目录或执行高权限命令？
admin_from = "alice,bob" 限定能运行 /dir、/shell 等特权命令的用户 ID。admin_from 应放在 [[projects]] 下，用户可用 /whoami 或 /status 查询自己的 ID。长时间运行的命令会不会永久占住会话？
max_turn_time_mins 墙钟时间上限，并采用软停止、强制终止和自动恢复机制；用户也可以用 /cancel 主动中断当前轮次。