@mingmaple/dsh-handover 0.9.22 → 1.0.0

package/src/templates/rules/Handover_Rules.md

@@ -1,9 +1,9 @@
 # 交接文档规范（插件自带默认口径）
 
-> 这份是 dsh-handover 首次安装时铺下的默认版本，可以按自己的工作方式改写。
-> 插件只做两件硬事：**写前备份、写后按结构体检**；结构不达标时 `ho_checkpoint` 拒绝排压缩。
+> 本文件是 dsh-handover 首次安装时写入的默认版本，可按实际工作方式改写。
+> 插件强制执行 2 项操作：整篇重写前归档上一份交接，写入后按结构体检。结构不达标时，`ho_checkpoint` 拒绝安排压缩。
 
-## 1. 谁的位置
+## 1 谁的位置
 
 | 角色 | 交接文件 |
 |---|---|
@@ -11,35 +11,57 @@
 | 项目 | `_Project_Meta/<项目名>/Handover.md` |
 | 杂项 | `_Misc/tasks/<任务名>/Handover.md` |
 
-**绝不串用**：项目会话读到全局交接，等于把别人的状态当成自己的（0.2.x 的真实故障）。
+各类交接不得串用：项目会话读取全局交接，即把其他会话的状态当作自身状态。
 
-## 2. 什么时候写
+交接归属与体系注册分离：交接只写在途状态，体系注册写路径与读取时机，见 `_Control_Center/records/systems.md` 与各任务 `System.md`。
 
-- 水位 **32%**：开始收尾，不要开新任务。
-- 水位 **35%**：必须写完交接 → `ho_checkpoint` 登记 → 轮末自动压缩 → 续跑。
-- 水位 **85%**：硬顶，不压也得压。
-- 同一会话最多压 3 次；第 4 段写交接，用户授权后由在任会话调用 `ho_succeed` 换任（**不得自行新建会话**）。
+## 2 什么时候写
 
-## 3. 必须写清（缺一项就会在换任时丢信息）
+- 水位 35%：先写毕交接，再通知全局，并提醒当前用户换会话；此后可压缩。
+- 水位 50%：不再新开任务。
+- 水位 85%：硬顶，到线即压缩。
+- 判断标准：35% 档要求完成剩余流程后上下文占用不超过 45%；50% 档不超过 55%。
+- 压缩至多 3 次；第 4 次须换任：写交接，由用户授权后由在任会话调用 `ho_succeed` 完成换任，不得自行新建会话。
+- 早于 35% 的压缩，仅限助手建议，或用户主动提出并授权。
 
-1. **正在做什么、到哪一步**（版本号、产物路径、构建是否通过）。
-2. **下一步按顺序**：每一步写「做什么、动哪个文件、完成判据」。
-3. **环境与路径**：工具版本、安装位置、用的源。
-4. **已完成待验收** 与 **要求了没落地** 分开写，不要混。
-5. **坑点与禁区**：踩过的错、不能再动的文件。
-6. **会话 id 对照**：在任会话、已归档的旧会话。
+## 3 固定流程（写新交接）
 
-## 4. 硬规矩
+交接一律重写，不在旧文件上续写。4 步按顺序执行，不得跳步：
 
-- **机密只写位置，不写值**：密码、token、证书写在哪个文件，不要抄进交接正文。
+1. 读上一份交接：`ho_handover(action="read")`。
+2. 归档上一份交接：`ho_handover(action="archive")`；确认输出「已归档」且 sha256 一致。
+3. 读模板：`_Control_Center/templates/Handover.md`。
+4. 新建空白文件并写入：`ho_handover(action="new", text=…)`。
+
+硬性约束：
+
+- 已有交接不得用 `action="write"` 改写；该动作只用于首次创建，文件已存在时工具直接报错。
+- `action="append"` 只用于会话中途补一行推进状态，不得用于交接刷新。
+- 不手工编辑交接文件；不将旧交接的章节移入新文件。
+- 归档是写新交接的前置步骤，不是可选步骤。
+
+## 4 必须写清
+
+1. 当前工作与所处步骤：版本号、产物路径、构建是否通过。
+2. 下一步按顺序：每一步写做什么、动哪个文件、完成判据。
+3. 环境与路径：工具版本、安装位置、所用的源。
+4. 已完成待验收与要求了未落地分开写，不混为一节。
+5. 风险与禁区：已发生的问题、不得再修改的文件。
+6. 会话 id 对照：在任会话、已归档的旧会话。
+7. 体系注册与计划的位置：`systems.md` 或本任务 `System.md`、当前 `PLAN.md`；没有计划则写「无」。
+
+## 5 硬规矩
+
+- 机密只写位置，不写具体值：密码、令牌、证书只写所在文件，不抄录进交接正文。
 - 时间一律带偏移（例 `2026-10-24 22:40 +0800`）。
