前言¶

DSH 生態裏，渠道能力通常以插件形式接入。如果你希望在飛書或國際版 Lark 中使用 DeepSeek Harness，並且需要處理文本、圖片、普通文件、持久會話和工具審批，而不是隻做單輪文本問答，就需要一個能承接這些能力的渠道插件。

相比需要公網回調服務器的接入方式，sliverp/DeepSeek-harness-lark 使用官方 WebSocket 傳輸，不需要公網回調服務器，並支持飛書和國際版 Lark。下面介紹它的定位、核心能力、安裝配置和典型用法。

這是什麼¶

sliverp/DeepSeek-harness-lark 是一個 DeepSeek Harness channel bridge，用於把飛書 / Lark 的文本、圖片和文件接入 DSH。

關鍵信息如下：

• 倉庫：sliverp/DeepSeek-harness-lark
• 維護者：sliverp
• 許可證：MIT
• 基礎：官方 @larksuiteoapi/node-sdk
• 傳輸：官方 WebSocket，自動重連
• 適用：飛書和國際版 Lark

核心功能¶

消息與會話¶

• 支持文本、富文本、圖片和普通文件輸入。
• 每個聊天維護持久、隔離的 Harness 會話。
• 發送 /new 會保留舊歷史，並切換到空白會話。
• 創建和恢復會話時都會掛載並記錄 Agent preset，默認 preset 是 standard。
• 支持直聊和羣聊訪問策略；羣聊默認需要 @ 機器人。

文件與多模態¶

• 支持 Durable Harness attachments，並按模型能力組織多模態輸入。
• 普通文件會下載到 Agent workspace 的 .dsh-lark/inbox/，方便文件系統工具檢查。
• 回覆支持模型文本、生成圖片上傳和工作區文件發送。

命令與審批¶

• 已註冊的 Harness slash commands 直接執行，不作爲普通消息發送給模型。
• 同一會話內可以使用 /approve <code> 和 /reject <code> 完成一次性工具審批。
• 提供以下命令：
• /bot-ping
• /bot-help
• /bot-image-test
• /bot-file-test
• /bot-status
• /bot-cancel

憑據與啓動¶

• App Secret 通過 Harness credential service 解析。
• 如果未配置 App ID 或 App Secret，插件會處於 dormant startup。
• 僅安裝插件不會阻塞 Harness Web。
• 憑據缺失或無效時，該渠道離線並記錄日誌，不會阻塞 Harness 啓動。

安裝與啓用¶

環境要求¶

Node.js 22.19 or later
pnpm 10.33.4
DeepSeek Harness 0.1.0-rc.7 or later

安裝¶

先安裝插件，再配置飛書 / Lark 應用憑據：

pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-lark

配置飛書 / Lark 應用¶

1. 在飛書開發者控制檯創建自建應用，並啓用 bot 能力。
2. 授予以下權限：

im:message.p2p_msg:readonly
im:message.group_at_msg:readonly
im:message:readonly
im:message:send_as_bot
im:resource

其中，im:message:readonly 用於飛書消息資源下載端點，處理用戶發送的圖片和文件；im:resource 仍用於機器人側圖片 / 文件上傳。

3. 選擇長連接事件投遞，並訂閱 im.message.receive_v1。
4. 發佈應用版本，並把機器人加入需要使用的聊天。
5. 將 App ID 放入 LARK_APP_ID，並把 App Secret 存到 Harness credential reference LARK_APP_SECRET。

開發環境可以臨時注入環境變量：

export LARK_APP_ID='<app-id>'
export LARK_APP_SECRET='<app-secret>'
pnpm dsh --profile web

爲了長期使用，將 App ID 放入 ~/.dsh/.env，並通過 Harness credential 設置界面保存 App Secret。不要提交憑據。

典型用法¶

基礎檢查¶

在聊天中依次發送：

/bot-ping
/bot-image-test
/bot-file-test
/new

這一步用於檢查基本連通性、圖片測試、文件測試和新建會話。

文件檢查與發送¶

發送普通文本、一張圖片和一個 CSV 文件，然後要求機器人檢查 CSV，並確認它使用的是已下載到工作區的路徑。

接着要求它創建併發送一個 CSV。最終回覆應包含文件附件。

工具審批¶

發起一個需要審批的操作，然後使用給出的精確指令回覆：

/approve <code>

或者拒絕該操作：

/reject <code>

限制與注意¶

• 訪問策略支持 open、allowlist、disabled。生產環境建議使用 allowlists 和最小權限 Harness permissions。
• 入站默認值：單條消息允許 10 個文件，單文件最多 50 MiB，單條消息總大小最多 100 MiB。
• 出站默認值：一條回覆最多發送 5 個非空文件，每個最多 30 MiB。
• approvalTimeoutMs 必須小於 responseTimeoutMs。
• agentPreset 是新建會話和沒有 preset 的持久化記錄的顯式回退值。
• 工具循環修復會把插件會話命名空間從 lark-v1-* 推進到 lark-v2-*。舊文件不刪除、不改寫，但插件不再追加到可能受 DSML 污染的 lark-v1-* 記錄；舊記錄仍可在 Web UI 中查看。
• 插件會以當前 dsh 進程權限運行。安裝前建議先檢查源碼和 MIT 許可證。

結尾¶

如果需要在飛書 / Lark 內使用 DeepSeek Harness，並且重點是文本、圖片、文件、持久會話和審批，sliverp/DeepSeek-harness-lark 提供了一個不需要公網回調服務器的接入方式。

社區目錄爲獨立站點，不代表 DeepSeek / 幻方官方應用商店。倉庫地址：

https://github.com/sliverp/DeepSeek-harness-lark

線索給出的目錄頁，以實際收錄爲準：

https://www.skillhub.cn/plugins/sliverp/DeepSeek-harness-lark