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