成本分析报告生成器

从项目费用 Excel 文件自动生成按客户分类的成本分析报告。

触发条件

当用户：

上传类似 EVP 项目费用.xlsx 的文件并要求生成成本分析报告
提到"按客户分类生成成本报告"、"提炼成本分析"、"整理项目费用"
发送包含客户费用数据的 Excel 文件

核心功能

自动识别客户分类：帝国、BAT、MT、ITMS 等
费用分类汇总：
- HR 费用（人工费用）
- 试产/打样费用（打样 + 制造 + 物料耗用）
- 测试费用（测试 + 外发认证）
- 开发投资（开模 + 改模）
- 其他费用（IDC、品烟、其它、手板）
时间维度：2025 年（12 个月）、2026 年（1-2 月）
数据指标：年度汇总、月均、月度明细
格式化输出：千分符、两位小数、美化样式

使用方法

方式 1：直接运行脚本

python3 ~/.openclaw/workspace/skills/cost-report-generator/scripts/generate_cost_report.py <源文件路径> [输出目录]

示例：

python3 ~/.openclaw/workspace/skills/cost-report-generator/scripts/generate_cost_report.py ~/Desktop/EVP_项目费用.xlsx

方式 2：通过 Python 调用

from scripts.generate_cost_report import generate_cost_report

output_file = generate_cost_report(
    source_file="/path/to/EVP_项目费用.xlsx",
    output_dir="/path/to/output"  # 可选，默认为源文件所在目录
)

输入文件格式

必需列

客户大类：客户分类（帝国、BAT、MT、ITMS 等）
项目大类：项目名称/类别
内部订单号：订单编号

费用列（按年份和月份）

支持的费用类型：

人工费用
打样费用
制造费用
物料耗用
测试费用
外发认证费用
开模费用
改模费用
IDC 费用
品烟费用
其它费用
手板费用

列名格式：{年份} 年{月份} 月{费用类型}，如：

25 年 1 月人工费用
25 年打样费用（年度汇总）
26 年 1-2 月人工费用

表头位置

脚本默认使用第 4 行（索引 3）作为表头。如果源文件格式不同，需要调整 header 参数。

输出报告结构

工作表

2025 年成本分析：按客户分类展示 2025 年 1-12 月数据
2026 年成本分析：按客户分类展示 2026 年 1-2 月数据

列结构（每个客户分类）

| 列范围 | 内容 | |--------|------| | A-C | 基本信息（客户大类、项目大类、内部订单号） | | D-E | HR 费用（汇总、月均） | | F-R | HR 费用月度明细（1-12 月） | | S-T | 试产/打样费用（汇总、月均） | | U-AG | 试产/打样费用月度明细 | | ... | 其他费用类别同理 | | 最后两列 | 总计（汇总、月度合计） |

样式特点（必须严格遵守）

表头：深蓝色背景 (#2E74B5) + 白色文字，微软雅黑字体
子标题：浅蓝色背景 (#D6EAF8) + 深色文字
数据行：交替使用白色/浅灰色背景 (#F8F9FA)，便于阅读
总计列：黄色高亮 (#FFEB9C) + 粗体，突出显示
月度合计：绿色高亮 (#C6EFCE) + 粗体
数字格式：#,##0.00（千分符 + 两位小数），所有数值统一
对齐方式：文本左对齐，数字右对齐
列宽：基本信息列加宽（14-20），月度列统一（10），总计列加宽（14）
边框：细边框 + 浅灰色 (#CCCCCC)

月均计算逻辑

2025 年：年度汇总 ÷ 12
2026 年：年度汇总 ÷ 2（因为只有 1-2 月数据）

脚本会自动统计实际有数据的月份数，并按以下规则计算：

max_months = 2 if year == 2026 else 12
divisor = min(actual_months_count, max_months)
monthly_avg = monthly_sum / divisor

注意事项

表头位置：确保源文件的表头在第 4 行（索引 3），否则需要调整 header 参数
客户分类：只处理"帝国"、"BAT"、"MT"、"ITMS"四类，其他会被忽略
数据完整性：如果某些月份数据缺失，月均计算会自动调整除数
输出位置：默认保存到源文件所在目录，可通过 output_dir 参数指定

故障排除

问题：读取数据为空

原因：表头位置不正确

解决：检查源文件的表头位置，修改脚本中的 header 参数：

df = pd.read_excel(source_file, sheet_name='Sheet1', header=3)  # 调整为正确的行号

问题：费用数据为 0

原因：列名格式不匹配

解决：检查源文件的列名格式，确保包含"年"、"月"等关键字，如25 年 1 月人工费用

问题：客户分类缺失

原因：客户大类列的值与预期不符

解决：检查"客户大类"列的实际值，必要时在脚本的 valid_customers 列表中添加新的客户类型

分享与发布

本地使用（当前用户）

技能已安装在 ~/.openclaw/workspace/skills/cost-report-generator/，当前 OpenClaw 会话可直接使用。

分享给其他飞书用户

方式 1：通过 ClawHub 发布（推荐）

# 1. 登录 ClawHub
clawhub login

# 2. 发布技能
clawhub publish ~/.openclaw/workspace/skills/cost-report-generator \
  --slug cost-report-generator \
  --name "成本分析报告生成器" \
  --version 1.0.0 \
  --changelog "初始版本：支持 EVP 项目费用文件自动生成成本分析报告"

其他用户安装：

clawhub install cost-report-generator

方式 2：直接共享技能文件夹

将 ~/.openclaw/workspace/skills/cost-report-generator/ 打包发送给其他用户，让他们放到自己的 ~/.openclaw/workspace/skills/ 目录下。

方式 3：通过 OpenClaw 团队空间

如果多个用户共享同一个 OpenClaw workspace，技能会自动对所有用户可见。

技能元数据（发布用）

name: cost-report-generator
version: 1.0.0
description: 从项目费用 Excel 自动生成按客户分类的成本分析报告
author: Richard 张
tags: [成本分析，财务报告，Excel, 飞书]

Cost Report Generator