核心用法
Office Generator Py 是一个基于本地 Python 引擎的办公文档生成工具，支持创建 Microsoft Word (.docx)、Excel (.xlsx) 和 PowerPoint (.pptx) 文件。该 skill 提供两种工作模式：标准模式（通过完整 JSON 请求文件指定文档类型、模板和内容规范）和商业模式（通过预设的 kind 参数快速生成常见业务文档，如工作报告、会议纪要、项目计划等）。
首次使用需运行 setup_engine.py 安装依赖，后续通过 generate_office.py 脚本执行生成任务。工具内置 6 种业务模板（3 类 Word、2 类 Excel、2 类 PPT），支持从结构化 JSON 或自然语言需求转换为 Office 文档。
显著优点
- 本地化执行：不依赖云端 API，数据保留在本地环境
- 多格式覆盖：一站式解决三大主流 Office 格式的生成需求
- 模板化工作流：内置业务模板降低配置成本，提升常见文档产出效率
- 灵活输入：支持原始 JSON 与简化命令行参数两种调用方式
- 明确输出契约：成功时返回文件路径，失败时通过 stderr 输出错误信息
潜在缺点与局限性
- 环境依赖：需预装 Python 3 及虚拟环境，首次配置存在技术门槛
- 模板有限：目前仅 6 个内置模板，复杂或定制化需求需自行扩展
- 无可视化编辑：纯命令行交互，不支持实时预览或 WYSIWYG 调整
- 输入格式约束：自然语言需求需手动转换为结构化 JSON，增加了中间步骤
适合人群
- 需要批量生成标准化业务文档的办公自动化用户
- 希望将文档生成集成到本地工作流的技术人员
- 对数据隐私敏感、倾向于本地处理而非云端方案的企业用户
常规风险
- 路径安全：脚本接收绝对路径参数，需注意输入路径的合法性校验，避免路径遍历攻击
- 依赖管理：Python 依赖包的供应链安全风险，建议锁定依赖版本并审计
- 文件覆盖：输出路径若已存在文件将被覆盖，需确认目标路径安全性
- 编码问题：要求 UTF-8 编码的 JSON 输入，编码错误可能导致生成失败
- 沙箱缺失：文档生成过程在当前用户权限下执行，恶意模板或内容可能触发系统调用（若模板引擎支持脚本执行）