星财富AI – 港股新股 IPO 打新分析

概述

港股新股 IPO 分析

港股新股（IPO / 打新）一站式分析：鉴权 → 自家 MCP 取数 → 富模板 HTML 报告，一条链路走到交付。数据面 = 自家 MCP 的 5 个取数 tool ＋ 宿主自带 westock-data（只兜发行日期），按四层优先级取数（见 §2.1）：MCP 结构化真值 → Dify 母本 → MCP 补充信源 → 宿主新股日历；联网只放行宿主自带的 WebSearch / WebFetch（只补发行日期缺口）；Windows / macOS / Linux 同一套命令，唯一依赖是 Python 3.8+。

本技能只做四件事：过闸 · 列新股 · 出报告 · 交付一条路径。除本文列出的命令外，不要自作主张。

list 与 report 彻底独立：问名单只跑 list，列完即停；用户点名代码/名字只跑 report，禁止先 list。两条命令不共享状态、互不前置。

🗺️ 速览

0 · 🔐 鉴权（最高优先级，先于一切）

Key 没过闸：不装依赖、不调 MCP、不出报告、不用自身知识回答，本轮到此为止。

首次运行

bash "<技能根>/run.sh" gate          # Windows： py -3 "<技能根>scriptsmain.py" gate

• <技能根> 见 §1。不要直接执行 run.sh（无 +x 时 exit 126），一律 bash。
• 运行环境（关键）：本包命令要写 .env 并访问 HTTP 端点，须在可写技能目录、允许出网的环境里执行，单次超时设 timeout: 1800000（一次报告约 10 分钟）。WorkBuddy / CodeBuddy 的 Bash 工具自带所需开关，按工具 schema 传入即可；不要依赖 hook 改写。

用户粘贴了 Key

用户在开通页登录后把 Key 复制粘贴回对话（形如 fsk_…）→ 立刻写入并校验，然后接着他原来的问题继续，不要让他重问：

bash "<技能根>/run.sh" gate --set-key "<用户粘贴的 Key>"

Key 的来路（只有一条）

门禁是双闸：入口先过闸，MCP 出口（client_common.mcp_rpc）还会再拦一道 —— 绕过入口直接调 MCP 也漏不过去。

• 唯一来路：用户在对话里粘贴 → gate --set-key 写进本技能根目录 .env（就地 upsert，不会动端点那几行）。
• 不读用户主目录、不读宿主注入的插件选项、不向上层目录爬 —— 没粘贴过 Key 的机器必然先看到开通引导，不存在「本机残留让门禁悄悄过关」。
• 只接受 FinSkillHub 签发的 fsk_ Key，不接受自拟字符串，不自动重试。

1 · 🚪 入口（三平台同一套参数）

<技能根> = 本 SKILL.md 所在目录（WorkBuddy / CodeBuddy 装到 ~/.workbuddy/skills/hk-ipo-analysis，Windows %USERPROFILE%.workbuddyskillshk-ipo-analysis；其它宿主落在各自的 skills 目录，本包不认路径、只认 SKILL.md 的位置）。

入口自己定位技能根、自己找解释器（python3 → python → py -3），不依赖 cwd、不依赖任何环境变量；要指定解释器就设 HK_PYTHON=<解释器路径>。

唯一依赖是 Python 3.8+：没有 pip、没有 npm、没有第三方包。Windows 从 python.org 安装并勾选 “Add python.exe to PATH” 即可直接用。

2 · ⛔ 铁律

