dsh-rescue

DSH PLUGIN开发与运行时

仓库 Iliyasfiel/dsh-rescue

开发与运行时 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

dsh-rescue 为 DeepSeek Harness 提供救援模式:升级后第三方插件冲突导致 GUI 无法启动时,一条命令摘除全部第三方 bundle,让 DSH 以纯核心启动并自行修复,再一键原样还原。

一句话选型结论

按资料字段整理

dsh-rescue 是开发与运行时类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-09-07 创建于 2026-09-07
README 6.4 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Iliyasfiel/dsh-rescue#v0.1.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.0-rc.2 等 7 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.0-rc.2 等 7 个版本版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-rescue:DeepSeek Harness 起不来时的救援模式工具

  • 一条命令摘除第三方插件层
  • 纯核心启动,GUI 起不来也能用
  • 秒级离线原样还原插件栈
  • 事务化改写,失败自动回滚

适用场景

文件读写终端命令

上游标签

dsh-plugin

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度稳定按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-10-08): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2 等 7 个),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-rescue当前 L5 · 运行验证通过 低风险 0 0.2.0-rc.2 等 7 个 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Iliyasfiel仓库 dsh-rescue · 默认分支 main
分类开发与运行时developer
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-09-07 · 2026-09-07最后推送 2026-09-07
本站收录2026-09-08首次进入本站目录的时间

README 全文

6.4 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-rescue

Rescue mode for DeepSeek Harness (DSH).
When a version upgrade leaves third-party plugins conflicting and the GUI will
no longer start, dsh-rescue temporarily strips every third-party bundle from
a profile's stack so dsh boots on a pure core and can repair itself — then
restores the original stack with one command. Plain Node, zero dependencies,
works fully offline, and — critically — works even when the GUI cannot boot at
all.

DSH 救援模式工具。当 DeepSeek Harness 因版本升级后第三方插件冲突而无法启动时,
dsh-rescue 临时摘除 profile 中所有第三方插件层,让 dsh 以纯核心启动并自行修复;
修完一条命令原样还原。纯 Node、零依赖、离线可用,dsh GUI 完全起不来时也能用。

Why a launcher-level tool, not a rescue plugin / 为什么做在插件体系之外

DSH plugins are patch layers declared in a profile's package.json
(dsh.profile.bundles); at boot they all load in order and fail loudly — one
broken bundle refuses the whole profile. Self-repair therefore cannot live
inside the plugin stack (it would be the very thing being quarantined).
dsh-rescue edits the profile manifest directly, at the same layer as the
dsh plugin command:

  • A third-party plugin = a package listed in both dependencies and
    dsh.profile.bundles.
  • In-box core layers (@deepseek-ai/dsh-base, @deepseek-ai/dsh-web-app, …)
    are not in dependencies, so they are always kept.

enter only trims bundles and leaves dependencies untouched — leaving
rescue mode is therefore instant, offline, and needs no pnpm step.

DSH 的插件是 profile 里的 bundle 补丁层(package.json → dsh.profile.bundles),启动时按
顺序全部加载且 fail-loud——一个插件崩,整个 profile 拒绝启动。所以"自救"不能做成插件
(它自己就是被隔离对象),必须发生在插件体系之外。dsh-rescue 直接操作 profile 清单,
与 dsh plugin 命令同层。第三方插件 = 同时出现在 dependencies 与 bundles 里的包;
内置核心层(如 @deepseek-ai/dsh-base)不在 dependencies 中,必然保留。
enter 只精简 bundles、不动 dependencies,因此 exit 是秒级、离线的原样还原。

Dual form / 双形态

The package ships two surfaces:

