dsh-handoff-button

DeepSeek Harness 插件：在每条 AI 回复的底部操作行添加一个 Handoff 按钮， 点击后把当前会话压缩成 handoff 文档，写入该会话工作区的 handoff/ 目录。

功能

• 按钮：每条已完成的 AI 回复操作组最右侧（复制/反馈按钮之后）的圆形图标按钮 （Magnific "Write" 图标，独立文件 assets/write.png，由 Host 路由同源提供，无外部网络依赖）， 悬停有 Tooltip 提示。想换图标：直接替换 assets/write.png 后重启即可
• 生成：点击后调用 LLM（当前默认模型）按原版 handoff skill 要求 生成总结式文档：Status / Goal / Progress / Next Steps / Suggested Skills 五段结构， Progress 为紧凑总结而非对话实录；LLM 不可用时自动降级为启发式摘要
• 状态反馈：生成中变暗 → 完成显示绿色 ✓（2 秒自动复原）→ 失败显示红色 ⚠（悬停可见原因）
• 打开文件：完成状态（✓ 期间）再次点击，在新标签页打开生成的文档
• 文件名：handoff-{yyyymmddhhmmss}-{会话标题}.md（非法字符替换为 -，最长 60 字符）， handoff/ 目录不存在时自动创建
• 脱敏：API key、token、密码等常见敏感信息在写入前自动打码
• References：自动收集会话中实际触碰过的文件路径；Suggested Skills 列出会话中实际调用过的技能

安装

发布到 npm 后（或本地包目录）：

dsh plugin --profile <name> add dsh-handoff-button

本地开发版：

dsh plugin --profile <name> add /绝对路径/dsh-handoff-button

然后重启 dsh（Web UI 或桌面应用）使组合生效。

架构

• index.js — Host 半部：注册三个路由（webServer 服务）： POST /handoff/write（生成文档）、GET /handoff/read（打开文档）、 GET /handoff/icon（提供 assets/write.png 图标）。读取会话日志 （sessionQuery）并写文件（fs，自动建目录），调用 LLM 总结（llm + agentDefaultModel）。仅依赖 Node 内置模块（node:fs/node:url/node:path）， 无第三方运行时依赖。
• client.js — 浏览器半部：通过 client module loader （window.__ModuleLoader__.load）注册，向 conversation.chat.assistant-actions 槽注入按钮（order: 100，最右侧插槽条目），点击后同源 fetch 调用 Host 路由； 图标通过 CSS mask 引用 /handoff/icon，颜色跟随主题。
• assets/write.png — 按钮图标（Magnific/Freepik "Write" 图标），可自由替换。
• cordis.patch.yml — Bundle 补丁层：把本包作为插件行插入组合。

卸载

dsh plugin --profile <name> remove dsh-handoff-button

验证

• 组合加载：dsh --profile <name> --dump-config | grep -A2 handoff
• 浏览器检查：http://127.0.0.1:3080/plugins/dsh-handoff-button/client.js 应返回脚本

许可

MIT