SensenMeng/dsh-plugin-8r

dsh-plugin-8r

8R 规则本地判定插件，用于 DeepSeek Harness（DSH）。

用户说话触发了 8R 时，AI 的回复自动带上加粗前缀：

诶！「早八」

（正文从这里开始……）

判定完全在本地完成，模型全程不知情：不打断思考、不污染上下文、不占 token，
性能开销可忽略。

安装

在 DSH 的 profile 目录中执行（例如 web profile）：

dsh plugin --profile web add https://github.com/SensenMeng/dsh-plugin-8r

dsh plugin add 会安装依赖并把 bundle 写进 dsh.profile.bundles（可手动核对
~/.dsh/profiles/web/package.json）。重启 DSH 后生效。

验证是否生效：发一句触发句，例如 早八，回复开头应出现 诶！「早八」。
诊断接口：http://127.0.0.1:3081/8r-status（事件计数器与 pending 状态）。

工作原理

用户消息 ──> agent/pre-step（判定主通道，必然可达）
│  内嵌 JS 判定器 judge(text)（与 Python 参考实现逐字等价）
▼  命中（should_e=true）→ pending 武装
AI 回复流 ──> llm/stream（全局瀑布）
▼  条件：sessionId 匹配 + 流内最后一条人类文本匹配
text-delta 与 block-end 双注入点（产出新 chunk 对象，兼容冻结块）
▼
chunk.text = '诶！「前五…后五」\n\n' + chunk.text   ← 机械拼接，模型不知道

关键契约（全部经运行时源码确认）：

- llm/stream 瀑布能到达会话级动态插件与 profile 插件；GenerateOptions.sessionId
与会话 id 对应（Agent.id === session.id 是运行时不变量）。
- 判定主通道是 agent/pre-step（该瀑布必然可达）；agent/inbox/inserted 与
session/event 'user/message' 作备份通道。注意 session/event 的 user/message
在 agent/pre-step 之后才触发（消息入日志时发射），因此 setPending 不得
重置 armed，否则会把 pre-step 刚武装的状态清掉（v5 修复）。
- 适配器在流末尾补发的 block-end 携带其内部攒的原始完整文本（不含注入前缀），
BlockAssembler 以它为最终内容（first-close-wins）——因此注入点必须同时覆盖
text-delta 与 block-end，且 block-end 分支不能被 !prefixed 外层守卫跳过，
否则前缀会「闪现后消失」（v6 修复）。
- 多步回合（带工具调用）时：第一个带正文的流注入；一次命中后 applied=true，
同回合后续流不再重复注入；失败重试会重新注入。
- 只对主会话生效：子代理消息（source=model）不判定，子代理流的 sessionId 天然排除。

8R 规则（v2.3 简述）

核心是末位辈分单位裁决：输入合法且去尾部标点非空时，从整句话最右端向左扫描，
忽略普通字符与标点，遇到的最后一个辈分单位（王位 λ）就是唯一裁决单位。

- 高辈分 D（die / ba / fu / ye 四系及数字 8）→ 诶
- 低辈分 E（er / zi / sun 三系及 2 / r / R）→ 不诶
- 复合低辈分 token 几把 / 曼巴 与 E 同级 → 不诶
- 没有辈分单位 → 不诶

完整规则与 Python 参考判定器见 8Rworld。

验证

npm test        # 或 node test/verify.js

- 86 条黄金用例全部通过（用例随仓库分发于 test/data/8r_strict_cases.json）
- 内嵌判定器与此前 29564 条模糊用例的 Python 参考输出逐字段一致

目录结构

index.js             插件本体（判定逻辑内嵌，无第三方依赖）
cordis.patch.yml     bundle 挂载补丁（dsh plugin add 自动应用）
test/judge.cjs        独立判定器副本（CommonJS，供验证）
test/verify.js       黄金用例验证脚本
test/data/           规则数据与用例（D/E 字集、86 条黄金用例）

已知边界

- 前缀会写进会话记录（流注入），刷新后仍在；是机械文本，模型与它无关。
- 会话压缩（compaction）改写历史后可能匹配不到原文 → 不注入（罕见）。
- 判定对象是用户消息全文（多文本块拼接）；附件/图片块不参与。
- 动态定义（cordis_define）不跨进程重启；profile 安装则随 DSH 常驻。

许可

MIT © SensenMeng