Surface Where Purpose
CLI dsh-rescue bin/dsh-rescue.js, global install The real mechanism. Usable from a terminal when the GUI is dead.
cordis bundle entry lib/index.js + cordis.patch.yml Deliberately inert plugin entry (apply() is a no-op) that declares dsh.bundle, making the package installable via dsh plugin add. It exists for ecosystem compatibility only — a "rescue plugin" that ran at boot would defeat its own purpose.
形态 位置 用途
CLI dsh-rescue bin/dsh-rescue.js(全局安装) 真正的救援机制,GUI 起不来时在终端使用。
cordis bundle 入口 lib/index.js + cordis.patch.yml 刻意惰性的插件入口(apply() 为空),声明 dsh.bundle 使其可被 dsh plugin add 安装。仅为生态兼容——会在启动时运行的"救援插件"恰恰违背自救初衷。

Install / 安装

# CLI (recommended — this is the rescue path)
npm install -g dsh-rescue

# Optional: register the inert bundle in a profile (ecosystem install form)
dsh plugin --profile web add dsh-rescue

Usage / 用法

dsh-rescue enter      # rescue ON: keep only core layers, park all third-party plugins
dsh-rescue exit       # rescue OFF: reconcile-restore the original bundle stack
dsh-rescue status     # read-only: rescue state + core/third-party split
dsh-rescue help

Profiles live under $DSH_HOME/profiles (DSH_HOME defaults to ~/.dsh);
the default web GUI profile is named web. Set DSH_HOME to target another
installation.

Typical rescue workflow / 典型救援流程:

# dsh won't start. Stop it, then:
dsh-rescue enter web          # ① profile now boots WITHOUT third-party plugins
dsh web                       # ② pure boot succeeds — repair in the GUI/CLI,
#    e.g.  dsh plugin --profile web remove
dsh-rescue exit web           # ③ reconcile-restore the plugin stack
dsh web                       # ④ normal boot again

Behaviour details / 行为细节

  • Transactional: backup + state are written before the manifest is
    rewritten; a failed rewrite rolls back and leaves no half-written state.
  • Reconciled exit: in-box core layers always return; each original
    third-party bundle returns only while its package is still in
    dependencies. A plugin removed during rescue (e.g. dsh plugin ... remove) stays removed — it is not resurrected into an unresolvable
    layer.
  • If a dsh boot ran while in rescue, the host may auto-append the default
    patchReload: "live" to the manifest; exit drops exactly that
    auto-written default so the round-trip stays clean. User-chosen values are
    preserved.
  • Guardrails: repeated enter, state-less exit, non-profile directories and
    already-pure profiles all fail with a clear message and touch nothing.

  • 事务化:先备份+写状态,再改写清单;失败自动回滚。

  • exit 协调式还原:核心层必然恢复;第三方插件仅当其包仍在 dependencies 时恢复
    (顺序不变)。救援期间用 dsh plugin remove 删掉的插件不会被"复活"成无法解析的层。
  • 救援期间若曾用 dsh 启动,宿主可能自动补写默认 patchReload: "live",exit 会精确摘除
    这份自动写入,保持往返干净;用户主动设置的值保留。
  • 重复 enter、无状态 exit、非 profile 目录、本就无第三方插件等场景都会明确报错且不落地。

Classification rule / 判定规则

Based on the manifest alone (dependencies ∩ bundles) — no assumptions about
package-name prefixes — so it stays correct as dsh's core/plugin shapes evolve.

仅依据清单本身判断(dependencies ∩ bundles),不假设包名前缀规则,对 dsh 核心/插件
形态的未来变化更稳健。

Development / 开发

node --test test/rescue-core.test.js     # tests run against throwaway profiles only
node bin/dsh-rescue.js status web        # read-only look at a real profile

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-rescue 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Iliyasfiel/dsh-rescue#v0.1.0` 即可。

dsh-rescue 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-rescue 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

dsh-rescue 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-rescue 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2、0.1.3-alpha.2。

dsh-rescue 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-rescue 有哪些功能?

一条命令摘除第三方插件层、纯核心启动,GUI 起不来也能用、秒级离线原样还原插件栈、事务化改写,失败自动回滚。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-10-08。