持仓体检 zfl-portfolio-health-check
把「给任意股票列表 → 四维体检 + 组合视角 + 可交互单页报告」做成可复用的端到端流程。
核心差异化能力：自定义标的 + 引导式 intake + 报告中途可改（权重/成分/阈值实时重算，改标的清单只需重跑一次 CLI）。
评分模型（五维，默认权重）
| 维度 | 权重 | 数据来源 | 高分含义 |
|---|---|---|---|
| 估值 val | 25 | 市值/PE/PB/股息率（由 finance+dividend+现价反算） | 便宜、分红厚 |
| 质量 qua | 25 | 毛利率/净利率/ROE/负债率（finance） | 生意好、杠杆低 |
| 成长 gro | 20 | 营收/净利同比（finance 年报对比） | 在增长 |
| 资金 fund | 15 | 近5/20日主力净流入占市值比（asfund） | 主力在买 |
| 技术 tech | 15 | MA位置/MACD/RSI/回撤/年化波动（technical+kline） | 趋势好、波动低 |
综合分 = Σ(维度分 × 权重) / Σ权重（不强制权重和为 100，自动归一）。
判定阈值（可调）：≥60 保留 / 45–60 持有观察 / 30–45 减仓 / <30 砍。
> 完整打分公式与字段映射见 references/methodology.md。所有分数均为启发式量化辅助，非投资建议。
工作流（引导式，务必按序）
第 1 步 · 引导确认（带引导）
先和用户对齐，不要直接闷头跑：
1. 标的清单：让用户给代码或名称（如「600519 茅台, 300750 宁德」）。支持任意 A 股代码；若用户给的是名称，用 westock-data search <名> 解析成代码再跑。
2. 权重偏好：默认 25/25/20/15/15。问是否调整（如「我更看重估值和安全边际」→ 估值/质量加权）。
3. 关注点：有无特别想盯的维度或单只票的风险顾虑。
4. 复盘频率：一次性还是定期（定期→提示可重复调用，报告自带「导出配置」）。
第 2 步 · 取数 + 生成
运行引擎（在用户工作区或本技能目录均可）：
python3 scripts/fetch_and_build.py --stocks "sh600519,sz300750,sz002594,sh600276,sz002475" --out 持仓体检报告.html
- 引擎并发调 westock-data-clawhub 拉 technical/asfund/finance(lrb+zcfz)/dividend/kline + 批量 profile（行业），解析、反算估值、算相关性/波动率，输出自包含 HTML。
- 知会用户：取数依赖外网，5 只约 1–2 分钟；若个别接口超时，该指标置空并优雅降级（分数照算，标注缺失）。
第 3 步 · 呈现
用 present_files 打开生成的 HTML。
第 4 步 · 支持中途更改
报告本身即交互面板：
- 权重滑块：拖动五维权重，评分排行/判定/优先级实时重算。
- 成分勾选：勾掉某只即移出本次体检（不影响数据，可随时勾回）。
- 阈值滑块：调整保留/减仓分界，判定自动变。
- 导出配置：把当前标的+权重+阈值导出为 JSON/命令，下次一句话重跑。
- 改标的清单：在面板点「重新体检」会生成预填命令，回 Agent 重跑即可（浏览器无法直连行情 CLI，故换标的走重跑）。
已知坑（已固化，勿重复踩）
- kline 返回降序（最新日在第一行）：解析后必须按日期升序反转，否则现价/涨跌幅全反。见 PF-294。
- profile 不含估值列：PE/PB/市值/股息率须由 finance+dividend+现价反算，不要指望 profile。见 PF-288。
- 单文件 HTML 上线前双检：生成后用 Node 跑
node --check+ 假 document 冒烟，防白屏/空图。见 PF-295。 - 测退出码禁用管道：脚本自检若用
$?接管道会恒为 0，需用PIPESTATUS或set -o pipefail。见 PF 系列。
输出物
持仓体检报告.html：自包含、零依赖、涨红跌绿（中国习惯）、可离线打开。- 报告含：综合评分排行 / 逐只四维卡 / 归一化走势 / 维度均分对比 / 相关性热力 / 行业集中度 / 组合风险 / 加减仓优先级 / 综合建议。
