公司最新财报技能

根据用户输入的公司（股票代码或中文名），调用 money.whatis.vip 的财报接口，获取该公司最新年报的完整财务数据并格式化呈现。

配置（与 dcf-three-scenario / company-checkup 共用）

• 推荐：统一配置路径 ~/.config/godknows/config.json。格式：

  { "api_base": "http://money.whatis.vip", "username": "xxx", "password": "xxx", "token": "获取到的token" }
  

• 脚本可从 config 自动读取 api_base、token；也可通过环境变量 GODKNOWS_API_BASE、GODKNOWS_TOKEN 或传参传入。

首次使用

若尚无 token，向用户询问用户名和密码，在本技能根目录执行：

bash <SKILL_ROOT>/scripts/login.sh <username> <password> [api_base]

登录成功后会写入 ~/.config/godknows/config.json（含 api_base、token、username、password_b64），与 company-checkup、dcf-three-scenario 共用。后续脚本会自动读 token。token 过期时：执行 bash <SKILL_ROOT>/scripts/login.sh（不传参），会从 config 读取账号密码并刷新 token，无需再向用户索要。config 含敏感信息，请勿泄露。

后续使用

直接使用 config 中的 token。若 API 返回 errorCode: "NOT_LOGIN"，先执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）从 config 刷新 token，无需再向用户要账号密码；仅当 config 无账号密码或刷新失败时再向用户询问并执行带参 login.sh。

• 公司需在平台已有数据（可选公司列表内），否则可能返回「未找到该公司年报财务数据」。

工作流程

<SKILL_ROOT> 为本技能根目录（如 ~/.cursor/skills/company-latest-report）。

1. 解析公司

   • 若输入为股票代码（如 AAPL、00700），直接使用。
   • 若为中文名或模糊名，执行 bash <SKILL_ROOT>/scripts/companies.sh [api_base] [token]，在返回的 data[].label 中匹配得到 value（ticker）。
   • 若 companies.sh 返回 errorCode: "NOT_LOGIN"：先执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）从 config 刷新 token，再重试 companies.sh，无需向用户索要密码。

2. 获取最新财报数据

   • bash <SKILL_ROOT>/scripts/latest_report.sh <ticker> [api_base] [token]
   • 调用 GET /api/filing/latest-cash-flow/{ticker}，返回最新年报的完整财务数据（DupontAnalysisVO）。
   • 若返回 NOT_LOGIN：先执行 bash <SKILL_ROOT>/scripts/login.sh（不传参）刷新 token，再重试 latest_report.sh。

3. 格式化呈现

   • 根据返回的 JSON 整理为易读报告：公司名、ticker、财年/季度；杜邦三要素与 ROE；关键损益与现金流；偿债与资产结构等。可参考 references/api-filing.md 字段说明。金额单位需注明（如百万美元或换算为亿）。
   • 历年 ROE/净利润率趋势：须完整列出 data.yearlyTrends 的全部年份，以表格呈现，不得节选或只展示最近几年。

API 与响应

• 通用响应：{ "success": true|false, "data": <payload>, "message": "..." }
• 失败时用 message 提示用户（如未找到年报、需先同步财务数据）。
• GET /api/filing/latest-cash-flow/{ticker} 的 data 结构见 references/api-filing.md。

错误与边界

• 未配置 api_base 或 token：先尝试执行无参 scripts/login.sh 从 config 刷新；若 config 无账号密码再按首次使用向用户询问并执行带参 login.sh。
• 公司不存在或无年报数据：直接返回接口错误信息，建议用户确认股票代码或先在平台同步该公司财务数据。
• 若返回 NOT_LOGIN：先执行 scripts/login.sh（不传参）从 config 自动刷新 token 并重试请求，无需向用户要账号密码；仅当无参 login 失败（如 config 无 username/password_b64）时再向用户索要账号密码。