dsh-handoff-button
DeepSeek Harness 的交接按钮：为每条助手消息添加一个按钮，将整个会话的交接文档写入工作区的 /handoff 目录。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-handoff-button@0.1.4Handoff Button 以 dsh-handoff-button 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 插件：在每条 AI 回复的底部操作行添加一个 Handoff 按钮，
点击后把当前会话压缩成 handoff 文档，写入该会话工作区的 handoff/ 目录。
assets/write.png，由 Host 路由同源提供，无外部网络依赖），
悬停有 Tooltip 提示。想换图标：直接替换 assets/write.png 后重启即可Status / Goal / Progress / Next Steps / Suggested Skills 五段结构，
让一个全新 agent 能接手整段工作（不是只压缩最近几轮）。Goal 取自第一轮目标与之后的明确改口；
Progress 为紧凑总结而非对话实录；中段助手长文默认视为已落入 References 中的工件（specs / plans / ADRs），
用路径引用、不复述。LLM 不可用时自动降级为启发式摘要（同样保留第一轮目标）。
Alt+点击可填写「下一会话关注点」（对应 skill 的参数），Next Steps 会偏向该焦点，但不替换原始 GoalopenWorkspacePath 在软件内打开（安装了 better-sidebar 时进侧边栏编辑器；否则走系统默认应用）。不再打开浏览器原始 URL。handoff-{yyyymmddhhmmss}-{会话标题}.md（非法字符替换为 -，最长 60 字符），
handoff/ 目录不存在时自动创建handoff/，以便 openWorkspacePath 在软件内打开、跨会话复用file access denied under workspace-write mode；若会话 approval 为 never（无法升级沙箱），仍会写入 handoff/发布到 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）。写入把沙箱围栏钉在该会话的工作区根目录上
（用户点击，不是模型工具）；若沙箱仍拒绝（例如 approval 为 never
无法升级），则回退为 Node 直接写入同一路径。仅依赖 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 handoffhttp://127.0.0.1:3080/plugins/dsh-handoff-button/client.js 应返回脚本npm testDeepSeek Harness plugin: adds a Handoff button to the action row of every
assistant message. Clicking it compresses the current conversation into a
handoff document and writes it to the handoff/ directory of that session's
workspace.
assets/write.png) is served same-origin by a host
route — no external network dependency. To change the icon, replace
assets/write.png and restart.Status / Goal / Progress / Next Steps / Suggested Skills, so a fresh
agent can continue the whole job — not just the latest turns. Goal is
taken from the opening objective (and later explicit restatements);
Progress is a compact summary rather than a raw transcript; middle
assistant turns are treated as already captured in referenced artifacts
(specs / plans / ADRs) and are cited by path instead of quoted. Falls
back to a heuristic digest (still keeping the original goal) when the
LLM is unavailable. Alt+click sets a "next session focus" (the
skill's argument): Next Steps bias toward that focus without replacing
the original Goal.openWorkspacePath (sidebar editor
when better-sidebar is installed; otherwise the OS default app). It
no longer opens a raw browser URL.handoff-{yyyymmddhhmmss}-{session title}.md (illegal
characters replaced with -, max 60 chars); handoff/ is created
automatically if missing.handoff/
and can be reopened in-app via openWorkspacePath.Once published to npm (or from a local package directory):
dsh plugin --profile <name> add dsh-handoff-button
Local development checkout:
dsh plugin --profile <name> add /absolute/path/dsh-handoff-button
[!IMPORTANT] Startup order decides whether a restart is needed. DSH composes the plugin bundle at process startup; the install command only rewrites profile files on disk and does not hot-plug a running process:
- Install → start: the plugin is already in the list at startup, no restart needed.
- Start → install: you must fully quit and restart
dsh(⌘Q the desktop app or kill the Web UI process — a page refresh is not enough).After installing,
dsh --profile <name> --dump-config | grep handoffconfirms the plugin is in the bundle layer.
index.js — host half: registers three routes (webServer service):
POST /handoff/write (generates the document), GET /handoff/read (opens
it), GET /handoff/icon (serves assets/write.png). Reads the session
log (sessionQuery), writes files (fs, creating directories as needed),
and calls the LLM (llm + agentDefaultModel). The write pins the
sandbox fence to that session's workspace root (the user clicked;
this is not a model tool call). If the sandbox still refuses (for
example when approval is never and escalation is impossible), it
falls back to a direct Node write of the same path. Node builtins only
— no third-party runtime dependencies.client.js — browser half: registered via the client module loader
(window.__ModuleLoader__.load), injects the button into the
conversation.chat.assistant-actions slot (order: 100, rightmost), and
calls the host routes with same-origin fetch. The icon is applied via a
CSS mask referencing /handoff/icon, so it follows the theme color.assets/write.png — the button icon (Magnific/Freepik "Write"), freely
replaceable.cordis.patch.yml — bundle patch layer: inserts this package as a plugin
row in the composition.dsh plugin --profile <name> remove dsh-handoff-button
dsh --profile <name> --dump-config | grep -A2 handoffhttp://127.0.0.1:3080/plugins/dsh-handoff-button/client.js
should return the scriptnpm testMIT
file access denied under workspace-write modeneverhandoff/