Skip to content

docs: 修复章号 vs 篇号体系全面错乱#70

Merged
luyao618 merged 1 commit into
mainfrom
yao-147-fix-chapter-numbering
May 27, 2026
Merged

docs: 修复章号 vs 篇号体系全面错乱#70
luyao618 merged 1 commit into
mainfrom
yao-147-fix-chapter-numbering

Conversation

@luyao618
Copy link
Copy Markdown
Owner

Summary

v2 重排后,几乎每章开篇仍写「本篇是系列的第 X 篇」,但 X 与文件名章号完全对不上:

  • 第 03 章自称第 17 篇
  • 第 04 章自称第 26 篇
  • 第 06 章自称第 4 篇
  • 第 17 章自称第 27 篇
  • 第 21 章自称第 24 篇
  • 第 32 章自称第 11 篇
  • 第 33 章自称第 3 篇
  • ……

跨章引用(「第 21 篇讲了 Ink」「第 27 篇讲了多模态文件上传」)几乎全错。这是全书第一观感的最大伤害。

修复内容

  • 34 个章节文件开篇 self-ref 全部对齐到文件名 NN,「本篇」→「本章」
  • v1 沿用章节的正文交叉引用按 v1→v2 映射表全部 remap,「篇」→「章」
  • 8 个 v2 新增章节(C04 / C13 / C17 / C24 / C25 / C28 / C29 / C30)的正文引用按目标 v2 章号手动修正
  • 第 34 章「过去 33 篇」「这 34 篇」统一为「章」
  • 第 21 章「前面 23 篇」→「前面 20 章」(开篇时已读章数对齐)

Test plan

  • `bun run check:docs` 全绿
  • `grep -rn '第 [0-9]+ 篇\|本篇' docs/[0-9]*.md` 无结果
  • 34 个章节开篇 self-ref 与文件名 NN 一一对应

🤖 Generated with Claude Code

v2 重排后,几乎每章开篇仍写"本篇是系列的第 X 篇",但 X 与文件名
章号完全对不上(第 03 章自称第 17 篇、第 04 章自称第 26 篇、
第 33 章自称第 3 篇等等)。跨章引用("第 21 篇讲了 Ink")也全错。

本次统一修正:

- 34 个章节文件开篇 self-ref 全部对齐到文件名 NN,"本篇"→"本章"
- v1 沿用章节的正文交叉引用按 v1→v2 映射表全部 remap,"篇"→"章"
- 8 个 v2 新增章节的正文引用按目标 v2 章号手动修正
- 第 34 章"过去 33 篇"、"这 34 篇"统一为"章"
- 第 21 章"前面 23 篇" → "前面 20 章"(开篇时已读章数对齐)

bun run check:docs 全绿。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@luyao618 luyao618 merged commit 6211f8c into main May 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant