financial-reporting

财务报告

用途

此技能可通过汇总数据、创建可视化图表，并确保符合 GAAP 或 IFRS 等标准，生成和分析财务报告。它会处理财务数据集，为报告任务提供可执行的洞见。

适用场景

在编制季度财务摘要、年度审计、合规检查，或对损益表和资产负债表进行临时分析时使用此技能。在与会计软件集成或可视化财务指标趋势时，也可使用此技能。

主要功能

• 数据汇总：通过 API 端点 /api/v1/aggregate?start_date=2023-01-01&end_date=2023-12-31 从数据源提取数据，并支持按账户和货币筛选。
• 可视化：使用 Matplotlib 等库生成图表；例如，使用 plot_type='pie'&data_source='expenses' 创建费用明细饼图。
• 合规工具：根据规则检查报告，例如使用 compliance_check('GAAP', report_data) 验证总额，并返回布尔结果。
• 分析函数：执行比率分析，例如使用 calculate_ratio('debt_to_equity', balance_sheet_data) 计算并输出浮点数值。
• 导出格式：支持 JSON、CSV 或 PDF 输出；使用 export_format='PDF'&file_path='/reports/q1.pdf' 进行配置。

使用模式

在 Python 脚本中导入模块，或通过 CLI 调用此技能。首先使用 $FINANCIAL_API_KEY 进行身份验证，然后再汇总数据并开展分析。在脚本中，应使用 try-except 代码块处理调用，以提高错误恢复能力。常见模式：获取数据、处理数据、生成可视化图表并导出。工作流示例：aggregate_data() -> analyze_data() -> generate_report()。

常用命令/API

• CLI 命令：openclaw financial-report aggregate --start-date 2023-01-01 --end-date 2023-12-31 --key $FINANCIAL_API_KEY
  • 汇总数据并输出到 stdout。
• API 端点：POST /api/v1/reports/generate，JSON 请求体：{"type": "balance_sheet", "data": {"assets": 100000}}
  • 需要以下标头：Authorization: Bearer $FINANCIAL_API_KEY
• 代码片段（Python）：

  import openclaw_financial
  api_key = os.environ.get('FINANCIAL_API_KEY')
  report = openclaw_financial.generate_report('income_statement', api_key)
  

• 另一个代码片段（用于分析）：

  from openclaw_financial import analyze
  result = analyze.calculate_ratio('quick_ratio', {'cash': 50000, 'receivables': 30000, 'liabilities': 100000})
  print(result)  # Outputs: 0.8
  

• 配置格式：使用 JSON 配置，例如在名为 .financial-config.json 的文件中写入 {"api_endpoint": "/api/v1/aggregate", "auth_key": "$FINANCIAL_API_KEY", "default_currency": "USD"}。

集成说明

运行命令前，设置环境变量 $FINANCIAL_API_KEY 以进行身份验证。对于外部系统，使用 SDK 进行连接；例如，在 Node.js 应用中，引入此软件包并传入密钥：const client = new FinancialClient(process.env.FINANCIAL_API_KEY);。确保数据源兼容（例如 CSV 或兼容 API 的数据源）。对于 Web 应用，可在服务器配置中添加标头，以处理 /api/v1/* 端点的 CORS。

错误处理

通过检查 401 响应并提示输入 $FINANCIAL_API_KEY 来处理身份验证错误。对于数据错误（例如日期无效），在代码中捕获 ValueError 等异常：try: openclaw_financial.aggregate_data(start_date) except ValueError as e: print(f"Error: {e} - Use YYYY-MM-DD format")。对于 API 超时，使用指数退避重试逻辑；可通过 requests 库实现：response = requests.get(url, headers, timeout=10)。记录所有错误及其详细信息（例如端点不存在时返回的错误代码 404），以便调试。

具体使用示例

1. 生成季度资产负债表：使用 CLI：openclaw financial-report generate --type balance_sheet --period Q1-2024 --key $FINANCIAL_API_KEY。此命令会汇总资产和负债，并输出用于审计的 PDF 报告。
2. 分析收益趋势：在 Python 中获取数据并生成可视化图表：

   import openclaw_financial
   data = openclaw_financial.aggregate_data('earnings', os.environ['FINANCIAL_API_KEY'])
   openclaw_financial.visualize(data, 'line', 'earnings_trend.png')
   

   此图表会绘制季度收益，以便识别增长模式。

图关系

• 相关技能：accounting-tools（用于账簿管理）、data-visualization（用于生成图表）
• 集群：financial（与 budgeting 和 forecasting 技能共享数据源）
• 依赖项：需要 data-analysis 集群提供底层功能
• 关联：通过 /api/v1/compliance-check 等共享 API 端点连接到 compliance-auditing