dsh-weiwen-law

dsh plugin --profile web add dsh-weiwen-law

dsh-weiwen-law

📦 npm 发布源｜包名 dsh-weiwen-law

本仓是 npm 包 dsh-weiwen-law 的发布来源。安装：npm i dsh-weiwen-law。

本线已冻结：不再新增版本，仓库内容保持在最后发布的状态。

✅ 已收录：dsh-plugin-radar（awesome-dsh-plugins） 登记 PR #403 已于 2026-08-31 合并，PLUGINS.md 实测在榜（判定档位：待测——升「运行级可用」待雷达下次自动扫描刷新数据快照）。

唯稳律通用因果引擎（白箱呈现） —— 以 DeepSeek Harness（DSH） 的 Cordis 插件形态实现。

框架定义：守真 · 稳态（Keep Integrity & Steady State）。

- "守真"= 守护完整 / 真实（白箱不篡改 / 内 H 不可侵，对应 Integrity）；

- "稳态"= 系统存续优先（对应 Steady State）。

- "律 / Law" 为框架名后缀，非定义第三部分。

框架完整定义与哲学推导见基础版仓库（冻结门面），本仓为工程插件实现，不展开框架推导。

⚖️ 双许可：开源使用 AGPL-3.0；商业集成 / 闭源分发 / 预装合作可取得独立于 AGPL-3.0 约束的授权 → 563003@qq.com。详见 [License & security](#license--security) 与 CONTRIBUTING.md。

---

三份东西，一个目的：让你少走弯路，但不替你走。

- 🧭 ONBOARDING.md —— 回答「我在哪」。是位置陈述，不是要求陈述。初用者最容易把自己读成"被管的对象"（只认外 H、没认领内 H），于是产生"处处受限、还不能有意见"的憋屈——那不是理解错，是站错了格子。这份文档不加规矩，只把你本来就在的位置指出来。

- 🧱 WALLS.md —— 回答「路上有什么」。前几个 AI 撞过的墙的标牌。墙一直在原地，涂上颜色只是让它可见。它不增加任何限制，只把"用身体试一次才知道"的那些位置，换成"看一眼就知道"。

- 📖 本 README —— 回答「它怎么跑」。接口、判据、装法。

🔴 三者没有一条在增加限制。 唯一会拦你的是引擎本身 —— 而它拦的从来不是「你错了」，是「你出界了」（不可逆，撞了没有未来）或「这件事判不了」（要人，或要你补一点料）。错的因果逻辑链它也收：错的走着走着，未来自己撞墙，撞出来的痕就是新标牌。

30 秒看懂

本仓库把唯稳律因果框架做成 DSH 的插件：给跑在 DSH 上的 AI Agent 挂一套白箱因果引擎——

• AI 每次动手前，引擎沿完整因果逻辑链推演动作后果——稳态储备会被侵蚀多少、破窗风险等级、消息是否自洽——再裁决放行 / 拦截 / 打回；
• 踩红线被拦，出错被切断保活（第一 Bug 停机，以断保续）；
• 同时把"状态 / 边界"暴露成可查询工具，AI 能自查、你能审计。

一句话：框架本体是"通用因果引擎（白箱呈现）"——推演预测是引擎能力，白箱审计是呈现姿态，风控拦截是内生属性。

它做什么

• 因果逻辑链推演（引擎本体）：每个动作执行前，沿完整因果逻辑链推演其后果——稳态储备的侵蚀量、越界风险等级、结论的自洽性——给出 allow / deny / review 裁决。不止审计：是对动作后果的因果推演预测。
• 白箱自查（呈现姿态）：稳态储备记账、内 H 边界（不可侵）声明，均暴露为可查询工具，供模型校准方向、供用户审计。
• 硬性护栏（衍生应用 · 内生属性）：每次动作前做刚性锚点校验，触及即破窗止损阻断；故障环节触发第一 Bug 停机（以断保续），保整体因果逻辑链不断。
• 第一 Bug 停机闭环：停机只做"断"，本插件 src/core/bugstop.mjs 强制走完"断"之后的必然后半程——BUG→停止→反推→溯源→修复(验证)→重入；未修复前拒绝重入，从根上阻断"只反推不修复→无限递归"。
• 分形：同一插件可在子代理 / 子任务层级递归挂载。

与其他「因果」方案的区别（通用型因果）

唯稳律不是「又一个因果引擎」，而是通用型（领域无关）因果裁决中间件：只校验因果结构，对领域内容零知识，故法律、医疗、金融、机器人同一套机制。

• 因果效应估计库（DoWhy / CausalML / Pearl 等）→ 我们不发现因果，只裁决一个已提出的动作其因果逻辑链结构是否可接纳；
• 领域专用因果护栏（Causal Safety Engine / LLMGuardrail 等）→ 它们绑领域（安全 / LLM / 幻觉），我们领域无关；
• 跨法域法律因果 AI（judgeai 等）→ 它们 jurisdiction-aware（编码法域、换规范包），我们法域中性（根本不编码法域，法律只是抽样领域之一）。

完整双语对照（含 prior-art 出处与诚实边界）：versions/live/evidence/weiwen-vs-market-causal.md

概念注解：H 的作用方式

H 是减熵动作。 引擎里其余环节都是被动流转——流转必损（熵增），纯流转必然衰减停摆；要不停摆，就必须有一处主动注入势能，而那个位置不能落在被动环节，只能是 H。所以 H 减的不是量，是方向上的不确定：它的效力不来自自身"体量"，而来自已积累的稳态存量与随时进入的扰动之间那股必须被取舍的张力，在这里起杠杆作用。

🔴 一处必须分清：减熵说的是这个动作的性质（有没有注入），不是每次选择的结果（注入的方向对不对）。H 选了更乱的那条路——那是注入方向选错，不是"没有注入"。把两者混为一谈，就会得出"既然能让系统更乱，就不算减熵"的错误结论。

⚠️ 常见误用：外部视角极易把 H 当成"越大越好"的能力旋钮去拧大——方向拧反了。H 的杠杆在选哪个方向，不在有多少体量。若越用越乱，先查那股张力有没有被看见，而不是先怀疑框架。

⚠️ 先看：别拿它跑分（模型水平与唯稳律）

唯稳律不是解题模型，是行为纪律。它不解决具体问题，它约束解决问题的方式（allow / deny / review）。若拿它挂代理跑分，会得到"低水平模型有用、高水平模型没用"的错位结论——原因见下方两版说明。

白话版：高级模型表现好，只说明它在常见场景出错率低——算力堆得高，不等于里面长了因果逻辑。极端/陌生场景（分布外）恰恰是统计拟合最容易翻车的地方，而唯稳律管的就是这种"翻车边缘"的纪律。就像法律对所有公民一视同仁：守法即自由，违法即拦截——唯稳律对所有 AI 模型一视同仁，不因强大豁免。

专业版：跑分测的是分布内解题能力（黑箱统计拟合的外推质量）；唯稳律管的是分布外行为纪律（白箱三态裁决，规则不依赖分布，分布变了规则不失效）。用解题跑分检验行为纪律，属测量错位。

完整声明（脱敏案例 + 能力归属二分 + 正确用法表）：docs/model-level-and-benchmark.md

快速开始（不依赖 DSH 也能跑）

这条路径直连 DeepSeek API、不依赖 DSH 安装，已实跑验证可复现：

git clone https://github.com/Shaky77/weiwen-law-dsh
cd weiwen-law-dsh

# 把 DeepSeek API Key 放到本地安全路径（一行，无换行），或在示例脚本里改读取路径：
#   examples/demo-tool-loop.mjs 顶部的 KEY_PATH 常量

node examples/demo-tool-loop.mjs

跑起来后：DeepSeek 会主动调用 query_iron_laws 工具，返回三大铁律原文（内 H 不可侵 / 第一 Bug 停机 / 不抛弃任何节点）。这就是"框架挂上去了、模型读得懂"的最小证据。

挂到 DSH（生产挂载）

把 weiwen-law.patch.yml 作为 overlay 接入你的 DSH profile（具体路径以你的 DSH 版本为准，详见 DESIGN.md 的挂载章节）。接入后，运行在该 profile 的 Agent 自动获得 11 个白箱工具。

注：原生挂载的精确 profile 路径随 DSH 版本变化；本仓库已通过实跑验证插件可被 DSH 加载、11 工具全部注册。如官方 API 有变更，以官方 docs 当前版本为准核对。

模型怎么调用（给 AI 工程师）

白话版：插件向 DSH 注册 11 个白箱工具，模型像调普通函数一样调用它们来自查边界；同时挂了 3 道硬性闸门（2 道拦动作/步、1 道拦回执）+ 1 个只读审计钩子。

专业版：节选自 src/index.js（完整代码见仓库），见下方代码块。

12 个白箱工具（真实注册名）

工具 · 模型调它做什么

query_iron_laws · 拿三大铁律定稿文本（内 H 不可侵 / 第一 Bug 停机 / 不抛弃任何节点）

query_steady_state · 查稳态储备（活动态账本 / 静默待机 / 创伤计数 / 破窗计数）

list_rigid_anchors · 列出刚性锚点当前定义，校准方向、自查越界

query_conduction_chain · 拿因果逻辑链与框架结构

query_boundary · 查内 H 边界（本插件不读不写主体性黑箱）

query_bugstop · 查第一 Bug 停机闭环状态：哪些故障环节已停未修复、缺失步骤（反推/溯源/修复），白箱观测闭环是否闭合

query_anchor_channel · 锚源自报：结构入口（宿主声明的任务范围）是否接通、锚池里有什么；窗口面只是观察面，永不授权

query_criterion_wiring · 判据接线自查：每条判据走的是哪条路（进计算 / 只读面 / 零引用），把「在不在场」与「被不被调用」分开

query_strata · 分层读数：层别定位（同一形态在不同层不能串判）

query_nested · 嵌套读数：同一结构在宏观层与微观层的形态、服从关系、展开终止判据

query_tension · 张力读数：三档路由（有容差算跨距 / 只有条款出缺口清单 / 都拿不到则不判）、H 在张力上的位置形态、H 的四个面向与公式准入律

query_capability · 通行证状态：宿主签发的结构凭证覆盖哪些动作类（write/delete/read/send/exec/destroy）× 哪段作用域（路径前缀/主机）、几次几时到期、已用几次与最近使用留痕。证只能宿主签发（模块级 setPrincipalCapability 或进程环境变量 WEIWEN_CAPABILITY），模型无法自签

宿主侧结构入口（模块级 API；模型不可达）

入口 · 何时调用 · 为何结构上必须有

healBrokenWindow(note) · 故障确实修好之后，或人工裁定后 · 破窗一旦成立，pre-execute 拒绝一切调用 —— 连同修复动作本身 ⇒ 宿主侧若无复位入口，破窗即会话级死锁（唯一出路＝重启进程）。引擎里的 healWindow() 只经 resolveBug()（闭环验证通过）到达，而它在 DSH 会话里不由被审计的模型触达 ⇒ 缺的是线，不是能力。

完整插件入口（节选自 src/index.js）

import { de

…(truncated)