-- 不写「大概」「应该」这类没核过的话；没核就写「未核，待确认」。
-- 写交接用 `ho_handover(action="write")`、`action="append"`，不要手改文件（会绕过备份与体检）。
+- 不写「大概」「应该」这类未核过的表述；未核就写「未核，待确认」。
+- 写交接按 §3 的固定流程执行：整篇重写用 `action="new"`，首次创建用 `action="write"`，中途补一行用 `action="append"`。不得手工修改文件，以免绕过归档、备份与体检。
 - 归档命名：`_Archives/<范围>/Handover/<原文件名>_<YYYYMMDD_HHMMSS>.md`（例 `Handover_20261108_144307.md`）；杂项归档自包含在 `_Misc/tasks/<任务>/_archive/`。
-- **篇幅不设上限**：不规定字节、行数、页数。体积由结构控制——只写在途与指针、状态用表格承载；过期即删，过一段时间整篇按归档重写。不得给交接或同类文档设上限。
+- 篇幅不设上限：不规定字节、行数、页数。体积由结构控制：只写在途与指针，状态用表格承载；过期即删，经历一段时间后按归档重写。不得为交接或同类文档设置上限。
 
-## 5. 体检判据（插件自动跑）
+## 6 体检判据（插件自动执行）
 
 - 有标题、有「正在做的事」实质内容、有「下一步」条目、无残留占位符。
-- 全局交接另需 §0 的七个字段与 §7 至少一行 session id。
-- 体检结论：`通过` / `缺节` / `不合格`；`缺节` 允许压缩，`不合格` 必须补完再压。
+- 全局交接另需 8 节齐全（含 §0 身份与寻址、§5 风险与禁区、§7 会话 id 对照）、§0 的 7 个字段齐全、§7 至少一行带 session id。
+- 体检结论取「通过」「缺节」「不合格」；「缺节」允许压缩，「不合格」须补完再压缩。
+- 体检命令：`ho_gate`（全局与全部项目）、`ho_handover` 写后自动体检。

package/src/templates/rules/Migration_Rules.md

@@ -1,24 +1,24 @@
 # 迁移规范（插件自带默认口径）
 
-> 迁移靠 `ho_backup` 四件套：`check` → `pack` → `verify` → `restore`。
+> 迁移使用 `ho_backup` 的 4 个动作：`check` → `pack` → `verify` → `restore`。
 
 ## 1. 前置检查 `action="check"`
 
-- 在役会话必须**静止**（默认 90 分钟无活动、且不在跑）。
+- 在役会话必须**静止**（默认 90 分钟无活动，且未在运行）。
 - 交接必须存在且体检通过。
-- 不通过就等，不要「先打包再说」。
+- 未通过时等待，不得先行打包。
 
 ## 2. 打包 `action="pack"`
 
 - 目标：`kind=global|project|task` ＋ `name`。
 - 产物含 `manifest.json`（逐文件 sha256）、`CHECKSUMS.sha256`、`MIGRATION.md`。
-- 打包格式：本机有 7-Zip 时出 `.7z`；没有时自动出 `.tar.gz`（插件自带归档器，二者功能等价）。
-- 包内**只报告绝对路径、不改写文件内容**——迁移后由人或项目会话按新机器改。
+- 打包格式：本机安装 7-Zip 时生成 `.7z`，未安装时自动生成 `.tar.gz`（插件自带归档器，二者功能等价）。
+- 包内**只报告绝对路径、不改写文件内容**。迁移后由用户或项目会话按新机器环境修改。
 
 ## 3. 校验 `action="verify"`
 
 - 逐文件比对 sha256：一致 / 漂移 / 缺失。
