Skip to content

dsh-guard-degen

Verified

dsh-guard-degen · v0.1.1 · MIT · Web UI

Degeneration guard for DeepSeek Harness: detect and contain runaway symbol streams, verify writes, repair polluted artifacts and sessions

Install

dsh plugin add dsh-guard-degen

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-guard-degen

CI npm

退化守卫:给 DeepSeek Harness 装一道「模型符号流退化」的护栏,并附赠工件/会话的清理工具。

为什么需要它

某些模型(实测集中在 MiniMax 系列)在思考阶段会退化成单字符长跑,例如:

⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ ⇒ …

退化不一定是同一个符号的重复,也可能是多字符单元整段整段地重复:

⇒⇒§ ⇒⇒§ §

⇒⇒§ ⇒⇒§ §

…(整段整段地重复下去)

这种输出会一路写进会话文件、思考内容,甚至被模型自己写进仓库里的文档和源码。 一旦会话被污染,「继续」只会得到更多同样的符号流——会话本身已经不可用, 但文件里的污染会留给下一个会话,形成越积越多的脏工件。

本插件做四件事:

  1. 流式拦截——在模型输出到达界面前检测符号游程,按策略截断/消毒/删除,避免污染进入会话与磁盘。
  2. 写后校验——写文件类工具执行后回读文件,发现退化内容就阻断并把反馈回灌给模型。
  3. 重试与换模——退化导致请求失败时自动重试(同模型 N 次),必要时切换到指定模型。
  4. 工件与会话清理——扫描仓库与历史会话,产出报告,由你选择哪些要修(默认只预览,不写盘)。

流式守卫有四种处置方式,思考流与正文流各设各的:

方式 退化段怎么处理
off 不检测也不改:退化段原样流过去。
truncate(默认) 切断该通道,本轮以「退化」错误收尾。
sanitize 把退化段折叠成一个标记(〔退化符号流×N〕),本轮继续。
remove 退化段整段删掉,一个标记都不留,本轮继续。

remove 是最安静的一种:模型输出读起来就像退化段从来没写过。 被删掉的原文仍然记进判定流水作为证据,但与 sanitize 不同,它不可回退—— 流里已经没有东西可以写回去了。

工件治理覆盖两种退化形态:单个符号的游程,以及多字符单元整段重复 (例如 ⇒⇒§ ⇒⇒§ § 反复出现)。勾选条目后点「预览修复」,界面直接给出 红/绿对照(红=修复前的原文,绿=修复后的样子),确认无误再落盘。

「多字符单元整段重复」这一形态在四个地方都受治理,各有各的开关与份数阈值:

位置 开关 份数阈值 默认
工件修复 artifacts.unitRun artifacts.unitRepeats 开 / 4
流式守卫 stream.unitRun stream.unitRepeats 开 / 4
工具守卫 toolGuard.unitRun toolGuard.unitRepeats 开 / 4
会话遮蔽 sessions.unitRun sessions.unitRepeats 开 / 4

关掉某个开关,只是那一个地方退回「只管单符号游程」;其它地方照旧, 四道守卫互不牵连。份数阈值同理——四处各调各的,调大更宽松,调小更敏感。

安装

一条命令(包已发布到 npm):

dsh plugin --profile <你的 profile> add dsh-guard-degen

<你的 profile> 换成宿主实际使用的 profile 名(dsh web 通常是 web, 桌面端应用用的是它自己的 profile,名字未必相同)。

也可以直接从仓库装:

dsh plugin --profile <你的 profile> add github:chunqing286/dsh-guard-degen

也可以在 DSH 界面里点一下:插件 → 发现,添加索引源 https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json, 搜「退化守卫 / guard degen」,点安装。

装好之后,插件自带的 cordis.patch.yml 会作为 bundle 层被应用,宿主半边与浏览器半边一起装上, 运行时会话和设置页里立刻能看见「退化守卫」分区。

手动安装

不想用包管理器的话,在 $DSH_HOME/profiles/<你的 profile>/cordis.patch.yml 里追加一条 insert:

- insert:
    - id: guard-degen
      name: <指向插件目录的相对路径或包名>

name 里的相对路径以该 patch 文件所在目录为锚点(这是宿主 dsh-app-boot 的既定语义), 所以指向任何本地目录都可以;改成包名则需要该包能被解析(profile 的 node_modules 或安装自带包)。

走相对路径安装时,插件目录要能解析到自己的运行时依赖 (@deepseek-ai/dsh-typert-protocol、@deepseek-ai/schemastery,以及它们依赖的 @deepseek-ai/cordis、@deepseek-ai/cosmokit);走 npm 安装则由 npm 自动装齐。

也可以走 profile 的 bundle 机制:在 profile 的 package.json 里写 "dsh": { "profile": { "bundles": ["dsh-guard-degen"] } } 并把包列进 dependencies, 插件自带的 cordis.patch.yml 会作为 bundle 层被应用。

