fix(scripts): rename_ref 搬整目录不再改脏目录内部内容，并补齐出链层级

2026-10-30 测试说明分层那次（28 个路径、209 文件）实测踩到两条，都是
「把不该改的东西改脏」，当时的补救全靠事后从 git 里捞原始字节：

B1 整目录搬迁会改写目录内部文件的内容。「相对引用文件所在目录」这条
    解析规则不检验目标是否存在，于是台架日志里不是路径的斜杠片段被当成
    「旧目录下的子路径」并插上目录名：`1/1 PASSED` → `test_data/1/1 PASSED`、
    `13639/32768`、日期占位 `[----/--/-- --:--:--]` 全中招，连有效的
    `see ../a.md` 也被换成指向不存在的 `see td/a.md`。23 个证据文件是
    用 `git show HEAD:<旧路径>` 逐字节还原才救回来的。
B2 目录内部文件指向外部的 `../` 出链不补层级。emit_dir 取的是
    `new_abs.parent`，整目录搬迁时少算一层，`../images/x.svg` 搬深一层后
    仍指旧层级；图片按文档目录相对（§3.2），check_doc_links 看不见 → 静默断链。

改法（尽量小面）：
- resolve_token：按引用文件目录解析时要求目标真存在；根相对写法保持原宽松口径。
- rewrite_text：moved 文件的 emit_dir 改成「本文件搬完实际所在的目录」；
  单文件搬迁走原分支，一字未动。
- 整目录搬迁时目录内部互为相对的引用一律不改（两侧一起搬，改了必错）；
  「旧路径是不是目录」必须在搬迁前记进 old_is_dir_global——--apply 是先
  git mv 再改写，那时旧路径已经不存在了。
- glob 形态改成看得见：搬目录时前缀整体跟着搬（本来就该改）；搬单文件时
  一条 glob 可能同时盖住搬走与没搬走的两批文件，不猜，只点名列出。
  分层那次有 4 处这种引用是静默漏改、事后手改的。

回归：新增 `--selftest`（在一次性临时 git 仓里跑本脚本的副本，`.gitignore`
先排除 /scripts/ 免得脚本自己进扫描面）。案例 A 守整目录搬迁（证据文件
逐字节不变、出链补层、别人文件的入链照改、glob 前缀跟着搬），案例 B 守
单文件搬迁的层级换算与 glob 提示，18 项断言全绿。反向对照也做了：同一
夹具在改前版本上 B1/B2 都复现，所以断言不是凭空写的。

文档同步：docs/文档规范.md §3.6 第 4/5 条从「现存危害」改写成「已修 +
验收判据」，新增第 6 条 glob 提示，并加「改本体必须先跑 --selftest」；
docs/测试说明/README.md 第 3/5 节口径同步；scripts/README.md 补 --selftest
与任务树 --no-verify 的用法行。顺带修掉分层那笔里我写错的日期：
2026-11-01 → 2026-10-30（文档规范 4 处、测试说明 README 2 处，真值就是今天）。

树内验证：AST OK；--selftest PASS；改动的 3 个 .md 单文件
check_doc_links --sections-strict RC=0（36 处章节引用、可判定 34、无法判定 0）；
字节体检干净。未跑 @build（无 .c/.h 改动）。

scripts/README.md

@@ -33,7 +33,7 @@
 | 脚本 | 作用 |
 |---|---|
 | `rename_ids.py` | **编号（字面量）批量改名**：映射表 JSON 驱动，`files` 显式 scope（同一裸形字面量可能属多族，实测 `S3` 三义 → 全局替换必造新撞号）；默认干跑，`--apply` 落盘并自动写 `id_aliases.json` 的 scoped 旧号→新号条目；`[示例]`/`[计划]` 行与变更记录表不改写；按原字节读写（保 BOM 与行尾）。用法与批次记录 → `scripts/archive/id_gate/编号治理历史.md` §8.3 |
-| `rename_ref.py` | **改名/挪目录 + 全库引用自动改写**：默认 dry-run 预览，`--apply` 才落盘（`git mv` → 改写引用 → 自动跑 `check_doc_links --all` 复核）。覆盖反引号引用、Markdown 链接、图片 `../` 层级换算、`#include`、`uvprojx`/`CMakeLists.txt` 源列表。固定动作与边界 → `docs/文档规范.md` §3.6 |
+| `rename_ref.py` | **改名/挪目录 + 全库引用自动改写**：默认 dry-run 预览，`--apply` 才落盘（`git mv` → 改写引用 → 自动跑 `check_doc_links --all` 复核）。覆盖反引号引用、Markdown 链接、图片 `../` 层级换算（**整目录搬迁时目录内部文件的出链按新目录补层**）、`#include`、`uvprojx`/`CMakeLists.txt` 源列表；搬**单文件**时指向旧目录的 glob 不自动改、但会点名列出。**改本脚本必须跑 `--selftest`**（一次性临时 git 仓，守住"搬目录把内部文件改脏"与"出链少补一层"两条实测踩过的坑）。固定动作与边界 → `docs/文档规范.md` §3.6 |
 
 > `check_doc_links.py` 除链接存在性外，还校验 **`§N.M` 章节引用**是否指向目标文档真实存在的编号标题（口径见 `docs/文档规范.md` §3.5）。
 
@@ -77,6 +77,9 @@
 & '.venv\Scripts\python.exe' scripts/check_doc_links.py --all
 & '.venv\Scripts\python.exe' scripts/rename_ref.py docs/旧/名.md docs/新/名.md          # 预览
 & '.venv\Scripts\python.exe' scripts/rename_ref.py docs/旧/名.md docs/新/名.md --apply  # 落盘
+& '.venv\Scripts\python.exe' scripts/rename_ref.py --selftest   # 改 rename_ref 本体必须跑（一次性临时 git 仓回归）
+# 任务工作树里落盘请加 --no-verify：树内 simulator/SDL2 是目录联接，收尾的 check_doc_links --all
+# 会把同一份仓库当第二副本扫出假红；全库 --all 复核留到主工作树跑
 & '.venv\Scripts\python.exe' scripts/gen_task_table.py --check   # 或 --write / --diff
 & '.venv\Scripts\python.exe' scripts/check_mem_numbers.py --check
 & '.venv\Scripts\python.exe' scripts/check_test_suite.py               # 门禁判定