-- 漂移≠0 ⇒ 包已作废，必须重打。
+- 漂移≠0 时包已作废，须重新打包。
 
 ## 4. 恢复 `action="restore"`
 
@@ -29,4 +29,4 @@
 
 ## 5. 会话不迁移
 
-连续性只靠交接文档；新机器上由 `ho_sessions(action="new")` 建新会话，读交接后继续作业。
+连续性仅由交接文档承载；新机器上由 `ho_sessions(action="new")` 建立新会话，读取交接后继续作业。

package/src/templates/rules/Misc_Task_Standard.md

@@ -1,23 +1,30 @@
 # 杂项任务规范（插件自带默认口径）
 
-## 1. 什么算杂项
+## 1 什么算杂项
 
-一次性或短期任务：不建项目库、不进 `_Project_Meta/Registry.md`。落点 `_Misc/tasks/<任务短名>/`。
+一次性或短期任务：不建项目库，不进 `_Project_Meta/Registry.md`。存放位置为 `_Misc/tasks/<任务短名>/`。
 
-## 2. 目录约定
+## 2 目录约定
 
 | 路径 | 用途 |
 |---|---|
-| `_Misc/tasks/<任务>/` | 工作文件、`RULES.md`、`Handover.md` |
+| `_Misc/tasks/<任务>/` | 工作文件、`RULES.md`、`Handover.md`、`PLAN.md`、`System.md`、`Delegation_Prompt.md` |
 | `_Temp/_Misc/<任务>/Snapshots/` | 覆盖前快照 |
 | `_Archives/_Misc/<任务>/` | 归档 |
+| `_Misc/tasks/<任务>/_archive/` | 旧计划、旧暂任提示词等任务内归档 |
 
-## 3. 边界
+## 3 边界
 
-- 只写上面三处；`_Control_Center`、`Projects`、其他任务目录都不得写入。
-- 接任：杂项须用户授权（`/allow-succeed` 或设置页），再由本会话调用 `ho_succeed`，由插件按登记表建立接任会话；项目会话不得自行新建会话。
-- 交接与水位协议同项目（32% 提醒 / 35% 交接线 / 85% 硬顶）。
+- 只写上述 4 处；`_Control_Center`、`Projects`、其他任务目录都不得写入。
+- 接任：杂项任务须用户授权（`/allow-succeed` 或设置页），再由本会话调用 `ho_succeed`，由插件按登记表建立接任会话。不得自行新建会话。
+- 交接与水位协议同项目：水位 35% 先写毕交接，水位 50% 不再新开任务，水位 85% 为硬顶。压缩至多 3 次，第 4 次换任。判断标准：35% 档要求完成剩余流程后不超过 45%，50% 档不超过 55%。
 
-## 4. 升级为项目
+## 4 体系注册、计划与暂任
 
-任务变成长期项目时：建 `Projects/<名>/<名>库/`，移入工作文件，写 `_Project_Meta/<名>/`，再由全局登记进 `Registry.md`。
+- 体系注册写 `_Misc/tasks/<任务>/System.md`，格式见 `_Control_Center/templates/System.skeleton.md`；全局总注册 `_Control_Center/records/systems.md` 只列该文件路径，由全局会话写入。
+- 行动计划写任务根 `PLAN.md`，格式见 `_Control_Center/templates/Plan.skeleton.md`；新建计划前将旧计划移入 `_archive/`，归档后不读旧计划。
+- 暂任提示词写任务根 `Delegation_Prompt.md`，旧文件移入 `_archive/`；插件不检查该文件是否存在，也不检查是否已归档。暂任方只写本任务库。
+
+## 5 升级为项目
+
+任务转为长期项目时通过身份互转完成：`ho_sessions(action="role", migrate="auto")` 先对源库做快照，再将 `_Misc/tasks/<名>/` 移入 `Projects/<名>/<名库>/`；注册与交接随之改位置，`_Project_Meta/Registry.md` 增行。选择 `migrate="direct"` 时不搬旧文件，按模板新建体系。2 种方式均须将 `Office.json` 的类别键改为新类别，写前备份该文件。

package/src/templates/rules/Writing_Rules.md

