Hysen Labsdeepcoldy/botmux：README 來源編輯指南
根據 README、倉庫資料與授權整理 deepcoldy/botmux 的安裝與核驗路徑。
專案定位
deepcoldy/botmux 的 README 將專案描述為「Bridge Feishu/Lark to AI coding CLIs , Claude Code, Codex, Gemini, OpenCode… every DM, group or topic spawns its own live-streaming CLI session」。本文只整理倉庫可直接核對的內容，不把 star、Fork 或宣傳語當成品質證明。README 在「botmux」下寫到：Daemon 监听飞书消息，为每个新会话自动 spawn 一个独立的会话进程，把 AI 编程 CLI / Agent 的输出实时流式回传成飞书卡片，并提供可交互的 Web 终端。它不重造 Agent 能力，而是直接桥接你已经在用的工具（20+ CLI / Agent 适配器，见 支持的 CLI / Agent）。。這說明的是專案邊界，不是已完成的生產驗證。
適用場景
從 README 的「它解决什么」與相關條目，可以先判斷它是否處理你的實際問題：CLI 不感知飞书上下文 , 把机器人拉进话题群 / oncall 群，@ 一句就在你本机的代码库里开跑；会话可以用 /relay 原样搬到另一个群，上下文一点不丢。。若需求不同，不應只因專案熱度就採用。本文保留原始專案名、命令與元件名，方便回到一手來源核對。 README 另外列出一項可核對的資訊：Agent 收不到通知、手机控不了 , CLI 跑在开发机上，人在手机上。botmux 把每轮输出推成飞书卡片，随时随地查看 / 追问 / 打断，还能开可写 Web 终端直接操作。。這類原文條目可用來設計試跑步驟，但不能取代實際環境測試。
運作方式
README 將運作方式分散在「5 分钟接入」等段落。可確認的線索包括：然后私聊机器人、或 botmux dashboard 拉个群，直接开聊。完整步骤（含 Lark 国际版、--no-open-platform-auto 后手动配置权限 / 发版、排查）见 5 分钟快速接入。。本文不把未寫出的架構、效能或安全邊界補成結論；真正的執行鏈仍要配合目錄、設定檔與版本標籤檢查。
安裝與第一次執行
第一次安裝應從 README 指出的入口開始。目前可核對的命令是： npm install -g botmux # 需要 Node >= 22 botmux setup # 一次扫码建应用 → 选 CLI → 选工作目录（自动配权限 + 发版） botmux start # 启动 daemon（botmux autostart enable 设开机自启） 如果倉庫沒有命令，本文不會自行編造步驟，而是建議先閱讀「它解决什么」，確認系統依賴、預設埠與首次初始化。
設定與日常使用
日常使用取決於專案文件。README 的「支持的 CLI / Agent」段落提到：bots.json 里用 cliId 一键切换。20+ 适配器，覆盖本地 CLI（进程隔离，tmux attach 可直连）和 API / 云 Agent（如 Mira、riff,,通过 API / 远端接入，非本地进程）。代表项：。設定檔、環境變數、權限與資料目錄只在來源明確時才會記錄；沒有寫出的預設值，應在測試環境驗證並保留回滾副本。 同一部分也提到：单个 Agent 不够用 , 同一个群里放多个不同 CLI 的机器人，@ 谁谁干活，让 Claude Code 和 Codex 一起 review 同一个 MR、各自独立分析、观点不同自动互怼。。