dsh-simple-restart
DeepSeek Harness 插件：无需 market 插件，即可从 General 设置行重启正在运行的 `dsh web` 进程。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yizhixiaokong/dsh-simple-restart#b90c2f3ba11099df076aef6a7f5c1d7d34818c6bSimple Restart 以 dsh-simple-restart 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 中文
A DeepSeek Harness plugin
that adds one row to Settings → General: a button that restarts the running
dsh web process with the same invocation it was started with.
It exists because a plugin change to a client bundle only takes effect after the host restarts, and doing that from a terminal means finding the terminal again. This package owns its own route and its own restart logic — no other plugin is involved.
If anything goes wrong after the handoff, the helper writes a diagnosis to
$TMPDIR/dsh-simple-restart-<timestamp>.err.log (the replacement's own stdout/stderr
go to the .out.log beside it). The process that would otherwise log the
failure is the one that just exited — that is why the helper is a separate
program rather than a setTimeout in the host.
A process cannot replace itself: it can only stop, and something has to start the
successor after the listening port is free. Starting it earlier dies with
EADDRINUSE. So the restart is a handshake between two processes, and the second
one has to be detached — it must outlive the first.
"free" is tested by connecting to the port, never by binding it: a test bind
would itself hold the port at the exact moment the replacement needs it.
| Requirement | Notes |
|---|---|
| DSH, web profile | The route is served by webServer; the settings row is a client-half slot. |
| Same-origin loopback caller | The route refuses anything else (see below). |
Not supervised by systemd — or allowRestart: true | systemd's default KillMode=control-group kills the helper together with the unit, so a restart there would leave nothing running. |
| Not under a debugger | A debugger attached to this process cannot follow it across an exec-less restart. |
Straight from GitHub — nothing to clone (pin a tag if you want a fixed release):
dsh plugin --profile web add "github:yizhixiaokong/dsh-simple-restart"
# pinned: dsh plugin --profile web add "github:yizhixiaokong/dsh-simple-restart#v0.1.0"
From a clone, when you want to edit the code:
git clone https://github.com/yizhixiaokong/dsh-simple-restart.git
cd dsh-simple-restart
dsh plugin --profile web add "$PWD"
From npm, once it is published:
dsh plugin --profile web add dsh-simple-restart
All three end the same way, and none of them needs a manual registration step:
dsh plugin runs pnpm, then reads each installed dependency's
package.json; a package that declares dsh.bundle has its name appended to
dsh.profile.bundles, which is what mounts the
cordis.patch.yml beside it.
Now restart dsh web once from a terminal — the client bundle is baselined
at boot, so the button appears only after the next start. After that, the
button can do it.
To remove it:
dsh plugin --profile web remove dsh-simple-restart
Settings → 通用 / General → 重启 dsh web:
确认重启？), a second click within 5s performs it;The row's config is passed to the host apply:
# in the profile's cordis.patch.yml, on the row this package contributes
- insert:
- id: simple-restart
name: dsh-simple-restart
config:
allowRestart: true # restart even when a systemd supervisor is detected
| Key | Type | Default | Meaning |
|---|---|---|---|
allowRestart | boolean | false under a detected systemd supervisor, true otherwise | Whether a restart is permitted where supervision was detected. Only set this where the unit is known to survive it (KillMode=process, or a supervisor that restarts the unit). |
One exact route, POST /dsh-simple-restart/api/restart. It is fenced before anything is
spawned:
| Check | Refusal |
|---|---|
| Method other than POST | 405 with Allow: POST |
Socket peer that is not 127.0.0.1, ::1 or ::ffff:127.0.0.1 | 403 |
Any forwarding header (forwarded, x-forwarded-for, x-real-ip) | 403 |
Missing Origin, or an Origin whose host is not Host | 403 |
systemd supervisor detected and allowRestart not true | 403 |
Debugger detected in process.execArgv | 403 |
| A restart is already scheduled | 409 |
// 202 Accepted
{
"ok": true,
"pid": 12345, // the host that is stepping aside
"helperPid": 12350, // the detached helper
"logOut": "/tmp/dsh-simple-restart-2026-09-15T10-00-00.out.log",
"logErr": "/tmp/dsh-simple-restart-2026-09-15T10-00-00.err.log"
}
Failures answer {"ok":false,"error":"…"} with the status from the table above.
The helper is spawned as node -e <program>, detached with stdio: "ignore" and
unref()ed, so it is out of this process's lifetime from the moment it exists.
It is given the boot invocation as data ({ file, args, cwd }), never by
re-running a shell command line: when the host was started as node …/bin.js
the absolute entry and its original execArgv/argv are reused; otherwise it
falls back to the dsh executable on PATH with the original arguments.
dsh with the same argv — which is right for dsh web, not for every
possible wrapper.Host carries no port, the helper simply waits
1.5s before starting the replacement.lib/index.js host half — route, guards, launch description, detached helper
lib/client.js client bundle — one General-settings row
cordis.patch.yml the single host row this package contributes
scripts/smoke.mjs offline checks (no harness, no restart)
npm test # node scripts/smoke.mjs
The smoke test materializes the client bundle against stub globals and applies the host half to a stub context. It never restarts anything. It checks that the client half fills exactly one settings seat, that the host registers exactly one route, and that both halves agree on that route's path — a mismatch shows up in the browser as a row that always says "请求失败" while the host log stays empty.
Versions are tagged to match package.json — this tree is v0.1.0.
The yizhixiaokong placeholder in package.json, CHANGELOG.md, the badges and the
install commands above stands for the GitHub account this repository is pushed
to; replace it before publishing. The commits here were authored under a neutral
dsh-plugins <noreply@example.com> identity so that no personal address ends up
in the published history; if you want your own name on them, set
git config user.name / user.email and run
git commit --amend --reset-author before pushing.
This plugin was developed under the working name dsh-restart-button. That name
is not available: it is published on npm by
jiqiu0709/dsh-restart-button
and used by several other GitHub repositories, so the package ships as
dsh-simple-restart. Renaming also removed a real collision — the route is now
this package's own /dsh-simple-restart/api/restart, instead of the
/dsh-restart/api/restart that other restart plugins register.
The plugin list at
awesome-dsh-plugin
is generated from one YAML file per plugin, and its CI checks a submission's
shape against this repository. The mechanical part is already satisfied here:
dsh.bundle is declared in package.json beside cordis.patch.yml, the
official @deepseek-ai/* packages are declared as peerDependencies, there are
no dependencies to install and no build step.
Mind what this plugin shares with entries already on that list: several of them
restart dsh web from inside the GUI. This one adds two things they do not
state — it refuses to restart under a detected systemd supervisor, whose default
KillMode=control-group would kill the helper along with the unit, and it tests
whether the port is free by connecting to it rather than binding it, so the
replacement never races the old process for the port.
Owner steps:
add the dsh-plugin topic —
gh repo edit yizhixiaokong/dsh-simple-restart --add-topic dsh-plugin;
let the repository age past 1 day (the list's CI rejects younger ones);
open one PR adding data/plugins/yizhixiaokong__dsh-simple-restart.yml:
url: https://github.com/yizhixiaokong/dsh-simple-restart
name: yizhixiaokong/dsh-simple-restart
category: dev
description:
en: 'Adds a restart row to Settings → General that relaunches dsh web with the same invocation through a detached helper, refuses under a detected systemd supervisor unless allowRestart is true, and tests whether the listening port is free by connecting to it rather than binding it.'
zh: '在「设置 → 通用」增加一行重启按钮：用相同启动参数、经分离的 helper 重新拉起 dsh web；检测到 systemd 监管时默认拒绝（除非 allowRestart 为 true）；判断端口是否空闲用连接探测而非绑定。'
The storefront reads a screenshots.json next to package.json for its
screenshot strip; this repository declares assets/01-settings-row.png and
assets/02-confirm.png, in that order.
npm login --registry=https://registry.npmjs.org # a mirror accepts neither a login nor a publish
npm publish --registry=https://registry.npmjs.org
npm publish --dry-run prints the tarball contents without uploading anything,
and prepublishOnly runs npm test before either. The published package's
repository field points back here; that is what lets the plugin list link the
two and then offer the registry install form instead of the GitHub one.