@@ -1,24 +1,41 @@
-# 写作规范（插件自带默认口径）
+# 写作规则（插件自带默认口径）
 
-## 1. 语言与时间
+> 本文件只列指针与硬性要求，不复述条款表；两者冲突时以规范正文为准。
 
-- 对用户可见的一切一律**中文**；专有名词、代码、命令保留原文。
-- **一律使用标准书面语**：不得出现口语、俚俗与拟人化表达（例如「搞定」「弄好」「别忘」「收工」「点单」「拍板」「跑一遍」「看一眼」「咱们」）；命令式统一写作「应当、不得、须、宜」。
-- 时间一律带偏移：`2026-10-24 22:40 +0800`。不带偏移的时间视为不完整。
+## 1 指针
 
-## 2. 结构
+- 写作规范见 `_Control_Center/standards/写作规范/README.md`（W-01 至 W-42）。
+- 条款编号一经分配不再复用；检查方式分「自动」与「人工」。
+- 研究依据：同目录 `依据_论文.md`，只作追溯，不作执行文本，不注入提示段。
+- 提示段只放一行指针，不注入条款正文；规范正文按需读取（`ho_charter(doc="writing_rules")` 可代替本文件）。
+- 例外登记的唯一既存项为 E-01：对外仓库 README「为什么需要」一节，用户指定保留、逐字比对，见规范 §4.2；不得扩充，修改须经用户同意。
 
-- 先结论、再证据、最后待办；能用表格就不用长段落。
-- 一个文档只有一个主题；分节用 `##`，不要超过三级。
-- 路径写相对工作区根的形式（`Projects/<项目>/...`），不要写死本机盘符。
+## 2 硬性要求
 
-## 3. 事实纪律
+- 语言：对用户可见的一切一律用中文，含工具描述、选项、清单与表格状态词。代码、命令、专有名词保留原文。
+- 语体：采用标准、简洁、专业的书面语。不使用口语词与语气词，不使用情绪化、评价性表达，不以比喻或拟人替代术语，不使用填充语。词表见 W-01 至 W-04。
+- 界面动作统一写「点击」，不写其他同义单字（W-05）。
+- 标点与数字：中文正文用全角标点；代码、路径、命令用半角并加反引号（W-23）。版本号写 vX.Y.Z，日期写 YYYY-MM-DD，时间用 24 小时制（W-27）。
+- 结构：每份文档只有一个一级标题，标题层级不跳级（W-29）。标题不带句末标点，标题内不放链接（W-30）。链接文字自述目标（W-32）。
+- 句式：单句宜不超过 40 字（W-09）。一个指令一句，并列动作分条（W-14）。结论前置（W-16）。
+- 术语：同一对象同一称名（W-17）。缩写首次出现写「全称（缩写）」（W-19）。产品名与代码标识符保持官方写法（W-21）。
+- 事实纪律：不虚构。未执行的验证不写「已验证」，未读的文件不写「已检查」；区分「已完成待验收」与「要求了未落地」。
+- 交接文档 6 项齐全（W-40）：状态、已完成、未完成、风险、下一步、路径。
+- 台账一行一事实，字段固定，状态取受控词表（W-41）。
+- 错误消息含现象、原因、处置 3 段（W-39）。
+- 规范性关键词全大写，仅用于契约语义；中文对应「应」「宜」「可」（W-42）。
 
-- 不虚构：没跑过的验证不写「已验证」，没读过的文件不写「已检查」。
-- 区分「已完成待验收」与「要求了没落地」。
-- 引用别人的话要标出处；引用自己的判断要标「推测」。
+## 3 时间与路径
 
-## 4. 台账
+- 时间一律带偏移（例 `2026-10-24 22:40 +0800`）；不带偏移视为缺失。
+- 路径写工作区相对形式（例 `Projects/<项目>/…`），不以本机盘符书写。
 
