Skip to content

docs(profile): 主页手写重复熵减 + 护栏上收——双清单收敛、结构测试与 CI 强制门 - #9

Merged
ThreeFish-AI merged 8 commits into
masterfrom
ThreeFish-AI/preening-substrate-readme.md
Oct 18, 2026
Merged

docs(profile): 主页手写重复熵减 + 护栏上收——双清单收敛、结构测试与 CI 强制门#9
ThreeFish-AI merged 8 commits into
masterfrom
ThreeFish-AI/preening-substrate-readme.md

Conversation

@ThreeFish-AI

@ThreeFish-AI ThreeFish-AI commented Oct 18, 2026 •
edited
Loading

Copy link
Copy Markdown
Owner

摘要

对主页两份 README（英/中逐行镜像）执行 preening-substrate 结构性熵减，并在同 PR 落地三项 Next Best Action：README 手写重复收敛、承重面护栏上收为测试并接入 CI、生成器结构不对称修复。PR #7/#8 已定稿的分层布局与双簇页签零改动。

一、手写重复收敛（2 行 ×2 文件）

  • 九厂商清单收敛：卡片（:163）与深潜块（:293）两处全文手写、无同步机制，且已实际漂移过一次——PR docs(profile): 主页 v5 结构性熵减——事实对齐、七类重复收敛与折叠层重组 #7 仅给卡片侧单侧补入 Xiaomi（git show 993de20 实锤）。本次卡片定为唯一权威清单，深潜句收敛为回指，从结构上除根（I-001）。
  • no-Redis 短语收敛：:215 doctrine 句去掉第三处 "No Redis, no queue" 点名（权威位保留 :164/:174），因果链改由 SQLite-WAL 本地性直接引出。
  • 审计宁缺毋滥：预裁决 4 处逐处考古复核后收缩为 2 处，云凭证/口径叙事等因角色分层（C2/C4）终裁保留，不为行数砍修辞。

二、护栏上收（原 NBA 1+2）

  • 新增 tests/test_readme_structure.py（31 → 35 用例）：锚点三方同名同序（<a name> 序 == FIG 簇序、导航 #user-content- 链接集 == 锚点集）、双文件行级镜像（marker/骨架行号、行数）、cur_year/cur_total 单调性状态源存续——此前为纯人工契约，破坏即 GitHub 静默死链。
  • CI lint job 接入 python -m unittest discover tests：全套特征化护栏（Golden Master + 结构守卫 + SVG 金样）由本地自觉变 PR 强制门，零网络亚秒级（I-002 闭环）。

三、生成器对称性修复（原 NBA 3）

  • cadence_alt 移出 refresh() 嵌套至模块级（原为 13 个 *_alt 中唯一嵌套者），闭包变量 rel_total 改显式穿参；函数体经独立 Verifier AST 逐 token 比对零差异，EN/ZH 合成输入行为冒烟一致。

四、知识结晶

  • docs/.agents/knowledge-map.md：文档索引 + 双语镜像编辑契约卡（机器领地/标记即契约/锚点三方/冻结面绕行/编辑后验证）。
  • docs/.agents/issue.md：I-001 漂移事故台账；I-002 护栏上收闭环。

验证

  • python3 -m unittest discover tests：35 用例全绿（既有断言零弱化，tests/ 既有文件零改动）；
  • python3 scripts/build_profile_svgs.py --lint：75 DATA + 13 FIG 双语一致；
  • 两轮独立 Verifier Subagent（全新只读上下文）盲审：README 改动四门 + 增量改动四门均全 PASS、终裁 APPROVE（搬移经 AST 比对、基线副本经 cmp 防伪）；
  • PR CI：lint（含新增 unittest 步骤）。

后续建议（未含在本 PR）

  • 手写数字漂移面（403 ×3、:249 的 1,378、:36 年度序列）已登记 issue.md；DATA 化需评估生成器与 caliber 边界，暂不动。

🤖 Generated with Claude Code

