中港美股上市公司财务报表 Excel 导出

要解决什么问题

做基本面或投研时，你往往需要的是整份利润表、资产负债表或现金流量表落在 Excel 里做筛选、对比和存档，而不是在对话里零散问几个数字。中港美标的代码格式不一（US.BABA、HK.00700、SH.600519），报表口径和期数（利润表按季度累计披露、另两表按年度）也容易搞混；自己拼富途 OpenD、futu-api 和导出脚本，运维成本高。

技能如何工作

你用自然语言说明公司名或代码和想要的报表即可，例如「腾讯最近 16 个季度利润表」或「BABA 资产负债表」。编排侧会先解析标的（必要时查代码），再经 generate_financial_excel.py 调用项目内的 futuapi 子进程，通过本机 Futu OpenD 网关只读拉取富途财务接口数据，用 openpyxl 写出 Excel。

输出默认在 workspace/excels/{代码}_{报表类型}_{时间戳}.xlsx，布局为指标在左、时间在右；利润表会附带毛利率、费用率等比率行，多数数值指标带 YoY 行，并按收入/成本/利润等类别配色，冻结窗格并带筛选。脚本成功时以一行 JSON 返回 excel_path 等字段，便于 Agent 只报路径和覆盖区间，而不是把整表贴回聊天。

适用边界与注意点

• 环境：依赖 OpenD 已启动并登录富途账号，且账号具备对应市场行情权限；本技能只用行情/财务只读接口，不涉及交易。
• 报表类型：income / balance / cashflow 三选一；--num 对利润表是季度条目数（默认 16），对资产负债表和现金流量表是年数，底层单页最多约 50 条。
• 与分部财报区分：此处是合并三表总计指标；按业务分部拆解需用 segment-financial-report 等另路技能。
• 使用时机：适合「导出整表」；单点指标问答可优先更轻量的查询类工具，避免无谓全量拉取。