Skip to content

骨架演进日志

这份文档记录 world-map 骨架本身的变化历史——L 层增减、group 调整、命名变更、归档决策。

为什么需要:骨架不是预设死的,它会被阅读过程反向塑造。这份日志是骨架演化的"git log",让任何时候都能回答"为什么 L 层现在是 5 个不是 4 个"、"为什么 strategic 这个 group 叫这个名字"。

日志格式

每条变更一条记录,倒序排列(最新在上):

markdown
### YYYY-MM-DD — 变更简述

**类型**: 新增 L 层 | 合并 L 层 | 拆分 L 层 | 新增 group | 改 group 名 | 归档文档 | 提议(未实施)

**背景**: 是什么触发了这次变更(哪本书、哪篇文章、哪个错误)

**决策**: 具体做了什么

**影响**: 影响了哪些 sidebar / 文档 / 链接

**回退方案**: 怎么回退这次变更(如需要)

骨架变更记录

2026-06-22 — 初始化 5 层骨架

类型: 新增 L 层(首次)

背景: 项目创建。book/ 目录下两本书——IDDD(Vaughn Vernon)+ 工程控制论(钱学森、宋健)。需要一套能同时承载"软件方法论"和"系统论"的骨架。

决策:

  • 采用控制论五层作为顶层骨架(辨识→设计→实现→验证→适应)
  • 每层 6–7 个 group:概览 + 4 个主题 group + 应用案例 + 源典精读
  • 顶部 nav 只放首页 + 5 个 L 层(不接受路由层污染)
  • DDD 战略/战术映射到 L1,集成/架构映射到 L2,应用/部署映射到 L3
  • 元文档(meta/)单独分区,不进 L 层

影响:

  • 创建 5 个顶层目录 l1-modeling/l5-evolution/
  • 103 个 .md 占位文件,全部 status=stub
  • 顶部 nav 6 项
  • 首页加 AI 协作约定 + 元规则分区链接

回退方案: git revert


2026-06-22 — 创建 meta/ 元文档分区

类型: 新增顶层分区

背景: AI 协作约定("wiki 本身是 AI 的操作手册")需要单独载体,不能塞进 L 层。

决策: 新增 meta/ 顶层目录,含 4 份元文档:

  • meta/ai-collaboration/ — AI 协作规则
  • meta/conventions/ — 文档撰写约定
  • meta/evolution-log/ — 本文档
  • meta/git-workflow/ — git 流程规范

影响:

  • meta/ 不进顶部 nav(它不是知识体系的认知层)
  • 在首页和每个 L 层 01-overview/index.md 末尾的"相关链接"指向 meta/

回退方案: 直接删目录,无外部依赖


待办 / 提议(未实施)

这里记录已识别但还没动手的骨架改造需求。每条标明触发原因 + 建议方案。

2026-06-22 — 新增 meta/source/cybernetics/ 源典精读目录

类型: 新增子目录(提议——等用户确认后实施)

背景: 开始精读《工程控制论》。Ch 1(引论)建立了整个控制论的世界观——五层闭环(辨识→设计→实现→验证→适应)的思想根源。它不属于任何单一 L 层,而是 L1–L5 共同的理论根

冲突: 现有骨架把"源典精读"放在各 L 层的 07-source/ 下(l1-modeling/07-source/cybernetics.md 是占位单文件),意味着每章精读必须挂到某个 L 层下。

建议方案:

  • 新增 meta/source/cybernetics/ 顶层子目录(与 meta/ai-collaboration/ 等并列)
  • 路径:meta/source/cybernetics/ch01-introduction.md / ch02-analysis.md / ...
  • 理由:Ch 1 是世界观级,跨所有 L 层,不应被任何 L 层"拥有"
  • 各 L 层 07-source/cybernetics.md 改为索引页,反向链接meta/source/cybernetics/ 对应章节

回退方案: 沿用旧路径 l1-modeling/07-source/cybernetics/chXX.md,把 Ch 1 挂在 L1 下;缺点是后续 Ch 4 涉及稳定性分析可能需要挂 L2,造成归属混乱。

状态: 已实施(commit 6754fc4 feat(meta-source): 接受提议


2026-06-22 — Phase 1 Ch 8 实际定位修正

类型: 路径澄清(不是新提议,是发现原计划不准确)

背景: 原计划"Ch 8 最优控制(变分法)"。开始精读时发现:

  • Ch 8 实际是"最速控制系统设计"——bang-bang 控制 + 开关曲线
  • Ch 9 才是"满足指定积分指标的控制系统设计"——泛指最优控制
  • Ch 10 是"最优控制(离散/最速)"——补充

影响: Ch 8 草稿以"最速控制(bang-bang + 开关曲线)"为题,而非"最优控制(变分法)"。

调整: 草稿中保留对"变分法/极大值原理"的概念性提及(在"它属于什么"一节),主体写最速控制。Ch 9 可作为 Phase 2 选读。

从名家方法论与工程化思路中蒸馏出自己的工程体系。