前言¶
DeepSeek Harness 以插件方式擴展本地智能體的使用入口。dsh-feishu-bot 解決的是另一個常見需求：把本地 agent 的交互延伸到飛書私聊。它允許用戶從 Feishu（Lark）私聊中發送命令、查看會話、處理審批，並與 Web GUI 共享會話。
下面介紹它的定位、已覈實能力、安裝方式和部署注意事項。
這是什麼¶
dsh-feishu-bot 是一個 DeepSeek Harness 插件，包名爲 @tingrudeng/dsh-feishu-bot，當前包版本爲 0.1.0-rc.11，許可證爲 MIT，由 TingRuDeng 維護。
它的定位是 Feishu（Lark）private-chat frontend：從飛書私聊中驅動、監控和審批 DeepSeek Harness 的本地 agent，並與 Web GUI 共享 sessions。
版本狀態¶
當前 0.1.0-rc.11 聲明兼容 DSH 0.1.2-alpha.2。
已覈實信息表明，rc.11 包含：
rc.9 S4 Markdown escaping unificationM7.0-M7.3 model/effort selectionsession-persistence ownership fence
在通過真實飛書驗收前，它仍是本地候選。
核心功能¶
私聊命令¶
插件提供飛書私聊命令，用於創建、綁定、查詢和控制會話：
/new [cwd]：在允許的 workspace 下創建會話並綁定/ls：查看未歸檔會話，兩級卡片先選擇 workspace，再點真實 session 標題綁定/use <sessionId|n>：綁定已有會話，作爲/ls的文本 fallback/stop：取消當前正在運行的 turn，保留已排隊的 follow-ups/status：查看狀態/effort <id>：選擇 effort/model：查看或處理模型相關狀態/release：停止任務卡與任務級持久結果同步/help：查看幫助
文本與審批¶
普通非命令飛書消息會作爲單個用戶文本塊進入已綁定會話，bridge 不重寫其內容。
插件支持審批卡片，並與 approval/asked 事件配對。飛書或 Web 的決定可解析正常審批請求。
模型行爲邊界¶
插件不注入系統提示詞、模型指令或工具 schema。模型與工具行爲仍由 DeepSeek Harness 擁有。
已覈實配置項¶
已覈實的網關和橋接配置項包括：
appIdRef
appSecretRef
sendRetryBaseMs
sendMaxAttempts
sendCircuitCooldownMs
disposeDrainTimeoutMs
allowedOpenIds
allowedWorkspaces
defaultWorkspace
這些配置項分別涉及憑據引用、發送重試、冷卻、關閉排水、允許用戶、允許 workspace 和默認 workspace。已覈實資料未給出完整配置參考，因此這裏不展開爲完整配置表。
安裝與啓用¶
registry 安裝¶
在已有 web profile 中安裝 scoped RC：
dsh plugin --profile web add @tingrudeng/dsh-feishu-bot@latest
安裝後可以用下面命令查看配置面，預期看到 gateway、bridge、registry 和 invariant 相關行：
dsh --profile web --dump-config
舊無 scope 源包¶
如果當前 profile 仍包含舊無 scope 源包，需要先移除，再安裝 scoped RC：
dsh plugin --profile web remove dsh-feishu-bot
dsh plugin --profile web add @tingrudeng/dsh-feishu-bot@latest
飛書側準備¶
憑據¶
需要設置飛書應用憑據：
FEISHU_APP_ID
FEISHU_APP_SECRET
倉庫不包含 secret。
飛書控制檯¶
需要訂閱事件並啓用權限：
- 訂閱
im.message.receive_v1事件 - 啓用
im:message.p2p_msg:readonly - 如果使用審批卡片，啓用
card.action.trigger回調 - 每次修改後發佈應用版本
典型用法¶
下面是已覈實的常用操作：
/new [cwd]
/ls
/use <sessionId|n>
/stop
/status
/effort <id>
/model
/release
/help
當你發送普通文本時，消息會進入已綁定會話。會話綁定時，任務卡和任務級持久結果會在飛書中同步；使用 /release 可以停止這種同步。
如果希望確認本地配置是否暴露出插件相關行，可以執行：
dsh --profile web --dump-config
適用場景與注意¶
dsh-feishu-bot 適合希望在飛書私聊中操作 DeepSeek Harness 本地 agent 的使用者，尤其是需要與 Web GUI 共享同一批會話，並在飛書中處理指令、狀態和審批的場景。
使用前需要注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 rc.11在通過真實飛書驗收前仍是本地候選。- bundle patch 在部署配置提供
allowedOpenIds和allowedWorkspaces前保持 fail-closed。 - 如果配置了
defaultWorkspace，它必須解析到允許的根內。 - 完整配置參考未在本次已覈實資料中展開，部署時應以倉庫文檔和實際
dsh --dump-config輸出爲準。
