Self-diagnosing, self-repairing watchdog for DSH plugins: 15s health patrol, version-switch repair with observe window and auto rollback, unknown symptoms escalated to human.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:ckk-09/dsh-refix#path:/packages/dsh-refix
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
DSH 静态 profile 层构建,由 deploy/static/build-static.mjs 自动生成。
生成源:versions/refix-v1.08.js(sha256 0cf42e50428fef2e…)。
装(一条命令)
dsh plugin --profile web add <本目录的绝对路径>
装完重启 dsh web。该命令是宿主原生能力:它把参数转发给 profile 目录里的 pnpm,
然后把声明了 dsh.bundle 的依赖自动并入 dsh.profile.bundles 层栈。
卸载:dsh plugin --profile web remove dsh-refix。
装好的标志
dsh 控制台出现:
dsh-refix p3.7 ready; contract OK (兼容性自检通过); baseline plugins: N; patrol every 15000ms
边界(与动态包一致)
- 周期巡检自动:
PATROL_PERIOD_MS = 15000,插件自己起定时器,无需任何外部触发。 - 修复与报告不自动:修复唯一入口是
refix_repair工具,报告是refix_report, 巡检是refix_patrol—— 都要由会话模型按需调用。插件源码里没有 prompt/systemPrompt 注入,所以它不会主动对被修复的会话说话。 要"全自动",请在挂载后授权会话模型:先refix_patrol建立基线,之后按需refix_report、 可修症状直接refix_repair。
运行期依赖
@deepseek-ai/dsh-tools(取 defineTool 做 DSL→JSON Schema 编译与参数校验)。
解析分两级:① 裸说明符 —— 本包以实体目录安装时命中;② $DSH_HOME/profiles/node_modules
—— DSH 启动时把安装侧依赖闭包投影在这里(healProfilesModuleFallback)。
pnpm 以 symlink 安装本包时第 ① 级必然失败(Node 会把模块 realpath 回源目录再找依赖),
靠第 ② 级命中安装侧同一份。
两级都不可达时插件仍会加载并巡检,只是工具 schema 走内置编译器、参数不做运行期校验,
控制台打印一行 [refix] 静态包:未能解析 … 警告。看到它不影响使用;
要消除它,确认 ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-tools 存在即可。
Links
More in this category
yjh051108/dsh-routing-suite★ 7194
One repository, three parts: a runtime injector for DSH plugin packages (inject, hot-reload, unload, promote a dev staging tool to the front, route self-heal, plus a settings-page plugin manager that lists, unloads and drags folders in to internalize), a task-aware reasoning-mode router agent preset (router-standard / router-spec / router-react), and a graded two-level task protocol whose six tools (commit_star, lock_stage, revise_do, edit_plan, mark_task, redteam_verdict) pin task state to disk. The injector implementation ships in-tree, so the install carries its own behaviour rather than a dependency list.
strukto-ai/mirage#dsh★ 3641
Swaps the filesystem and bash providers for a mirage virtual workspace: file tools and shell commands run over mounted resources (RAM, S3, Redis, Slack, Gmail, Notion, Postgres) instead of the host disk, with per-mount read/write/exec modes, per-command sandbox routing (monty, pyodide, quickjs in process; docker, e2b, daytona remote), and installed CLIs (git, gh, slack, linear, ntn, gws, or one you register) as head words in the virtual terminal.
hust-open-atom-club/oh-dsh★ 318
Community distribution: TUI, desktop, and Web UI as one bundle with layered installation.
weijiafu14/pi2dsh★ 196
Pi Host ABI compatibility engine: after one install, unmodified Pi extensions from npm mount as native DSH plugins with `dsh plugin add <pi-package>`. Verified end to end on stock DSH with pi-mcp-adapter (full MCP manager: OAuth, resources, prompts, MCP Apps, elicitation, sampling), @tintinweb/pi-subagents, pi-code, pi-hermes-memory and pi-background-tasks; `pi2dsh inspect` reports a package's compatibility before installing.
lire1131/dsh-undo-savepoint★ 159
Undo/redo & rollback system for DSH: every config change is auto-snapshotted; undo/redo/restore to any version from the WebUI or the offline CLI/GUI tools (works even when DSH fails to boot).
Fishquito7/dsh-skill-mcp-panel★ 132
Manages DSH skills and MCP servers from the web settings: skill cards with hot enable/disable, workspace scopes, groups, batch migration and drag-and-drop import, plus stdio/HTTP MCP CRUD with connection tests, secret redaction and the unified dsh-panel CLI.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.