用途:把内容先收敛为一个可审计的源,再针对每种交付格式生成其能忠实表达的版本。HTML 保留交互媒体;DOCX、PDF 和 Markdown 生成可编辑或可打印的静态投影,并为媒体保留封面、说明和原链接。
主要能力:支持 html-single、html-dir、md、docx、pdf 等格式,可加 --zip 打包。单文件 HTML 用 Pandoc --embed-resources 内嵌资源;HTML 文件夹保留 assets/ 与交互;Markdown 规范化并保留图片链接;DOCX 嵌入图片,音视频与 iframe 投影为封面、说明和链接;PDF 用 Chromium/Playwright 打印静态 HTML。
使用方式:默认输入为 .md,也支持 .html 和 rich-export.json,相对资源相对输入文件解析。示例:python3 "$SKILL_DIR/scripts/export_rich.py" --input ./release/article.md --out ./release/exports --formats html-single,html-dir,md,docx,pdf --zip。用 --help 查看依赖与选项,输入契约见 references/format-contract.md,产品集成见 references/product-integration.md。
适用场景:用户要求一键导出 HTML、Markdown、DOCX、PDF、ZIP 或离线交付包;导出含图片、音频、视频、iframe、交互图表或媒体说明的内容;为 Web、桌面端或服务端产品接入可复用的多格式导出能力。
限制:只编辑已有 DOCX、PDF 或网页局部内容且不涉及多格式交付时不适用;只生成单张图片、单个幻灯片或一个视频文件时应使用对应媒体工作流。媒体总量超过约 20 MB 时默认同时交付 html-dir;若必须只收一个文件,交付含 HTML 文件夹和 export-manifest.json 的 ZIP。HTML 与打印/办公格式并非等价,交互图表、iframe 和媒体播放能力只在 HTML 保真。每次导出后需按验收清单检查断网刷新、资源路径、DOCX 打开效果、PDF 渲染及 export-manifest.json 的 warnings,不得把内部元数据或提示词当作正文导出。