dsh-lark-bot 怎么用？把 DeepSeek Harness 装进飞书的完整教程

使用指南发布于 2026-08-19作者: DSH-Plugin 插件中心
dsh-lark-bot飞书LarkDeepSeek Harness使用教程
dsh-lark-bot 是 DeepSeek Harness（DSH）的飞书/Lark 桥接 DSH-Plugin，扫码即用：把本机 coding agent 装进飞书，支持流式卡片、并行任务与安全网守护。本文讲清三步安装、常用命令、多角色与并行任务用法，以及 dsh 崩溃后的 /safemode 自救。

dsh-lark-bot 是 DeepSeek Harness（DSH）的飞书/Lark 桥接插件（DSH-Plugin）：扫码即用，在手机、群聊、话题里指挥本机 coding agent，流式卡片实时看进度，任务完成主动推送并 @ 你，dsh 崩溃后依然叫得应。

dsh-lark-bot 由 PlutoKeating 维护，采用 AGPL-3.0 协议，用 TypeScript 编写，已验证兼容 dsh 0.1.0-rc.6（来源）。它是 DSH-Plugin 生态里功能组合最全的飞书桥接方案：安全网守护、多角色 Agent、并行多任务、会话归档、跨会话主动通知、对话内模型与密钥管理六项合一。

dsh-lark-bot 解决了什么问题？

DSH 跑在本机，离开电脑就「失联」：看不到任务进度、收不到完成通知，甚至 dsh 崩溃后完全断线。dsh-lark-bot 把遥控器装进飞书——私聊、群聊、话题里都能指挥本机 agent，图片、文本文件直接发给 bot 即可，Git 仓库内每个会话还会自动创建隔离的 worktree 项目工作区（来源）。

dsh-lark-bot 三步安装与扫码绑定

前置条件：已安装并配置好 DeepSeek Harness（dsh）和 DEEPSEEK_API_KEY，Node.js ≥ 22.19，一个飞书/Lark 账号（来源）。

bash
# ① 一键安装（自动装进 dsh profile，并默认安装「安全网守护」）
npx dsh-lark-bot@latest setup --profile dsh-lark
# ② 启动
dsh --profile dsh-lark

③ 首次启动终端打印二维码，用飞书/Lark 扫码创建或选择 PersonalAgent 应用即可绑定。无需公网 IP、域名、服务器或内网穿透（飞书走 WebSocket 出站长连接），Linux/macOS/Windows 通用。已有应用时可用 DSH_LARK_APP_ID / DSH_LARK_APP_SECRET / DSH_LARK_TENANT 环境变量跳过扫码。也可以直接通过插件中心安装：dsh plugin --profile web add github:plutokeating/dsh-lark-bot。

绑定后私聊直接发消息；群聊/话题默认 @bot，可显式开启受白名单保护的无 @ 模式。

dsh-lark-bot 常用命令速查

常用命令都以 / 开头，一条斜杠命令就能指挥本机 agent，/help 随时查看全量列表。

命令作用
/new /reset开始新会话
/newg <群名>自动新建群聊并开新会话
/cd <path>切换工作目录并重置会话
/ws save <name>保存当前工作空间
/status查看当前状态与运行中的 run
/stop终止当前任务
/timeout [N]查看/设置会话运行超时
/concurrency [N]查看/设置并行任务数（默认 2）
/archive /retention [N]手动归档 / 设置自动保留策略
/help查看帮助

完整命令见 README（来源）。

dsh-lark-bot 六项独有能力怎么用？

六项能力全部通过飞书内的斜杠命令触发，扫码绑定后即可直接使用。

  • Guardian 安全网守护：独立于 dsh 进程的系统级守护，dsh 崩溃后飞书仍会回复。发 /safemode 进入仅核心安全模式（只加载官方核心、不加载第三方插件），直接在聊天里定位/修复/禁用损坏插件，/safemode exit 恢复完整 profile。
  • 多角色 Agent：/role save <id> <name> --persona 文案 定义 PM、开发、文档等角色，/role set <id> 绑定到当前会话，每个 run 携带角色人设与规则。
  • 并行多任务：同一群聊同时跑多个任务、会话隔离，无需排队；/concurrency 调整并行数。
  • 会话归档与清理：/archive 归档旧任务、/retention 配置保留策略，会话列表不会烂掉。
  • 跨会话主动通知 + @人：A 群跑完任务主动推送到 B 群/私聊并 @ 你（/notify）。
  • 对话内管理模型和密钥：/providers /provider /model /key 打开交互式管理卡片，不用离开飞书即可热切换模型、管理 provider 与密钥。

dsh 崩溃了怎么办？

dsh 下线或无法 boot 时，安全网守护自动接管飞书通道。发 /safemode 进入仅核心安全模式，用 dsh-base + dsh-headless 官方核心直接定位问题；/safemode plugins 列出故障 profile 的插件清单，/safemode exit 重启完整 profile 并交还通道。这是唯一「dsh 挂了你不会失联」的桥接方案（来源）。

dsh-lark-bot 升级、禁用与卸载

升级一条命令、禁用一个环境变量、卸载一条指令，全部在终端完成。

  • 升级：npx dsh-lark-bot@latest upgrade --profile dsh-lark --yes（自动升级包体、幂等重装并重启守护，--check 零改动检查，--rollback 回滚）。
  • 禁用：启动前导出 DSH_LARK_DISABLED=1，保持加载但停止桥接引擎。
  • 卸载：dsh plugin --profile dsh-lark remove dsh-lark-bot；本地状态保留在 ~/.dsh-lark。

安全提醒：认准 dsh-lark-bot 官方渠道

唯一官方仓库为 PlutoKeating/dsh-lark-bot，唯一官方 npm 包为 dsh-lark-bot（同源双包 dsh-feishu-bot）。项目从不提供 Windows 可执行文件（.exe），任何以项目名义提供 exe 或「下载即运行」的页面、仓库或第三方分发渠道均为假冒/恶意来源，请勿下载运行。密钥建议在私聊中管理或引用环境变量，bot 不在任何回复中回显密钥值。

本插件详情见 dsh-lark-bot 插件页，更多 DSH 插件见 插件中心。

常见问题

dsh-lark-bot 怎么升级到最新版？

推荐一条命令：npx dsh-lark-bot@latest upgrade --profile dsh-lark --yes，自动完成包体升级、幂等重装并重启安全网守护，再用 doctor 验证；--check 只查不改，--rollback 可回滚。

怎么临时禁用或彻底卸载 dsh-lark-bot？

临时禁用：启动 profile 前导出 DSH_LARK_DISABLED=1（保持加载但停止桥接）。彻底卸载：dsh plugin --profile dsh-lark remove dsh-lark-bot；本地状态保留在 ~/.dsh-lark，如需清除先备份再删。

怎么识别 dsh-lark-bot 的假冒版本？

唯一官方仓库是 PlutoKeating/dsh-lark-bot，唯一官方 npm 包是 dsh-lark-bot（同源 dsh-feishu-bot）。项目从不提供 .exe 或「下载即运行」的安装包，任何以项目名义分发 exe 的页面或仓库都是假冒来源，不要下载运行。

来源

查看全部文章