@zapmomo-ai/dsh-plugin

dsh（DeepSeek Harness）→ ZapMomo 桌宠的任务事件桥。

面向用户的使用说明见文档站：deepseek-harness 集成（dsh 桥）；本篇是面向开发的实现与发布细节。

监听 dsh 的 agent/status 与 session/event（turn/end），把任务开始 / 完成 / 失败 / 中断翻译成语义化事件，POST 到 ZapMomo 的 loopback 桥（POST /dsh/events）。ZapMomo 桌宠据此以文字气泡 + 语音播报给用户反馈。

前置条件

• 已运行 ZapMomo（Tauri 应用，[dsh] 段默认启用）：ZapMomo 启动时在 ~/.zapmomo/runtime/dsh-bridge.json 写桥端口与 Bearer token（权限 0600）
• 已安装 deepseek-harness（dsh CLI）

插件只在读到发现文件时才推送；ZapMomo 未运行时静默跳过（不报错、不影响 dsh）。

安装

# 从 npm（推荐）
dsh plugin --profile web add @zapmomo-ai/dsh-plugin

# 从源码（开发/调试，link 模式改动即时生效；<zapmomo> 换成你的仓库路径）
dsh plugin --profile web add link:<zapmomo>/integrations/dsh-plugin

装完因声明了 dsh.bundle.patch，插件自动进入 profile bundles，无需手动改 patch。重启 dsh web 生效。

行为

| dsh 事件 | 推送类型 | 备注 | | --- | --- | --- | | agent/status → running | task-started | title 取自会话最近一条 user/message（前 40 字符） | | turn/end → reason.kind = completed | task-finished | | | turn/end → reason.kind = error | task-failed | detail = reason.error.message — code（截 200） | | turn/end → 其它（aborted/interrupted/max-tokens/blocked） | task-interrupted | |

推送纪律：每次发送前现读发现文件；POST 超时 1s、异常吞掉只打 debug——绝不阻塞/影响 dsh 宿主。

开发

# 本地调试用 link 模式安装（改动即时生效）
dsh plugin --profile web add link:<zapmomo>/integrations/dsh-plugin

字段路径按 dsh 源码核对（session.id / agent.status / reason.error），如有 dsh 版本升级导致漂移，以 src/index.ts 顶部「待实测核对」注释为准回读对齐。

发布

发布走 npm Trusted Publishing（OIDC），由 .github/workflows/npm-publish.yml 自动完成，不需要 NPM_TOKEN / OTP。

npm 侧前置（一次性）

在 npmjs.com 为 @zapmomo-ai/dsh-plugin 配置 Trusted Publisher，必须匹配：

| 字段 | 值 | | --- | --- | | Repository | shenjingnan/zapmomo | | Workflow filename | npm-publish.yml | | Environment | 留空 |

发新版本（tag 触发自动发布）

# 1. 递增版本
cd integrations/dsh-plugin && vim package.json    # version: 0.1.0 → 0.2.0

# 2. 提交 + 打 tag + 推送（workflow 收到 dsh-plugin-v* tag 即自动发布）
git add integrations/dsh-plugin/package.json
git commit -m "chore(dsh): bump version to 0.2.0"
git tag dsh-plugin-v0.2.0
git push origin dsh-plugin-v0.2.0

注意：tag 名必须 dsh-plugin-v<版本>（workflow 只匹配该前缀）。若 package.json 版本未变，npm publish 会被 npm 以 E403 already published 拒绝——正常保护，改对版本再推。

手动发布（临时/紧急）

GitHub → Actions → npm Publish (dsh-plugin) → Run workflow（不 push 任何东西）。

安全建议

Trusted Publisher 生效后，可在 npm 包设置里把发布方式设为 「Require 2FA and disallow tokens」——彻底禁掉 token 发布，只走 OIDC。