Back to skills
extension
Category: Data & AnalyticsNo API key required

企企服务业ERP项目利润分析

企企服务业ERP项目利润分析。当需要基于企企管理云数据按项目维度统计收入/成本/费用,计算项目利润(利润=收入−成本−费用)与利润率,并输出利润排名 Top N 列表或 HTML 可视化报告时使用。适用于"项目利润分析""项目利润率排名""哪些项目最赚钱"等诉求。依赖已就绪的 qiqi CLI 运行时与 qiqi-financial-analysis 技能提供的 qiqi_pull.py 辅助脚本。

personAuthor: u_389ac655hubenterprise

企企(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\"

前置条件(需自行准备,本包不包含)

  1. 基础技能已安装qiqi-cliqiqi-cli-installationqiqi-business-foundations
  2. qiqi-financial-analysis 已安装硬依赖):pull_project_profit.pyfrom qiqi_pull import aggregate_all 复用其 scripts/qiqi_pull.py 的服务端聚合助手,缺失会导致 ImportError。
  3. qiqi CLI 已安装并授权npm install --global @77hub/cli,并完成 qiqi auth + qiqi profile use
  4. 账号具备目标企业的财务单据查看权限。

使用方法(三步脚本)

# 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 返回为准,技能中的映射是候选参考。