dsh-harden
DSH 运行时看护层 —— 让任何一次停止都有明确原因
English ·
GitHub
插件用途
-
API由于特殊原因导致的调用失败后，可续接并自动重试
-
工具调用失败被吞导致会话莫名结束（需在设置页填「失败提示前缀」，否则本条不生效）
-
第三方API经常出现的：只输出思考直接中断，插件会自动重试
-
创建对接pwsh的后台job工具，解决只使用gitbash无法创建超120秒的后台任务
-
一键修复异常会话日志
-
上下文自动压缩 —— 会话涨到阈值自动把老历史压成摘要，界面沿用平台自带提示；压缩范围另有下拉框三档可选（全部压缩 / 仅主代理 / 仅子代理，默认全部压缩）
-
子代理通知聚合 —— 多个子代理并行结束时不再逐个唤醒主代理：中间通知先压住，全部结束后合并成一条统一送达（默认关闭，可在设置页打开）
-
子代理会话异常自动修复 —— 解决子代理运行过程中莫名的会话无法打开情况；平台写出的重试事件不合规时，在落盘前先修正，修正发生时回合尾部显示一行浅色提示（常驻开启，没有开关）
问题截图
会话日志被写坏后，平台会直接报错、整段历史再也打不开；插件在设置页提供一键扫描并修复：
历史加载失败：stored session is corrupt
工具调用失败被吞时，插件自动提示模型重新发起，回合不会莫名结束：
工具调用失败，已提示模型重新发起
模型只输出思考、没有正文就收尾时，插件自动提示模型补充正文，回合不会莫名结束：
回合没有答复就收尾，已提示模型补充正文
插件截图
设置页（中文 · 浅色）
设置页（中文 · 深色）
安装
三条路选一条，装完还必须把插件注册到 profile —— 这一步是必须的（见下一节）。
1. 从 npm 安装
npm install dsh-harden
2. 从 GitHub Releases 下载
到 Releases 下载 dsh-harden-<版本>.tgz：
dsh plugin --profile web add file:<tgz 文件的绝对路径>
3. 从源码构建
git clone https://github.com/thissensen/dsh-harden.git
cd dsh-harden
pnpm install
node scripts/link-deps.mjs # 把宿主包链进本项目的 node_modules
pnpm build # tsc（host）+ vite（client）
首次构建必须在启动 DSH 之前完成（client 壳受启动快照约束）。
注册到 profile
上面三条路只是把文件放到位置，还得把 dsh-harden 注册进 profile，DSH 启动时才会加载它。
桌面端：手动改 ~/.dsh/profiles/desktop/package.json 的两个地方：
- 在
dependencies 里加 "dsh-harden": "link:<克隆目录>/dsh-harden"（从 npm 装的用版本范围）；
- 在
dsh.profile.bundles 数组里加 "dsh-harden"。
然后在该目录跑 pnpm install，并重启桌面端（client 壳受启动快照约束）。
Web 端：一条 CLI 命令
dsh plugin --profile web add link:<克隆目录的绝对路径>
设置页
设置页在「DSH优化」分区下，共 八张卡：
| 卡片 | 说明 |
|---|
| 工具调用失败续跑 | 开关。工具调用失败被吞、框架仍把回合当作正常结束时，注入一条提示让模型重新发起。另有 失败提示前缀：只填平台警告的固定开头，整段匹配开头（不拆行）、区分大小写。默认空 —— 留空则规则 H1 不生效。 例：⚠ Could not execute tool。 |
| 回合无正文收尾 | 开关。最后一步只有思考、既没有回复也没有工具调用的回合，会被拉回再走一步。 |
| 网络请求中断续跑 | 开关 + 网络重试次数（官方重试耗尽后最多再补几次，0–99；填 0 表示不兜底）+ 触发重试的失败特征（错误码 SERVER / RATE_LIMIT / TIMEOUT / TRANSPORT 与 HTTP 状态码 502 / 429；留空表示不重试任何失败）。 |
| 上下文自动压缩 | 开关 + 压缩范围（下拉框：全部压缩 / 仅主代理 / 仅子代理，默认全部压缩）+ 触发阈值（如 200K / 1M / 100000；插件默认为 200K）+ 摘要指令（生成摘要时发给模型的指令）。会话超过阈值后，较早的一段历史被浓缩成摘要，并沿用平台自带的「上下文已压缩」提示。 |
| 后台任务工具 | 开关。开启后模型可以用 job_background 起后台命令，再用 job_list / job_output / job_kill 管理；关闭后该工具消失。 |
| 子代理通知聚合 | 开关，默认关闭。多个子代理并行结束时，中间通知先压住，全部结束后合并成一条统一送达，不再逐个唤醒模型。 |
| 子代理会话异常自动修复 | 没有开关，常驻开启。 平台即将写入不合规的重试事件时，插件在落盘前先修正，会话因此不会变得打不开；修正发生时回合尾部显示一行浅色提示。 |
| 修复损坏会话 | 扫描按钮。扫描全部会话日志并修复已知的损坏形态，让打不开的历史重新可用。 |
⚠️ 最要紧的一条：「失败提示前缀」默认为空，装完不填，规则 H1 就不生效。 请打开设置页，把你的平台警告原文的固定开头粘进去（例：⚠ Could not execute tool）。
设置页截图取自旧版本面板，与当前卡片文案不完全一致，以实际界面为准。
开发
pnpm install
node scripts/link-deps.mjs # 把宿主包链进本项目的 node_modules
pnpm build # tsc（host）+ vite（client）
pnpm typecheck # 只做类型检查
pnpm test # vitest，184 例
许可
MIT
