持仓体检 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 步 · 引导确认（带引导） 先和用户对齐，不要直接闷头跑：

标的清单：让用户给代码或名称（如「600519 茅台, 300750 宁德」）。支持任意 A 股代码；若用户给的是名称，用 westock-data search <名> 解析成代码再跑。
权重偏好：默认 25/25/20/15/15。问是否调整（如「我更看重估值和安全边际」→ 估值/质量加权）。
关注点：有无特别想盯的维度或单只票的风险顾虑。
复盘频率：一次性还是定期（定期→提示可重复调用，报告自带「导出配置」）。

第 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：自包含、零依赖、涨红跌绿（中国习惯）、可离线打开。
报告含：综合评分排行 / 逐只四维卡 / 归一化走势 / 维度均分对比 / 相关性热力 / 行业集中度 / 组合风险 / 加减仓优先级 / 综合建议。