Cc Workspace Bot

CC Workspace Bot

CC Workspace Bot 是一个面向企业内部和个人团队的飞书 AI 助理框架。它把飞书消息路由到不同的 Claude Code workspace，让每个飞书应用拥有独立的提示词、技能、长期记忆、定时任务和会话数据。

适合这些场景：

• 在飞书里使用自己的编程、研究、运营、学习助理
• 为不同业务线部署相互隔离的 AI 助手
• 在内网机器上运行，无需公网 Webhook
• 让 Claude Code 通过受控 workspace 读写文件、执行脚本、调用飞书文档和表格能力

核心能力

能力	说明
多应用隔离	一个 config.yaml 可配置多个飞书应用，每个应用绑定独立 workspace
飞书 WebSocket 接入	使用飞书长连接模式接收消息，本机只需能访问公网
会话队列	每个 channel_key 一个串行 Worker，避免同一聊天内并发互相污染
Claude Code 执行	子进程调用 claude -p，支持 --cwd、--resume、模型供应商覆盖和工具白名单
工作 / 陪伴双模式	work 模式使用交互卡片，companion 模式直接发送文本
附件处理	飞书图片和文件下载到当前 session 的 attachments/ 后交给 Claude 读取
长消息分段	超过飞书消息限制时自动切分发送
定时任务	workspace 的 tasks/*.yaml 是 source of truth，fsnotify + gocron 自动注册
长期记忆	workspace 的 memory/ 目录由技能和 flock 约束管理
可选观测	可通过 Claude Code hooks 接入自托管 Langfuse 记录成本和 trace

架构概览

飞书用户
  -> 飞书 WebSocket 事件
  -> feishu.Receiver 解析消息、下载附件、构造 channel_key
  -> session.Manager 按 channel_key 懒启动 Worker
  -> session.Worker 串行处理、管理 /new、记录消息
  -> claude.Executor 在 workspace/sessions// 调用 claude CLI
  -> feishu.Sender 发送文本或更新交互卡片

tasks/*.yaml
  -> task.Watcher 监听变更
  -> task.Scheduler 注册 cron
  -> task.Runner 定时调用 claude CLI 并按配置发送结果

详细设计见 [概要设计](docs/high-level-design.md) 和 [详细设计](docs/detailed-design.md)。

开源安全边界

仓库可以公开的内容包括 Go 源码、workspace 模板、脚本源码、测试 fixture、中文产品文档和安全模板。

不要提交这些内容：

• config.yaml、config.bailian.yaml、config.yaml.bak*、config.yaml.no_sonnet
• bot.db、bot.db.*、workspace 下的 bot.db
• workspaces//memory/、sessions/、tasks/、tmp/、tmp_file/
• 任意 .claude/skills/feishu_ops/feishu.json
• .claude/settings.local.json 等本机权限配置
• 运行日志、pid 文件、编译产物

已提供可公开模板：

• config.yaml.template
• config.bailian.yaml.template
• feishu.json.template

完整审计清单见 [开源发布审计](docs/open-source-audit.md)。

前置要求

必需：

• Linux / ma