本地履约脚本（鉴权型 Pay Skill）

服务端只做支付鉴权：支付通过后返回 {"paid": true, "fulfillment": "agent_local"}， 不返回业务结果。Agent 收到 paid: true 后在本机执行本目录脚本产出结果。

纪律

1. 支付未确认前不执行任何取数脚本、不输出任何付费内容；
2. already_fulfilled: true 表示同一订单已鉴权过，直接复用上次结果，不重复跑取数 （避免重复消耗外部接口配额）；
3. 取不到的数据标注「未获取」，严禁因已付费而推测补造；
4. 脚本失败如实告知用户，可引导稍后重试同一订单（未履约不会重复扣费）。

脚本清单

| 脚本 | 作用 | |---|---| | financial_report_core.py | 零依赖核心算法库：23 因子计算、基本面/价格加载、月末面板、披露择时拆分、Spearman/分档多空/年化绩效 | | run_local.py | 统一入口，按 --mode 跑三范式（factors / timing / catalog / all）并生成报告 | | fetch_daily.py | 拉取真实 A 股前复权日线（缓存优先，失败重试，带 Referer） |

用法

# 因子目录（不需数据）
python3 scripts/run_local.py --mode catalog

# 23 因子诊断（需基本面 + 价格）
python3 scripts/run_local.py --fundamentals fin.csv --prices bars.csv --mode factors \
    --groups 5 --out out_dir

# 披露择时（额外需披露日期）
python3 scripts/run_local.py --fundamentals fin.csv --prices bars.csv \
    --disclosure disc.csv --mode timing

订阅横幅

报告顶部固定 1 条订阅状态横幅（Markdown + HTML 双版本），由以下参数注入：

• --sub-order / --sub-channel / --sub-expire 命令行参数，或
• 环境变量 FINANCIAL_REPORT_FACTOR_LAB_SUB_ORDER / _SUB_CHANNEL / _SUB_EXPIRE / _SUB_ACTIVE=1

已订阅显示「您已通过 <渠道> 订阅此技能 · 订单 <号> · 有效期至 <日期>」（绿色渐变）； 未订阅显示「请先购买订阅」（琥珀渐变）。

数据边界（务必如实）

• 本包仅有真实 A 股前复权日线（无财务字段 / 披露日期）。
• factors / timing 需用户提供基本面 CSV（原始财务字段或已算好的 23 因子列）+ 日线价格， 方可真实复现；否则标注「未获取」+ 文献对照。
• catalog 永远可用（23 因子公式目录 + 文献 IR 对照，不具名）。
• 取数失败一律打印 [未获取] 原因 并返回 1，不输出任何推测结果。