宿主侧插件的 Config 是原生 Schemastery schema,因此设置页会自动渲染出配置表单; 插件自己在 设置 里注册了一个独立分区 退化守卫(与「插件」并列), 分区下面有三个页签,每个页签各占一页(互斥显示,不会叠在一起):

  • 配置:全部配置的图形入口。
  • 日志:判定流水——每一次退化判定都记着命中了哪条规则、发生在哪个会话、 守卫做了什么处置。列表带会话ID与会话名称两列,可以按会话筛选 (下拉选会话,或按会话 ID / 名称做文本筛选);点一条记录能看检出的退化特征 (哪个单元重复了几次),以及红/绿对照(红=治理前的退化原文, 绿=治理后留下的东西:净化时是折叠标记,删除时是「什么也没留下」的说明, 截断时是「后面没有了」的说明; 没有自动治理时绿行写明「只记录判定,未改写」)。误报反馈入口也在这里。
  • 工件:工件扫描报告、被污染会话列表,逐项勾选后再修复。

会话列表同时给出会话标题和会话 id;选中会话点「预览遮蔽」后, 界面直接给出红/绿对照(红=遮蔽前原文,绿=遮蔽后的标记), 不用再去翻生成的磁盘文件。

会话遮蔽有两种内容方式,工件页与会话视图里都能切换:

  • 折叠成标记:把整段退化折叠成 〔退化内容已遮蔽×N〕。
  • 整段删除:整段删掉,不留痕迹(默认)——磁盘上的内容里一个字标记都不写, 对照视图的绿行显示的就是删完剩下的文字(符号是真的没了, 不是「被换成了某一句话」)。整条内容都被删光时,绿行会写明「整条内容被删空了」。

切换之后预览会立刻按新方式重算,所以不用先落盘再回头看文件。

遮蔽还分两种落地方式(工件页与会话视图里都能切换):

  • 另存为副本:把遮蔽后的内容写成新文件,原档不动。
  • 直接改写会话存档:两个页面默认都是这一种——遮蔽的就是眼前这个会话本身 (原档先备份),不用再去别处找一份副本。

会话视图里的「退化守卫」

会话页的视图行里除了「对话 / 轨迹 / 上下文 / 编队」,还有一个 退化守卫 视图 (与它们并列),针对的就是当前会话:

  • 工作区工件:扫描范围是当前会话所在的工作目录(由宿主从会话存档头里解析, 浏览器只传会话 id,不能自选目录),修的也是这个目录里的工件。
  • 当前会话:直接遮蔽当前会话存档里的退化内容,方式与工件页一致。

「执行遮蔽」默认就地改写当前会话:会话存档被原子替换(先写临时文件再改名), 原文件备份到 ~/.dsh/guard-degen/backups/,写完回读复核。

三件事要清楚:

  • 界面上的历史消息不会当场变——对话视图是宿主内存里的内容, 重新打开会话才能看到改写后的文本。
  • 进行中的会话会继续追加:改写之后宿主新写入的消息仍接在改写后的内容后面。
  • 落盘前会以最新内容重算:预览之后若又写入了新消息,遮蔽按最新内容重算一遍, 不会把新消息抹掉。

命令

命令 作用
/degen-status 看当前守卫状态、规则表、最近判定
/degen-scan [路径…] 只读扫描工件(默认扫当前工作区),产出报告
/degen-fix <文件路径…> 修复指定文件里的退化内容(先备份再改写)
/degen-clean 遮蔽当前会话里的退化内容(默认就地改写存档,原档先备份)
/degen-ack 把最近一次判定登记为误报,并调高对应规则阈值一档

配置要点

键 默认 说明
enabled true 总开关
modelIncludes [] 只守卫这些模型(留空=全部模型)
stream.reasoning truncate 思考流策略:off/truncate/sanitize/remove
stream.text truncate 正文流策略:off/truncate/sanitize/remove
stream.holdbackChars 256 保留窗口:判定前不立即放行的字符数
stream.maxInterventionsPerCall 1 单次调用最多干预次数(防止反复改写)
stream.unitRun true 流式守卫是否治理「多字符单元整段重复」
stream.unitRepeats 4 流式守卫里单元重复多少份才算退化
toolGuard.mode warn 工具参数里的退化:off/warn/refuse
toolGuard.scope all all/write-only/oversized-only
toolGuard.unitRun true 工具守卫是否治理「多字符单元整段重复」
toolGuard.unitRepeats 4 工具守卫里单元重复多少份才算退化
postExecute.enabled false 写后校验开关(回读文件,有 IO 成本)
postExecute.roots [] 限定校验范围;留空=工作区内
retry.policy same-model same-model/steer/no-retry
retry.maxSameModelRetries 1 同模型重试次数
retry.switchModel.enabled false 是否允许自动换模型(需显式给 provider+model)
artifacts.mode remove 修复方式:collapse(折叠成标记)/remove(删除)
artifacts.apply false 默认只预览,不写盘
artifacts.unitRun true 是否治理「多字符单元整段重复」这类退化
artifacts.unitRepeats 4 单元重复多少份才算退化
sessions.mode replace 会话遮蔽方式:copy(另存新档)/replace(覆盖原档)
sessions.maskMode remove 会话遮蔽内容方式:collapse(折叠成标记)/remove(整段删除)
sessions.unitRun true 会话遮蔽是否治理「多字符单元整段重复」
sessions.unitRepeats 4 单元重复多少份才算退化
logging.enabled true 判定流水落盘

