knowledge-base-builder v10.3

knowledge-base-builder v10.3

v10.3（2026-10-20）：test_build_web 里「产物构建日不晚于今天」的断言同样留 1 天时区容差——v10.2 修了门禁本身，这条测试是同一个东八区 vs UTC 的坑，CI 在北京 0–8 点又红了一次。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

knowledge-base-builder v10.2

knowledge-base-builder v10.2

v10.2（2026-10-20）：check_freshness.py 的「核实日期在未来」判据留 1 天时区容差。核实日期按维护者本地日（东八区）写，CI 按 UTC 判当天：北京 0–8 点提交时，当天回写的核实日期在 CI 眼里是「明天」，2026-10-20 巡检提交因此 CI 误红 245 处、整库打包自检同时失败。补两条回归测试（差 1 天放行、差 2 天仍拦）。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

整库快照 kb-v2026.10.20

整库快照

下载解压，双击 README.html 就能读——断网可用，不需要装任何软件。
讲义 PPTX 用 PowerPoint 或 Keynote 打开。

包里带：21 册讲义与书单、网页版、库级取用产物（实战包／学习路径／全库一页纸）、
全套门禁脚本、技能分发包。不带：作者的历史留痕与外部输入档案。

拿到之后建议先在库根跑一次自检，确认这份拷贝是完整的：

bash _maintenance/run_all_gates.sh

（打包时已经在解压出来的那份里跑过同一条命令——这里再跑一次是验你手上这份。）

只想要维护这个库的那套方法（技能）、不要这些内容的，见仓库 README 的「两条下载路径」。

knowledge-base-builder v10.1

knowledge-base-builder v10.1

v10.1（2026-09-06）：gen_source_list.py --check 改按产物自己刻的「生成日期」比对。v10.0 把信源清单一致性做成门禁，但清单里「已过期 N 天／N 天后」是相对当天算的，生成后第二天起这道门必红——09-05 当天本地与 CI 都绿、09-06 验收一跑就红（口径同 build.py 的 adopt_stamped_date，同一类错第二次出现）。生成日距今超 30 天另起一行报告型提醒、不拦。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

knowledge-base-builder v10.0

knowledge-base-builder v10.0

v10.0（2026-09-05）：保鲜门禁拆两层 + 锚点与用语进门禁 + 脚本底座收敛。保鲜从「到期即 FAIL」改成「到期先进『到期待复核』清单、超过 KB-CONFIG『超期宽限』（默认 45 天）才拦」——每周一 freshness.yml 用 --strict 到期自动报 issue，push 门禁不再被过期事实整批拦死；保鲜看板改客户端判定（data-due + site.js 按浏览器当天重标），构建期断言「目前没有过期的」删除。三个幽灵章节补回网页（sp/de/mm-cheatsheet），check_html_links 开始查锚点、check_web_chapters 补反向契约。门禁体系：_lib.py 共享底座（唯一模块定义/表解析/日期解析/库根推导）、run_all_gates.sh 与 gates.yml 改成脚本集合比对（数步数防不了「两处各删一道」）、tests/ 回归测试进门禁（unittest，零第三方依赖）、check_internal_terms.py（内部用语扫描）、check_css_classes 补反向（页面用了 CSS 没有的类）、check_html_wellformed 扩到全站页面、check_scripts_sync 补反向与 tests 同步、check_deck_source 作用域改为「有源 JSON 必须对上」、KB-CONFIG 字段契约进门禁、check_derived_counts 增技能文档轴。技能文档自洽：删季度巡检遗物与 Ruby 门禁遗物段、init 模板补「库版本/复核节奏/在线站点/超期宽限」四字段、插页规则改「kb_insert 自动按目标册画布绘制、插页后一律 fix_footer_pagenum.py 重排」（删小画布预抬档与「接受页码漂移」旧取舍）。CI：矩阵 3.9/3.12、timeout/concurrency、fetch-tags。门禁 19 → 22 道。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

整库快照 kb-v2026.09.05

整库快照

下载解压，双击 README.html 就能读——断网可用，不需要装任何软件。
讲义 PPTX 用 PowerPoint 或 Keynote 打开。

包里带：21 册讲义与书单、网页版、库级取用产物（实战包／学习路径／全库一页纸）、
全套门禁脚本、技能分发包。不带：作者的历史留痕与外部输入档案。

拿到之后建议先在库根跑一次自检，确认这份拷贝是完整的：

bash _maintenance/run_all_gates.sh

（打包时已经在解压出来的那份里跑过同一条命令——这里再跑一次是验你手上这份。）

只想要维护这个库的那套方法（技能）、不要这些内容的，见仓库 README 的「两条下载路径」。

knowledge-base-builder v9.2

knowledge-base-builder v9.2

