DSH Restart Plugin

🌏 简体中文 · English

一键重启 DeepSeek Harness Web（127.0.0.1:3080）：侧边栏一个按钮，10 秒倒计时，自动完成「杀旧进程 → 拉起新实例 → 自检 → 原页面刷新」。从"打开终端、记步骤、赌运气"变成"点一下、等 10 秒、看结果"。

• 全程无弹窗 — wscript 静默启动，桌面不出现任何 PowerShell 命令行窗口
• 无终端操作 — 无需开终端 / 任务管理器找 PID / 手敲命令
• 不开新标签页 — 重启拉起不触发浏览器新页，由原标签页自动刷新收尾

痛点：没有这个按钮时，重启一次有多麻烦

DSH Web 是常驻宿主进程，改插件、改配置、装新 bundle 后都必须重启才生效——而"重启得好"常常也是一切疑难杂症的答案。但每一次重启，都要走一串手工步骤：

1. 打开终端或任务管理器，从 3080 端口反查宿主 PID；
2. 手动 Stop-Process 杀掉它（PID 每次不同，杀错有风险）；
3. 找到启动脚本、重新拉起服务；
4. 干等几秒，轮询端口确认监听成功；
5. 验证插件路由真的加载了（如 /_dsh/dsh-restart/state），才算重启"成功"；
6. 浏览器里手动刷新页面，甚至被迫接受一个新开的标签页。

全程 5~8 步、牵扯多个窗口，过程中零反馈——不知道进行到哪一步、也不知道失败没有。步骤越多越容易出错，而每次出错都要从头再来。

解决方案：一键完成全部

这个插件把整条链路收敛成一个侧边栏按钮：

• 双态按钮：展开态在「设置」右侧显示 [↻ 重启]；收起态在设置齿轮正上方显示圆形 ↻ 图标，随侧边栏实时同步、动画跟手；
• 点击即走：触发 10 秒倒计时，页面文字整体变浅灰作为进行中反馈（按钮自身保持醒目原色）；
• 全自动执行：计划任务静默杀旧进程 → 拉起新实例 → 自检（3080 监听 + GET /_dsh/dsh-restart/state + GET /）；
• 原页面收尾：自检成功后原标签页自动刷新，右上角弹出绿色「✅ 重启成功」提示；失败则按钮变红，可一键重试；
• 模型也能触发：对话里说「重启」即可（dsh_restart 工具），适合当前回合需要收尾的场景。

✨ 特性

• 双态侧边栏按钮（展开文字 / 收起图标），React 重渲染不掉、收起展开跟手不偏移
• 10 秒倒计时 + 页面文字浅灰 + 按钮状态机（重启中 / 失败重试）
• 静默启动：无弹窗、无终端、不开新标签页，原页面自动刷新
• 自检驱动：端口 + 插件路由双重验证，成功才提示，失败可重试
• 对话触发：dsh_restart 工具（模型侧）

🚀 安装

本插件由两部分组成，缺一不可：

1. 插件包（本仓库）——client 侧边栏按钮 + host /_dsh/dsh-restart/state|trigger 路由与 dsh_restart 工具；
2. 重启脚本链——真正的"杀进程 → 拉起 → 自检"落在 3 个本地脚本（.ps1 / .vbs / .bat）+ 1 个计划任务上，不在 npm 包里，由仓库 docs/setup/ 提供可复刻模板。

> 路径约定：README 中的 InstallDir（脚本部署目录）与命令示例均为通用写法，请按你的本机目录替换；dsh plugin --profile web 相关命令作用于 DSH web profile（~/.dsh/profiles/web）。

前置条件

第 1 步：注册插件包

# 方式 A：克隆到本地，用 link: 协议注册（推荐，便于后续改代码/host 常量）
git clone https://github.com/lnyuqian/dsh-restart-plugin.git
dsh plugin --profile web add link:.\dsh-restart-plugin

# 方式 B：不 clone，直接从 GitHub 安装
dsh plugin --profile web add git+https://github.com/lnyuqian/dsh-restart-plugin.git

dsh plugin --profile web <子命令> 等价于在 ~/.dsh/profiles/web（DSH web profile）里执行 pnpm <子命令>；add link:<目录> 用 pnpm 的 link: 协议把本地目录注册为该 profile 的依赖。注册完成后：

1. 停掉正在运行的 dsh web；
2. 重新 dsh web 启动；
3. 浏览器打开 http://127.0.0.1:3080，按 Ctrl+Shift+R 硬刷新。

此时应能看到：侧边栏出现重启按钮、http://127.0.0.1:3080/_dsh/dsh-restart/state 返回 {"ok":true,...}、对话工具列表出现 dsh_restart。但此时点按钮/调工具会失败——计划任务还不存在，继续第 2 步。

> 若按钮未出现（client bundle 未重建）：在 DSH 源码树跑 pnpm run dev:web（或对应构建命令）重建 web artifacts 后重启。

