外观
第 46 章 Research Brief：从书籍扩展到课程、博客和知识库
要解决的读者问题
一本技术书完成后，团队通常还想得到课程、工作坊、博客、FAQ、知识库条目和网站内容。最省事的做法是复制章节、删去一些段落，再为不同平台重新排版；它也最容易制造漂移：书稿事实已更新，博客仍引用旧接口；课程目标要求“能诊断”，练习却只让学员复述定义；FAQ 没有来源锚点；知识库片段脱离版本和权限语境；读者反馈直接改写事实源，却没有审查记录。
本章研究一个受限的内容供应链：书稿继续作为规范事实源，图示、示例、术语和经核验片段成为带锚点的候选内容原子；每种媒介按照自己的读者任务重新编排，并保存派生清单、学习目标、版本、许可、校验与反馈候选。它不是“一键多渠道发布器”，也不承诺同一段文字适合所有媒介。
研究范围与非范围
| 读者问题 | 本章研究的回答 | 本章不回答 |
|---|---|---|
| 哪些资产可以复用？ | 复用经过确认的事实、示例输入、图源、术语 ID 和来源锚点；叙述顺序、导语、练习、标题与互动必须按媒介任务判断。 | 把章节段落切块后自动发布，或把任何 Markdown 标题都当作稳定内容原子。 |
| 怎样把章节变成课程？ | 先定义学习路径、前置能力、可观察目标、练习、反馈与评估证据，再选择章节材料。 | 以播放时长、页数、测验数量或完成按钮证明学习效果。 |
| 博客与 FAQ 如何保持准确？ | 每个派生物保存源章节版本、事实复核日期、目标读者、删减边界和刷新触发。 | 要求短文包含整章所有限定语，或让营销文案覆盖规范书稿。 |
| 知识库怎样回链？ | 知识库条目保存 Source Anchor、适用范围、更新时间和失效条件；检索结果仍需第 13 章的证据判断。 | 把知识库、索引、搜索结果和事实答案合并为同一对象。 |
| 反馈如何回到书稿？ | 将反馈记录为待核验候选，先判断媒介局部问题还是规范事实缺口，再进入对应审查阶段。 | 让点击率、评论、模型摘要或单个读者意见直接改写书稿。 |
已核验的一手资料与受限用途
| 本地键 | 来源明确表达的内容 | 允许用于本章的范围 | 不可外推 |
|---|---|---|---|
| CH46-REF-01 | Diátaxis 区分教程、操作指南、参考和解释，并将它们对应到不同用户需求。 | 支持派生内容先明确读者任务和内容职责，而不是复制同一叙述。 | 四类是唯一内容产品、完整质量标准或本章派生物 Schema。 |
| CH46-REF-02 | OASIS DITA 1.3 将 DITA 描述为面向主题、按信息类型组织、可复用和 single-source 的 XML 架构，并提及培训与教育材料。 | 支持“可复用内容需要明确边界和类型”的标准背景。 | 本书必须使用 DITA/XML，或 Markdown Content Atom 已符合 DITA。 |
| CH46-REF-03 | Carnegie Mellon Eberly Center 要求学习目标、评估和教学策略对齐，并建议以学生可做的动作表达可测目标。 | 支持课程派生必须从学习目标和评估证据出发。 | 某个课程已对齐、学员已掌握或该方法适合所有场景。 |
| CH46-REF-04 | Schema.org 的 LearningResource 开发版提供教学、评估、前置能力、教育层级和资源类型等属性。 | 作为 Derivative Content Manifest 的候选字段背景。 | 字段是强制标准、所有平台支持或本仓库已经实现。 |
| CH46-REF-05 | W3C PROV-DM 表达实体、活动、Agent 以及生成、使用、派生和归属等关系。 | 支持记录源章节、转换活动、派生物和责任者之间的溯源关系。 | 保存关系就证明内容正确、授权充分或反馈合并安全。 |
访问日期均为 2026-07-17。CH46-REF-01 至 CH46-REF-05 分别映射 REF-132、REF-145、REF-146、REF-147 与 REF-135。完整 URL 与外推禁区见本章参考资料。
单一事实源不是单一文本副本
“单一来源”容易被误解成所有渠道共享同一段文字。本章把它拆为三层：
- 规范事实源： 经当前版本审查的书稿、来源映射、示例与术语登记。
- 派生契约： 声明哪个版本、哪些锚点、面向谁、要教会什么、允许省略什么。
- 媒介实现： 按课程、博客、FAQ 或知识库的阅读和交互方式重写。
事实、接口、引用和术语身份可以复用；叙述顺序、篇幅、练习、反馈、标题和行动召唤通常需要重写。若规范源变化，派生物不会自动正确，只会因为 Manifest 的版本差异而成为可检测的刷新候选。
本书的内容供应链模型
| 工件 | 最小字段 | 主要责任 | 不承担的责任 |
|---|---|---|---|
| 内容原子（Content Atom） | atomId、类型、源锚点、源版本、正文或资产引用、事实复核日期、许可、状态。 | 为可复用事实、示例、图示和术语提供稳定身份。 | 不保证脱离上下文仍正确，也不要求原文逐字复用。 |
| 来源锚点（Source Anchor） | 仓库路径、章节/小节 ID、版本、引用键、适用范围。 | 让派生物能定位规范输入。 | 不证明来源在线、内容新鲜或派生解释正确。 |
| 学习路径契约（Learning Path Contract） | 受众、前置、可观察目标、顺序、练习、评估、反馈、完成证据。 | 将章节材料编排成可练习的教学路径。 | 不证明学员掌握或认证有效。 |
| 派生内容清单（Derivative Content Manifest） | 派生物 ID、媒介、受众、源版本、所用原子、重写项、删减边界、责任者、校验、刷新触发。 | 固定“这份内容从哪里来、为何这样改”。 | 不执行转换、发布或平台同步。 |
| 发布适配档案（Publication Adapter Profile） | 目标平台、输入/输出格式、链接规则、资源约束、可访问性检查、预览与回滚入口。 | 把媒介实现与平台约束分开。 | 不授予凭证、上传权限或平台兼容保证。 |
| 反馈候选记录（Feedback Candidate Record） | 派生物、位置、反馈、观察时间、证据、影响范围、候选目标、裁决状态。 | 防止渠道反馈无审查地覆盖规范源。 | 不把热度、评论或模型建议变成事实。 |
| 一致性门（Consistency Gate） | 源版本、锚点可定位、引用/术语一致、目标-练习-评估对齐、链接、渲染、责任人。 | 在预览或发布候选前阻止可检测漂移。 | 不证明技术事实、学习效果、可访问性合规或出版批准。 |
这些字段是本书工程模型，不是 DITA、Schema.org、PROV-DM 或任一 LMS/发布平台的实现。
五种派生物需要不同重写
| 派生物 | 主要读者任务 | 可复用候选 | 必须重写或新增 | 最小完成证据 |
|---|---|---|---|---|
| Tutorial | 第一次跟随步骤获得可观察结果。 | 已核验前置、示例输入、关键图。 | 连续步骤、检查点、错误恢复、结束状态。 | 新手能按步骤产生并解释目标观察。 |
| Workshop | 在有限时间内练习并获得反馈。 | 示例、诊断卡、评估标准。 | 时间盒、讲师提示、分组活动、练习数据、反馈。 | 目标、活动与评估逐项映射，试讲问题有记录。 |
| Blog | 快速理解一个具体观点并决定下一步。 | 单一论点、图示、短案例、来源回链。 | 标题、导语、篇幅、上下文和行动入口。 | 每项事实可回链，删减未改变适用范围。 |
| FAQ | 解决一个可定位的高频疑问。 | 定义、限制、错误模式、相关章节。 | 问题措辞、短答案、升级入口、更新时间。 | 答案不越过证据范围，过期触发明确。 |
| Knowledge Base Entry | 在工作中检索当前、范围明确的操作或事实。 | 参考字段、命令、状态、来源锚点。 | 产品/版本/权限范围、失效条件、维护者。 | 候选能回链并通过第 13 章的证据门。 |
案例：把“最小 Harness”拆为三种产品
本章以第 28 章为仓库内案例，但不在 Research 阶段真正生成派生物。
Tutorial 候选
- 目标：读者能装配一个纯内存最小 Harness，观察
ready或带原因码的stopped。 - 复用：
minimal-harness-admission-assessment.mjs的接口、测试输入、流程图和术语锚点。 - 重写：安装前置、逐步输入、每步观察、错误恢复和结束解释。
- 禁止：把第 28 章测试通过写成读者环境或真实 Tool 已运行。
Workshop 候选
- 目标：学员能为缺证据、权限缺失和允许执行三个场景写判断，并解释失败出口。
- 复用：示例案例、状态语义、完成检查表。
- 新增：时间盒、分组练习、讲师 rubric、独立预期答案和复盘问题。
- 禁止：把完成练习等同生产环境授权或 Agent Engineering 能力认证。
FAQ 候选
- 问题：“最小 Harness 是否等于一个 Prompt 加工具调用？”
- 复用：第 28 章对目标、输入、边界、状态、证据和验收的限定。
- 重写：短答案、反例、何时升级到完整工作流和源章节回链。
- 禁止：为了简短删除“计划/执行/验证不可互相替代”的核心边界。
三个派生物引用同一规范源，但拥有不同目标、结构、验证和刷新触发；不能由一个共享文本片段替代所有媒介责任。
版本、许可与刷新
派生清单至少比较三类版本：源章节版本、派生物版本和发布适配档案版本。任一变化都可能只让某些派生物失效：接口字段变化影响 Tutorial 与 KB；核心论点变化影响 Blog 与 FAQ；平台链接规则变化只影响适配档案。
每个派生物还必须记录当前仓库许可、第三方资产许可和署名要求。仓库存在 LICENSE 只能证明当前文件声明；它不自动覆盖外部图片、长引用、商标、课程平台条款或未来新增素材。本章不提供法律意见。
刷新触发包括：源锚点不存在、源版本落后、引用复核日期过期、术语 ID 改名、示例接口变化、图示替换、目标与评估不再对齐、平台适配规则变化。检测到触发只生成 refresh_required，不得自动改写并发布。
反馈回流必须先分类
渠道反馈可分为：
- 媒介局部问题： 博客导语不清楚、练习时间不足、FAQ 问题措辞不匹配。
- 派生契约问题： 受众、前置、目标、删减边界或刷新策略错误。
- 规范事实候选： 书稿事实、示例、术语或来源可能过期。
- 无充分证据： 单个评论、点击率或模型建议没有可定位问题。
只有第三类在补齐来源、影响范围和复现证据后，才能进入书稿的 Research/Fact Check/Technical Review；其他类别留在相应派生物。任何反馈都不能直接写成“读者已经学会”或“书稿事实错误”。
计划图示
Mermaid 图将规范书稿、Content Atom、Derivative Content Manifest、Learning Path Contract、五种媒介适配、一致性门、预览候选、人工发布决定和反馈候选连接为供应链。图必须显示：
source_reused ≠ medium_readypreview_validated ≠ publication_approvedfeedback_received ≠ source_changed- 版本、引用或目标漂移回到对应重写/复核阶段，而不是直接覆盖书稿。
计划纯内存示例
Example Implementation 可实现 assessDerivedContentPackage(input)，只读取注入的：
sourceSnapshotcontentAtomslearningPathderivativeManifestadapterProfileconsistencyEvidencefeedbackCandidatespublicationRequest
函数返回 needs_source_evidence、needs_medium_rewrite、learning_alignment_failed、refresh_required、ready_for_preview_review 或 publication_approval_required。它不读取仓库、不生成课程/博客/FAQ、不访问 LMS、CMS、知识库或搜索索引、不调用模型、不修改书稿，也不上传、发布或收集读者数据。
主要风险与后续核验
- 复制漂移： 派生物保留文字却丢失来源、版本或限定语。
- 错误复用粒度： 章节小节被当作原子，但内部同时承担解释、步骤和参考职责。
- 目标装饰化： 课程写了学习目标，练习与评估却无法观察该动作。
- 元数据幻觉： 候选字段被写成目标平台支持或真实 Schema。
- 许可扩张： 仓库许可被错误外推到第三方图、引用和平台条款。
- 反馈污染： 热度或模型摘要未经核验覆盖规范事实源。
TODO(verify)：Chapter Outline 逐节映射五项来源、本书工件、案例和失败出口。TODO(verify)：First Draft 当天重读 Diátaxis、Schema.org 与仓库LICENSE，并重新核对第 28 章当前接口。TODO(verify)：Example Implementation 只使用注入对象；没有授权时不得读取真实平台、发布或收集数据。TODO(verify)：Final Review 必须以当轮命令证明源锚点、示例、图示、链接、状态和全仓校验，不沿用历史结果。
下一阶段建议
Chapter Outline 应按“规范事实源 → Content Atom → Learning Path Contract → Derivative Content Manifest → 媒介重写 → Consistency Gate → 人工发布决定 → Feedback Candidate”组织。案例贯穿第 28 章的 Tutorial、Workshop 和 FAQ 三条派生路径；每一节都要标明可复用、必须重写、最小证据和不可声称的真实执行。