> 🎁 新用户免费体验：首次使用自动获得 10 次免费试用（同一环境，客户端自动记忆），试用期间完整数据交付；用尽后按次付费。
> ⚠️ v1.3.2 架构升级说明（新增二维码弹窗付款：收到 402 后自动弹出扫码付款页，扫码即付、付完自动取数，无需在支付宝里翻找订单）：V4 评分引擎（一票否决判定/财务动态评分/动态ROIC行业标准/IRR测算/确定性折价）已迁移至云端付费 API。客户端负责财务数据采集与定性层评定，引擎计算全部在云端完成。按次计费 ¥2/次，每次评估单独立账。 已安装 v1.2.x 的老用户可继续离线使用旧版。
长期价值投资决策系统 V4（付费按次版）
计费说明（按次计费）
- 单价：¥2.00/次（支付宝AI按量付费 · 402协议），每次评估单独立账
- 调用方式：
POST /api/v1/v4/evaluate首次调用返回 HTTP 402 账单 → 付款 → 携Payment-Proof重放同一请求 → 返回评估结果 - 入参保护：请求体不合法（JSON 错误/行业代码错误/certainty 错误）会在开单前被 400 拒绝，不会产生费用；付款后按开单时存档的请求体计算，重放结果幂等一致
- 已付订单找回：重放同一请求并附原
Payment-Proof，或凭?trade_no=<支付宝交易号>回取
云端 API
- Base URL：
https://aipay-report.app.workbuddy.host - 评估：
POST /api/v1/v4/evaluate，请求体见下「请求体规格」 - 首次调用 → HTTP 402 +
Payment-Needed头（含账单） - 付款（强烈推荐）——二维码弹窗全自动：
python scripts/pay_api.py --url "https://aipay-report.app.workbuddy.host/api/v1/v4/evaluate" \ --method POST --data @v4_payload.json --auto-pay --out v4_result.json
自动开付款单 → 生成深色主题二维码付款页pay-qrcode.html（必须用 present_files 展示给用户，说明"扫码付款，付完自动出评估结果"）→ 用户扫码即付（无需在支付宝里翻找订单，手机端另有短链兜底）→ 自动轮询 → 付款后自动重放评估并保存v4_result.json（返回码 0）。
买家环境需一次性安装官方付款客户端：npx -y @alipay/agent-payment@latest install；超时未付（默认300秒）返回码 2，付款单仍有效，重跑同一命令即可继续等待（同请求体重放，结果幂等）。 - 兜底：
alipay-bot 402-buyer-pay --file <Payment-Needed头值文件> -r "<资源URL>" -m POST -d '<请求体JSON>' --json→ 付款后alipay-bot 402-query-payment-status -t <智能体交易号(008283开头)> -r "<资源URL>" -m POST -d '<请求体JSON>' --json - 付款后取数（极简）：重跑同一条
--auto-pay命令即可自动取数——服务端匹配同请求体已付订单直接交付（24h内幂等重放），客户端本地记忆付款单号自动续接，无需交易号、无需重扫 - 返回：一票否决结果 / 六层评分明细 / 10年IRR / 确定性系数 / 最终得分 / 决策结论 / 标准决策矩阵条目
工作流程
Step 1: 数据采集（前置条件）
在开始分析前，获取待分析股票的充分财务数据（近3年+）：
- 优先使用通达信 MCP（
tdx_security_deep_info、tdx_kline、wenda_report_query） - 其次使用 westock-data Skill 获取研报和财务指标
- 若需最新新闻和公告，使用
wenda_news_query和wenda_notice_query
云端引擎所需定量字段（收集后填入请求体 fin）：
| 字段 | 含义 |
|---|---|
roicSeries |
近3年 ROIC%（最新在前），非金融业必填 |
roeLatest |
最新 ROE%，金融业必填 |
ocfToNpPct3yAvg |
近3年经营现金流净额/净利润 均值% |
fcfSeries |
近3-5年自由现金流（亿元，最新在前，负为负） |
debtRatioPct |
最新资产负债率%（金融/公用事业豁免V2红线） |
goodwillToEquityPct |
商誉/净资产% |
pledgePct |
大股东股权质押%（可选） |
cet1Pct / cet1RegFloorPct |
核心一级资本充足率% / 监管底线%（仅银行保险） |
profitGrowth10yPct |
未来10年预期利润年化增速%（量增+价增+利润率改善推导） |
dividendYieldPct |
当前股息率% |
peCurrent / peFair |
当前PE / 合理PE（给出估值逻辑：历史中枢/同业中位数/PEG） |
Step 2: 定性层评定（Agent 依据下述指引打分，引擎复核汇总）
第一层 商业模式与企业质量（0-30，qual.l1）：商业模式是否简单易懂、是否具备强定价权、高频/重复消费属性、客户粘性与转换成本、产业链话语权。
- 28-30 卓越（强定价权+高频复购）；22-27 优良（明显护城河）；15-21 一般；0-14 弱势/商品化
第二层 五层护城河（0-20，qual.l2）：逐项检查成本优势/品牌/网络效应/转换成本/特许经营权五源，至少2项"强"才可给高分；AI 动态修正（AI增强+2 / AI削弱-5 / 中性0）。
- 18-20 ≥2强+1中；14-17 1-2项强；10-13 仅1项中；0-9 无护城河
第四层 管理层与资本配置（0-15，qual.l4）：资本再投资是否投向高回报主业（ROIC>WACC）、回购纪律（低估时是否回购）、分红纪律（30%-60%健康）、激励与诚信、指引透明度。
- 13-15 典范；10-12 良好；6-9 中等；0-5 糟糕
确定性等级（qual.certainty）：full 完全确定 / high 高度确定 / mid 中度确定 / low 低确定。必须给出行业理由（qual.reasons.certainty），不得为抬高得分虚标。
护城河塌方提示（qual.moatCollapse）：若核心优势面临技术颠覆或政策不可逆打击，置 true 并在 moatCollapseReason 说明——云端将按一票否决处理（疑罪从有）。
Step 3: 调用云端引擎评估
请求体规格（POST /api/v1/v4/evaluate，JSON）：
{
"code": "600036", "name": "招商银行", "industry": "finance",
"fin": { /* Step 1 定量字段 */ },
"qual": {
"l1": 26, "l2": 18, "l4": 12,
"certainty": "high",
"reasons": { "l1": "...", "l2": "...", "l4": "...", "certainty": "..." },
"moatCollapse": false
}
}
industry 取值：software（软件/消费科技）/ consumer（消费品）/ pharma（医药）/ manufacturing（高端制造）/ utility（公用事业/新能源运营商）/ finance（银行/保险）。ROIC 行业标准由云端按行业对号执行，不得跨行业比较。
Step 4: HTML 报告渲染
云端返回即权威结果：vetoes（一票否决明细）/ layers（六层逐项得分与拆解）/ irrPct（10年IRR）/ certainty.factor / finalScore / verdict（强烈推荐/推荐/观察/不推荐）/ matrixRow。
必须以 assets/report_template.html 为模板生成单文件深色主题 HTML 报告（黑底、无外部依赖、响应式），五大板块：
- 〇、黑名单与一票否决通告：每个被否决标的红色虚线框（触发红线|具体事实|否决结论）
- 一、投资委员会决策矩阵：排名|股票|行业|商业模式(30)|护城河(20)|财务动态(20)|资本配置(15)|IRR(15)|基础分|确定性|最终得分|决策结论（全部取自云端返回，多标的按最终得分降序）
- 二、核心拟投资标的深度研判（每标的一张高亮卡片）：六层得分进度条拆解、IRR三因子（量增/价增/估值回归+情景区间）、护城河定性理由、芒格反向思考必答——"持有5-10年最大的三个潜在风险"附可能性与后果
- 三、反面案例与观察组：表格（股票|最终得分|归类|核心问题一句话）
- 四、投资组合建议：仓位分散、单只≤20%、同行业≤30%、分批建仓
渲染纪律：
- 得分着色：≥85 绿 score-hi / 70-84 金 score-mid / <70 红 score-lo；结论徽章按 强烈推荐/推荐/观察/不推荐 四色
- 分数一律取云端返回，不得手工改动；客户端只填定性叙事与风险思考
- 数据缺失字段标 <span class="missing">暂缺</span>；报告落盘命名 v4-report-YYYYMMDD-<标的名>.html 并交付用户
分析纪律
- 真实性第一：所有数据来自实际拉取的财报/行情，绝不编造；云端引擎不可用时如实报告失败，不降级不手工估算
- 疑罪从有：定性判断模棱两可时倾向触发否决/降档
- 行业对标：ROIC 标准由云端按行业执行
- 反向思考必答：Inversion 是强制项
- IRR 测算透明：云端返回三因子拆解，客户端呈现全过程
- 跨标的可比较性：同批次分析使用相同行业标准和数据截止日期
- 确定性诚实：certainty 必须附行业理由
🎁 报告试用横幅（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 次"提示与报告横幅同时存在，二者不可互相替代
