deepseekplugins

DeepSeek Harness 插件

dsh-doctor-astra

Deterministic diagnostics and recovery for DeepSeek Harness, with a web client and CLI.（英文原文）

插件开发工具
跳到安装方式

来源信息

GitHub 仓库
astra3294/dsh-doctor
最近更新
2026年8月22日
分类
插件开发工具
GitHub stars
3
载体类型
bundle
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/astra3294/dsh-doctor
插件名：dsh-doctor-astra
作者：astra3294

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh-CN.md来源说明 · 只读预览
README 语言

DSH Doctor

DeepSeek Harness 的确定性诊断与恢复工具。

DSH Doctor 是 Harness「把自己改坏」两种典型情况的安全网：开得了但无法对话（WebUI 能打开但对话循环坏了），以及根本起不来（改了配置、依赖或插件后启动失败）。WebUI 还能打开时，Doctor 按钮调用仅限本机访问的 Host 救援服务；Harness 起不来时，同一套引擎以独立 CLI 运行——包括捕获启动失败的启动探针，和「一键恢复到最近健康检查点」的重置，让插件开发者可以放心折腾、随时回到能对话能用工具的状态。

> DSH Doctor 0.2.0 面向 @deepseek-ai/dsh 0.1.0-rc.6。DeepSeek Harness 仍处于 Developer Preview；遇到未知版本时，Doctor 只做保守的只读诊断。

English

安装

把 Doctor 安装进 Web profile：

dsh plugin --profile web add dsh-doctor
dsh --profile web

一个 npm 包同时包含 Host 与浏览器部分，并在 WebUI 中提供：

  • 侧栏设置旁边常驻的 Doctor 入口；
  • Prompt 或 Agent 失败后，在输入框上方主动出现的恢复提示；
  • 设置中的完整 Doctor 页面，用于查看问题、检查点和回滚；
  • 页面框架层的应急浮标入口：profile 出问题时自动出现，不依赖侧栏与对话插件是否存活。

如果 WebUI 无法启动：

npx dsh-doctor recover --profile web

CLI

# 扫描一个 profile（默认离线、隐藏绝对路径）
npx dsh-doctor scan

# 启动探针：判断 Harness 能否启动，并从启动输出诊断失败原因
npx dsh-doctor boot

# 一键恢复：配置重置到健康检查点、对齐依赖，并再次验证能否启动
npx dsh-doctor recover --profile web
npx dsh-doctor recover --profile web --yes   # 同时执行需确认的动作

# 把当前 profile 快照为健康恢复基准
npx dsh-doctor checkpoint --profile web

# 启动 Harness；启动失败时自动诊断（--auto-recover 会修复并重启一次）
npx dsh-doctor launch --auto-recover

# 回滚检查点
npx dsh-doctor rollback <checkpoint-id>

recover 零确认执行安全动作，之后在 Harness 原本未运行时用启动探针验证结果。仍有 Error 或启动验证失败时退出码为 1；Warning 默认返回 0，--strict 时返回 1；参数或内部错误返回 2。--json 输出机器可读结果。

v0.2.0 检查内容

  • Node、操作系统、Harness 版本和 profile；
  • profile manifest、bundle 列表、cordis.yml、cordis.patch.yml、pnpm workspace 的语法与权限；
  • 缺失依赖、重复 bundle 和损坏链接；
  • 从 WebUI 调用时的 Cordis 插件运行阶段；
  • 启动失败：真实启动探针（端口监听 + 捕获输出并映射为修复动作）；
  • 会话记录（session.jsonl.zstd）与 storage 缓存的完整性；
  • 本地近期日志中的 fatal/plugin failure 标记；
  • 非 registry 和外部插件来源（仅提示，永不阻塞恢复）；
  • 模型路由/凭据状态，以及验证模型真实应答的极小非会话请求。

恢复

每次修改都遵守同一事务：

1. 重新检查修复计划是否过期，并核对 profile 文件哈希。 2. 创建仅本机可访问的修复前检查点。 3. 只执行用户选定的动作。 4. 重新运行完整结构检查（Harness 原本未运行时追加启动验证）。 5. 验证失败时自动回滚。

一键安全动作包括准备 Doctor 状态，以及把 profile 配置整体重置到最近健康检查点。冷启动（还没有健康检查点）时，Doctor 可以在明确确认后合成最小合法配置文件，损坏的原文件保留在修复前检查点里。安装依赖、禁用导致启动崩溃的插件、隔离损坏的会话文件、重新启用被 Doctor 禁用的插件都需要确认。Doctor 拒绝禁用连接、布局、设置、对话、运行时、模块加载器以及 Doctor 自身入口。

检查点位于 $DSH_HOME/doctor/checkpoints/，每个 profile 保留最近 10 个，且最新的健康检查点永不被清理。为了精确回滚，检查点可能包含本地配置文件的原始副本，但绝不会进入诊断报告或上传。Doctor 不显示、不修改也不上传 API Key。

参见[恢复矩阵](./docs/RECOVERY_MATRIX.zh-CN.md)和[安全策略](./SECURITY.md)。

开发

需要 Node 24 和 pnpm：

pnpm install
pnpm check
npm pack --dry-run

许可证

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类

mirage#dsh

strukto-ai/mirage#dsh

把文件系统与 bash 提供者换成 mirage 虚拟工作区：文件工具与 shell 命令作用于挂载的资源（RAM、S3、Redis、Slack、Gmail、Notion、Postgres）而非宿主磁盘，支持按挂载点设置读/写/执行模式、按命令选择沙箱（进程内 monty、pyodide、quickjs；远程 docker、e2b、daytona），并可在虚拟终端中安装 CLI（git、gh、slack、linear、ntn、gws，或自行注册的程序树）作为命令头词。

2026年8月15日 3546