lovstudio/dsh-better-restart

dsh-better-restart

Lovstudio 为 DeepSeek Harness Web 界面提供的原地应用重启插件。设置页头部新增一个 重启应用 操作，可原地重启整个应用（重新加载当前标签页，而非打开新标签页），并带有一个实时监视运行中对话的确认对话框。

这是一个 Lovstudio 插件，并非 DeepSeek-AI 官方包，以 @lovstudio 作用域分发。

功能说明

- 宿主端 暴露两个 webServer 路由：
- POST /better-restart/status — { running, active }（有多少个 agent 循环正处于回合中）。
- POST /better-restart — 重启应用，优先使用启动器的 appRestart 服务，回退到根 include 重组。
- 客户端（设置页头部按钮）：
- 确认对话框实时轮询 agent 活动（1.5 秒）。若有对话正在运行，会报告数量，并将重启限制在显式确认之后；若无运行中的对话，则直接放行重启。
- 重启期间显示进行中 spinner + 禁用按钮；当前标签页在重连后重新加载。
- 一个 betterRestartUi Cordis 服务，向其他浏览器插件暴露相同的 status() 和 restart() 操作。

该插件完全运行时化且自包含：仅通过注入的 Cordis ctx（webServer、agents、appRestart）访问 DSH 能力，客户端页面通过普通 fetch 请求这些路由访问宿主——无需 Remote 组装，无需构建期转换。除 node 内置模块外，没有任何包依赖。

安装

前置条件：Node.js 22.19+ 或 24+，pnpm 11（corepack enable 或 npm i -g pnpm）——dsh plugin 会在 profile 目录内转发给 pnpm。

从 DeepSeek Harness 源码检出安装（推荐——你同时获得 harness 源码）：

git clone --depth 1 --branch dsh-v0.1.2-rc.1 https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && pnpm install && pnpm run build
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-better-restart#v0.1.4
pnpm dsh web

无检出安装（npx；仅编译后的 harness）：

npx @deepseek-ai/dsh plugin --profile web add -w github:lovstudio/dsh-better-restart#v0.1.4
npx @deepseek-ai/dsh web

重启是如何发生的

两种机制，按优先级排列：

1. appRestart —— 由启动器提供的服务，用于重启进程。dsh 0.1.2-rc.1 未提供该服务；这是未来或嵌入式启动器所走的路径，该路由返回 204。
2. 根包含重组合 — 使按钮在纯 dsh web 下工作的回退方案。加载器的根 cordis:include 条目被禁用后再重新启用，这会重新读取组合后的 cordis.yml 以及用户补丁层，并重启其下的每个插件，包括 web 服务器。Node 进程本身会存活，因此启动 dsh web 的终端仍然拥有它。该路由返回 202 {"mode":"recompose"}，然后才拆除插件树——响应会一直保持到其套接字关闭，因为与刷新竞争的重组合会以传输失败而非已接受的重新启动的形式到达浏览器。

两个杠杆都不具备的应用会以该原因返回 503，设置操作会显示可复制的失败信息，而不是假装重新启动，任何驱动此服务的插件——例如插件市场——都会看到相同的拒绝。

由于进程被复用，重组合会重新读取配置并加载新安装的插件，但 Node 的 ESM 缓存意味着已加载模块的已编辑源代码只能通过配置文件自身的 HMR 监视器被拾取。

web 是 dsh web 启动的配置文件。该标签固定了一个提交，其 lib/ 已预构建并提交，因此你的机器上不会编译任何内容。已于 2026-09-05 针对 dsh-v0.1.2-rc.1 以两种形式验证，包括在浏览器中端到端验证重组合回退。使用 dsh plugin --profile web remove @lovstudio/dsh-better-restart 移除。

客户端部分（dsh.client）在插件被组合后，由客户端模块系统自动提供给页面——无需重新构建 web 应用程序。

使用

1. 启动 web UI：dsh web。
2. 打开设置标题 → Restart app。
3. 确认；应用会就地重新启动，当前标签页会重新加载。

本地开发

将此检出保留在 DeepSeek Harness 仓库之外。在此处安装并构建它，然后将该包链接到一个隔离的开发配置文件中：

pnpm install
pnpm run watch

DSH_HOME=/Users/mark/.dsh-lov-dev pnpm --dir /path/to/deepseek-harness dsh plugin --profile web add -w link:/path/to/dsh-better-restart

Host 消费生成的 index.js，而浏览器模块系统消费 lib/client.js。仅客户端的重新构建由 Harness Client HMR 监视器检测；Host、manifest、patch 和 bundle 成员关系的更改需要重启配置文件。包构建不会导入 Harness tsconfig 或工作区源路径。

说明

- 需要 webServer 和 agents（两者均来自 @deepseek-ai/dsh-base）；appRestart 和 loader 各自都是可选的，当两者都不存在时，该路由会报告。
- 文案位于 @lovstudio/dsh-better-restart（zh/en）下，自动注册到 better-restart-ui 语言环境命名空间。

许可证

MIT