内容合规与事实核验自检清单
本清单用于每章交付前自检,目标是降低:事实错误、过期信息、敏感风险、读者无法复现。
A. 事实核验(必须)
Section titled “A. 事实核验(必须)”- 本章涉及的版本、日期明确(至少包含“基准版本 + 采集日期”)。
- 所有关键断言都有可追溯来源(至少 3 个:官方文档、GitHub Release/Issue、权威文章/公告)。
- 命令、配置字段、截图与 UI 文案与
facts/openclaw-baseline.md对齐。 - 所有外部链接可访问,且尽量指向“原始来源”(避免二手转载)。
B. 可复现性(必须)
Section titled “B. 可复现性(必须)”- 所有动手步骤从“空环境”开始也能跑通(必要前置清楚列出)。
- 每个步骤都包含“预期现象”(读者知道自己做对了)。
- 常见错误至少覆盖 3 个高频坑,并给出排查路径。
C. 合规与敏感性(必须)
Section titled “C. 合规与敏感性(必须)”说明:我无法替代出版社终审;这里只做工程化的“风险压低”。
- 不涉及政治敏感话题与现实政治评论。
- 不包含黄赌毒等违法违规内容、引导或描绘细节。
- 不包含绕过平台风控、入侵、窃取信息等违法指导(包括“看起来只是学习用途”的细节)。
- 涉及隐私与数据:明确提醒读者不要上传敏感信息;建议脱敏与最小权限。
- 不影射具体个人/组织的负面评价;对安全事件只引用公开披露与权威来源。
D. 表达与结构(建议)
Section titled “D. 表达与结构(建议)”- 开头 1 页内明确本章收益与路径。
- 概念解释不超过 2 段就进入动手。
- 结尾有小结与下一章过渡。
E. 出版社 13 条对齐(必须)
Section titled “E. 出版社 13 条对齐(必须)”- 本章存在章首语;若为篇首章,对应篇首语也已提供。
- 标题层级符合“章-节-小节”结构;长段内容已拆分为结构化小节。
- 全章术语统一(同一概念不混用多套名称)。
- 首次术语可中英对照,后文不重复加英文注释。
- 图片先文后图,图题/编号完整,图中文字可读且不过密。
- 表格先文后表,表题/编号完整,表格可编辑(非截图)。
- 代码可复制、非截图,注释已中文化。
- 无敏感表述、无网络化用语、无不当价值导向内容。
- 引用内容(图/表/观点/原文)均有明确来源标注;无大段未授权照搬。
F. .dotx 模板对齐(必须)
Section titled “F. .dotx 模板对齐(必须)”- 章节层级符合模板口径(章
X、节X.Y、小节X.Y.Z)。 - 每篇有篇首语、每章有章首语(均为 1~2 段导读)。
- 图、表在正文中均“先文后图/表”,并预留图题/表题位置。
- 代码内容可复制可编辑,后续可直接映射到“代码清单”样式。
- 连续大段(超过一页)已拆分为结构化小节,避免无标题堆叙。