work-export

work-export

用途

作为 work 命名空间的通用 Outflow 基座，提供从内容（Markdown / 结构化数据 / 大纲）到目标格式文档的统一导出管线。

本技能不实现格式生成逻辑，而是编排社区上游技能（docx/pdf/xlsx/pptx），提供：

• 统一的格式选择决策树
• 标准化的输出校验流程
• 与 work-markitdown（Inflow）形成闭环

依赖

• depends: docx（md→docx）、pdf（md→pdf）、xlsx（data→xlsx）、pptx（outline→pptx）
• 协作: work-markitdown（Inflow 侧）、work-convert（格式互转）
• 被依赖: work-sc-* 场景技能

适用场景

• 从 Markdown 内容导出为 Word 文档（报告、手册、合同等）
• 从 Markdown 内容导出为 PDF
• 从结构化数据导出为 Excel 表格
• 从大纲/结构导出为 PowerPoint 演示文稿
• 为 work-sc-* 场景技能提供底层导出能力

不适用场景

• 需要精确格式控制的专业排版 → 直接调用社区上游 docx / pdf 技能
• 文件格式互转（docx→pdf）→ 用 work-convert
• 解析/读取文档内容 → 用 work-markitdown

格式选择决策树

用户需要导出什么格式？
├─ Word (.docx)
│   → 调用 docx 社区上游技能
│   → docx-js 生成 / pandoc 转换
├─ PDF (.pdf)
│   → 调用 pdf 社区上游技能
│   → reportlab 生成 / soffice 转换
├─ Excel (.xlsx)
│   → 调用 xlsx 社区上游技能
│   → openpyxl 生成
├─ PowerPoint (.pptx)
│   → 调用 pptx 社区上游技能
│   → pptxgenjs 生成
└─ 多种格式
    → 按依赖顺序：源文档 → 派生导出
    → 例：先生成 docx，再从 docx 转 pdf

工作流

Markdown → Word

1. 确认 Markdown 源文件内容已确认
2. 调用 docx 技能生成 .docx
3. 校验：在 Office/WPS 中打开确认格式正确

Markdown → PDF

1. 确认 Markdown 源文件内容已确认
2. 选择管线：
   • 直接生成：reportlab / md-to-pdf
   • 经 docx 中转：先生成 docx → soffice --convert-to pdf
3. 校验：渲染页面确认排版

数据 → Excel

1. 确认数据源（CSV / JSON / 数据库查询结果）
2. 调用 xlsx 技能生成 .xlsx
3. 校验：打开确认公式无错误、格式正确

大纲 → PowerPoint

1. 确认大纲结构（标题/要点层级）
2. 调用 pptx 技能生成 .pptx
3. 校验：缩略图预览确认布局

统一输出校验

每种格式导出后 MUST 执行：

格式	校验项
docx	Office/WPS 打开无报错，标题/段落格式正确
pdf	页数正确，无截断/空白页，中文无乱码
xlsx	公式无 #REF!/#VALUE! 错误，表头对齐
pptx	缩略图预览，文字不溢出，图片显示正常

与 work 生态的协作

内容 (Markdown/数据/大纲)
    │
    ▼
work-export (本技能：内容→目标格式)
    │
    ├─→ docx (社区上游：Word 生成)
    ├─→ pdf  (社区上游：PDF 生成)
    ├─→ xlsx (社区上游：Excel 生成)
    └─→ pptx (社区上游：PPT 生成)

推荐输出格式

执行完毕后按以下结构输出：

状态：✅ 成功 / ⚠️ 部分成功 / ❌ 失败

<输入→输出文件/格式/路径>	<值/状态>	说明

下一步：<可执行动作>

约束

• 不实现格式生成逻辑，完全依赖社区上游技能
• 多格式导出时按依赖顺序执行（源文档 → 派生导出）
• 每次导出后 MUST 输出校验结果和文件路径
• 中文文档默认使用思源黑体或微软雅黑