@ThreeFish-AI
docs(profile): 主页手写重复收敛——九厂商清单与 no-Redis 短语各归唯一权威位;
0b4a7de 
- coding-proxy 九厂商清单曾两处全文手写且已实际漂移过一次（PR #7 仅单侧补 Xiaomi）：项目卡定为唯一权威清单，深潜块收敛为回指，消除双清单结构；
- 故障转移 doctrine 句去掉第三处 no Redis/no queue 点名（权威位保留项目卡与总栈行），因果链改由 SQLite-WAL 本地性直接引出；
- 中英两份 README 逐行镜像同步；13 FIG + 75 DATA 标记流、锚点三方契约、全部冻结面零触碰，31 用例与 --lint 全绿。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
docs(agents): 新建知识索引与 Issue 台账，沉淀双语镜像编辑契约;
327cd59 
- knowledge-map.md：文档索引 + 双语镜像编辑契约卡（机器领地/标记即契约/锚点三方同名同序/冻结面绕行/编辑后验证/重复收敛原则）；
- issue.md：登记 I-001 九厂商清单单侧漂移（本次结构性收敛）与 I-002 语义级镜像漂移、锚点死链无机器门（lab gate 护航，上收 tests 为后续路径）。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
test(readme): 锚点三方一致与双语行级镜像上收为结构测试;
0a00b1e 
- 新增 tests/test_readme_structure.py：锚点序 == FIG 簇序、导航链接集 == 锚点集（两份 README 各查）、marker 与结构骨架行号镜像、行数相等、cur_year/cur_total 单调性状态源存续；
- 此前三项承重面仅靠人工契约（破坏即 GitHub 静默死链），现并入零依赖特征化套件（31 → 35 用例）。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ci(lint): PR lint job 接入全套 unittest 护栏;
499022a 
- refresh-profile-data.yml 的 lint job 新增静态步骤 python -m unittest discover tests；
- 35 用例（Golden Master、结构守卫、SVG 闸门金样）由本地自觉变 PR 强制门，零网络、亚秒级。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
refactor(pipeline): cadence_alt 移出 refresh 至模块级，与其余 alt 对齐;
3808105 
- 原嵌套于 refresh() 内（唯一非模块级的 *_alt），闭包变量 rel_total 改为显式参数穿入；
- 函数体除缩进与签名外逐 token 不变（独立 Verifier 经 AST 比对确认），EN/ZH 合成输入行为冒烟一致；
- 附带收益：tests/_bps.py 按名加载器现可直接加载 cadence_alt，为后续可测铺路。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
docs(agents): 契约卡与 Issue 台账现行态同步;
06b8f25 
- knowledge-map：锚点三方契约标注机器强制、编辑后验证命令更新为 35 用例双命令（与 CI 同款）；
- issue：I-002 根治闭环（结构测试上收 + CI 接入），状态置已完成。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI ThreeFish-AI changed the title docs(profile): 主页手写重复熵减——双清单收敛与镜像编辑契约沉淀 docs(profile): 主页手写重复熵减 + 护栏上收——双清单收敛、结构测试与 CI 强制门 Oct 18, 2026
@ThreeFish-AI
test(readme): 删除臆造分区号并强化导航链接顺序断言;
d920e9c 
- docstring 去掉「Section B2」——全仓仅存在 Section A/C/C/D/A/C/E 的非正式引用，B/B2 无出处；
- 簇导航链接断言由 sorted 集合比较强化为「文档序 == FIG 簇序」，与 knowledge-map 契约卡第 4 条「集合与顺序一致」宣称同口径；变异自证换序可判红。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ci(lint): paths 增补 tests/**，消除纯测试 PR 的门禁盲区;
569bace 
- 此前仅改 tests/ 的 PR 会整体跳过 lint job，新接入的 unittest 步骤对其不生效，与 issue.md I-002「全套护栏变 PR 强制门」宣称相悖；
- 坏测试可无 CI 合入的缺口闭合。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ThreeFish-AI merged commit 896c841 into master Oct 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@ThreeFish-AI