项目简介
CollabVibe 是连接即时通讯平台与 AI Agent 后端的协作式编程编排引擎，核心能力包括：
- IM 消息与交互卡片接入
- 多 backend Agent 执行
- 审批驱动的 Human-in-the-Loop 流程
- 线程、快照、审计、本地状态持久化
设计目标
| 主题 | 说明 |
|---|---|
| Human-in-the-Loop | 高风险动作进入审批流，由用户决定是否继续 |
| 协作开发 | 围绕 thread 持续执行、review、merge、snapshot |
| 数据本地留存 | SQLite、日志、配置、工作区状态保存在本地 |
平台支持
| 平台 | 状态 | 当前能力 | 代码位置 |
|---|---|---|---|
| Feishu / Lark | 已支持 | WS 事件、消息、卡片、Bot 菜单、群/单聊入口 | src/feishu/*, src/feishu/channel/* |
| Slack | TODO | 已有输出适配与 socket handler，未完成应用层主链路接线 | src/slack/*, src/slack/channel/* |
| MS Teams | TODO | 预留平台扩展方向，当前仓库未接入 | — |
Backend 支持
当前代码只保留基于 API transport 的 backend 接入模式。
| Backend | 传输 | 模式 | 状态 | 说明 |
|---|---|---|---|---|
codex | codex | API | 已支持 | 通过 Codex protocol / stdio 接入 |
opencode | acp | API | 已支持 | 通过 ACP 接入 |
claude-code | acp | API | 已支持 | 通过 ACP 接入 |
gemini-cli | TBD | — | 规划中 | 当前代码未接入 |
trae-cli | TBD | — | 规划中 | 当前代码未接入 |
bash
# 本地文档预览
npm run docs:dev认证与鉴权
平台接入认证
| 项目 | 说明 |
|---|---|
FEISHU_APP_ID | Feishu 应用 ID |
FEISHU_APP_SECRET | Feishu 应用密钥 |
FEISHU_SIGNING_SECRET | Feishu 事件签名校验密钥 |
FEISHU_ENCRYPT_KEY | Feishu 加密事件配置 |
系统内权限控制
| 组件 | 作用 |
|---|---|
SYS_ADMIN_USER_IDS | 初始系统管理员导入 |
users 表 | 系统级角色持久源 |
RoleResolver | 角色解析 |
authorize / command-guard | 命令级权限校验 |
使用方式
| 步骤 | 说明 |
|---|---|
| 1 | 用户在 IM 中发送消息或点击卡片 |
| 2 | 平台层解析事件并进入统一 intent 分发 |
| 3 | 共享层决定走平台命令或 agent 命令路径 |
| 4 | orchestrator 解析 thread、backend、runtime config |
| 5 | backend 执行并通过流式事件回推中间状态 |
| 6 | 高风险动作进入审批流 |
| 7 | 结果、线程状态、审计信息写入本地存储 |
快速接入入口
如果读者是第一次接触项目，建议先看平台接入再进入架构章节：
本地留存的数据
| 类别 | 默认位置 |
|---|---|
| SQLite 主库 | collabvibe.db |
| backend 配置 | config |
| 日志 | logs |
| 工作区 / worktree / snapshot | 本地代码目录与派生 worktree |
bash
ls -lah .
ls -lah logs