技能介绍

要解决什么问题

做中港美上市公司研究时，分部业务（收入、成本、毛利、营业利润、EBITA）往往散落在年报/季报的 HTML 或 PDF 表格里，手工抄进 Excel 既慢又容易漏期、漏层级。本技能面向「本地已有财报文件」的场景：你说公司名或代码，它从 workspace/portfolio//filings/ 里读已下载披露，抽出分部指标，生成按业务树展开的 Excel，而不是让你自己拼命令或联网拉数。

怎么工作

触发方式很简单，用自然语言即可，例如「腾讯的分部财报」「BABA 分业务收入和 EBITA」。Agent 侧推荐一步：extract_segments.py --ticker <代码> --excel，引擎会按文件扩展名走 HTML/PDF 解析，成功时 stdout 最后一行 是 xlsx 绝对路径。

输出落在 workspace/excels/{ticker}_segments_{timestamp}.xlsx。表格是横向多期、纵向分部×指标：A 列分部名、B 列指标名，C 列起为各期（新期在左）。每个分部固定尝试 收入 → 成本 → 毛利 → 营业费用 → 营业利润 → EBITA，全空指标会隐藏；毛利/营业利润/EBITA 后自动跟 YoY 与对应利润率行。最多 L1→L2→L3 三级，L1 分组配色、子级用 ├─/└─ 缩进；若 L1 未披露总收入/EBITA（港股常见），会用子孙分部同期值累加补全。

开箱即用 ticker 含 BABA、PDD、TCOM、MSFT、GOOG、BEKE（美股 HTML）及 00700、83690（港股 PDF 等专用 layout）。新公司需在 config/extraction/ 增 .json 配 segment 别名；港股 PDF 往往还要列位置映射或专用 handler。

边界与注意

不联网、不调富途 API，与 futu-financial-report 不同；缺文件会直接提示先用 futu-filing 下载，不会编造数据。
--ticker 只认代码（中文名先查 ticker）；配置文件名是 BABA.json 这类，不要传 US.BABA。
数字来自原始披露解析，单位保留原币百万/千元，与富途标准化 API 口径可能对不齐；港股 PDF 单份解析可能较慢。
重跑前关掉已打开的 Excel，避免文件锁；诊断信息在 stderr，路径只看 stdout 最后一行。