v9.2（2026-08-03）：知识地图按元素实际宽度排版，不再按个数均分槽位。旧算法 left + (j+0.5)*area/n 完全不看胶囊多宽——层里 2–4 个模块时一直没事，21 册后工程保障层 7 个胶囊合计 939px 塞进 808px 可用宽度，相邻胶囊互相压住、长名字被裁半截，而十九道门禁一道都没响（重叠是几何，坏链/配平/样式契约谁也不看）。改法：一行装不下就换行（按个数均分成 4+3，避免贪心的 5+2 头重脚轻），带高随行数长；装得下的层一律保持旧口径，不为修一层去改全库七层的观感。判据入 web/web-design-system.md §二与错题本丁组：任何「把 N 个东西排成一排」的算法都要先问「这 N 个加起来多宽，装得下吗」。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

knowledge-base-builder v9.1

knowledge-base-builder v9.1

v9.1（2026-08-03）：页面右上角那个可见标记从样式版本戳改成整库 Release 号（v0723n → v2026.08.03）。原来它与 kb.css?v= 绑定、门禁要求尾号同字母——于是印给读者看的是「样式表改到第几轮」，而读者想知道的是「我在看这个库的哪一版」。拆成三件：check_css_classes 的缓存戳轴只管 kb.css?v= 与 js 戳（缓存击穿靠的是 URL 参数，可见标记从来只是它的镜子）；真源落在 KB-CONFIG 新增的「库版本」字段；新增 stamp_kb_version.py（落戳 + --check 门禁，第 19 道）。release-kb.yml 加「标签 vs 库版本」对账、check_version_tag 扩成技能与整库两条线——三处扣起来，保证显示出去的号一定发布过。同批修两处刚被自己改旧的：KB-CONFIG 的巡检节奏还写着季度与旧任务名；开始使用.html「换一台机器」一节里还藏着第五份门禁清单（v9.0 只塌掉了四份）。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

knowledge-base-builder v9.0

knowledge-base-builder v9.0

v9.0（2026-08-03）：一次以工程与可维护性为题的全库审视之后的批量整改，十一项——这一版的价值不在某一道新门禁，而在它们共同回答的那个问题：门禁全绿之下还剩哪些洞。门禁 15 → 18 道：check_deck_source（生成器册必须有源 JSON）、check_scripts_sync（库内脚本 ↔ 技能源目录，带 --sync）、check_derived_counts（模块数／网页覆盖／门禁道数这类可派生数目不许过期），另加报告型 check_version_tag。四份门禁清单塌成一份：make_share.py 的解压自检与整库 Release 说明改成跑 run_all_gates.sh——此前四份里只有 gates.yml ↔ run_all_gates 那一对有防漂自检，另两份静默漂到「对外说门禁全跑了一遍、实际只覆盖 15 道里的 9 道」。SKILL.md 瘦身三成：脚本目录外置成 references/tools.md、library-rules 按流程步骤拆成 library-layout（动手前）+ library-ledgers（收尾）、加载矩阵改成两列——A/B 类任务动手前必读 73k → 49k 字符。生成器两处：整册 JSON 必须入库（新增 deck_to_json.py 反解器，往返自检逐页文本比对通过），页脚页码改成 page_numbers 开关且默认关（它原来无条件写页码，正把库悄悄劈成两类册）。MANIFEST「最后更新」外置：21 册合计 4.3 万字符的变更日志从表格单元格挪进各模块 raw-data/更新记录.md。保鲜：巡检节奏季度 → 月度（库里最快的事实节奏是 30 天，季度巡检结构上服务不了它），新增 gen_source_list.py 按信源重排全库事实并把每月复核负荷印在清单顶部。

怎么装

• claude.ai：设置 → Capabilities → Skills，上传下面的 knowledge-base-builder.skill
• Claude Code：解压到 ~/.claude/skills/knowledge-base-builder/

装好后对 Claude 说「帮我建个知识库」或「把 ×× 整理进知识库」即可；库的个性全在库根 KB-CONFIG.md 一个文件里。

整库快照 kb-v2026.08.03

整库快照

下载解压，双击 README.html 就能读——断网可用，不需要装任何软件。
讲义 PPTX 用 PowerPoint 或 Keynote 打开。

包里带：21 册讲义与书单、网页版、库级取用产物（实战包／学习路径／全库一页纸）、
全套门禁脚本、技能分发包。不带：作者的历史留痕与外部输入档案。

拿到之后建议先在库根跑一次自检，确认这份拷贝是完整的：

bash _maintenance/run_all_gates.sh

（打包时已经在解压出来的那份里跑过同一条命令——这里再跑一次是验你手上这份。）

只想要维护这个库的那套方法（技能）、不要这些内容的，见仓库 README 的「两条下载路径」。