第 2 步：部署重启脚本链（一键）

cd dsh-restart-plugin
powershell -ExecutionPolicy Bypass -File docs\setup\install.ps1 `
-InstallDir "$env:USERPROFILE\.dsh-restart" -Seconds 10

install.ps1 自动完成三件事：

1. 把 docs/setup/ 的 3 个模板复制到 -InstallDir，并把所有占位符替换成你的实际路径——.ps1 保存为 UTF-8 带 BOM（PowerShell 5.1 也能正确读取），.vbs / .bat 保存为 GBK（中文路径下 cmd/wscript 按系统 ANSI 解析正确）；
2. 注册计划任务（默认名 dsh-web-restart-20s，Action 为 wscript.exe "…\restart-dsh-web-silent.vbs"，wscript 静默启动保证桌面无窗口）；
3. 把 lib/index.js 顶部的 LIVE / STATUS / TASK / SECONDS / cwd（以及 dsh_restart 工具描述里的路径文案）自动 patch 成你的路径，原文件备份为 lib/index.js.bak。

常用参数：-InstallDir（脚本存放目录）、-Seconds（倒计时秒数，默认 10）、-TaskName（计划任务名）、-SkipIndexJsPatch（跳过改 index.js）、-PluginDir（仓库根目录，默认自动探测）。

第 2 步（备选）：手工部署

（1）复制模板并替换占位符：把 docs/setup/ 下 3 个文件复制到你的目录，用文本编辑器全局替换：

保存时注意编码：.ps1 用 UTF-8 带 BOM，.vbs / .bat 用 GBK（系统 ANSI）。

（2）注册计划任务：

schtasks /Create /F /TN "dsh-web-restart-20s" /TR "wscript.exe \"C:\path\to\restart-dsh-web-silent.vbs\"" /SC ONCE /ST 00:00

（3）改 lib/index.js 路径常量（JS 字符串里 \ 要写成 \\）：

第 3 步：验证

# host 路由已挂载
Invoke-RestMethod http://127.0.0.1:3080/_dsh/dsh-restart/state

# 手动触发一次完整重启（与点按钮等价）
schtasks /Run /TN "dsh-web-restart-20s"
# 等倒计时结束后查看自检结果
Get-Content "$env:USERPROFILE\.dsh-restart\dsh-web-restart-status.txt" | Select-Object -Last 12
# 期望最后一行：self-check verdict: SUCCESS

浏览器侧边栏点「重启」→ 页面文字浅灰 10 秒 → 原标签页自动刷新 → 右上角「✅ 重启成功」toast；失败则按钮变红可点重试。

> 自检探针：模板默认探测 GET /_dsh/dsh-restart/state（本插件自己的路由，宿主在则恒存在），GET / 的 401/403（登录鉴权）视为服务在应答、不算失败；完全连不上（无 HTTP 状态码）才判失败。

卸载

dsh plugin --profile web remove dsh-restart-plugin
schtasks /Delete /TN "dsh-web-restart-20s" /F
# 删除 -InstallDir 部署目录；重启 dsh web + 硬刷新

安装常见问题

🔁 工作原理

flowchart LR
U[用户点侧边栏「重启」或对模型说「重启」] --> T[dsh_restart 工具POST /_dsh/dsh-restart/trigger]
T --> S[schtasks /Run 触发计划任务]
S --> W[wscript 静默启动 PowerShell]
W --> C{10 秒倒计时页面文字浅灰}
C --> K[杀掉 3080 旧宿主进程]
K --> B[--no-open 拉起新 dsh web]
B --> P[自检：3080 监听GET /_dsh/dsh-restart/state + GET /]
P --> R{success?}
R -- 成功 --> X[原标签页自动刷新右上角「✅ 重启成功」]
R -- 失败 --> F[按钮变红「重启失败·重试」]

1. 用户要求重启（点按钮，或对模型说「重启 DSH」触发 dsh_restart 工具）。
2. 触发计划任务 dsh-web-restart-20s（wscript 静默启动，无 PowerShell 窗口）。
3. 页面字体整体变浅灰、重启按钮保持原色显示「重启中…」并旋转图标；模型立即用一句话通知用户并结束回合。
4. 倒计时结束后，脚本自动执行：杀掉 127.0.0.1:3080 的旧宿主 → 以 --no-open 拉起新实例（不新开浏览器标签页）→ 自检（3080 端口监听 + GET /_dsh/dsh-restart/state + GET /）。
5. 原页面轮询到 done+success 后自动刷新，并在右上角弹出「重启成功」toast（约 4 秒自动消失）；失败则重启按钮变红「重启失败·重试」。
6. 重启后若用户询问结果，可读取状态文件汇报（默认 InstallDir\dsh-web-restart-status.txt）。

🧩 组成

🛠️ 开发与构建

• 目录：lib/index.js（host：路由 + dsh_restart 工具）、lib/client.js（client：侧边栏按钮与倒计时 UI，零依赖 DOM 实现）。
• host 改动（路由/工具/路径常量）：改完重启 dsh web 生效。
• client 改动：改完按 DSH 插件通道生效——client bundle 经 profile 依赖挂载；DSH 源码树开着 pnpm run dev:web 时热更新自动生效，否则按第 1 步的重建/重启流程。
• 无需独立构建：插件包没有自己的 build 步骤，client 依赖注入 dsh.client 与 bundle patch（cordis.patch.yml）随 profile 组合生效。
• 测试：暂无自动化测试，改动后按上文「验证」逐项自测：/_dsh/dsh-restart/state 路由、侧边栏按钮、dsh_restart 工具、完整重启链路。

🔐 安全

• host 路由带信任围栏：仅接受 loopback 来源（127.0.0.1 / ::1）且 Host 为 127.* / localhost / [::1]，POST /trigger 还要求同源 Origin；非本机来源或跨站请求一律 403。
• 触发链路走系统计划任务（schtasks /Run），任务名与参数固定、无 shell 拼接，不存在命令注入面。
• client 仅注入 web 平台，且只在本机 http://127.0.0.1:3080 页面上下文运行。

🖥️ 平台支持

📋 更新日志

• v0.2.0（2026-09）— 适配 DSH 0.2.x
• peerDependencies 改为 @deepseek-ai/dsh-tools / @deepseek-ai/dsh-host-webserver 的 ^0.2.0-rc.2，移除 0.2.x 已不存在的 @deepseek-ai/dsh-client-runtime；不再需要 dsh plugin allow-version 精确版本豁免。
• 修 subprocess.spawn 非法 stdio：0.2.x 的 SubprocessOutputMode 只接受 'pipe' | 'inherit' | { maxBytes, ... }，旧值 stdout/stderr: 'ignore' 不合法（'ignore' 仅适用于 stdin），改用 'inherit'。
• 修安全缺陷：isLoopbackRemoteAddress 原先只要 4 段数字就判定为 loopback，等于接受任意 IPv4——以 --host 0.0.0.0 绑定时局域网内任何人都能触发重启（同源检查挡不住，Origin 由调用方控制）。现只认 127.0.0.0/8、::1 与 ::ffff:127.x。
• 工具定义补 isConcurrencySafe: () => false（重启会拆掉本宿主进程，不得进入并行工具组）；execute(args, exec) 转发 exec.signal；spawn 的同步抛错与 handle.done 的拒绝统一转成失败值，不再向调度层抛异常。
• 新增 selftest.mjs：30 项离线契约测试（假 ctx 驱动 apply()，覆盖路由围栏、ToolDefinition 形状、spawn spec 合法性、失败路径），无需启动宿主，node selftest.mjs 即可跑。

• 说明：本插件不 import '@deepseek-ai/dsh-tools'——profile 插件的 node_modules 里没有该包（ERR_MODULE_NOT_FOUND），defineTool 在宿主侧不可用；它是类型糖而非契约，契约是 ToolDefinition（output.schema 为裸 JSON Schema），本实现直接按契约书写。

• v0.1.0（2026-08）

• 初始发布：侧边栏双态重启按钮 + 10 秒倒计时 + 页面文字浅灰反馈 + 原页面自动刷新与「重启成功」toast；dsh_restart 工具；host 路由 /_dsh/dsh-restart/state|trigger。
• 安装文档：README「安装」章节 + docs/setup/ 可部署模板与 install.ps1 一键部署（自动注册计划任务、patch lib/index.js 常量）。
• 文档通用化：组件表与命令示例去除作者本机路径。

使用

• 页面按钮：展开态点设置按钮右侧「重启」；收起态点设置图标上方的 ↻ 图标。
• 对话触发：对模型说「重启」即可（dsh_restart 工具）。
• 手动触发：schtasks /Run /TN "dsh-web-restart-20s"。
• 改倒计时：编辑部署目录 restart-dsh-web-silent.vbs 里的 -Seconds 10，并同步本仓库 lib/index.js 的 SECONDS 常量与描述文案。若用 schtasks /Change /TR 覆盖 Action，请保持 wscript.exe "…\restart-dsh-web-silent.vbs"，不要写回 powershell.exe（会恢复弹窗）。

注意事项

• 倒计时期间模型回合必须已结束（SOP 已固化：工具返回后立即一句短回复收尾）。
• 重启会短暂断开当前 Web 会话；原页面自动重连刷新，不新开标签页。
• 重启成功提示经 sessionStorage 跨刷新接力，仅原标签页显示、消费后即清除。
• 持久插件在重启后生效；若 client bundle 构建失败，按钮/提示缺失但 dsh_restart 工具与自检日志仍可用。

🔗 生态

• awesome-dsh-plugin：DSH 插件精选列表
• dshfind 插件超市：三方插件市场（GitHub topic dsh-plugin 下公开仓库清单）

License

MIT