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
[!IMPORTANT]
启动顺序决定是否需要重启。 DSH 的插件 bundle 组合发生在进程启动时(Loader 读取
profile 的package.json生成插件树和 client 模块图),安装命令只改磁盘上的 profile 文件,
不会热插进已在运行的进程:
- 先安装 → 再启动:启动时插件已在列表里,直接生效,无需重启;
- 先启动 → 再安装:装完后必须完全退出并重新启动
dsh(⌘Q 退出桌面应用或终止
Web UI 进程,不是刷新页面),让进程重新组合 profile。安装后可用
dsh --profile <name> --dump-config | grep handoff确认插件已进入 bundle 层。
架构
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