office-generator-pyOffice文件生成器

Generate Office files with a bundled Python engine. Use when creating or exporting Word (.docx), Excel (.xlsx), or PowerPoint (.pptx) files from structured JSON, reports, meeting minutes, project plans, trackers, business briefs, or natural-language requirements that must be turned into Office documents.

作者: admin | 来源: ClawHub

Office Generator Py

使用 scripts/engine/ 下捆绑的引擎生成 Office 文件。

首次运行

将 Python 依赖安装到捆绑的虚拟环境中：

bash
python3 skills/office-generator-py/scripts/setup_engine.py

如果你自行管理环境，可以通过 OFFICEGENERATORPYTHON=/path/to/python 将包装器指向另一个 Python 二进制文件。

快速工作流程

1. 确定输出类型：docx、xlsx 或 pptx。
在适用时优先选用内置业务模板。
编写 UTF-8 编码的 JSON 请求文件。
运行 scripts/generate_office.py。
返回生成的文件路径。

入口点

使用 scripts/generate_office.py。

- 标准模式：通过 --type 传入完整的 JSON 请求文件。
业务模式：通过 --kind、--title、--input 和 --out 传入参数。

内置模板

Word

- wordworkreportv1
meetingminutes_v1

Excel

- exceldatatrackerv1
projectplan_v1

PPT

- pptbusinessbriefv1
projectstatusbriefv1

内置业务类型

- word-report
meeting-minutes
excel-tracker
project-plan
ppt-brief
project-status-brief

命令

标准模式：

bash
python3 skills/office-generator-py/scripts/generate_office.py \
--type docx \
--input /absolute/path/request.json \
--out /absolute/path/output.docx

业务模式：

bash
python3 skills/office-generator-py/scripts/generate_office.py \
--kind meeting-minutes \
--title Office 评审会纪要 \
--purpose 内部存档 \
--input /absolute/path/content.json \
--out /absolute/path/meeting_minutes.docx

请求格式化

如果用户仅提供自然语言，请先将其转换为 JSON。

有关支持的请求格式和示例负载，请阅读 references/input-formats.md。

输出约定

- 成功：标准输出打印生成的文件路径。
失败：标准错误输出打印错误信息；命令以非零状态退出。

注意事项

- 尽可能使用绝对路径作为输出路径。
对于常见文档类型，优先使用业务模式。
当调用方已拥有完整的 documentType/templateId/contentSpec JSON 时，使用标准模式。

office-generator-pyOffice文件生成器