自己开发的skill-Office Suite Report

案例与作品 作品分享
1

Office Suite Report - 一键生成数据报告三件套的利器

项目简介

Office Suite Report 是一个强大的工具，能够从单一数据源一键生成协调一致的办公三件套（XLSX + PPTX + DOCX），为您的业务报告提供专业、美观的解决方案。

为什么选择 Office Suite Report？

核心优势

  1. 一键生成三件套：从单一配置文件同时生成 Excel 分析表格、PowerPoint 演示文稿和 Word 文档，节省大量手动操作时间
  2. 数据一致性：所有文件使用相同的数据源，确保数据在不同文件中保持一致，避免手动复制粘贴导致的错误
  3. 专业格式：内置精心设计的专业格式和样式，包括图表、条件格式、表格样式等，让您的报告看起来更加专业
  4. 高度可定制：支持自定义颜色方案、内容结构和输出格式，满足不同场景的需求
  5. 智能生成：根据提供的数据自动调整输出内容，缺失数据的部分会被智能跳过，确保生成的文件始终保持完整和专业

技术特点

  • 统一配置：使用单一 JSON 配置文件管理所有数据，简化数据管理流程
  • 跨语言实现：结合 Python 和 Node.js 的优势，分别处理不同类型文件的生成
  • 专业库支持：使用 openpyxl、pptxgenjs 和 docx 等专业库，确保生成文件的质量和兼容性
  • 模块化设计：清晰的代码结构，便于维护和扩展

应用场景

Office Suite Report 适用于多种业务场景：

  • 季度/年度报告：快速生成包含数据分析、演示文稿和正式文档的完整报告套件
  • 销售分析：从销售数据生成专业的分析表格、展示幻灯片和详细报告
  • 业务回顾：为业务回顾会议准备全套材料，包括数据、图表和文字说明
  • 项目总结：生成项目总结的完整文档套件，方便团队和管理层查阅

快速开始

安装依赖

# 安装 Python 依赖
pip install openpyxl

# 安装 Node.js 依赖
npm install pptxgenjs docx

准备配置文件

创建一个 config.json 文件，按照以下结构填写数据：

{
  "company": "星辰科技",
  "title": "2026年Q1销售业绩汇报",
  "period": "2026 Q1",
  "department": "销售管理部",
  "date": "2026年4月",
  "color_primary": "1F4E79",
  "color_secondary": "2E75B6",
  "color_accent": "4BACC6",
  "dimensions": {
    "regions": [
      {"name": "华东", "sales": 2075, "orders": 680, "target": 2000, "yoy": 0.221}
    ],
    "products": [
      {"name": "云服务", "sales": 2680, "share": 0.315, "yoy": 0.253}
    ]
  },
  "kpis": [
    {"label": "总销售额", "value": "8,500", "unit": "万元", "icon": "¥"}
  ],
  "monthly": [
    {"month": "1月", "sales": 2550}
  ],
  "top_sales": [
    {"rank": 1, "name": "张伟", "region": "华东", "product": "云服务", "sales": 486.5, "rate": 1.215, "new_clients": 18}
  ],
  "insights": [
    {"title": "3月爆发增长", "desc": "环比增长25.4%\n春季订单集中释放"}
  ],
  "outlook": {
    "title": "Q2 展望与目标",
    "target": {"label": "Q2 销售目标", "value": "10,000", "unit": "万元"},
    "strategies": [
      {"title": "深耕云服务赛道", "desc": "加大云服务在华北、西南的市场拓展"}
    ]
  },
  "sections": [
    {
      "title": "一、Q1业绩概况",
      "content": [
        {"type": "paragraph", "text": "本季度整体表现优异..."}
      ]
    }
  ]
}

生成文件

# 创建输出目录
mkdir -p output

# 生成 XLSX 文件
python scripts/generate_xlsx.py config.json output/report.xlsx

# 生成 PPTX 文件
node scripts/generate_pptx.js config.json output/report.pptx

# 生成 DOCX 文件
node scripts/generate_docx.js config.json output/report.docx

生成文件预览

Excel 分析表格 (XLSX)

  • 区域摘要：包含各区域销售额、订单数、目标完成率等数据，使用条件格式直观展示完成情况
  • 产品线摘要：展示各产品线的销售情况和占比
  • 销售排名：列出 Top 销售业绩，使用条件格式突出显示

PowerPoint 演示文稿 (PPTX)

  • 封面：包含公司名称、报告标题和装饰性图形
  • KPI 卡片：展示关键业绩指标，带有图标和阴影效果
  • 区域分析：使用条形图展示各区域销售情况
  • 产品分析：使用环形图展示产品销售占比
  • 月度趋势：使用折线图展示月度销售趋势
  • 销售排名：展示 Top 销售业绩，带有 medal 徽章
  • 展望与策略：展示未来目标和策略
  • 感谢页：简洁的结束页面

Word 文档 (DOCX)

  • 封面：包含公司名称和报告标题
  • 目录：自动生成的目录结构
  • 结构化内容：按照配置文件中的 sections 生成的详细内容
  • 专业表格：带有彩色表头和交替行颜色的表格
  • 页眉页脚：包含公司名称、报告名称和页码

技术架构

核心组件

  1. 配置系统：统一的 JSON 配置文件，包含所有生成文件所需的数据
  2. 生成器：
    • generate_xlsx.py - 使用 openpyxl 生成 Excel 文件
    • generate_pptx.js - 使用 pptxgenjs 生成 PowerPoint 文件
    • generate_docx.js - 使用 docx 生成 Word 文件
  3. 数据处理：从配置文件中提取数据并转换为各文件格式所需的结构

技术栈

  • Python：用于生成 Excel 文件
  • Node.js：用于生成 PowerPoint 和 Word 文件
  • openpyxl：Python 库，用于创建和修改 Excel 文件
  • pptxgenjs：Node.js 库，用于生成 PowerPoint 文件
  • docx：Node.js 库，用于生成 Word 文件

定制与扩展

颜色定制

通过在配置文件中设置 color_primary、color_secondary 和 color_accent 字段，可以自定义生成文件的颜色方案。

内容定制

  • Word 文档：通过配置文件中的 sections 数组完全控制文档内容，可以自由添加、删除和重新排序章节
  • PowerPoint 幻灯片：当配置文件中提供相应数据时，才会生成对应的幻灯片（如月度趋势、销售排名、展望等）
  • Excel 工作表：当提供 top_sales 数据时，才会生成销售排名工作表

扩展建议

  • 添加更多图表类型和样式
  • 支持更多数据源格式（如 CSV、数据库等）
  • 开发图形界面，方便用户填写配置
  • 添加更多行业特定的模板

项目地址

Office Suite Report - 让业务报告生成更简单、更专业！

无论是季度报告、销售分析还是业务回顾，Office Suite Report 都能为您提供一站式的专业解决方案。立即尝试，体验高效、一致、专业的报告生成流程！

1 个赞
✨ 阿呆每日精选【4月6日】