← 返回列表
⚠ 装前注意
DSH 报错后别停：自动重试、自动刷新、自动换路，任务继续跑。
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/9/13 · 已提供中文文档
DeepSeek Harness 常见工具错误的自动恢复。重试、刷新、切换工具，让任务持续推进——零提示、零配置。
综合分
32.4
GitHub 分
32.4
用户评分
—
★ Stars
4
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add cyanseek/dsh-autofix未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
数据截至 2026/9/19（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-autofix（未发布到 npm，仅可源码安装）
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/19 01:12:46
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-llm@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools@deepseek-ai/schemastery用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-autofix
English
DSH 报错后别停：自动重试、自动刷新、自动换路，任务继续跑。
安装一次，然后照常使用 DeepSeek Harness。命中支持范围的错误时给出一次明确恢复动作；未知错误保持不变。
- Web 或 API 瞬时错误：重试一次
- 编辑期间文件变化：刷新当前上下文
- 当前系统缺少命令：使用已安装的等价命令
- 常见 DSH 错误：给 Agent 可直接执行的下一步
安装
npx -y dsh-autofix install
完成。之后正常使用 DSH。
使用前后
Web 工具返回 502
以前：HTTP 502 → 任务暂停 → 用户说“继续”
现在：HTTP 502 → AutoFix 要求重试一次 → 任务继续
编辑时文件发生变化
以前：old text not found → 用户转述错误 → Agent 再读取
现在：old text not found → AutoFix 刷新有界片段 → Agent 重新编辑
不同平台的命令名称不同
以前：找不到 rg → 任务停止
现在：找不到 rg → AutoFix 找到已安装的等价命令 → Agent 继续
恢复 Recipe
| Recipe | 识别范围 | 动作 |
| --- | --- | --- |
| 瞬时工具错误 | 限流、部分 408/5xx、超时和传输重置 | 要求 Agent 对同一操作重试一次，再失败就换方案 |
| 过期文件上下文 | 明确的编辑过期和替换未命中错误 | DSH 文件服务可用时附加当前文件的有界片段 |
| 命令替代 | Shell 工具的 command-not-found 错误 | 只推荐当前 PATH 中真实存在的第一个等价命令 |
| DSH Error Atlas | 一组受控且有版本的常见 DSH 错误 | 附加简短下一步，不改写 profile 或 session 数据 |
公开目录见 recipes/catalog.json。欢迎通过 Recipe 需求表单 补充常见错误。
零打断契约
dsh-autofix 只在工具已经失败后工作。它不增加审批弹窗、不修改工具参数、不改变成功结果、不安装系统命令、不要求额外服务，也不增加 UI。
同一错误在短窗口内最多触发一次恢复。第二次相同失败保持可见，让 Agent 换方案。取消会停止待处理的恢复工作；卸载会移除插件和随包 Skill。
未知错误保持原样。
兼容性
当前开发快照在 Windows Node.js 24.11.1 和真实 @deepseek-ai/dsh-tools 0.1.0-rc.8 运行时上通过全部 55 项测试（2026 年 9 月 12 日）。此前发布版本的 rc.6 兼容性证据单独保留：Linux/WSL 的 Node.js 24.19.0 与 Windows 的 Node.js 22.19.0 均已通过严格类型检查、构建和完整测试。Windows CLI 路径也已通过 WSL 互操作，在隔离的真实 DSH profile 上完成安装、重复安装、生效配置和卸载检查。独立 Windows 客户端运行与原生 macOS 安装仍需发布候选验证。
准确证据与限制见兼容矩阵。
高级 Test Kit
维护者可以运行随包提供的确定性恢复检查：
dsh-autofix test --scenario transient-tool-error --json
可用场景为 transient-tool-error、stale-file、command-alternative 和 error-atlas。
插件作者可以导入稳定的 Recipe 接口：
import { applyRecipes } from 'dsh-autofix'
import type { AutoFixRecipe } from 'dsh-autofix/recipes'
const recipes: AutoFixRecipe[] = [myRecipe]
applyRecipes(ctx, recipes)
该高级入口应放入一个自定义 bundle，不要再同时挂载默认 bundle。Recipe 按 priority 降序执行，重复 ID 会立即报错。
旧的确定性故障引擎继续作为高级回归测试工具提供：
import { ChaosEngine } from 'dsh-autofix/testkit'
普通用户无需使用 Test Kit。
开发与贡献
npm ci --ignore-scripts
npm run check
一个恢复贡献应保持很小：一个 Recipe、一个确定性回归测试和一个简短目录条目。提交前请阅读 CONTRIBUTING.zh-CN.md。
许可证
MIT同作者（cyanseek）的其他插件
扫码进群