anweat/dsh-restart

dsh-restart

重启整个 DeepSeek Harness 进程的插件，用于重新加载插件与配置（profile 的 cordis 组合、settings 等）。host + client 双半，装进 profile 的 bundle 后即可用。

截图来自真实 web profile 部署，展示当前 DSH 设置页中的重启配置卡片。

功能

• 模型工具 restart_harness：让 agent 直接安排一次进程重启（可选 delayMs）。
• /restart 斜杠命令：在 UI 里手动触发重启。
• 配置卡片（设置 → 插件 → 插件配置 → 「DSH 重启」）：可视化编辑以下设置，改动即时写入 settings.yaml：
  • legacyRestart — 旧 PowerShell/WMI/taskkill 重启方式（默认关闭，用 Node 原生方式）。
  • continuePrompt — 重启后自动继续时注入给 agent 的提示词。
• 「立即重启」按钮：先读取当前进程身份，安排重启后等待新进程恢复并自动刷新页面。只读 GET 返回 { pid, startedAt }；出于安全考虑，重启 POST 仍仅接受来自环回地址（127.0.0.1 / localhost）的同源请求，经反向代理/远程访问时会被拒绝（403）。

自 0.1.3-alpha.4 起，内置 detached watchdog 已停用并从设置卡片移除。旧 watchdog* 配置仍可被读取但不会执行；进程异常恢复请交给 systemd、Windows 服务或其他拥有完整进程生命周期的外部管理器。插件启动时会保留 $DSH_HOME/dsh-stop.flag，让旧版本遗留的 detached watchdog 自行退出。

兼容与发布通道

开发版不会覆盖 npm latest。0.1.5-alpha.1 依赖按精确版本锁定；该版本已移除 @deepseek-ai/dsh-client-runtime，客户端契约分别迁移到 Cordis、 dsh-client-store 与 dsh-client-ui-settings，不会混装 rc.2 运行时。

0.1.3-alpha.4 变更

• 禁用并移除内置 detached watchdog；旧配置保留为无操作兼容项。
• Windows 重启通过隐藏控制台拉起，保留完整 argv，避免后续 sandbox 命令闪窗。
• 新进程 PID 变化后继续等待带认证的前端首页返回成功，再刷新页面，避免源码部署 重启期间因静态前端尚未挂载而停留在 HTTP 404。
• 防止并发请求重复安排 helper；helper 创建失败时保留旧进程，并记录失败日志。
• 自动继续投递失败时保留恢复标记；Web 路由随 Cordis 生命周期正确释放。

源码部署排错

• 本开发分支只对齐官方标签 dsh-v0.1.5-alpha.1。源码 checkout 先执行 corepack pnpm install --frozen-lockfile 和 corepack pnpm run build，再把本地插件 重新加入隔离 profile；只安装依赖但没有构建 workspace，会表现为缺少 @deepseek-ai/*/lib，并不是 restart 拉起失败。
• 如果页面显示 list slot "settings.plugin.item" requires options.id，说明 Harness 与插件客户端落在不同的开发期 slot 契约。0.1.5-alpha.1 的官方契约是 keyed slot， 本插件必须使用 options.key；不要直接改成 id，应统一 Harness 标签、插件分支 和 profile 锁文件后重装。
• pnpm 首次安装 profile 依赖时可能把原生包写成待决的 allowBuilds 项。逐项确认 true 或 false 后重跑 dsh plugin --profile <name> add ...，不要用全局放行绕过。
• 若旧版本重启后已经停在浏览器 HTTP 错误页，请手工打开新进程日志打印的当前 dsh web: URL 完成一次恢复；升级到本版本后，设置卡片会等待首页真正就绪再刷新。

安装

1. 把包加入 profile 依赖并挂进 bundle：

// profiles/<profile>/package.json
{
  "dependencies": { "dsh-restart": "..." },
  "dsh": { "profile": { "bundles": ["...", "dsh-restart"] } }
}

2. 重启 DSH（/restart 或 restart_harness），刷新页面后即可看到卡片；之后通过卡片重启时会自动等待并恢复页面。

构建

pnpm install
node scripts/link-dsh-workspace.mjs --source <path-to-deepseek-harness>
pnpm run build

host 半由 tsc 输出到 lib/index.js（@deepseek-ai/* 保持外部依赖）；client 半由 tsdown 打成单文件 lib/client.js。