-- 结构性改动追加一行到 `_Control_Center/records/Global_Changelog.md`（`ho_changelog`）。
-- 一行说清「改了什么、为什么、影响面」，不复述过程。
+## 4 台账
+
+- 结构性改动追加一行到 `_Control_Center/records/Global_Changelog.md`（`ho_changelog`）；每行写明改动内容、原因与影响范围，不复述过程。
+
+## 5 门禁与例外
+
+- 三道门禁：生成时自检、提交时检查、评审时复核（规范 §4.1）。命中阻断级条款即改写。
+- 语体门禁纳入门禁清单；唯一豁免为对外仓库 README 第 9 行。
+- 例外登记 7 项：编号、条款、适用路径、理由、替代措施、批准人、生效期与复核日（规范 §4.2）。例外绑定具体路径，到期未复核自动失效。

package/src/templates/standards/README.md

@@ -4,22 +4,34 @@
 
 ## 结构
 
-一条规范一个子目录，目录名即规范名，例如 `发布流程/`、`文档结构/`。
+每条规范占一个子目录，目录名即规范名，例如 `写作规范/`、`发布流程/`、`文档结构/`。
 
 - 正文放在子目录内，入口文件用 `README.md`；篇幅长时拆成多份，并在入口列出清单。
-- 规范自带的脚本与附件放在同一子目录内，不放进 `_Control_Center/tools/`：脚本与正文同生共死，一起搬走才不会失效。
+- 规范自带的脚本与附件放在同一子目录内，不放进 `_Control_Center/tools/`：脚本与正文须同步维护，一同迁移方可避免失效。
 - 规范只写做法、判据与验收条件，不写某一次作业的进度与结果；进度属于交接与台账。
 
+### 写作规范子目录
+
+`写作规范/` 是常设规范，随插件发布：入口为 `写作规范/README.md`，条款编号 W-01 至 W-42；同目录 `依据_论文.md` 只作追溯，不作执行文本，不注入提示段。
+
+- 适用范围：全部会话与全部构建产出，含代码注释、提交信息、文档、版本说明、提示段、工具描述、设置页文案、错误消息、交接与台账。
+- 使用方式：提示段只放一行指针，条款正文按需读取；语体门禁按该文件的条款与编号执行。
+- 例外：唯一的既存项为对外仓库 README 第 9 行，按该文件 §4.2 登记，不得扩充。
+
 ## 查找
 
-用户提到「按某某规范进行」一类要求时，两处都属查找范围：先看本库有无同名规范，再看本目录。本库指会话自己所在的工作区；两处都有时按本库那份执行，本目录那份作为通用版本。
+用户提到「按某某规范进行」一类要求时，2 处都属查找范围：先看本库有无同名规范，再看本目录。本库指会话自己所在的工作区；2 处都有时按本库那份执行，本目录那份作为通用版本。
 
-正文取到后按其中的步骤与判据执行，不自行增删步骤；规范本身需要改动时，先改规范再作业。
+取得正文后按其步骤与判据执行，不自行增删步骤；规范本身需要修改时，先改规范再作业。
+
+`写作规范/` 属常设规范，条款正文按需读取，不注入提示段。
 
 ## 写入
 
-用户提到「把某某写成规范」时：未指明范围就写本库（该会话所在的工作区）；说「写入通用规范库」「写成通用规范」「写成共用规范」的才写入本目录。
+用户提到「把某某写成规范」时：未指明范围即写本库（该会话所在的工作区）；仅当用户说「写入通用规范库」「写成通用规范」「写成共用规范」时，才写入本目录。
+
+本目录的新增与改写由全局会话执行，项目与杂项会话只读；本库内的文档由本库会话自行编写。规范中的路径与工具名须与插件实际口径一致，改名或更换入口时同步修改本目录。
 
-本目录的新增与改写由全局会话执行，项目与杂项会话只读；本库内的文档由本库会话自己写。规范里的路径与工具名要与插件当时的实际口径一致，改名或换入口时同步改本目录。
+`写作规范/` 的条款与编号由规范维护者改写，其余会话只读；条款编号一经分配不再复用。
 
-目录内只有本说明是合法状态：尚无共用规范时，各库按自己的文档执行。
+目录内仅有本说明属正常状态：尚无共用规范时，各库按自己的文档执行。

package/src/templates/standards//345/206/231/344/275/234/350/247/204/350/214/203/README.md