运行时改配置会写 ~/.dsh/guard-degen/config.json(覆盖 profile 层的值)。

安全边界

  • 默认只读:工件修复与会话遮蔽的 apply 默认 false,预览阶段一个字节都不写。
  • 先备份后改写:真正落盘时先写 <文件>.degen-backup,备份失败就不动原文件。
  • 回读复核:改写后重新读文件数残留游程,残留不为 0 会报错,不会假装成功。
  • 按游程判定,不按单符号:★ 这类合法标记在真实仓库里存在,只有成串的游程才算退化。
  • 多字符单元重复才算数,且只在符号区里找:像 ⇒⇒§ ⇒⇒§ § 这样整段整段重复的内容 会另算一类退化(标记成 〔退化单元×N〕);判定要求单元里至少含一个非 ASCII 字符, 所以代码、表格、正常中文散文都不会被误判;单个符号的长跑仍归游程那条规则管, 两边不会重复上报。
  • 清完长游程剩下的碎片也要判:退化内容常是「长游程 + 碎片」交替的样子, 长游程被摘掉后碎片会贴到一起,拼出一个新的单元重复。 所以单元判定是在「摘掉游程之后的残渣」上做的,一遍治理就把两者一起清干净—— 否则回读复核会判「复核未通过」,用户等于什么都没拿到。
  • 浏览器端放宽不了阈值:游程长度、符号集、单元份数阈值一律取自配置, 绝不取自浏览器请求;页面要求更松的阈值会被忽略。
  • 工具调用参数默认不清理:会话遮蔽保留 tool-call 块逐字一致(配对关系不能破), 实测约 24% 的污染位于工具参数内,因此不会被清除——这是有意的取舍。
  • 只改模型自己产出的内容:会话遮蔽仅处理 assistant/message(含 compaction 摘要) 里的文本与思考;用户提问、系统提示、工具结果一律原样保留。
  • 不越界写:工件扫描/修复受 artifacts.roots 约束(默认当前工作目录), 显式传入的文件列表也不能绕过根目录;符号链接目标与非 UTF-8 文件一律跳过。 /degen-fix 会把根目录绑到你点名文件的所在目录,所以工作区以外的文件照样能修, 但那棵树里的其它文件一个都不碰。
  • 浏览器端不能指定落盘位置:远程方法只透传白名单参数,输出/备份/审计路径由插件决定; 遮蔽副本、备份、审计分别写在 ~/.dsh/guard-degen/{masked,backups,audit}/,不落在会话目录里; 遮蔽只接受 ~/.dsh/sessions 之内的目标。
  • 没有退化就不落盘:会话里一段退化都没有时,遮蔽不会改写存档,也不会产生备份。
  • 游程跨两个块时切断整条流:宿主按块推送 delta,已经放行的内容收不回来。 所以游程头部已经放行时,守卫切断整条流而不是只折叠尾巴—— 半折叠的标记既会少算符号数,又会把原始符号留在正文里。 代价是这一段回答被截断,这正是该有的失败姿态:这条会话本来就要重开。
  • 标记计数与正文一致:宿主 assembler 里 block-end 的文本才是权威值, 所以 〔退化符号流×N〕 也会在权威文本里同步改写——存档里的计数等于真正清掉的符号数。
  • 符号链接目标一律不遮蔽:目标是符号链接的会话文件直接拒绝(即使它解析后仍在会话根目录内), 根目录判定又按真实路径比较,根目录里的链接改不动根目录外的文件。
  • 干预上限用尽就截断,不放行:单次调用的改写次数用完后再遇到退化,流会被截断并以 error 结束——原始符号不会有机会进入会话。
  • 配置不会带坏自己:setConfig 先校验合并后的整体,非法值不落盘。
  • 跳过的文件会被说出来:单文件超过 artifacts.maxFileBytes(默认 8MB)时不会检查, 这些文件会列在扫描报告的 skippedTooLarge 里并在界面提示——「没扫到」不等于「没问题」。

开发

node --test test/*.test.mjs

测试不依赖宿主运行时(除少数需要真实 cordis 的集成检查外)。

独立校验脚本在 verify/(用同一个 node 跑):

脚本 证明什么
check-patch-config.mjs 自带的 cordis.patch.yml 与 schema 默认值一致
check-host-load.mjs 宿主类在真实 cordis 里能实例化,13 个远程方法都在
check-host-entry.mjs 宿主半边能在真实 cordis 上装载并起监听
check-remote.mjs 远程方法标记能被真实协议包识别
check-package-files.mjs 包清单指向的文件都存在(npm pack --dry-run 的等价物)
check-mutations.mjs 每处修复都被用例钉住:改回缺陷状态必有测试变红
check-remove-mode.mjs 「整段删除」模式下磁盘上不留任何痕迹