illustrated-manual-word

图解 Word 手册

将主题或技术资料制作成可编辑的 Word 手册，包含结构图、原理图、步骤图、说明文字和可追溯来源。流程包括资料核查、图片选择或绘制、Word 编排、实际渲染和逐页检查。

适用范围

• 产品部件与操作说明、机械和科学原理图解、带剖面与状态图的读物、软件机制的概念类比。
• 输入可以是对象、机制、仓库或资料。默认中文、A4 纵向，面向无专业背景的成年人；读者和用途可按任务调整。
• 不用于认证维修手册、制造公差或压力设计、医疗和危险操作指南。纯润色、PDF 转 Word、统计报告不适用本流程。

输入与输出

在 BRIEF.md 记录对象、型号或版本、读者问题、真实结构或概念类比、适用范围、排除事项、用途与篇幅。仅在缺项会改变事实或安全结论时询问。

输出可下载的 .docx；保留 book.json、media.json、来源、图形源码和生成记录。PDF 与逐页预览用于验收，不替代 Word。标题、正文、步骤、图注、表格和来源为 Word 原生内容；内嵌插图为 PNG，图内零件和短标签不承诺在 Word 中独立编辑。

先完成小样章，再扩展全书。delivery_kind=sample-chapter 必须声明 sample_objectives 和 sample_limits；完整书使用 production，最低编辑单元、图数、视图和字数只用于识别空壳，不证明出版质量。technical-smoke 只用于技术测试，不作为成品交付。

中性内容与平台分发

• 描述只说明用途、输入、输出和操作方法，不加入本 Skill 的作者介绍、个人称呼、团队署名、开发故事、推广语或内部调度说明。
• Word 正文、封面、图注、表格、页眉页脚及图片替代文字只保留主题内容。页眉用书名或中性系列名，页脚用页码；不加入制作人、助手人设、平台推荐和无关制作说明。
• 构建器不写入作者或最后修改者；清空备注、关键词等默认模板元数据。保留中性的主题标题和适用范围，不把旧书稿的作者字段自动带入新文件。
• 用准确、客观的说明替代自我评价和夸张措辞；型号差异、来源、AI 图片披露、必要警告和适用限制不得因中性化而删除。
• 分发前检查文档属性、隐藏文字、批注、修订及外部链接。未解决的审阅记录不能静默删除或视为通过；生成干净副本并保留原稿。
• 包内不含个人绝对路径、账号、凭据、内部沟通记录、缓存或临时日志。第三方依赖的许可证和必要版权声明独立保留，不混入手册正文。本 Skill 的许可不替代外部图片或品牌素材的许可。

前提

通过当前宿主的命令工具运行 python <skill>/scripts/manual.py preflight。Word 构建需要 python-docx 和 Pillow；排版验收需要 PyMuPDF 和 LibreOffice。SVG 需要 Node 或 Python 绘图，以及 rsvg-convert、CairoSVG、Chrome 中至少一种栅格工具。依赖见 scripts/requirements.txt，在项目虚拟环境安装，不修改宿主全局环境。

搜图和生图使用宿主已有工具，不绑定模型、平台或账号。图片搜索不可用时回到来源网页或 PDF；不读取凭据、不打包密钥、不虚构工具执行结果。官方图片也需要核对使用权。

命令

<skill> 为本 Skill 根目录，<project> 为独立书稿目录。路径均可替换；脚本不会自动安装服务、调用另一个 AI 或执行发布。

python <skill>/scripts/manual.py preflight
python <skill>/scripts/media.py plan <project>/figure-brief.json
python <skill>/scripts/media.py fetch https://public.example/image.png --out <project>/research/image.png --allow-host public.example
python <skill>/scripts/media.py check <project>/media.json --out <project>/qa/media-check.json
python <skill>/scripts/media.py contact <project>/media.json --out <project>/qa/contact.png
python <skill>/scripts/manual.py raster <project>/figures/figure.svg --out <project>/figures/figure.png --width 2400
python <skill>/scripts/manual.py validate <project>/book.json
python <skill>/scripts/manual.py build <project>/book.json --out <project>/out/book.docx
python <skill>/scripts/manual.py render <project>/out/book.docx --out-dir <project>/qa
python <skill>/scripts/manual.py inspect <project>/out/book.docx --out <project>/qa/package.json
python <skill>/scripts/distribution_check.py <project>/out/book.docx
python <skill>/scripts/manual.py qa <project>/book.json <project>/out/book.docx --qa-dir <project>/qa
python <skill>/scripts/test_manual.py
python <skill>/scripts/test_media.py