用 S&P Capital IQ 数据生成单页融资交易摘要…

当用户要求按周/月汇总某行业或关注公司的融资交易、生成 deal flow digest 或资本市场简报幻灯片时使用。

适用场景

解决思路

1. 在查询融资前，先用 get_info_from_identifiers 批量预校验所有公司标识符（Rule 0）：检查是否解析成功，并查看 status 字段——Operating 可查询融资；Operating Subsidiary 表示被母公司持有、不会有独立融资轮，仅作为背景注明；其他状态表示公司已停止运营，可能只有历史数据。把全部候选公司放进一次 get_info_from_identifiers 调用中批量处理并分类。
2. 永远不要轻信空结果：若 get_rounds_of_funding_from_identifiers 对预期有数据的公司返回空，改用法定实体名或 company_id 重试（常见品牌名→法定名映射如 Together AI → "Together Computer, Inc."、Character.ai → "Character Technologies, Inc."、Runway ML → "Runway AI, Inc."，可查 references/sector-seeds.md 的别名表）；若仍为空，用 get_info_from_identifiers 确认公司是否存在于 S&P（可能太早期或未被收录）。
3. 识别子公司：被大公司全资持有或作为事业部的公司（如 Alphabet 下的 DeepMind、Microsoft 下的 GitHub、Voodoo 下的 BeReal）融资轮为零，资本事件记在母公司层面；通过 get_info_from_identifiers 的 status="Operating Subsidiary" 或 references/sector-seeds.md 中的 ⚠️ 标记识别并跳过融资查询。
4. 以 get_rounds_of_funding_from_identifiers 作为主要数据源，不要用 get_funding_summary_from_identifiers：后者更快但更不可靠，可能报错或数据不完整；summary 工具仅用于快速聚合检查（总融资额、轮次数），若结果偏低必须用 rounds 工具复核。
5. 大批量处理（50+ 公司）时按 15–20 家分批；每批后检查返回空结果的公司，并在继续前按 Rule 1 的兜底步骤重试。
6. 正确设置 role 参数：company_raising_funds 表示"X 融了哪些轮"（公司视角），company_investing_in_round_of_funding 表示"投资方 Y 投了什么"（投资方视角）；用错会静默返回空结果。做 deal flow digest 几乎总是用 company_raising_funds，只有专门分析某投资方组合时才用投资方视角。
7. 注意标识符解析大小写不敏感但拼写敏感："openai" 等于 "OpenAI"，但 "Character AI" 可能失败而 "Character.ai" 成功；不确定时直接用 company_id（如 C_1829047235）保证解析。
8. 确定覆盖范围与周期：回访用户沿用其既有 watchlist（查对话历史）；新用户需询问 sectors（至少一个）、可选的具体公司、时间周期（默认最近 7 天），并据此计算精确的 start_date 和 end_date。
9. 构建公司池：从领域知识（references/sector-seeds.md）选种子公司，注意其中的 ⚠️ 警告与别名说明；立即用 get_info_from_identifiers 预校验全部种子，分为"已解析且 Operating"与"未解析或子公司"两类；仅用已解析种子调用 get_competitors_from_identifiers(competitor_source="all") 扩展；再对扩展结果做 get_info_from_identifiers 校验，按 simple_industry 过滤匹配目标行业，剔除未解析和子公司。每个行业保持 15–40 家已解析且运营中的公司。
10. 拉取融资轮：对全部公司调用 get_rounds_of_funding_from_identifiers(identifiers=[batch], role="company_raising_funds", start_date="YYYY-MM-DD", end_date="YYYY-MM-DD")，大批量按 15–20 家分批；收集所有 transaction_id 后，用 get_rounds_of_funding_info_from_transaction_ids 一次性（或少数几次）传入全部 ID 批量富化，不要逐条调用。
11. 从每轮融资中提取：transaction_id（用于 Capital IQ 链接）、公告日期、交割日期、融资金额、投前估值、投后估值、领投方、轮次类型、证券条款、顾问、定价趋势（up/down/flat）。公告日期和交割日期必须出现在最终幻灯片的交易表中；若只有一个日期，显示它并把另一个标为 "—"。
12. 对重要交易（大额轮次、估值显著变化）用 get_company_summary_from_identifiers 获取公司简介，为叙述补充背景（如"这家 2021 年成立的 AI 基础设施初创公司正在拓展……"）。
13. 设计幻灯片前先分析数据讲故事：标记 Notable 项（≥$100M 的轮次、down round、新晋独角兽即投后估值突破 $1B、估值较上次 ≥2x 的跳升、6 个月内重复融资、异常庞大的投资方团）；识别趋势（本期总资本 vs 常态、最热子行业、轮次阶段分布、最活跃投资方、地域集中度、估值趋势）；提炼 3–5 条一句话、有力、有数据支撑的关键要点作为幻灯片核心。
14. 生成公司 logo 时使用两级本地流程，不要用已废弃且常失败的 Clearbit（logo.clearbit.com），也不要依赖需要 API key 或被网络限制的外部 CDN（Brandfetch、logo.dev、Google Favicons）：第一级用 npm install simple-icons sharp 安装后离线查找品牌 SVG（先精确匹配 title，再剥离 AI/Inc./Corp./Ltd. 等后缀重试），用 sharp 把 SVG 按品牌官方色（icon.hex）转成 128×128 透明 PNG；第二级对未命中的公司用 sharp 生成灰底（BDBDBD）白字首字母圆形 PNG 兜底，保证 100% 覆盖。所有 logo 存到 /home/claude/logos/[company-name].png，幻灯片上以 0.35"–0.5" 高度作为点缀展示，风格保持一致。
15. 生成单页 PPTX 前先读 /mnt/skills/public/pptx/SKILL.md 和 pptxgenjs.md，用 pptxgenjs 创建单页幻灯片，布局为：深色标题栏（标题+周期+行业+日期）、4 个统计卡片（总融资额、轮次数、平均投前估值、最大单轮）、3–5 条带 logo 的关键要点、4–6 笔重要交易的紧凑表格、页脚。
16. 严格采用极简单色设计：背景 FFFFFF、标题栏 1A1A1A、正文 1A1A1A、次要文字 6B6B6B、边框 D0D0D0、卡片底 F5F5F5、链接 2B5797；语义色仅少量使用（down round 用 C0392B 的小点/标签，突出正向指标用 2E7D32），无数据支撑时完全不用彩色；公司 logo 是唯一全彩元素；除 logo 和链接外，幻灯片应能在黑白打印机上正确呈现；绝不给背景、装饰条、分隔线着色。
17. 交易表列包含 Company、Type、Announced（MMM DD 格式）、Closed（MMM DD 格式）、Amount、Pre-Money、Post-Money、Lead Investor、Deal Link；Announced 和 Closed 列必须始终存在，缺失显示 "—"；估值未披露显示 "—"；Deal Link 用 pptxgenjs 单元格的 options.hyperlink 指向 https://www.capitaliq.spglobal.com/web/client?#offering/capitalOfferingProfile?id=<transaction_id>，文字为 "View →"、颜色 2B5797、字号 9；表头用 1A1A1A 填充白字，交替行 F5F5F5 与 FFFFFF；表格必须水平居中，x = (SLIDE_W - sum(colW)) / 2（16:9 时 SLIDE_W=13.33），绝不左对齐贴边；单元格不用彩色填充，down round 仅在金额旁加红色小字标签 "(↓ down)"。
18. 页脚必须包含强制 AI 免责声明，以醒目黄色横幅置于幻灯片底部："Analysis is AI-generated — please confirm all outputs"；页脚小字用中灰色写 "Deal Flow Digest · [Period] · Sources: S&P Global Capital IQ · Generated [Date]"。
19. 用工厂函数（而非共享对象）创建阴影和重复样式，遵循 pptxgenjs 的 pitfalls 指引。
20. QA 幻灯片：用 python -m markitdown deal-flow-digest.pptx 做内容 QA，核对所有文字、数字、公司名、估值和交易链接；用 python /mnt/skills/public/pptx/scripts/office/soffice.py --headless --convert-to pdf 再 pdftoppm -jpeg -r 200 转图做视觉 QA，检查元素重叠、文字溢出# 对齐、低对比度文字、logo 尺寸和链接文字可见性；核对 Capital IQ URL 的 transaction_id 是否正确；至少完成一轮修复并复验。
21. 交付结果：把最终 .pptx 复制到 /mnt/user-data/outputs/，用 present_files 分享，并用 2–3 句话口头总结（覆盖多少轮、总融资额、最显著的一笔交易及其估值、任何令人担忧的趋势如 down round 或估值压缩）。
22. 错误处理：已知公司返回空先查 get_info_from_identifiers，失败再试别名或 company_id；子公司（DeepMind、GitHub、Instagram、WhatsApp、YouTube、BeReal 等）零独立融资轮，标注为"被收购/子公司"而非"无活动"；已停运公司（如 2023 年 10 月关停的 Convoy）仍能解析但永无新活动，查 references/sector-seeds.md 确认；summary 工具报错或返回零时回退到 rounds 工具；投资方视角查询为空时检查 role 参数是否用反。
23. 数据质量问题处理：某行业零融资轮时在幻灯片上明确写 "No transactions recorded in [Sector] during the period"（无活动本身也是信息）；估值数据稀疏时在页脚注明数据限制并用 "—"，把统计卡片换成其他指标（如 Median Round Size）；logo 获取失败时用 simple-icons 兜底，若 simple-icons 或 sharp 安装失败则退回 pptxgenjs 形状首字母（灰色椭圆+白色文字叠加），无需外部依赖；超过 6 笔重要交易时表中只显示前 6 并加脚注 "+N additional deals not shown"，按交易规模排序；100+ 公司的多行业 digest 按 15–20 家分批调用 API，重要交易优先于次要交易；竞争对手扩展结果过少时说明种子太窄，补充 2–3 个知名公司重新扩展；transaction_id 无法生成有效 Capital IQ URL 时省略该行链接单元格，不要放坏链。

适用边界 · 注意事项

• 没有 S&P Global Capital IQ 访问权限或相关工具（get_info_from_identifiers、get_rounds_of_funding_from_identifiers 等）时无法使用。
• 用户不需要幻灯片交付物、只要纯文本融资摘要时，不必走完整的 PPTX 生成与 QA 流程。
• 公司太早期或未被 S&P 收录、且无法通过别名或 company_id 解析时，无法获取其融资数据。