dsh-setting-reset
English · 简体中文
给 DeepSeek Harness 加一个通用「重启」按钮:设置页一个分区 + 侧栏底部一个入口,桌面应用和 dsh web 命令行宿主都能用,不需要修改应用本体。
这个插件是从一份修改 app.asar 的重启补丁里抽出来的独立版本:补丁会随应用更新失效,插件不会。
功能
- 侧栏底部「重启」:一键重启,第一次点击进入确认态(6 秒内再点一次才执行,超时自动取消)。
- 设置 → 重启:展示宿主运行环境、DSH 版本、插件版本、Node 版本、PID、运行时长、工作目录,并提供重启 / 刷新页面 / 刷新状态。
- 自动选择重启方式,并如实告诉你当前环境能不能重启:
- 桌面应用暴露了
window.dshDesktop.restart→ 调用桌面桥,应用整体重启; dsh web之类的命令行宿主 → 宿主进程自我重启(respawn);- 都不支持 → 弹出一段明确的替代操作,绝不假装已经重启。
- 桌面应用暴露了
- 中英双语,跟随浏览器语言自动切换。
平台支持
| 运行方式 | 重启方式 | 说明 |
|---|---|---|
桌面应用(preload 暴露 dshDesktop.restart) |
调用桌面桥,应用整体重启 | 需要打过重启补丁,或未来版本自带该接口 |
| 桌面应用(没有重启接口) | 不支持自动重启 | 弹出指引:用应用菜单的「重启应用与 Host」,或只刷新页面 |
dsh web / CLI 宿主 |
宿主自我重启(respawn) | 由 restart-helper.cjs 等旧进程退出、端口释放后再拉起新进程 |
| 其它嵌入场景 | 不支持 | 显示手动重启步骤 |
安装
方式 A:从 GitHub 安装(推荐)
在 profile 目录里安装:
cd ~/.dsh/profiles/desktop
pnpm add github:lololsiyuan/dsh-setting-reset
然后在 设置 → 插件 里启用 dsh-setting-reset;或者手动编辑该 profile 的 package.json,把 "dsh-setting-reset" 加进 dsh.profile.bundles 数组。
首次启用需要重启一次 DSH(宿主端路由要重新加载),之后就可以直接用插件里的按钮重启。
方式 B:本地开发目录
cd ~/.dsh/profiles/desktop
pnpm add link:H:/path/to/dsh-setting-reset
注意:DSH 的客户端模块扫描要求插件是 真实目录,
link:装出来的是软链接,可能出现「宿主路由能用、侧栏和设置里看不到入口」。遇到这种情况请把插件目录复制到node_modules/dsh-setting-reset(真实目录)后再启用。
使用
- 侧栏底部点「重启」,按钮变成「确认重启?」,6 秒内再点一次即执行;点击别处或等待超时会自动取消。
- 设置 → 重启里可以看到宿主状态,并用同样的两步确认执行重启。
- 重启后:
- 桌面应用:窗口会重新打开(由 Electron 自己 relaunch);
- CLI 宿主:页面每 0.8 秒探测一次
/dsh-setting-reset/api/status,等新 PID 出现后自动刷新页面。
工作原理
宿主端注册两条 HTTP 路由(挂载在 DSH 的 webServer 服务上):
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/dsh-setting-reset/api/status |
返回插件版本、宿主环境、PID、运行时长、工作目录等 |
POST |
/dsh-setting-reset/api/restart |
触发重启(仅限可自重启的 CLI 宿主) |
CLI 宿主的重启流程:
页面 POST /api/restart
→ 宿主 spawn 一个游离的 restart-helper.cjs(detached,stdio 忽略)
→ 宿主立即返回 200,约 700ms 后 process.exit(0)
→ helper 轮询父进程是否退出(120ms 一次,最多 30 秒)
→ 父进程退出后再等 500ms,让监听端口释放
→ helper 用相同的 execPath / argv / cwd 拉起新宿主,然后自己退出
→ 页面探测到新 PID,location.reload()
之所以要单独一个 helper 进程:新宿主如果在旧宿主还占着端口时启动,会直接 EADDRINUSE 起不来。
安全约束
- 只接受来自
127.0.0.1/::1/::ffff:127.0.0.1的回环请求; - 必须带
x-dsh-setting-reset: 1请求头 —— 跨站请求无法携带自定义头(会先被 CORS 预检拦下); - 只接受
POST; - 重启进行中重复请求返回
409 ALREADY_RESTARTING; - 桌面宿主即使收到请求也只返回
409 DESKTOP_APP,不会尝试自杀式重启。
配置
cordis.patch.yml 里只有一个开关:
config:
allowRespawn: true
设为 false 时关闭 CLI 宿主的自我重启,只保留桌面桥和页面刷新。
和 app.asar 补丁的关系
之前那份补丁是直接改应用包里的 main.js / preload.js / client.js,在账号菜单里塞了一个「重启」项,应用一更新就得重新打。
本插件不改应用本体,装进 profile 就能用,应用更新后依然在。两者可以共存:插件检测到 window.dshDesktop.restart 时直接走桌面桥,没有时再退回到 CLI 自重启或手动指引。
兼容性
- DeepSeek Harness:
>=0.1.2 <0.3.0 - Node.js:
>=20(插件自身零运行时依赖) - 已在 Windows 11 + DSH 桌面版环境验证宿主自重启链路(旧 PID → 新 PID,端口复用正常)
开发
node --test
目录结构:
index.js 宿主端:路由注册、环境探测、重启调度
client.js 浏览器端:设置分区、侧栏按钮、重启状态机
restart-helper.cjs 游离子进程:等旧宿主退出后拉起新宿主
cordis.patch.yml Cordis 补丁(注册插件与默认配置)
test/ node:test 单元测试(无外部依赖)
已知限制
- 桌面宿主进程无法自我重启:它只是 Electron 的子进程,必须由渲染进程调用
app.relaunch();插件在这种情况下只做引导,不伪造结果。 - CLI 自重启会以相同 argv / cwd 启动新进程:如果原来的 DSH 是用 pm2、nssm 之类的守护进程托管的,请把
allowRespawn设为false,否则可能出现双实例。 - 重启会立即结束宿主进程:正在运行的对话任务会被中断,请在确认前保存重要内容。
- 重启日志写在
$DSH_HOME/dsh-setting-reset/restart.log,排查失败时先看这里。
No comments yet. Be the first to write one.