前言¶
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 智能体的开发者，这是一个落地的选择。
