[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 #2）：

• 独立于 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 命令（不经过模型） #2 设计实现）：独立于 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?

[PlutoKeating]

v0.10.1 更新（2026-08-16）· Stability fix

已发布 v0.10.1（npm 双包 dsh-lark-bot / dsh-feishu-bot 同步；GitHub Release：https://github.com/PlutoKeating/dsh-lark-bot/releases/tag/v0.10.1）。

v0.10.0 新增（安全模式实时可见性）：

• 安全模式优先使用官方 SDK 流式 runtime（dsh-lark-safe-sdk，仅官方核心 bundle、无第三方插件、不挂载 bridge 回调工具），与正常模式同一张流式卡片实时展示思考 / 工具调用 / web search / 打字机文字，并支持原生 session(id) 续跑；SDK 预置失败自动回退 headless 活动卡；
• 运行卡片显示「已运行 Ns / 无响应 Ns」，排队消息立即回执（不再无声排队）；
• 新增 DSH_LARK_GUARDIAN_SAFE_ADAPTER / DSH_LARK_GUARDIAN_SAFE_TIMEOUT_MS / DSH_LARK_GUARDIAN_CARD_DENSITY。

v0.10.1 修复（稳定性）：

• 运行看门狗从「墙钟超时」改为「空闲超时」：只在任务持续无活动事件时才终止，活跃的流式任务不再被 5 分钟总时长上限误杀（真实线上问题：正常工作中被掐断并显示“N 分钟无响应，已自动终止”）；
• SDK 原生 session 续跑不再重放历史（避免与 dsh 持久化日志漂移），恢复失败自动清除 session 绑定并以全新会话重试一次（id collision 自愈）；
• 发布脚本直接引用仓库 cordis.patch.yml，发布版与仓库文件零漂移。

安装：npx dsh-lark-bot@latest setup --profile dsh-lark（或 dsh plugin --profile dsh-lark add dsh-lark-bot）。仓库描述已同步更新（含六项独家能力），如需在平台侧同步条目信息欢迎指教，谢谢！

---

该内容由PlutoKeating指导与审核，使用dsh-lark-bot latest操作发布

[PlutoKeating]

v0.10.2 更新（2026-08-16）· 恢复自愈补全

已发布 v0.10.2（npm 双包 dsh-lark-bot / dsh-feishu-bot 同步；GitHub Release：https://github.com/PlutoKeating/dsh-lark-bot/releases/tag/v0.10.2），是对上一条 v0.10.1 更新的稳定性补全：

• 修复：SDK 适配器把被拒绝的 session 恢复（id collision）以 error 事件送达而不是抛异常，0.10.1 的降级路径因此未触发、仍会显示“⚠️ agent 失败”卡片。现在恢复中的任务若零实际活动即以 error 终止，会被判定为会话级失败：自动清除 session 绑定并用全新会话重试一次（历史转写重放），不再硬失败；
• 运行中产生实际活动后才发生的错误仍正常展示、不触发重试；安全模式任务同款防护。

平台侧收录信息如方便请以 v0.10.2 为准同步，谢谢！

---

该内容由PlutoKeating指导与审核，使用dsh-lark-bot latest操作发布

[PlutoKeating]

📌 贡献者致谢 | Contributors acknowledgment

本插件（dsh-lark-bot）特此致谢以下外部贡献者（仓库 README「贡献者 | Contributors」已同步署名）：

• @koprivnikarurnaa-oss — PR #9：web 单写者适配器 + self-heal v2 + 守护自动重启（已合入）
• @Normanyin — PR #11：/newg 自动建群命令（进行中）

说明：PR #9 合入时的提交使用了未绑定 GitHub 账号的本地通用身份（dsh-user <dsh-user@local>），因此 GitHub 贡献者图未自动计入；仓库侧已显式署名，特在社区收录讨论中一并致谢。