zarazhangrui/lark-coding-agent-bridge

解決的問題

本專案在 Feishu/Lark 聊天工具與本地 AI 編程助手（如 Claude Code 或 Codex CLI）之間搭建了一座橋樑。它允許使用者直接透過聊天介面與本地開發環境及編程助手進行互動，無需為每次操作都保持終端開啟。

工作原理

該橋樑作為一個中間件，負責將來自 Feishu/Lark 的訊息轉發到本地代理進程。它負責管理會話、工作目錄和檔案附件。透過 PersonalAgent 應用連接到聊天工具的 API，可以在首次執行時透過 QR Code 向導進行配置。

適用對象

使用 Claude Code 或 Codex CLI，並希望為了方便、遠端存取或團隊協作，透過行動裝置或桌面端聊天應用（Feishu/Lark）存取本地編程助手的開發者。

功能亮點

• 即時串流傳輸：在單個 Lark 卡片上即時更新文本回覆和工具呼叫。
• 會話管理：為不同的聊天、話題或文件評論執行緒維護獨立的會話。
• 工作區控制：支援使用 /cd 切換專案目錄，並使用 /ws 儲存命名工作區。
• 存取控制：預設為私有，並提供精細的權限設定，用於邀請特定使用者、群組或管理員。
• COT 過程可視化：可選擇顯示代理的「思維鏈」（COT）過程，包括工具呼叫和進度文本，隨後才給出最終答案。
• 檔案處理：自動將透過聊天發送的圖片和檔案下載到本地代理環境中。
• 背景服務：可以作為作業系統管理的守護進程（systemd、launchd 或 Windows 任務排程器）執行，以實現持久可用性。