企企(77Hub)项目利润分析技能
基于企企服务业 ERP(qiqi CLI)的项目维度利润分析技能,按项目汇总收入/成本/费用,计算利润(利润=收入−成本−费用)与利润率(利润÷收入),输出利润排名 Top N 的 HTML 报告。
目录结构(单层技能包)
qiqi-project-profit-analysis/
├── SKILL.md
├── README.md
├── references/methodology.md
└── scripts/{pull,compute,gen}_project_profit.py
安装方法
解压后把整个 qiqi-project-profit-analysis/ 目录复制到用户级技能目录:
# macOS / Linux
cp -R qiqi-project-profit-analysis ~/.workbuddy/skills/
Windows(PowerShell):
Copy-Item -Recurse qiqi-project-profit-analysis "$env:USERPROFILE\.workbuddy\skills\"
前置条件(需自行准备,本包不包含)
- 基础技能已安装:
qiqi-cli、qiqi-cli-installation、qiqi-business-foundations。 qiqi-financial-analysis已安装(硬依赖):pull_project_profit.py会from qiqi_pull import aggregate_all复用其scripts/qiqi_pull.py的服务端聚合助手,缺失会导致 ImportError。- qiqi CLI 已安装并授权:
npm install --global @77hub/cli,并完成qiqi auth+qiqi profile use。 - 账号具备目标企业的财务单据查看权限。
使用方法(三步脚本)
# 1. 服务端聚合拉取(八类金额按项目分组求和)→ ./out/profit_data.json
python3 scripts/pull_project_profit.py --year 2026 --out ./out
# 2. 合并计算(按项目合并收入/成本/费用)→ ./out/profit_result.json(--top N 控制排名数量)
python3 scripts/compute_project_profit.py --data ./out/profit_data.json --out ./out/profit_result.json --top 10
# 3. 生成 HTML 报告
python3 scripts/gen_project_profit_report.py --data ./out/profit_result.json --out ./out/项目利润排行.html --year 2026 --title "2026 项目利润排行"
参数说明:
pull的--out是输出目录;compute/gen的--data是输入文件、--out是输出文件路径。 取数方式:第 1 步用qiqi find aggregate在服务端完成分组求和,不拉全量明细,查询汇总更高效。
注意事项
- 技能不包含任何账号凭证或企业数据,可安全分享。
- 口径:利润 = 收入 − 成本 − 费用;利润率 = 利润 ÷ 收入(含税本币);仅取「已生效」单据。
- 收入含「不计入往来的收款单」;付款/收款单「不记往来」均按款项类型口径
fundPurpose.isToCa = false过滤(非明细行isToCa)。 - 数据质量:项目维度填写率低(收入约 1/3、成本约 2/3 未挂项目),排名仅覆盖已挂项目部分;部分项目有收入无成本导致利润率虚高,结论中需提示。
- 运行时对象/字段/枚举以实际
qiqi返回为准,技能中的映射是候选参考。
Scan to join WeChat group