• 数据面 = 自家 MCP 的 5 个取数 tool ＋ 宿主自带 westock-data：ipo_list / market_snapshot / ipo_dify_report / deep_profile / news_catalysts，外加宿主 CLI westock-data ipo --market hk --raw（只补发行日期：招股起 / 招股止 / 上市日）。除此之外禁止浏览器、curl/wget、第二个数据源、猜名单、下载招股书、改本包源码；脚本失败了就停，不得改渲染器。禁止自己写 data/<code>/<code>.json 或 HTML——payload 由脚本按母本标题 / 「标签：值」/ 表格填出。
• 联网只有一个出口：宿主自带的 WebSearch / WebFetch（其余联网工具被 hook 拒）。只在 MCP 四层都没给出某个发行日期槽时用它，只补 issue_params 的日期字段，不搜名单、不搜招股书、不换数据源。
• 旁路由包内 hooks/pretool.py（PreToolUse）按能力拦截：联网类工具直接拒（白名单例外：宿主自带的 WebSearch / WebFetch，按后缀匹配）；写/改落在本包源码路径直接拒（data/<code>/*.json 产物放行）；curl / wget 命令直接拒。宿主其它项目的写改不受影响。
• 不要 ls / env / 探 127.0.0.1 / 找第二个入口。
• report 一次跑完：Bash timeout 必须是 1800000。提交后这一次进程一直监测状态和当前节点，直到全文；遇到静默期断流（服务端把这次生成判死）脚本会自动带 retry 换一次新生成继续，最多 4 次尝试；确定性失败（额度 / 招股书 / 基本信息缺失）立刻停。不要中途停掉，也不要另起第二条命令。

2.1 · 🧭 数据源优先级（四层，唯一真相在 scripts/ipo_sources.py）

• 合并只有一条机制：report_fill.merge_prefer（有值者胜、空值不覆盖），所以「谁优先」只写一遍；payload 将来加槽不用改代码。
• 层 1 与层 3 都花额度（同一把 Key、同一份额度）：层 3 先判空槽，空了才发起调用；层 1 失败 / 层 3 失败都只降级，报告照出。
• 层 4 只动空槽，绝不覆盖母本或 MCP 给出的值；westock-data 的 price / hy 不取（招股价与行业一律以母本为准）。
• 母本里的招股起止优先：整句（招股期自9月14日…至9月17日…）→ 拆开的独立标签（招股开始：… / 招股截止：…）→ 才轮到层 4。
• 开关：IPO_MCP_PRIMARY=0 关层 1，IPO_MCP_SUPPLEMENT=0 关层 3，IPO_HOST_SOURCES=0 关层 4（默认都开）。

3 · 🔄 流程

list 只列清单，列完即停。report --codes 只出点名的报告，不依赖、不调用 list。交付只走 §5：present_files 的 files 只传脚本回报的那条 <code>_report.html，就一条。

report 内部次序固定为 层 1 → 层 2 → 层 3 → 层 4：先 MCP 结构化真值（ipo_list + market_snapshot）→ 再母本（本地已有 <code>_raw.md 就直接用，否则 ipo_dify_report）→ 再 deep_profile / news_catalysts 补 interpretation 空槽 → 最后宿主 westock-data ipo 补仍为空的发行日期槽。各层各印一行日志（层1 … / 层4 …），报告本身不写数据来源清单。

单只报告约 10 分钟（服务端 eta_seconds 自报）。提交后按服务端 poll_after_seconds 长轮询这一次作业：每次打印是否正常运行、当前节点、第几步，一直等到全文。静默期断流（Dify 下载招股书期间零字节输出，链路按空闲超时掐断）会让这次生成被判死——脚本会自动带 retry 换一次新生成继续，最多 4 次尝试；确定性失败（额度 / 招股书 / 基本信息缺失）立刻停。report 一拍出 HTML（进程最多等 1800 秒，Bash timeout 写 1800000），不要手写 payload。本地已有母本就直接填、不要 --refresh。

4 · 📄 产物与结构（锁定）

产物三件套落 IPO_DATA_DIR（默认本包 data/<code>/）：

报告为富模板单文件（11 个 section.card + hero + nav.toc + 两张档位表 + 最多 4 张 echarts 图：五维雷达只在「AI 评级」卡出 1 张，另有认购 / 保荐人 / 基本面折线各 1；echarts 已内联，离线可画），结构与参照 ../ipo_data/hk02261_report.html 锁定，只换数据，禁止改结构。overview 卡的五维只以 gauge 明细（5 条）呈现，不再重复出雷达。

• 母本模块 10「热点问答」已整体移除：不抽取（payload 无 hot_qa）、不渲染（无 .qa 块），出报告时整段跳过，不补占位。
• 图表随数据：任一 series 不足 2 点（含单点）→ 该图整块不出，不留空白框。
• 渲染链路：report_fill.py（标题 / 「标签：值」/ 表格 → payload，不用正则）→ chart_options.py → report_template.py；echarts 本体 assets/echarts.min.js。
• 结构回归：run.sh check A.html B.html。

5 · 📦 交付

交付只有一件、路径只有一条。 present_files 的 files 只放脚本回报的 {symbol}_report.html（在 IPO_DATA_DIR 下），不放第二个。

• 产物只落 IPO_DATA_DIR；禁止复制 / 导出 / 另存到任何包外目录（桌面、下载、文档……），也禁止为「方便打开」cp 出副本 —— 多一份副本就是面板上多一条同内容的产物（一次 present_files 带 N 个路径 = 登记 N 条）。
• 多只代码才可能 >1 条：那时一码一条 <code>_report.html，同一份不得交两遍。
• 给用户的话里文件只说这一条路径。

6 · 🚦 退出码

3/4/5 只属于门禁；ipo.py 自己的失败走 6，不撞门禁的码。