利润分析器

状态： MVP 草稿 · 负责人： JJ · 版本： 1.1.0 类别： 财务与运营 · 阶段： V2

快速开始

当中小企业主问"我应该涨价吗？"或"我的利润正常吗？"时，此技能：

1. 确定分析对象 — 哪些产品/服务在范围内
2. 从 QuickBooks（COGS、直接费用）提取成本数据
3. 从 PayPal 或 Square 提取收入数据（交易历史）
4. 计算单位经济效益 — 每项的收入、COGS、毛利润、利润率百分比
5. 对照背景进行基准测试 — 通胀、成本变化、行业标准（如可用）
6. 构建定价情景 — 显示在+5%、+10%、+15%价格变化下收入和利润的变化，在数据允许时使用历史相关性
7. 呈现分析 — 无价格建议；由负责人决定

输出结果使负责人能够基于真实数据做出自己的定价决策。

工作流程

第1步：前置检查

QuickBooks： 调用 company-info 验证行业字段是否已填写。如果缺失或显示"未知"，询问："我需要您的业务类别来提取相关基准。您在哪个行业？"然后调用 quickbooks-profile-info-update。

PayPal： 无需前置检查，但 PayPal 在快速调用时会有速率限制——参见 reference/gotchas.md。

无连接器： 提供 CSV 上传作为回退方案。此技能可以处理导出的交易和费用数据。预期的 CSV 模式见 reference/csv-schema.md。

第2步：澄清范围

向负责人询问两个问题：

1. "您想分析哪些产品或服务？"

   • 全部，还是特定子集？
   • 如果他们说"全部"，在提取所有内容前确认连接器有足够数据以确保有意义。

2. "哪个指标对您最重要？"

   • 毛利润（收入减去直接成本）？
   • 净利润（扣除所有费用后）？
   • 每单位收入？
   • 他们的答案决定了您如何呈现输出。

第3步：提取成本数据（QuickBooks）

使用 profit-loss-quickbooks-account 从 QuickBooks 获取：

• 日期范围： 最近12个月（如果可用数据不足则使用全部历史）
• 提取： 按产品/服务线划分的销售成本、直接费用

如果 QuickBooks 未连接，请负责人提供：

• 按产品/服务线划分的成本明细（每项的材料、人工、直接交付成本）
• 过去6-12个月内任何已知的成本变化

如果 QuickBooks 已连接但所有期间的 COGS = $0，不要使用 $0 作为成本输入。向负责人说明：

"QuickBooks 显示此期间未记录任何销售成本。要计算有意义的利润，我需要按产品或服务线划分的成本明细——而不是整个业务的单一平均值。对于您想分析的每个项目，交付它的成本是多少？材料、直接人工、每项的直接费用。即使是粗略数字也可以。"

在最终输出的数据质量说明部分标记此限制。

第4步：提取收入数据（PayPal / Square）

从 list_transactions（PayPal）或 make_api_request（Square）获取：

• 日期范围： 与成本数据窗口一致（最近12个月）
• 提取： 交易金额、项目/服务名称、日期、数量（如可用）

如果遇到 PayPal 速率限制，暂停30秒并重试一次。如果仍然受限，提供："PayPal 暂时被限速。要切换到 Square 或上传 CSV 吗？"

如果只有一个数据源可用，在输出中注明限制。

第5步：计算单位经济效益

对于范围内的每个产品/服务，计算：

标记任何利润率低于20%的项目——不是作为建议，而是作为值得负责人关注的数据点。

第6步：基准测试

加入背景使数字有意义：

• 通胀： 如果讨论投入成本上升，注意相关的成本趋势。示例："在此期间您的投入成本上升了约X%，而您的价格保持不变——这使利润率压缩了Y个百分点。"
• 行业基准： 使用 QuickBooks 行业资料显示其类别的大致毛利率标准。参见 reference/industry-benchmarks.md。
• 历史比较： 如果有24个月以上的数据可用，将今年的利润率与去年的进行比较以显示趋势方向。

优雅处理数据不足的情况：如果交易历史少于6个月，省略弹性部分并注明："您需要至少6个月的定价历史才能估算销量如何响应价格变化。我将改为展示情景计算。"

第7步：定价情景

为每个产品/服务构建一个表格，显示三种价格变化情景：

如何计算预计收入：

• 如果有6个月以上的历史： 使用历史数据估算销量反应。如果存在过去的价格变化，计算观察到的弹性：弹性 = 销量变化百分比 ÷ 价格变化百分比。应用于在新价格下预测销量。
• 如果历史不足： 显示三种销量假设（−0%、−5%、−10%）并让负责人选择看起来合理的选项。

添加说明："这些是基于可用数据的预测，并非保证。实际的销量反应取决于竞争、客户敏感度和时机。"

第8步：呈现分析

按如下结构组织输出：

以 H2 标题开头，显示业务名称和日期范围，后跟四个部分：单位经济效益摘要表（产品/服务、收入、COGS、毛利润、利润率百分比）、背景与基准测试部分（2-4句话关于通胀、成本变化、行业标准）、定价情景（每个产品的情景表，如果项目多则仅显示前3-5个）、数据质量说明（标记任何限制，如部分数据、缺少 COGS 或短暂历史）。

保持事实性。不要说"您应该涨价"或"考虑降价。"负责人在看数据以做出自己的判断。

范围边界

此技能呈现数据。它不建议价格。

如果负责人问"那我该怎么做？"——回复："我可以向您展示数据的含义，但定价决策由您自己做出。您希望我建模其他情景吗？"

这是有意为之。定价决策有真实的业务后果，并取决于只有负责人知道的背景（竞争定位、客户关系、资金需求）。此技能的工作是确保他们在做决策时看到的是真实数字。

连接器

主要： QuickBooks、PayPal 也支持： Square、Brex · 桌面（CSV/导出）

参考文件

• reference/gotchas.md — 常见陷阱（数据缺口、弹性陷阱、利润计算错误）
• reference/industry-benchmarks.md — 按中小企业类别划分的毛利率范围
• reference/csv-schema.md — 负责人上传 CSV 时的预期列
• reference/examples/ — 工作场景（零售、服务、产品型）