自选持仓投资价值评分
自选/持仓 → 批量取数及来源记录 → 分行业指标 → 价值与交易环境分别评分 → 基本面情景估值 → 用户政策约束配置 → HTML报告与快照。
评分和估值由 scripts/score_engine.py 调用 scripts/value_model.py 确定性计算，禁止心算评分、编造输入或直接填目标价绕过公式。模型负责取数、证据支持的定性判断、合理经营假设及说明。
v2是规则与数据质量升级，未完成历史收益校准；不能宣称更赚钱或目标价必然兑现。
资源与适用边界
- 计算前读 references/indicator-mapping.md：v2输入字段、来源日期、估值公式和单位。
- 判断行业与规则时读 references/scoring-model.md：评分结构、缺失门槛、模型路由、风险与配置约束。
- 取数时读 references/data-playbook.md：westock-mcp连接器与westockdata CLI命令、降级路径。
- references/valuation-review-2026-09-05.md是v1问题留档，不覆盖当前v2规范。
- 历史回测/自动调权读 references/backtesting.md：数据格式、滚动分区、执行模拟、启用门槛和一键命令。
主通道为已连接的westock-mcp，以及 npx -y westock-data-skillhub@1.0.5。先检查实际可用能力；服务字段、披露频率与数据覆盖需验证，不能把供应商缺项理解为零。
本版本针对A股。港股、美股可以记录清单，但不未经适配就套用A股行业阈值、币种与配置规则。
工作流
1. 确定清单和持仓
自选优先使用连接器portfolio_watchlist，不可用则读workspace/portfolio_ledger/watchlist.json；都没有时向用户索取名称或代码。
持仓优先采用用户提供且核对过的记录，或明确标记的模拟盘portfolio_paper_positions；也可读取本地positions.json。模拟盘不能冒充真实券商资产。
只有holding=true进入配置，自选未持仓只作观察。
python scripts/portfolio_ledger.py init --dir workspace/portfolio_ledger
截图识别名称、代码、股数、成本价、现价，回显表格供用户核对，并询问是否还有未截到的持仓。未经核对不进入配置计算；单票基本面分析可独立继续。
核对后用portfolio_ledger.py save-positions保存。摊薄成本、股数单位、融资负债等陷阱见data-playbook。
2. 批量取数与时点留痕
把标的代码以逗号拼接，独立读取可批量执行，不必逐股拆开。
npx -y westock-data-skillhub@1.0.5 kline sh600519,sz000725 --period day --limit 1
npx -y westock-data-skillhub@1.0.5 kline sh600519,sz000725 --period day --limit 250
npx -y westock-data-skillhub@1.0.5 finance sh600519,sz000725 --num 8
npx -y westock-data-skillhub@1.0.5 risk sh600519,sz000725
npx -y westock-data-skillhub@1.0.5 consensus sh600519,sz000725
以上是命令示例，不是用户真实清单。按需补充公告、资金、行业和新闻；保留原始来源、数据日、财报期、公告日、抓取时间、单位和实际/预测属性。
250日K线用于技术指标，不能生成5年估值历史；8期财报也不保证足够3年年度盈利或完整周期。估值历史、年度盈利、周期正常化及金融指标需另取足够样本。
北向数据先核实披露机制与供应商时间粒度；v2不依赖北向20日净流入，不能换名伪装成机构资金。
3. 加工v2输入
python scripts/score_engine.py --template --output metrics.json
填写模板null字段，未知保持null。每项指标的indicator_meta必须有来源与原始数据日期；财务指标还需报告期与公告日。现价为独立price_meta。
财报累计值拆单季，统一TTM与归母/扣非口径；百分数20表示20%，PEG辅助计算20/20=1。
亏损、非正净资产、缺失数据是不同状态；不能用当前EPS除历史股价得到历史PE。
risk.status区分checked/not_checked/failed。已核查无风险用events=[]，未核查用null；ST/退市/立案必须保留标准标签。
Q/G/V有效覆盖率不足70%、关键财务字段缺失、风险未查或无有效现价/估值，输出NR而不是中性分评级。已知硬风险仍优先D。
缺失字段处置优先级（v2.4.0）：先补数据 → 能派生就派生 → 结构性缺失（forecast/industry_boom）按期望分插补 → 观测项缺失按中性默认分60兜底；兜底与插补都不抬高覆盖率，NR门槛不受影响，哪些分是插补/兜底来的见 data_quality.*.imputed/.neutral。大盘温度 4 项里拿到 ≥3 项即出分、按可用项权重归一（不足 3 项才"数据不足"）。
4. 构造适用基本面情景
明确profile：default/growth/value/cyclical/bank/broker/insurance。旧financial必须拆为具体子行业。
按scoring-model的方法路由，选一种主模型并提交bear/base/bull完整输入与非空假设、来源。可用正常化PE、ROE驱动PB、适用EV倍数、内含价值或股利/现金流折现。
参数依据公开信息、行业可比与经营预测，不能为得到期望结论倒推倍数。周期公司须说明完整周期正常化和恢复路径。没有可信假设则暂不估值。
公允价值为估值日当前价值，不是未来12个月股价预测。券商目标价和技术压力位独立显示，不参与估值；不要求为了凑方法数量混入不适用模型。
5. 读取用户配置约束
没有完整持仓、总资产口径及风险政策时，先完成个股评分报告，配置显示“暂不生成”。不要把股票资产内部占比当全部资产权重。
需要用户提供或确认的事实：风险承受度、投资期限、可承受回撤、总资产、现金需求、权益预算、其他资产比例及持仓完整性。已有信息直接复用，不重复询问。
current_weight=股票市值/总资产×100。每只持仓需行业、产业链敞口分组、1日内有效可交易状态记录。融资负债账户不直接套当前配置器。
市场冰点不自动满仓；权益预算取自用户政策。输出仅是单票/行业/产业链/现金约束下的参考权重，不生成订单，也不保证回撤限额。
6. 计算、报告、归档
python scripts/score_engine.py --input metrics.json --output result.json
python scripts/build_report.py --result result.json --output workspace/portfolio_ledger/report.html
有历史快照时可传--prev；不同模型版本、不同档位或NR不直接比较分差，重建基线。不要硬编码历史日期充当本次分析日。
使用当前环境的文件展示能力打开HTML。报告离线可用，内嵌当前Logo，展示情景、假设、来源、数据门槛和独立交易环境。
python scripts/portfolio_ledger.py snapshot --result result.json --dir workspace/portfolio_ledger
对话输出
给出简明结论和表格：标的、价值分/评级、交易环境分、保守/基准/乐观公允价值、安全边际、数据覆盖和关键缺口。
有合格配置参考时显示目标权重；否则说明缺哪些事实。市场温度仅描述市场环境。不要把NR写成“回避评级”，不要把未知权重写成0或100%现金。
说明估值日、数据是否实时、情景条件与风险；涨/正面沿用红色，跌/负面沿用绿色。
风险提示：公开数据量化参考，不构成投资建议，不承诺收益。
维护验证
v2.1增加历史时点数据构建、逐日回测、滚动调权与日期感知的权重注册。默认读取config/weights.json，没有有效学习版本时使用内置权重。
用户要求回测/调权时运行run_calibration.py；真实历史数据尚未提供时只用标为synthetic的样本验证程序，不能据此启用正式权重。
自动调权只限Q/G/V，只有真实数据与全部检验门槛通过时--apply才会写本地权重注册表，次日生效，不涉及任何交易。结果显示weights_version，并把调权与数据变化造成的分数变化分开归因。
python -B -m unittest discover -s scripts -p "test_*.py" -v
回归测试是人工构造数据，不能冒充真实取数或收益回测。历史校准需另有按公告可得时点的数据集，包含退市样本、分红复权及费用，之后才能校准阈值和权重。
修改规则时同步value_model、模板、指标说明、报告与版本；保留原始快照以便审计。
用户另行明确要求模拟盘下单时，使用相应连接器并按实际工具规则核对价格、数量与账户；本技能计算本身不授权任何交易。
