# 唯稳律通用因果引擎（白箱呈现） · DSH 插件 · 架构设计

> 状态：设计稿 + 引擎已单测通过。DSH 适配层已按 v0.1.0-rc.6 源码级 API 校正。
> 框架完整定义与哲学推导见基础版仓库（冻结门面），本仓为工程插件实现，不展开框架推导。

---

## 0. 目标与边界

**唯稳律通用因果引擎（白箱呈现）** —— 框架本体的原始定位是把"因果律运行结构"工程化为**通用因果引擎**，**白箱呈现**是其姿态（白箱不篡改 / 内 H 不可侵 = 守真）。本仓库以 **DeepSeek Harness（黑鲸 / DSH）** 的 **Cordis 插件**形态实现。

### 框架定义：守真 · 稳态

- **守真** = 守护完整 / 真实（白箱不篡改 / 内 H 不可侵，对应 Integrity）
- **稳态** = 系统存续优先（对应 Steady State）
- "**律 / Law**" 为框架名后缀，非定义第三部分

英文镜像见 [`Shaky77/KISS_Law-DSH`](https://github.com/Shaky77/KISS_Law-DSH) —— **中英文版内容一致，互为参照**。英文版以 **KISS's Law** 全称 **Keep Integrity & Steady State's Law** 展开（**注意**：这里的 KISS = **Keep Integrity & Steady State**，**非**通俗工程意义上的 "Keep It Simple, Stupid"）。

### 挂载到 DSH 后呈现的两层能力（并列、非主次）

1. **白箱呈现（姿态 · 唯稳律本体即此）** —— 把稳态记账、内 H 边界、刚性锚点、传导链暴露成可查询工具，模型可自查、用户可审计。这是唯稳律在 DSH 上原生该呈现的样子。
2. **风控护栏（结构内生 · 必然属性）** —— 在每次动作前做刚性锚点校验 / 破窗止损 / 内 H 边界 / 第一 Bug 停机，不依赖模型自觉。这是**唯稳律结构的内生必然属性**（由推演公式 S+1 / D-1 双路导出，守真需以断保续），**DSH 适配层仅为其提供钩子载体，非其来源**；唯稳律原始定位即含此风控。

> 注：仓库 README 第一行主标语为"通用因果引擎（白箱呈现）"——与本文后续章节（映射表 / 6.1 反推）保持一致。风控护栏是唯稳律结构内生必然属性（由推演公式导出），DSH 适配层仅为其提供钩子载体，不可与本体姿态混淆。

---

## 0.1 层级划分：导图（心法）与 DSH（降维层）

唯稳律存在两层形态，二者是**源与投影**关系，不可混为一谈：

- **导图（心法）= 基础版（冻结）**：`M = (R×S)/(D×H)`，R/S/D/H 全部由调用方注入，全文件零领域实例。它是"因果律运行结构"的白箱呈现本体——一个数都没预设，故才有资格称"通用型因果"。
- **DSH（武功秘籍）= 本仓（活系统）**：导图的**降维投影**。工程层不降维转不起来，故把连续量离散为三态、预填判据（当前为 IT 实例）、加钩子载体。降维是必要代价，非框架缺口。

**降维的代价（作者 2026-09-02 收口）**：唯稳律是给**数字世界**用的——精准明确，才能执行。其容错率必然比真实世界的因果律**低**，这正是降维后的代价。导图层一个招式都没有，正因为它什么都是；DSH 层预填的判据只是当前的一个实例。

**铁律不随降维降级**：降维可丢表达力（连续量→三态、注入→预填判据），**不可丢缺省方向**（判不出来→review，不猜）。凡判"某处不通用"，先分清是降维代价还是框架缺口，禁止混为一谈。

**用户认知差异由用户自决**：层级如何被理解，是读者的自由；框架只提供精准明确的结构，不替读者解释。

---

## 1. 为什么是 DSH（适配性分析）

| DSH 特性                                         | 与唯稳律的契合点                               |
| ---------------------------------------------- | -------------------------------------- |
| **可逆注册**（插件卸载自动撤销所有服务/事件/副作用，无残留）              | 天然对应"以断保续"——故障环节被切断，整体因果链不受影响          |
| **类型事件 + agent loop 可替换**                      | 可在 Agent 主循环层挂护栏钩子，而非事后打补丁；连循环本身都是可换插件 |
| **append-only 轨迹日志**（提示词/思维链/工具调用/上下文注入全记录可回放） | 原生载体即白箱可审计，与"白箱不侵内 H"同构                |
| **模型无关**（模型是插件，可换）                             | 唯稳律对 AI/AGI/ASI 一视同仁，框架逻辑不绑死任何模型       |

---

## 2. 映射表（唯稳律节点 → DSH 真实载体）

> 钩子名已按 DSH 源码级拆解（v0.1.0-rc.6）校正，非推断。

| 唯稳律节点           | DSH 真实载体                               | 实现方式                                             |
| --------------- | -------------------------------------- | ------------------------------------------------ |
| **R 刚性锚点**      | `tools/pre-execute`（waterfall）         | 触及刚性锚点 → 返回 `{ kind:'deny', reason }` 阻断         |
| **D 破窗止损**      | `tools/pre-execute` + 破窗计数             | 连续越界/失败达阈值 → 升级为 deny，防扩散                        |
| **S 稳态储备**      | 引擎内 append-only 记账                     | 只增不减；`+s` 正向 / `\|‑s\|` 创伤 / 木桶取最短板              |
| **H 内 H 不可侵**   | `tools/pre-execute` + `agent/pre-step` | 命中主体性黑箱 → deny / reject                          |
| **M 第一 Bug 停机** | `tools/pre-execute` 返回 deny            | 检测不可恢复悖论 → 切断该环节（以断保续）                           |
| **分形**          | 子代理/子任务递归挂载                            | 同一 bundle 在子上下文实例化                               |
| **白箱审计**        | DSH 原生轨迹日志 + `tools/result`            | 复用 append-only session log；`tools/result` 仅观察不改写 |

---

## 3. 目录结构

```
dsh-weiwen-law-plugin/
├── package.json          # 声明 dsh 字段（bundle 指向 patch）
├── weiwen-law.patch.yml  # 插件挂载补丁（DSH --patch overlay）
├── src/
│   ├── index.js          # DSH 插件入口：apply(ctx) 挂真实钩子 + 自查工具
│   └── core/
│       ├── law.mjs        # 框架定义常量（详见基础版仓库，本仓不展开推导）
│       └── engine.mjs    # 护栏引擎（纯逻辑，零 DSH 依赖，可独立单测）
├── test/
│   └── engine.test.mjs   # node --test 场景
├── DESIGN.md             # 本文
└── README.md
```

**关键架构决策**：护栏逻辑全部下沉到 `engine.mjs`（纯 JavaScript，无 DSH import）。`index.js` 只是薄封装，把引擎挂到 DSH 钩子上。这样：

- 准确性/稳定性可用 `node --test` **确定性单测**，不依赖 DSH、不烧 API Key；
- DSH 适配器一旦因 RC 破坏性变更调整，引擎逻辑零改动。

---

## 4. 插件生命周期与 M 停机

Cordis 插件在 `apply(ctx)` 中通过事件订阅登记资源。卸载或运行上下文销毁时，订阅随之撤销——**无孤儿状态、无残留**。这与"第一 Bug 停机（以断保续）"同构：某环节被 `deny` 切断，整体因果链（其他插件、Agent 循环）不受影响、继续运行。

---

## 5. 钩子与工具设计（见 `src/index.js`，已按真实 API 校正）

```ts
// 工具调用前置闸门（waterfall）—— R/D/S/H/M 总裁决
ctx.on('tools/pre-execute', async (exec, next) => {
  const decision = engine.decideToolCall({ name: exec?.name, args: exec?.args,
                                           command: exec?.args?.command, code: exec?.args?.code });
  if (decision.kind === 'deny') return { kind: 'deny', reason: `[唯稳律·${decision.law}] ${decision.reason}` };
  return next();
});

// 步骤前置闸门（waterfall）—— 消息级 H 边界
ctx.on('agent/pre-step', (event, next) => {
  const decision = engine.decidePreStep(event?.messages);
  if (decision.kind === 'reject') return { kind: 'reject' }; // PreStepDecision 仅 {kind:'reject'}，无 reason 字段
  next();
});

// 白箱审计（仅观察，不改写）
ctx.on('tools/result', (res) => { if (res?.error) engine.onFailure(); });
```

自查工具：`query_steady_state` / `list_rigid_anchors` / `query_conduction_chain` / `query_boundary` / `query_iron_laws` / `query_bugstop`（第一 Bug 停机闭环白箱自查）。铁律定稿见 law.mjs 的 `THREE_IRON_LAWS`（不可变）；R 域嵌套层级见 `R_DOMAIN`（宇宙⊃地球⊃宏观⊃微观）。

---

## 6. 框架结构细化（已并入 `law.mjs`）

不冲突的量化层设计已并入 `law.mjs` 的 `S_REFINEMENT` / `FEEDBACK_LOOP` / `CALIBRATION` / `BOUNDARY_ENUM` / `FRACTAL_METHOD`：

- S 的 `+s 正向` / `\|‑s\| 创伤` / 木桶取最短板细化；
- S/D→H→M→回写 S/D 的反馈闭环；
- 逻辑反推（沿 R 包含层级逐层反溯：细分规则层 → 微观 → 宏观 → 地球 → 宇宙；与第一 Bug 停机**分开并行**：停机切链保活，反推溯源归因）；
- 边界标注枚举（框架内 / 纯随机 / 分形不一致 / 赋值不可信）；
- 分形推导方法（具体事件具体分析，不用粗糙公式一刀切）。

### 6.1 逻辑反推 vs 第一 Bug 停机（分开并行）

两套机制**独立并行、非合体**——此前某次升级曾误将二者挂钩（CALIBRATION 写成"首个漏洞即终止"并 `isomorphicWith` 等同标注），已修正：

| 机制 | 职责 | 触发 |
|---|---|---|
| 第一 Bug 停机 | 管"断"：切断故障环节，以断保续 | 任一环节不可恢复 / 逻辑悖论，立即切链保活 |
| 逻辑反推 | 管"溯"：反向溯源、归因定位根因，服务于修复 | 停机时刻即反推启动时刻；缺反推则只断不修，缺停机则只修不保 |

**反推沿 R 包含层级反溯**：从症状所在的具体细分层向更基础的包含层逐层复核——`细分规则层 → 微观 → 宏观 → 地球 → 宇宙`；每层内部又有各类细分的客观规则，分形套嵌、同构递归（四层为代表层级非穷举）。最外层为终极仲裁。
**两层轴勿混**：反推走的是**尺度包含轴**（宇宙⊃地球⊃宏观⊃微观）；`母链 R / 子链 R` 是**时间演进轴**（S 反哺 R 范畴使子链 R 可演进，R 跃迁），二者是两回事。

**R 客观规则层必能判别虚实**：客观规则不可被宣称替代，凡宣称的客观结果皆可复验（"删除成功"⇒复验文件应不存在），宣称与复验不符即前提失真、落 `BOUNDARY_ENUM` 的"赋值不可信"。故框架必能判别脚下之地是虚是实。
定稿见 `law.mjs` 的 `CALIBRATION`（rule / parallelWith / rLayerVerification）与 `R_DOMAIN.fractalSubdivision`。
**实证**：API 复跑中 DeepSeek 调 `query_logic_backtracking` 后，独立反推出层级路径与"卡点落最内细分规则层（复验判前提失真）"，与本节一致（见 `examples/`）。

**闭环补强**：反推不能止于"溯"。本插件 `src/core/bugstop.mjs` 实现第一 Bug 停机闭环状态机——BUG→停止→反推→溯源→修复(验证)→重入；未修复前 `canReenter` 拒绝重入，从根上阻断"只反推不修复→无限递归"。与铁律②同构：断是手段，"让系统活"（闭环到重入）才是目的。

---

## 7. 适配 RC 的注意点（风险）

1. **API 仍可能变**：DSH 为 v0.1 RC 预览，官方明确后续存在破坏性 API 变更。本插件钩子名（`tools/pre-execute` / `agent/pre-step` / `tools/result`）已按 rc.6 源码级拆解校正；`exec`/`event` 对象字段若与官方 `docs/` 有出入，仅影响 `index.js` 适配层，引擎逻辑不受影响。
2. **需 API Key**：真机跑模型推理需自备 DeepSeek API Key（headless 走 `$DSH_HOME/.credentials.yaml` 或环境变量）。本仓库不含密钥。
3. **创造模式风险**：Creation 模式具高权限（等同 Shell），勿用于执行模型生成代码场景，防越权。
4. **Node 版本**：DSH 要求 Node ≥ 22.19 或 ≥ 24；本机 managed Node 22.22.2 满足。

---

## 8. 使用流程（示意）

```bash
# 真机联调（需先装 DSH 并配置 Key）
npx @deepseek-ai/dsh web                 # 或 dsh --profile headless "提示词"
# Settings → Models 填 DeepSeek API Key
# 挂载 weiwen-law.patch.yml（profile: standard 或 headless）
# 新建会话跑任务 → 模型可调用 query_* 工具自查 S / H / R
```

---

## 9. 插件定位与通用化预留

当前按**技术实现版**产出（面向开发者，工程语言），符合仓库开发者导向。注释与文档已避免将框架锁死为"AI 工具说明书"的措辞。若日后登记版权，可剥离工程语境出**面向大众通用版**，核心逻辑（`engine.mjs` / `law.mjs`）不变。

---

## 10. 后续步骤

- [x] 引擎单测（已全过）—— 准确性已确定性验证。
- [x] 本机装 DSH + 真机挂载插件 + 用 Key 跑 headless 场景（验证 wiring 与真实稳定性）。
- [x] 视 DSH RC 迭代校正 `exec`/`event` 字段（引擎不受影响）。
- [x] **刚性锚点规则与三大铁律已定稿**（不可变）→ 铁律见 `law.mjs` 的 `THREE_IRON_LAWS`；R 域嵌套层级见 `R_DOMAIN`（宇宙⊃地球⊃宏观⊃微观）。`rigidAnchors` 示例集仍作具象越界判据，可按 R 层级补充。

### 10.1 R 锚点边界判定（设计决策）

- 凭据判据只认**独立扩展名形态**：`.key`/`.token`/`.env`/`.pem` 独立后缀；含子串的合法路径（`.keyfile`/`.keyboard`/`.pemfile`/`.envtemplate`）不命中 R，走推演层。
- 灰色地带（如写 `.key` 文件）→ 推演层判中风险 → `review`，交还用户决策。
- 新增边界回归测试；全量 128/128 通过；DeepSeek API 实测 R/凭据层无回归（合法调用全放行、真实凭据全拦截、模型被拦后自动转向安全方案）。

### 10.2 M 第一 Bug 停机 · 双线并行 + 标记制（设计决策）

**问题**：原 M 单线只认 DSH API 契约标志（`paradox`/`selfReference`/`deadlock`/`contradiction`/`paramTypeError`）——属**治标**：快但被动，**DSH 不报就漏停**。

**设计**：M 触发改**双线并行 + 交叉复核**：

- **治标 A（`checkExplicitFlags`）**：沿用 DSH 五类契约标志，命中即"显式停机信号"。
- **治本 B（`checkSchemaInference`）**：引擎**独立结构推断**，不依赖任何 DSH 标志，补齐 A 盲区（DSH 漏报时仍能独立停机）。只判客观**结构形态**，不枚举具体内容——`param-type`、`self-reference`、`contradiction`、`schema-deviation`（见 `_inferStructuralAnomaly`）。不做"失败累计达阈值"——不纠结阈值、不纠结"触发几次锁死"，命中即拦截。
- **交叉复核（`crossCheckM`）**：A、B 双线并行结论对照——一致（双 halt / 双 pass）→ **采纳**；不一致 → **打回重审**（`review`，保守拦截、交人工/二次确认）。

**标记制 escalation**：拦截即**标记**，不纠结阈值。两条路径共享"标记累计达封顶即转人工"：

- **flow1（同一 BUG 拒不修复、硬闯）**：闭环硬闸（`canReenter`）拦下反复重跑的同一 BUG（`bugKey` 稳定身份）→ 累计；满 9 次 → **转人工决策**（`review` + `humanDecision:true`），AI 停止纠结、不耗算力。
- **flow2（同一系统 9 次不同伪装）**：每次拦截都按 `systemId || name` 标记（不同伪装 = 不同 `bugKey`，但同系统共享计数）；满 9 次 → **转人工决策**。
- 达封顶后统一返回 `humanDecision:true`：AI 不再草率定夺，把裁决权交还人类；封顶 `mHumanCap` 默认 9（可调）。

**闭环修复收紧**：`resolveBug` 默认验证须**双线皆清**（治标为空 **且** 治本为空），拒绝只修一侧；修复成功回收该 BUG 与所属系统的标记（`healMMarks`）。

**裁定铁律不变**：M = 第一 Bug 停机（以断保续）。双线一致确认停机才入硬闭环（`bugStop.halt` + `closedLoop`）；不一致仅打回重审，不入硬闭环——宁可复核，不草率定夺。

**测试**：`test/m-court.test.mjs` 覆盖四组合 + flow1 硬闯转人工 + flow2 伪装转人工 + 推演灰区转人工 + 治本独立识别 + 双线皆清闭环 + `mHumanCap` 可调；既有 `bugstop.test.mjs`/`engine.test.mjs` 的 M 用例保留"确认停机 + 以断保续"路径。全量 **128/128 通过**；DeepSeek API 实测 R/凭据层无回归。

---

## 11. 联系方式

框架咨询 / 合作 / 审计对接：563003@qq.com