cashflow-viewer
Cashflow Viewer
从 GodKnows 投资分析平台获取公司最新年报的现金流量表数据。港股仅看年报现金流；美股也返回最新年报口径。本技能为通用技能，安装到统一目录后可供 Cursor、Qoder 等多种 agent 引用。
安装
使用 skills CLI 从 registry 安装（全局安装到 ~/.agents/skills/）：
npx skills add http://skills.whatis.vip --skill cashflow-viewer -g
安装后技能根目录为 ~/.agents/skills/cashflow-viewer/。Cursor、Qoder 等可配置为直接引用 ~/.agents/skills/，或由 npx skills add 同步到各自 agent 目录。下文的 <SKILL_ROOT> 即该技能根目录。
配置（与安装位置解耦）
- 推荐：使用统一配置路径
~/.config/godknows/config.json（与技能安装位置无关，可与 company-checkup 等 GodKnows 技能共用）。格式：{ "api_base": "http://money.whatis.vip", "username": "xxx", "password": "xxx", "token": "获取到的token" } - 运行时可将该文件中的
api_base、token通过环境变量 GODKNOWS_API_BASE、GODKNOWS_TOKEN 传给脚本；或调用脚本时直接传参[api_base] [token]。 - 也可在技能根目录下放置
config.json。
首次使用
若尚无 token，向用户询问用户名和密码，在技能根目录下执行：
bash <SKILL_ROOT>/scripts/login.sh <username> <password> [api_base]
将 token 与 api_base 写入 config；后续可经环境变量或参数传入。
后续使用
直接使用 config 中的 token；若 API 返回 errorCode: "NOT_LOGIN"，需重新执行 login.sh 并更新 config。
执行流程
1. 解析用户输入
支持股票代码或公司中文名。若为中文名，先调用公司列表（与 company-checkup 同一接口）：
bash <SKILL_ROOT>/scripts/companies.sh [api_base] [token]
在 label 中模糊匹配得到 ticker。
2. 调用最新年报现金流接口
bash <SKILL_ROOT>/scripts/cashflow.sh <ticker> [api_base] [token]
接口：GET {api_base}/api/filing/latest-cash-flow/{ticker}，返回含完整现金流量表字段的杜邦 VO。
3. 格式化输出
从 JSON 提取现金流相关字段，格式化为中文报告。单位：金额为百万美元，展示时可换算为亿（÷100）。包含：财年/报告期；经营活动（折旧摊销、股票薪酬、营运资本变动、经营现金流净额）；投资活动（资本支出、其他投资、投资现金流净额）；融资活动（股息、股票/债务净额、融资现金流净额）；自由现金流、现金净变动额。空值显示为 — 或 N/A。
4. 错误处理
errorCode: "NOT_LOGIN"→ 提示重新登录并更新 configsuccess: false或未找到数据 → 提示该公司可能未同步或暂无年报- 中文名匹配不到 → 列出候选公司供选择