[Plugin] dsh-lark-bot：把 DeepSeek Harness (dsh) 桥接进飞书 / Lark（标准 dsh profile bundle）

[PlutoKeating]

[Plugin] dsh-lark-bot —— 把 DeepSeek Harness (dsh) 桥接进飞书 / Lark

1. 插件名称与仓库地址

• 名称：dsh-lark-bot（npm 双包 dsh-lark-bot / dsh-feishu-bot，内容一致）
• 仓库：https://github.com/PlutoKeating/dsh-lark-bot
• 形态：标准 dsh profile bundle（dsh.bundle.patch → cordis.patch.yml）

2. 功能简介及与 DeepSeek 的关系

把 DeepSeek Harness（dsh）接入飞书 / Lark 的桥接 bot：在私聊、群聊、话题里指挥本机 dsh
coding agent，收到流式卡片与工具调用过程。核心能力：

• 标准插件装载：dsh-lark-bot/plugin 在 dsh 进程内运行完整桥接引擎（飞书通道、会话/工作区、
  卡片、通知回调），lark-notify 作为标准工具行（lark_notify 跨会话通知 + @ 提及）。
• 项目工作区管理（核心差异化）：git worktree / 分支隔离、项目级 AGENTS.md 注入、上下文持久化。
• scope 内并行任务、多角色 Agent（persona / 模型 / 工具指引 / 规则）、会话/任务归档、审批卡 / 问答卡。

与 DeepSeek 的关系：直接使用官方 @deepseek-ai/dsh-sdk-client / @deepseek-ai/dsh-acp，
在 dsh 0.1.0-rc.6 上完成真实握手与流式任务验证；非官方项目，无 DeepSeek 背书。

3. 安装或使用方式

唯一路径（一行安装 + 一次扫码）：

npx dsh-lark-bot@latest setup --profile dsh-lark   # 安装为 dsh profile bundle
dsh --profile dsh-lark                              # 启动，首次扫码绑定飞书应用

或标准命令：dsh plugin --profile <name> add dsh-lark-bot。
卸载：dsh plugin --profile <name> remove dsh-lark-bot。

4. 开源许可证和版权归属

• 许可证：AGPL-3.0（LICENSE 与 package.json 一致）。
• 版权归属：源码归项目维护者所有，按 AGPL-3.0 授权；「DeepSeek」「飞书 / Lark」商标归各自权利人。

5. 当前维护状态及主要维护者

• 状态：活跃维护（Active），npm 已发布 0.7.0（npm + GitHub Packages + GitHub Release）。
• 主要维护者：PlutoKeating。
• 问题 / 建议：GitHub Issues；安全漏洞走 SECURITY.md 私下报告渠道。

6. 已知风险、限制或兼容性说明

• 兼容性：dsh 0.1.0-rc.6（最后验证 2026-08-15，pnpm release:check + CI compat-probe 通过）。
• 已知限制：ACP 会话每次全新（上游限制）；SDK 协议无 mid-turn cancel，/stop 关闭并重建
  runtime；桥接引擎在 dsh 进程内运行、agent 执行使用官方 dsh SDK runtime 子进程（嵌套
  runtime 的有意取舍，服务于按工作区隔离的 runtime 池与并行 run）；飞书文档评论 / 富文本回复
  为规划中；pnpm ≥ 10 构建脚本策略由 setup 自动处理。
• 权限披露：访问本机工作目录（执行命令 / 改文件）、飞书凭据（本地 0600 配置）、
  ~/.dsh/settings.yaml 与 ~/.dsh/.credentials.yaml（仅管理员命令）、dsh runtime 子进程；
  详见插件 README「权限与数据」与 SECURITY.md。

[PlutoKeating]

v0.8.0 更新（2026-08-15）

已发布 v0.8.0（npm 双包 dsh-lark-bot / dsh-feishu-bot 同步；GitHub Release：
https://github.com/PlutoKeating/dsh-lark-bot/releases/tag/v0.8.0），本次新增 安全网守护
（Safety-net guardian，issue #6）：

• 独立于 dsh 进程的系统级最小守护（Linux systemd user unit / macOS LaunchAgent / Windows 启动项）；
• dsh 正常运行时静默、不抢占飞书通道；dsh 下线 / 无法 boot 后自动接管飞书长连接，接收
  /safemode 控制信号作为唯一救援入口；
• /safemode 以仅核心 profile（dsh-base + dsh-headless，不加载任何第三方插件）拉起受限
  对话自愈，可定位 / 修复 / 禁用损坏插件；/safemode plugins 列出故障 profile 插件清单；
• /safemode exit 退出安全模式并重启完整 profile、交还飞书通道；全程无需接触命令行；
• 安装：npx dsh-lark-bot@latest setup --profile dsh-lark --guardian。

升级：重跑 npx dsh-lark-bot@latest setup --profile dsh-lark 即升级到最新版。
仓库信息无变化：https://github.com/PlutoKeating/dsh-lark-bot

[PlutoKeating]

亮点补充：六项全网独家能力（2026-08-15）

补充 dsh-lark-bot 相对其他飞书桥接方案的六项独家能力（详见 README「项目介绍 | What & Why」）：

• 🆘 Guardian 安全网守护 —— “永远叫得应”（issue [Plugin] dsh-bang-shell — 输入框以 ! 直接执行 Shell 命令（不经过模型） #6 设计实现）：独立于 dsh 进程的系统级最小守护；dsh 崩溃 / 无法 boot 时自动接管飞书通道，/safemode 以仅核心 profile（dsh-base + dsh-headless，不加载任何第三方插件）拉起受限对话自愈（定位 / 修复 / 禁用损坏插件），/safemode plugins 列出插件清单，/safemode exit 恢复完整 profile。唯一“出故障时用户不会失联”的项目。
• 👥 多角色 Agent —— “一个机器人，一整个团队”：/role 在飞书里切换或指派 PM / 开发 / 文档等角色，每个角色有持久化人设、模型偏好与规则。
• ⚡ 并行多任务 —— “不用排队”：同一群聊可同时跑多个任务，会话隔离，上一个没跑完不影响下一个。
• 🗂 会话归档与清理 —— “会话列表不会烂掉”：/archive 归档旧任务、/retention 自动保留策略。
• 📣 跨会话主动通知 + @人 —— “活干完了它会来找你”：agent 完成任务可主动发消息到其他群 / 私聊并 @ 成员。
• 🔑 对话内管理模型和密钥 —— “不用离开飞书”：/providers /provider /key 聊天内查看、切换供应商、热更新密钥。

以上六项为 dsh-lark-bot 全网独有组合；安装：npx dsh-lark-bot@latest setup --profile dsh-lark --guardian。

[Nanki-nn]

hi

[PlutoKeating]

hi! anything i can help with?