财务报告分析器

从上传的 Excel/PDF 文件生成财务分析报告，支持内联 SVG 折线图趋势图表，并提供多格式输出。

快速开始

python3 scripts/generate_report.py input.xlsx -o pdf --company "公司名" --ticker "000001.SZ"

输出格式

-o 标志控制输出结果。HTML 始终作为基础格式生成，其他格式均基于 HTML 转换。

工作流程

步骤 1：获取数据文件

按以下顺序尝试：

1. 飞书聊天中的文件附件 —— 通过 API 下载：

   # 获取 token
   TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
     -H 'Content-Type: application/json' \
     -d '{"app_id":"APP_ID","app_secret":"APP_SECRET"}' | python3 -c "import json,sys; print(json.load(sys.stdin)['tenant_access_token'])")
   # 从消息中获取 file_key
   curl -s "https://open.feishu.cn/open-apis/im/v1/messages/{message_id}" -H "Authorization: Bearer $TOKEN"
   # 下载文件
   curl -s "https://open.feishu.cn/open-apis/im/v1/messages/{message_id}/resources/{file_key}?type=file" \
     -H "Authorization: Bearer $TOKEN" -o /tmp/data.xlsx

获取应用凭证：从 openclaw.json 中读取 channels.feishu.appId / appSecret。

1. 飞书文档/飞书多维表链接 —— 使用 feishu_doc / feishu_bitable 工具
2. 本地文件 —— 直接使用
3. 粘贴文本 —— 解析并保存为 xlsx

步骤 2：生成报告

python3 scripts/generate_report.py /tmp/data.xlsx -o pdf \
  --company "百济神州-U" --ticker "688235.SH" --output-dir /tmp/reports

步骤 3：网络搜索增强（可选）

搜索行业基准数据：

web_search("{company} 行业对比 市场份额 {year}")

步骤 4：通过飞书 API 发送文件

message 工具可能将路径作为文本发送。建议直接使用飞书 API 发送真实文件消息：

# 1. 上传文件以获取 file_key
UPLOAD=$(curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/files' \
  -H "Authorization: Bearer $TOKEN" \
  -F 'file_type=stream' \
  -F "file_name=report.html" \
  -F "file=@/path/to/report.html")
FILE_KEY=$(echo "$UPLOAD" | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['file_key'])")

# 2. 向聊天发送文件消息
curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"receive_id\":\"CHAT_ID\",\"msg_type\":\"file\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}"

报告功能

• 折线图趋势图表：每个指标行包含一个内联 SVG 图表，显示趋势（实线=实际值，虚线=预测值）
• 预测标记：预测值以 ⟡ 符号标注，并用黄色背景突出显示
• 颜色编码：绿色=正向，红色=负向
• 响应式布局：适用于移动端与桌面端
• 打印就绪：包含 CSS 打印样式

指标定义

详见 [references/metrics.md](references/metrics.md) 了解财务指标的计算方式。