前言¶
离开电脑后，需要继续与 DeepSeek Harness 助手对话、查看结果或处理任务时，通常只能回到桌面端。dsh-lark-agent 为 DeepSeek Harness 提供了一个飞书（Lark）私聊入口，让助手在手机或平板上也能响应请求。
这是什么¶
dsh-lark-agent 是一个 DeepSeek Harness 插件，通过官方飞书 CLI 与运行中的 Harness 实例通信。它会在飞书中创建一个独立的私聊会话，不会接管桌面端或网页端已打开的对话。插件由 Nirvana-Jie 维护，开源协议为 MIT。
核心功能¶
在飞书私聊中，助手支持以下能力：
- 发起请求：助手使用 Harness 的工具（网页搜索、页面读取、工作区文件等）处理请求，结果以卡片形式流式返回，思考过程折叠在卡片内部
- 确认请求：需要用户审批的操作会发送确认卡片，点击「允许一次」或「拒绝」；5 分钟内未响应则不会执行
- 选项选择：当 Harness 需要用户选择时，发送选项卡片供点击或填写
- 权限切换：通过
/permission或底部菜单「设置 → 权限模式」在只读、工作区编辑、完全访问之间切换，完全访问后不再询问 - 文件传输：助手可以将工作区文件直接发送到聊天中
- 优先结论：说「lead with the conclusion from now on」，助手会记住此偏好
- 会话管理：使用
/sessions、/new继续、切换或开启新话题 - 图表展示：请求柱状图等数据时，返回原生飞书图表卡片
- 表单交互：先让用户选择选项再继续，发送表单卡片
- 文档与白板：请求架构图或报告时，创建只读共享的飞书文档（含白板），App 0.2.1-rc.2/0.2.1-rc.3 中打开该文档可在 App 内预览
- 模型与思考深度：通过
/model、/thinking切换模型与思考深度，与电脑端保持同步
默认情况下，助手只响应自己的私聊。权限和会话记忆保留在运行 Harness 的主机上，消息通过飞书传递给模型提供商。
安装与启用¶
前置要求¶
- DeepSeek Harness 正在运行，已选择默认模型
- PC App 版本 0.2.1-rc.3（0.2.1-rc.2 也可），或 Web / dsh CLI 版本 0.1.1-rc.2
- 在同一机器上安装官方飞书 CLI（需要 Node.js / npm）：
npm install -g @larksuite/cli@1.0.98
lark-cli --version
安装插件前不要运行 lark-cli config init 或 lark-cli auth login，插件会在扫码时创建自己的专用 CLI 配置文件。
桌面应用安装¶
- 在侧边栏打开「插件 → 添加插件」
- 输入
dsh-lark-agent，点击「安装」 - 点击「立即启用」，如需则重启应用
CLI 安装¶
dsh plugin 使用 pnpm，需确保 pnpm 在 PATH 中：
dsh plugin --profile web add dsh-lark-agent --allow-build=protobufjs
然后重启 dsh web。
注意：
--allow-build=protobufjs允许 Lark SDK 依赖的安装脚本运行。pnpm 11 在未指定时会跳过该脚本并报错ERR_PNPM_IGNORED_BUILDS。若已报错，可执行：
dsh plugin --profile web approve-builds '!protobufjs'
然后再重启 dsh web。
连接飞书¶
- 打开飞书设置页面：桌面应用「设置 → 内置插件 → 飞书」，网页「设置 → 插件 → 飞书」
- 点击「扫码创建并连接」，用你的飞书账号扫码并批准
- 若组织需要管理员批准，点击「重新检查」等待批准
- 点击「打开飞书私聊」，从扫码账号发送配对词（
DSH-…，10 分钟内有效）作为纯文本消息，必要时确认「这是我，完成连接」 - 页面显示「已连接」后，即可向助手发送消息
注意：飞书入口仅在主机在线时可用（主机未关闭、网页未停止、电脑未睡眠）。
典型用法¶
在飞书私聊中：
- 请求查询或任务处理：助手会使用工具并流式返回结果卡片
- 需要审批时：点击「允许一次」或「拒绝」
- 需要选择时：点击选项或填写表单并提交
- 切换权限模式：使用
/permission或底部菜单 - 查看结果文件：助手直接发送文件
- 请求图表：获得原生飞书图表卡片
- 请求文档或白板：创建只读共享的飞书文档
- 切换模型或思考深度：使用
/model或/thinking
适用场景与注意¶
适合需要移动端访问 Harness 能力的场景，如外出时继续对话、查看生成结果、快速审批或处理简单任务。
注意：插件以当前 Harness 进程的权限运行。安装前应检查源码与许可证。不同版本和平台的兼容性尚未完全验证，当前已验证的版本组合见 README 中的兼容性说明。
结尾¶
dsh-lark-agent 让 DeepSeek Harness 助手从电脑延伸到飞书，在离开屏幕时也能保持连续交互。更多文档、升级说明与排障步骤请参考项目页面。
- 插件目录：https://www.skillhub.cn/plugins/Nirvana-Jie/dsh-lark-agent
- GitHub：https://github.com/Nirvana-Jie/dsh-lark-agent
