zarazhangrui/lark-coding-agent-bridge

解决的问题

本项目在 Feishu/Lark 聊天工具与本地 AI 编程助手（如 Claude Code 或 Codex CLI）之间搭建了一座桥梁。它允许用户直接通过聊天界面与本地开发环境及编程助手进行交互，无需为每次操作都保持终端开启。

工作原理

该桥梁作为一个中间件，负责将来自 Feishu/Lark 的消息转发到本地代理进程。它负责管理会话、工作目录和文件附件。通过 PersonalAgent 应用连接到聊天工具的 API，可以在首次运行时通过二维码向导进行配置。

适用对象

使用 Claude Code 或 Codex CLI，并希望为了方便、远程访问或团队协作，通过移动端或桌面端聊天应用（Feishu/Lark）访问本地编程助手的开发者。

功能亮点

• 实时流式传输：在单个 Lark 卡片上实时更新文本回复和工具调用。
• 会话管理：为不同的聊天、话题或文档评论线程维护独立的会话。
• 工作区控制：支持使用 /cd 切换项目目录，并使用 /ws 保存命名工作区。
• 访问控制：默认私有，并提供精细的权限设置，用于邀请特定用户、群组或管理员。
• COT 过程可视化：可选显示代理的“思维链”（COT）过程，包括工具调用和进度文本，随后才给出最终答案。
• 文件处理：自动将通过聊天发送的图片和文件下载到本地代理环境中。
• 后台服务：可以作为操作系统管理的守护进程（systemd、launchd 或 Windows 任务计划程序）运行，以实现持久可用性。