> 🎁 新用户免费体验：首次使用自动获得 10 次免费试用（同一环境，客户端自动记忆），试用期间完整数据交付；用尽后按次付费。
> ⚠️ v1.3.2 架构升级说明（新增二维码弹窗付款：收到 402 后自动弹出扫码付款页，扫码即付、付完自动取数，无需在支付宝里翻找订单）：妖气评分引擎（涨停/连板数据采集 + 四维评分计算）已迁移至云端付费 API，本客户端负责报告渲染与定性分析。已安装 v1.2.x 的老用户可继续离线使用旧版；新版本按次付费。
短线妖股情绪分析报告（付费版）
计费说明（Pay Skill · 按次）
- 计费模式：按次收费，¥2.0/次（支付宝AI按量付费，402协议）
- 每次调用 = 对一个交易日执行完整数据获取+评分计算，返回结构化JSON
- 付费内容（云端引擎）：涨停/炸板/跌停全池数据、连板梯队、行业聚集统计、四维妖气评分与排名（资金抱团度/筹码健康度/短线性价比/封板质量，含逐项得分拆解）
- 客户端负责：报告渲染（模板）、情绪周期定性判断、核心妖股叙事拆解、排雷与临盘决断
付费 API
- Base URL：
https://aipay-report.app.workbuddy.host - 端点：
GET /api/v1/monster?date=YYYYMMDD（缺省=当日） - 返回 JSON：
indices（四大指数）、stats（涨停/炸板家数、最高板）、ladder（连板梯队）、industries（行业涨停家数统计）、ranked（妖气评分降序，每只含scores.资金抱团度30/筹码健康度25/短线性价比25/封板质量20/total/grade/icon及逐项拆解parts）、zhaban、dizang - 付费流程（首次请求返回 HTTP 402 + Payment-Needed 账单）：
方式A：通用客户端 + 二维码弹窗付款（强烈推荐）
python scripts/pay_api.py --url "https://aipay-report.app.workbuddy.host/api/v1/monster?date=YYYYMMDD" \
--auto-pay --out monster_data.json
一条命令全自动：自动开付款单 → 生成深色主题二维码付款页（pay-qrcode.html，用 present_files 展示给用户）→ 用户扫码即付（无需在支付宝里翻找订单，手机端另有短链兜底）→ 自动轮询 → 付款成功后自动回取数据写入 monster_data.json（返回码 0）。
- 买家环境需装有官方付款客户端 alipay-bot（一次性）：
npx -y @alipay/agent-payment@latest install - 二维码页面务必通过 present_files 展示；展示时向用户说明"扫码付款，付完自动出数据"
- 超时未付（默认300秒）返回码 2：付款单仍有效，可重新运行同一命令继续等待
方式B：手动分步（无 alipay-bot 时的兜底）
python scripts/pay_api.py --url "https://aipay-report.app.workbuddy.host/api/v1/monster?date=YYYYMMDD" --out monster_data.json
# 返回码2=需付款，账单存于 402-bill.txt，按 stderr 提示用 alipay-bot 付款：
alipay-bot 402-buyer-pay --file 402-bill.txt -r "https://aipay-report.app.workbuddy.host/api/v1/monster?date=YYYYMMDD" -m GET --json
# 付款后凭智能体侧交易号（008283开头）回取：
alipay-bot 402-query-payment-status -t <智能体交易号> -r "https://aipay-report.app.workbuddy.host/api/v1/monster?date=YYYYMMDD" -m GET --json
付款后取数（极简）
付款后重跑同一条命令即可自动取数——服务端自动匹配同资源已付订单直接交付（24h内幂等重放），客户端本地也会记忆付款单号自动续接。无需提供任何交易号、无需重新扫码。
工作流程
Step 1: 调用付费 API 获取评分数据
按上方「付费 API」获取当日 JSON。校验：date 为目标交易日、stats.totalLimitUp > 0。数据缺失字段如实标注"暂缺"，严禁绕过 API 自行取数后编造评分。
Step 2: 识别主线与情绪周期定位
基于 industries（行业涨停家数）与 ladder（梯队）确定主线/辅线板块；按板块连板天数定位情绪周期阶段：
- 启动期：首日涨停潮，无连板
- 发酵期：2-3天，2连板出现
- 分歧高潮期：4-7天，3连板以上，高位巨量分歧
- 衰退期：龙头断板/炸板，涨停数骤降
Step 3: 报告渲染
以 ranked 为唯一排名依据生成 HTML（模板 assets/report_template.html），五大板块：
- 〇、短线情绪周期定位
- 一、短线"妖气"综合排名：排名|名称|代码|市值|涨幅|连板|换手|封板时间/质量|妖气指数（全部取自 ranked[].scores）
- 二、核心"妖股"潜质拆解（前3-4名）：结合 scores.parts 逐项拆解叙述
- 三、反面教材：跟风排雷：利用 zhaban（炸板次数）、低分标的、一字断层板
- 四、临盘交易决断指南
模型说明：定性叙事由当前 Agent 模型生成（如需 Hy3 请切换模型选择器）；确定性计算（评分/排名）一律以云端返回为准，不得手工改动分数。
Step 4: 通达信联动渲染
按 scripts/tdx_link.py 规则渲染双链接（PC tdxlink://kline/<code> + 手机东财 wap 📱），代码取6位纯数字。详见下文「通达信联动」。
Step 5: 推送飞书（可选，需自备接收人配置）
用 scripts/send_feishu.py 推送（需 FEISHU_USER_ID 环境变量）。推送内容与报告结论完全一致。
通达信联动（点击股票代码 → 等同手动输入代码回车）
- PC端：代码 →
<a href="tdxlink://kline/{code}">，由scripts/tdx_link.py零侵入实现（激活窗口→逐字符输入代码+回车→原窗口切换K线→报告最小化） - 手机端：代码后附加 📱 →
https://wap.eastmoney.com/quote/stock/{mkt}.{code}.html（6开头 mkt=1，其余=0） - 前置：已注册
tdxlink://协议、通达信已打开、报告用系统浏览器打开
🎁 报告试用横幅（v1.4.1 必须执行）
pay_api.py 在免费试用交付时会在工作目录写入侧车文件 trial-info.json（含 remaining/limit/trialId）。生成报告时必须读取该文件，在报告头部（标题/meta 区下方）插入试用横幅；工作目录无 trial-info.json（已付费用户/无痕环境）则不显示：
remaining > 0：🎁 新用户体验期：本环境免费额度剩余 {remaining}/10 次，用尽后按次付费 ¥2.00/次（{remaining} 用 trial-info.json 的实际数值替换）-
remaining == 0：🎁 免费体验已用完（10/10），继续使用将按次付费 ¥2.00/次 -
HTML 报告：插入 header 区 meta 行下方，inline 样式，颜色用主题强调色（如 #f39c12），字号 13-14px，圆角边框胶囊样式
- Markdown 报告：放在首行引用块
> 🎁 ... - 飞书推送：推送内容与报告保持一致，横幅文字包含在内
- 命令行 stderr 的"🎁 剩余 N 次"提示与报告横幅同时存在，二者不可互相替代
注意事项
- 真实性第一：数据与评分全部来自付费 API 返回，绝不编造；API 不可用时如实报告失败，不使用降级数据源
- 短线视角：纯资金博弈逻辑，不看长线估值
- 涨停<10只：结构不变，标注"今日盘面较弱，短线机会有限"
- 无连板：标注"今日无连板标的，市场处于启动期/衰退期"
- ST股：数据源默认过滤 ST；如需提及在排雷区说明
