出版前排版审校记录

审校日期：2026-07-10

审校范围：前言、第 1～23 章、图示资源、HonKit 网站版样式、构建与发布检查

1. 审校结论

本轮已完成出版前的结构、图示、排版、代码块、术语与重复内容审校。当前书稿满足以下基线：

  • 第 1～23 章均包含本章导读、章节元信息、贯穿案例、本章小结和实践任务；
  • 章节二级标题编号连续；
  • 章节内 90 张图、前言 1 张图均采用统一图号、中文图注和可访问替代文本；
  • Mermaid 图保留 .mmd 源文件，并以预渲染 SVG 嵌入正文；
  • 代码块最长 46 行，没有超过 60 行的审校阈值；
  • 未发现失效的本地链接；
  • 未发现“智能体”“子智能体”“多智能体”“上下文工程化”等非推荐术语；
  • HonKit 干净构建通过；
  • 在 390px 移动端视口逐章检查，无横向溢出，90 张章节图片全部成功加载。

2. 章节视觉结构

网站版通过 styles/website.css 统一以下视觉层级：

  1. 章标题使用底部强调线，形成稳定的章节入口；
  2. 标题后的“本章导读”使用强调色信息框；
  3. 章节元信息使用弱化背景和较小字号；
  4. 二级标题统一使用左侧色条；
  5. “贯穿案例”“本章小结”“实践任务”使用不同语义色；
  6. 移动端收紧页边距，避免表格和图片溢出；
  7. 打印模式取消图片高度限制，并避免图、表、代码块跨页断裂。

3. 图示与图注

图示统一为 <figure> 结构：

  • 主图使用 book-figure--primary；
  • 图号按“图 X-Y”连续编号；
  • alt 使用中文图名，不再直接使用文件名；
  • 图片居中显示，宽度不超过正文容器，高度最多 760px；
  • 移动端取消高度限制；
  • 点击图片可以在新窗口打开原始 SVG；
  • 图注提供 Mermaid 源文件链接；
  • 主图图注保留阅读提示。

本轮共规范化：

  • 第 1～23 章：90 张图；
  • 前言：1 张图；
  • 合计：91 张正文图。

4. 代码块审校

全书第 1～23 章共有 583 个围栏代码块，其中包含 Java、JSON、YAML、Markdown、伪代码和文本结构示例。

审校规则：

  • 超过 60 行给出警告；
  • 代码块必须支持水平滚动，不撑破正文；
  • 打印时保持完整内容；
  • 接口示例优先展示职责，不扩展为完整项目实现。

本轮结果：最长代码块为 46 行，没有需要强制拆分的代码块。

5. 中文技术书风格

本轮检查继续以 references/glossary.md 和 docs/chapter-style-guide.md 为准：

  • 保留 Agent、Workflow、Context、Tool、Skill、Harness、Runtime、Memory 等稳定英文术语；
  • 不使用“智能体”“子智能体”“多智能体”等替代写法；
  • 中文正文使用中文标点；
  • 工程结论避免拟人化、绝对化表达；
  • Java / Spring Boot 内容继续保持接口优先和架构边界优先。

自动审校未发现上述非推荐术语。

6. 重复内容审校

本轮发现并处理两处实质性重复：

  1. 第 1 章与第 2 章都包含 Prompt / Workflow / Agent 决策表。第 1 章改为三个初步判断问题，并引导读者到第 2 章使用完整决策矩阵复核；
  2. 第 22 章主图与“企业 Agent 平台总览”内联图高度重复，删除内联重复图，并连续调整后续图号和小节编号。

以下概念交叉被判定为递进关系，因此保留：

  • 第 1 章 Agent 基本循环与第 2 章控制权边界；
  • 第 4～8 章 Context 总览、组成、选择、压缩和隔离；
  • 第 15～16 章 Memory 生命周期与检索治理；
  • 第 18～19 章 Multi-Agent 编排与上下文共享；
  • 第 20～21 章 Agent Runtime 与 Managed Agents；
  • 第 22～23 章企业平台架构与 Java Framework 模块映射。

7. 自动化审校命令

# 规范化新增图示
npm run book:format

# 运行出版前结构与资源审校
npm run book:audit

# 清理并完整构建
npm run book:rebuild

# 启动 4005 端口预览
npm run book:serve

book:build 和 book:serve 已自动执行 book:audit，审校失败时不会继续构建或启动。

8. 本轮验证结果

Chapters: 23
Standardized figures: 90
Code blocks: 583
Longest code block: 46 lines
Local links checked: 393
Warnings: 0
Errors: 0
Mobile overflow issues: 0
Chapter image load failures: 0
HonKit build: success

results matching ""

    No results matching ""