DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

lololsiyuan /

lololsiyuan/dsh-setting-reset

Verified

Portable restart button for DeepSeek Harness: Settings section + sidebar entry, works with the desktop app and CLI hosts.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@56eef2de

dsh-setting-reset

English · 简体中文

给 DeepSeek Harness 加一个通用「重启」按钮:设置页一个分区 + 侧栏底部一个入口,桌面应用和 dsh web 命令行宿主都能用,不需要修改应用本体。

这个插件是从一份修改 app.asar 的重启补丁里抽出来的独立版本:补丁会随应用更新失效,插件不会。


功能

  • 侧栏底部「重启」:一键重启,第一次点击进入确认态(6 秒内再点一次才执行,超时自动取消)。
  • 设置 → 重启:展示宿主运行环境、DSH 版本、插件版本、Node 版本、PID、运行时长、工作目录,并提供重启 / 刷新页面 / 刷新状态。
  • 自动选择重启方式,并如实告诉你当前环境能不能重启:
    1. 桌面应用暴露了 window.dshDesktop.restart → 调用桌面桥,应用整体重启;
    2. dsh web 之类的命令行宿主 → 宿主进程自我重启(respawn);
    3. 都不支持 → 弹出一段明确的替代操作,绝不假装已经重启。
  • 中英双语,跟随浏览器语言自动切换。

平台支持

运行方式 重启方式 说明
桌面应用(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(真实目录)后再启用。

使用

  1. 侧栏底部点「重启」,按钮变成「确认重启?」,6 秒内再点一次即执行;点击别处或等待超时会自动取消。
  2. 设置 → 重启里可以看到宿主状态,并用同样的两步确认执行重启。
  3. 重启后:
    • 桌面应用:窗口会重新打开(由 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,排查失败时先看这里。

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit 56eef2de02f0

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout