前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。開發者在使用 DSH 構建智能體時，若需接入飛書或 Lark，通常面臨配置繁瑣（需公網服務器、回調配置）或語音處理依賴雲端 API 的問題。dsh-lark-plus 解決了這兩個痛點：它提供了零門檻的掃碼建應用方式，並實現了一條全程本機的語音轉寫鏈路。
核心功能¶
該插件將 DSH 智能體能力直接裝進飛書，具備以下能力：
- 雙向橋接與持久化：支持私聊與羣聊，具備雙持久化機制（Outbox + WAL），確保消息與回答在進程崩潰或熱更新後不丟失。支持連接自愈。
- 零門檻接入：通過
/lark setup掃碼即可創建飛書應用，無需手動配置回調。 - 本地語音轉寫：音頻處理完全在本地進行，不調用雲端語音 API。使用 SenseVoice 引擎進行轉寫，並在 DSH 網頁端提供播放條。
- Agent 能力：支持多模式 Agent（標準/PTC/極簡等），具備權限分級（只讀/工作區寫/完全訪問）、意圖確認轉發、命令分流等特性。
- 交互體驗：支持卡片按鈕、Markdown 渲染、流式輸出和表情回執。
安裝與啓用¶
前置條件：
- Node.js ≥ 24
- ffmpeg（用於語音轉寫）
安裝：
dsh plugin --profile <你的檔> add dsh-lark-plus
啓用步驟：
1. 在 DSH 的輸入框執行 /lark setup，使用手機飛書掃碼創建應用並寫入憑據。
2. 執行 /lark start 建立長連接。
3. 執行 /lark status 查看連接、會話及補發計數。
典型用法¶
- 命令分流：飛書側的
/mode、/permission、/goal均爲卡片化單選命令，點擊即可切換模式、權限或目標狀態。 - 診斷：發送
/doctor獲取包含 session log 和配置信息的診斷包。 - 熱改配置：發送
/lark-config key=value實時修改配置（如streaming.enabled=true）。 - 多媒體支持：發送圖片或文件，插件會將其轉交給視覺模型或文本提取工具。
注意事項¶
- 語音模型約 228MB，僅在首次使用時下載，之後完全離線。
- 桌面版 DSH 的
desktop檔由 Electron 獨佔，語音功能不可用。 - 許可證爲 MIT（fork 自 dsh-lark-link）。
總結¶
dsh-lark-plus 是一個功能完備的 DSH 插件，它不僅解決了飛書接入的配置難題，還通過本地語音處理保證了數據隱私。對於需要在飛書環境中運行 DSH 智能體的開發者，這是一個落地的選擇。
