New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

dsh-rescue-toolbox

Package Overview
Dependencies
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

dsh-rescue-toolbox

DSH 插件应急工具箱:DSH 因插件 fail-loud 无法启动时的独立急救工具(诊断问题插件 + 禁用 + 备份恢复)

latest
npmnpm
Version
0.1.0
Version published
Weekly downloads
0
Maintainers
1
Weekly downloads
 
Created
Source

🛠️ DSH 插件应急工具箱(dsh-rescue-toolbox)

DSH(DeepSeek Harness)因插件 fail-loud(一个插件坏了整个 DSH 起不来)而无法启动时的独立急救工具。

  • 完全独立:不依赖 DSH、不装任何依赖(零 npm 依赖),只读 DSH 配置文件。
  • 零基础可用:双击 启动工具.bat 即可,浏览器操作,代码小白也能用。
  • 安全:禁用前自动备份,可一键恢复;只监听本机 127.0.0.1。

什么时候用

DSH 更新了插件 / 装了新插件之后突然启动崩溃(黑窗口一闪而过 / 网页打不开),多半是某条插件配置有问题。用它找出问题插件并禁用它,DSH 就能重新启动。

功能

  • 读取本机所有 DSH 配置(~/.dsh/profiles/*/cordis.patch.yml)中的插件条目,分三区展示:
    • ① 检测到的插件:参与加载的插件,自动诊断(路径格式错误 / 文件缺失 / 包不存在),可勾选禁用
    • ② 已禁用插件:被本工具禁用的插件,可一键恢复
    • ③ 未生效插件:- disable: 指令等不参与加载的条目,只读展示,防止误启用引发崩溃
  • 禁用前自动备份原配置(cordis.patch.yml.bak-时间戳),支持从任意备份点恢复
  • 一键禁用全部插件(排查"无插件能否启动")

使用方法

方式一:双击启动(推荐,普通用户)

双击 启动工具.bat,自动完成:检测 Node → 启动服务 → 打开浏览器 http://127.0.0.1:8765。

方式二:命令行(开发者)

node server.mjs
# 然后浏览器打开 http://127.0.0.1:8765

方式三:npx 一键运行(npm 已发布)

npx dsh-rescue-toolbox

环境要求

  • Node.js 18+(唯一依赖,nodejs.org 免费下载安装)
  • Windows 10 / 11(自带 PowerShell 5.1,启动脚本会用到)
  • 不需要 Java / Python / conda 等任何其他环境

提示:启动工具.bat 为 GBK 编码,在中文版 Windows 上显示正常;英文版 Windows 下中文会乱码(可改用方式二/三)。

常见问题

问题处理
窗口提示"未找到 Node.js"先到 nodejs.org 安装 Node.js,再重新双击
浏览器打不开 / 连接被拒确认窗口显示"工具箱已就绪",稍等片刻刷新
端口 8765 被占用关闭其它工具箱实例后重试(服务只监听 127.0.0.1 本机)
防火墙/安全软件提示允许即可(仅本机回环访问,无网络风险)
禁用后 DSH 还是起不来用「恢复备份」还原,再逐个排查

目录结构

dsh-rescue-toolbox/
├── server.mjs          # 服务端(零依赖 Node,端口 8765)
├── 启动工具.bat        # 双击启动脚本(GBK 编码,中文 Windows)
├── web/
│   ├── index.html      # 界面
│   └── app.js          # 前端逻辑
└── bin/
    └── dsh-rescue-toolbox.mjs  # npm 命令入口

原理简述

DSH 的插件配置在 ~/.dsh/profiles/<profile>/cordis.patch.yml,加载器对坏插件是 fail-loud:某条插件 name 路径写错(如盘符路径缺 file:///)、指向的文件/包不存在,就会导致 DSH 整个无法启动。本工具逐条解析该文件并做最小诊断,把问题条目注释掉(# [已禁用])即可恢复启动;注释不删原内容,可随时还原。

许可证

MIT

Keywords

dsh

FAQs

Package last updated on 24 Aug 2026

Related posts