前言¶
DeepSeek Harness 的插件體系可以把渠道能力接入同一個 dsh 環境。對需要在飛書/Lark 裏和 agent 協作的開發者來說，常見需求是：在私聊或羣聊中發送消息、接收流式卡片、處理 dsh 審批請求、調用雲文檔/表格/日曆/任務，並按 chat 路由多個 agent。
harness-lark 是 Lark/飛書（Feishu）渠道插件，爲 DeepSeek Harness 提供飛書通信能力。
這是什麼¶
harness-lark 的倉庫地址爲：
https://github.com/huoxue1/harness-lark
許可證爲 MIT。它解決的是把 DeepSeek Harness 的會話、流式回覆、審批請求和飛書能力接到飛書/Lark 消息通道的問題。
核心功能¶
下面介紹已覈實的幾類能力。
- IM 消息收發：WebSocket 長連接接收消息、文本/卡片回覆、@提及、羣聊/私聊策略、重連去重。
- 交互卡片 + 流式回覆：思考過程（reasoning）流式 → 生成（answer）流式 → 最終結果更新到卡片，含可摺疊思考面板、耗時/token footer。
- 媒體：圖片/文件/音頻的上傳、下載與發送。
- 文檔/Wiki/Drive：創建/讀取/更新雲文檔（docx）、知識庫節點、雲盤文件。
- Base/表格/日曆/任務：多維表格（bitable）、電子表格、日曆事件、任務。
- 用戶 OAuth：設備授權碼流程（RFC 8628），用戶級 token 管理。
- 表情反饋：收到消息回覆 Get 表情（處理中），完成後換成 DONE。
- 飛書審批卡片：dsh 審批請求（如 bash 沙箱升級）以帶批准/拒絕按鈕的卡片發到會話，點擊即應答，超時自動拒絕。
- 斜槓命令：/status、/model、/cd、/permission、/setting、/help 等本地命令。
安裝與啓用¶
前置條件¶
安裝前需要滿足以下條件：
Node.js ≥ 22（含 pnpm）
已安裝 dsh CLI
飛書開放平臺應用憑據：appId、appSecret
已訂閱事件：im.message.receive_v1
推薦安裝¶
先設置飛書應用憑據：
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=your_secret
然後安裝到 web profile：
dsh plugin --profile web add harness-lark
再啓動：
dsh --profile web
經過上面的步驟，插件會隨當前 dsh 進程加載，並按授權範圍調用飛書 API。
可選一鍵腳本：
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=your_secret
bash scripts/install-dsh.sh web harness-lark
源碼安裝¶
先克隆倉庫並構建：
git clone https://github.com/huoxue1/harness-lark.git
cd harness-lark
pnpm install && pnpm run build
再把本地目錄加入 web profile：
dsh plugin --profile web add file:/path/to/harness-lark
典型用法¶
斜槓命令¶
啓動後可以在飛書會話中使用以下本地命令：
/status
/model
/cd
/new
/stop
/permission
/setting
/help
這些命令用於查看狀態、切換模型、修改工作目錄、新建上下文、停止當前回覆、調整權限/設置以及查看幫助。
羣聊提及¶
羣聊中命令可帶 @機器人 前綴，例如：
@機器人 /status
插件會自動剝離提及前綴。
多 Agent 路由¶
多 Agent 配置可在 config.agents 中按 chat 路由。下面是一個只表達 chat 路由的示例：
agents:
- id: agent-a
chats:
- oc_111
- p2p
- id: agent-b
chats:
- oc_222
- group
其中 oc_ 形式表示精確 chat_id，p2p 和 group 表示類型標籤。
安全與適用場景¶
harness-lark 適合私聊助手場景。插件在授權範圍內以機器人身份調用飛書 API，存在模型幻覺、提示注入等固有風險。建議不要加入羣聊或允許他人交互，並保持默認安全配置：
groupPolicy: disabled
requireMentionInGroups: true
用戶數據類工具在用戶執行 /feishu auth 授權後以該用戶身份調用飛書 API；未授權時回退爲機器人身份。Wiki/Drive/IM 類工具始終以機器人身份調用。
安裝前建議檢查源碼和許可證。許可證爲 MIT。
鏈接¶
GitHub 倉庫：
https://github.com/huoxue1/harness-lark