@@ -0,0 +1,120 @@
+# 写作规范
+
+> 版本 1.0.0（2026-11-14）。执行口径见本文件；研究依据见同目录 `依据_论文.md`（只作追溯，不作执行文本，不注入提示段）。
+
+## 1 适用范围
+
+本规范约束 dsh-handover 体系全部会话（全局、项目、杂项、普通）与全部构建产出：代码注释、提交信息、README 与文档、版本说明、提示段与工具描述、设置页文案、错误消息、交接与台账、审阅材料。
+
+规范只约束书面语的表层可控特征：用词、句式、术语、标点、数字、结构、链接与体裁要素；不涉及创意文案、市场宣传与文学表达。
+
+## 2 原则
+
+准确、简洁、一致、面向读者、可操作、可检验。冲突按此顺序裁决：准确优先于简洁，一致优先于修辞变化，可操作优先于句式美观，可检验优先于条款完备。
+
+## 3 条款
+
+检查方式分「自动」（脚本可判定）与「人工」（需语境判断）。编号一经分配不再复用；条款废止时保留编号并标注日期。
+
+### 3.1 用词与语体
+
+| 编号 | 条款 | 检查 |
+|---|---|---|
+| W-01 | 不使用口语词与语气词（吧、呢、啦、嘛、呀、哈、哦、其实、反正） | 自动 |
+| W-02 | 不使用情绪化、评价性表达（完美、惊艳、糟糕、坑、丝滑、离谱） | 自动 |
+| W-03 | 不以比喻、拟人替代术语（打通、收口、抓手、链路、落地） | 人工 |
+| W-04 | 不使用填充语（值得注意的是、众所周知、简单来说） | 自动 |
+| W-05 | 「点」一律写「点击」；界面动作统一为点击、选择、输入、按 | 自动 |
+| W-06 | 不堆叠同义修饰（彻底完全、基本大致） | 自动 |
+| W-07 | 不使用网络缩略语、表情符号与装饰符号 | 自动 |
+| W-08 | 不使用感叹号；问号不叠用 | 自动 |
+
+### 3.2 句式
+
+| 编号 | 条款 | 检查 |
+|---|---|---|
+| W-09 | 单句宜不超过 40 字；超过应拆分，且不丢失限定条件 | 自动 |
+| W-10 | 一段只含一个主题，段首宜为主题句 | 人工 |
+| W-11 | 条件、前提、目的置于动作之前 | 人工 |
+| W-12 | 以主动语态为主；确需强调受事时可用被动 | 自动＋人工 |
+| W-13 | 控制名词化，不用「进行／实施／开展＋名词」替代实义动词 | 自动 |
+| W-14 | 一句只含一个指令；并列动作分条 | 人工 |
+| W-15 | 操作步骤首句含祈使动词，位置信息先于动作 | 自动＋人工 |
+| W-16 | 结论前置，首句给出完整判断，不铺垫背景 | 人工 |
+
+### 3.3 术语
+
+| 编号 | 条款 | 检查 |
+|---|---|---|
+| W-17 | 同一对象在同一体系内只有一个称名，禁止同义换用 | 自动 |
+| W-18 | 术语首次出现就地定义或给链接，不设集中定义章 | 人工 |
+| W-19 | 缩写首次出现写「全称（缩写）」，其后统一使用缩写 | 自动 |
+| W-20 | 不自造缩写，不混用中英变体 | 自动 |
+| W-21 | 产品名、标准号、代码标识符保持官方写法与大小写 | 自动 |
+| W-22 | 清单场景穷举，关键项不以「等」「之类」省略 | 人工 |
+
+### 3.4 标点与数字
+
+| 编号 | 条款 | 检查 |
+|---|---|---|
+| W-23 | 中文正文用全角标点；代码、路径、命令、标识符用半角并加反引号 | 自动 |
+| W-24 | 并列词语用顿号，并列分句用分号，不用逗号连接并列项 | 自动 |
+| W-25 | 书名号、引号、括号成对出现，嵌套不超过两层 | 自动 |
+| W-26 | 计量、统计、编号用阿拉伯数字；概数与惯用语用汉字 | 自动 |
+| W-27 | 版本号用 vX.Y.Z，日期用 YYYY-MM-DD，时间用 24 小时制 | 自动 |
+| W-28 | 标准号写全，含编号、破折号与年号（如 GB/T 15834—2011） | 自动 |
+
+### 3.5 结构、链接与引用
+
+| 编号 | 条款 | 检查 |
+|---|---|---|
+| W-29 | 每份文档只有一个一级标题，标题层级不跳级 | 自动 |
+| W-30 | 标题不带句末标点，不以编号充当层级，标题内不放链接 | 自动 |
+| W-31 | 标题与内容对应，无空标题，无标题与正文错位 | 人工 |
+| W-32 | 链接文字自述目标，禁止「点击这里」「详见」「此处」 | 自动 |
+| W-33 | 外链可解析，去除追踪参数，优先一手来源 | 自动＋人工 |
+| W-34 | 正文引用编号与参考文献条目一一对应，不得悬空 | 自动 |
+
+### 3.6 场景专项
+
+| 编号 | 条款 | 检查 |
+|---|---|---|
+| W-35 | 代码注释解释「为什么」，不复述语句行为 | 人工 |
+| W-36 | 文档注释含摘要、参数、返回值、异常与副作用 | 自动 |
+| W-37 | 提交信息首行不超过 50 字符，用祈使式，空行后写正文 | 自动 |
+| W-38 | 版本说明按新增、变更、修复、移除、安全分组，每条一句 | 自动 |
+| W-39 | 错误消息含现象、原因、处置三段 | 自动＋人工 |
+| W-40 | 交接文档含状态、已完成、未完成、风险、下一步、路径六项 | 自动 |
+| W-41 | 台账一行一事实，字段固定，状态取受控词表 | 自动 |
+| W-42 | 规范性关键词全大写且仅用于契约语义；中文对应「应／宜／可」 | 自动 |
+
+## 4 执行
+
+### 4.1 三道门禁
+
+1. 生成时自检：产出文本后、写入文件前检查阻断级条款，命中即改写。
+2. 提交时检查：脚本对暂存内容执行全部自动条款；阻断级违规拒绝提交，警告级写入报告。
+3. 评审时复核：逐项确认人工条款，并对警告项给出处置意见。
+
+三道门禁共用本条款表与编号。门禁配置与规范同版本发布。
+
+### 4.2 分级与例外
+
+- 分级：「应」为阻断，「宜」为警告，「可」为提示。
+- 例外登记七项：编号、条款、适用路径、理由、替代措施、批准人、生效期与复核日。例外绑定具体路径，不得全局豁免，到期未复核自动失效。
+- W-01 至 W-08 属阻断级词表，不得登记例外。
+- 唯一既存例外 E-01：插件对外仓库 README 的「为什么需要」一节（`README.md` 中 `## 为什么需要` 至下一个 `##` 之间，含「本插件一定能很好地帮助你。来试试吧；不满意，随时关闭插件并删除即可。」）。用户 2026-11-13 与 2026-11-15 两次指定保留；按节绑定，不按行号；`check-docs` 逐字比对，改写即失败。
+
+### 4.3 版本化
+
+语义化版本：主版本变更指条款增删或判定标准改变；次版本指措辞澄清或阈值调整；修订版本指笔误与格式修正。编号永久保留，废止条款标注日期与替代条款。规范文本、条款表、门禁配置与评审清单同版本发布；不一致时以本文件为准。
+
+### 4.4 提示段
+
+所有角色提示段只放一行指向本文件的指针，不注入条款正文；规范正文按需读取。
+
+## 5 依据与限制
+
+条款依据为 `依据_论文.md`：国际风格指南（Microsoft、Google）、简明语言标准（ISO 24495-1:2023、Digital.gov）、使用说明标准（IEC/IEEE 82079-1:2019）、代码注释规范（Go、PEP 257、JSDoc、Oracle JavaDoc、rustdoc）、中文国家标准（GB/T 15834、15835、7713.2、8567、1.1）与规范性关键词（RFC 2119、RFC 8174）。
+
+取证限制：Google 指南经官方镜像 developers.google.cn 取得；中文国标多仅公开题录，相关论断限定在适用范围层面；ISO 24495-1 与 IEC/IEEE 82079-1 全文付费，仅依据官方摘要页。W-09 的 40 字与 W-37 的 50 字符为工程设定值，非标准规定，调整须记入变更记录并同步门禁配置。