个股九面速读（Stock 9-Facet Scan）

这是什么 / 这不是什么

是：一个信息组织工具。把分散在行情、财报、技术、资金、公告里的信息，按 9 个正交维度一次性拉齐、结构化呈现，省掉你逐个翻查的时间。

不是：
- ❌ 不输出买入 / 卖出 / 持有结论
- ❌ 不给目标价、不给估值锚定价位
- ❌ 不做「加减仓优先级」排序
- ❌ 不预测涨跌

> 一句话原则：只回答「现在是什么情况」，不回答「该怎么办」。

这个边界不是保守，是让工具可以安全地被复用——使用者自己承担判断，工具只负责把信息摆清楚。

何时使用

• 想快速了解一只股票的基本面 + 技术面 + 资金面全貌
• 需要把 N 只股票放在同一个维度框架下横向对比
• 做研究前的信息预处理，替代手工逐个翻 F10
• 定期跟踪已有标的，看各维度读数相对上期的变化

9 面框架（单一数据域轴正交划分）

> 设计原则：一个面回答且只回答一个问题。①-⑦ 各自闭合；⑧ 是每只股票的纵向时间切片，⑨ 是跨股票的横向结构视角，作为正交维度不与单股面并列。

①-⑦ 单股面（顺序固定，每只必做）

完整子项见 references/nine-facets.md。

⑧ 时间维度（每只必给，四档）

> ⚠️ 每档输出「主导因素 + 待观察变量」两件套，不输出方向性预判。
> 写法见 references/output-spec.md。

⑨ 组合结构面（条件启用）

启用条件：仅当该股票属于使用者指定的一组持仓时才输出。独立研究标的跳过本节。

位置红线：永远在 ⑧ 之后，作为报告第 9 节，不可前置。

包含（结构性描述，不含排序建议）：
- 行业/风格集中度分布
- 日收益相关性矩阵（Pearson）
- 波动率与最大回撤分布
- 结构特征摘要

> 原版含「加减仓优先级排序」，对外版已剥离——那属于决策，不属于读数。

6 条读数原则（核心资产，务必内化）

这 6 条来自实盘复盘的教训，是本 skill 最有价值的部分。它们的作用是防止误读：

1. 快照式横截面读数系统性偏空——只看静态 PE 与当期财报，容易把"高波动成长"读成"基本面差"。某铜加工案例：静态 PE 400+、毛利 5% 看似极差，实为"铜价+加工费"定价可转嫁 + 产品结构跃迁。必须结合动态估值与景气维度一起读。

2. "高波动" ≠ "会跌"——高波动是双向的，涨也猛。表述用「高波动」，不用「危险」「该回避」。

3. 背离是技术面最关键信号——MACD + RSI 双顶背离：上涨动能衰减信号最强；底背离：下跌动能衰减。背离优先级高于单一指标位置。

4. 缩量/平量 = 修复性反弹，不是趋势反转——量能是反弹成色的试金石。无放量配合，不下"反转"判断。

5. 基本面长逻辑与技术面短节奏可以矛盾并存——不要在读数层面互相否定，用时间维度表分档并呈现。

6. 阈值必须个股化，不用一把尺量所有股票——价值股与成长股波动差一个量级（实测样本年化波动 40%~106%，差约 2.6 倍），固定常数必然"对低波股过严、对高波股形同虚设"。所有阈值类读数（短期急涨、放量缩量、超买超卖、关键价位）一律以该股自身近 120 日分布为基准动态计算、每日随最新 K 线滚动重算，并写明基准与数据基准日；禁止任何固定百分比一刀切，数据缺失则留空标注，不得退回固定值顶替。细则见 references/nine-facets.md 原则 6。

工作流

1. 确认标的与范围

• 用户给名称 → 先 search 拿代码
• 确认是否属于某一组持仓（决定 ⑨ 是否启用）

2. 拉数据（westock-data，批量优先）

# 搜索
npx -y westock-data-skillhub@1.0.5 search 宁德时代

# 行情 / 财务 / 技术 / 资金（支持逗号批量，凡支持批量的命令只调 1 次）
# ⚠️ 市场版**没有** `quote` 命令（实测 2026-09-21），行情取 kline 最新一根
npx -y westock-data-skillhub@1.0.5 kline sz300750,sz002594 --period day --limit 1
# 估值/一致预期（横向估值分位与动态 PE 的数据来源）
npx -y westock-data-skillhub@1.0.5 consensus sz300750
npx -y westock-data-skillhub@1.0.5 profile sz300750
npx -y westock-data-skillhub@1.0.5 finance sz300750,sz002594 --num 4
# 技术指标：四个都要取，只取 macd 会让 ⑤ 面读数明显稀疏
npx -y westock-data-skillhub@1.0.5 technical sz300750 --indicator macd
npx -y westock-data-skillhub@1.0.5 technical sz300750 --indicator kdj
npx -y westock-data-skillhub@1.0.5 technical sz300750 --indicator boll
npx -y westock-data-skillhub@1.0.5 technical sz300750 --indicator rsi   # 含 RSI_2/6/12/24

# 资金
npx -y westock-data-skillhub@1.0.5 fund flow sz300750

# 日 K 250 根（供 120 日滚动窗口 + ⑦ 近 250 日回撤分布；⚠️ exchange 列即换手率）
# ⚠️ 只取一次、全部读数共用这一份——同一天多次取数的行情快照可能不一致
npx -y westock-data-skillhub@1.0.5 kline sz300750 --period day --limit 250

# 股东 / 分红 / 公告 / 风险事件 —— ⑥⑦ 面与事件清单的必需项，缺了数据会明显偏薄
npx -y westock-data-skillhub@1.0.5 shareholder sz300750
npx -y westock-data-skillhub@1.0.5 dividend list sz300750 --years 3
npx -y westock-data-skillhub@1.0.5 notice list sz300750 --limit 20
npx -y westock-data-skillhub@1.0.5 risk sz300750

# 自算（技术指标 + 个股化阈值；纯标准库）
python scripts/compute_indicators.py <kline输出文件>

> ⚠️ kline 取 250 根日 K：其中最近 120 个交易日用于算个股化动态阈值（见步骤 4 与读数原则 6），
> 全部 250 根用于算 ⑦ 面「近 120 日最大回撤」的个股化分位（滚动 120 日窗口约 131 个，见 scoring-algorithm.md §3 ⑦）。
> 窗口随最新 K 线每日滚动前移，不锚定任何固定日期区间。
>
> ⚠️ 单快照一致性（硬性）：一次扫描中所有价格类读数（均价 / 分位 / 阈值 / 关键价位 / 回撤）
> 必须来自同一次取数，不得中途重新取价拼接。行情接口在同一天的多次调用可能返回不同的
> last / volume 快照（实测 2026-09-21 同一收盘日三次调用分别返回 287.05 / 282.53 / 289.13），
> 混用会导致 ⑤ 面「均线站位」一类离散读数跳档。页脚必须标注取数时刻。

> ⚠️ finance 请省略 --type：两版 CLI 参数值不兼容（内置版 lrb/zcfz/xjll vs 市场版 income/balance/cashflow），省略则两版均返回三表齐全，跨版本零风险。
> 完整链路与坑见 references/data-sources.md。

3. 补 WebSearch 维度

③ 经营（业务结构/定价模式/TAM/客户）、④ 景气（行业增速+催化剂+政策）、⑦ 事件（解禁/减持/公告）。

4. 自算技术信号（纯 Python 标准库）

EMA / MACD / RSI14 / MA + 顶底背离检测（局部极值比对，间隔 ≥5 根）。
⚠️ kline 输出为倒序（最新在前），计算前需 reverse。

同时算个股化动态阈值（每日必算，见读数原则 6）：取最近 120 个交易日
① 「5 日滚动涨幅」均值 + 2 倍标准差（夹取 [5%, 30%]）→ 短期急涨参考线；
② 量比分布的 80 / 20 分位 → 放量 / 缩量线；
③ RSI 分布的 80 / 20 分位 → 超买 / 超卖线。
窗口随最新 K 线滚动，不得锚定固定日期或写死数值。
标准差用总体口径（÷N）；计算一律用全精度；对外展示时参考线统一保留 1 位小数
（如 24.14% → 24.1%），不做向上取整（避免系统性偏保守）；判定统一用「当前值 ≥ 参考线」。

5. 生成九面特征雷达

①-⑦ 各面归一化打分（0-100，越高=该面读数越积极）。算法不得临场发明，一律按
references/scoring-algorithm.md 执行：
三种转换器（P 个股化分位 / R 板块分位 / T 绝对档位）+ ①-⑦ 子指标权重表 + 缺失项权重重分配。
雷达图 7 轴固定顺序（①估值→②财报→③经营→④景气→⑤技术→⑥资金→⑦事件风险），量程 0-100，
每只必画，置于 ⑧ 之后、结构摘要之前。

5b. 异常与降级（与取数同步执行）

任何环节失败一律按 references/degradation-spec.md 处理：
单项失败不阻断整体、缺失必须显式标注、禁止用固定值或估算值顶替。
页脚强制输出「数据缺失清单」；7 面全失败时不出报告，改出一页失败说明。

6. 输出 HTML

必须套用版式模板 assets/report-template.html——
其 <style> 与结构为硬性规范，不得自创版式。细则见 references/output-spec.md §「视觉版式」。
章节顺序严格按 ①→②→③→④→⑤→⑥→⑦→⑧→[雷达图]→结构摘要→⑨(条件)→页脚。
配色（中国习惯）：涨红 #e23b3b / 跌绿 #2ba46a / 中性蓝 #3b6fe2 / 强调橙 #f0a020。

措辞红线（硬性规范）

完整对照与示例见 references/output-spec.md。

输出规范

• 单文件 HTML + Chart.js（CDN；离线时文字与表格仍完整可读）
• 每版必须标注：数据基准日、数据来源、免责声明
• 快照类读数必须标基准日——行情变化快，一周后读数可能完全不同
• 中文简练；金额 ¥、比率 %；配色涨红跌绿

免责声明（每份输出必带）

> 本文档为基于公开市场数据的结构化信息汇总，不构成投资建议、证券投资咨询服务或任何买卖要约。
> 数据可能存在延迟或误差，请以交易所官方披露为准。据此操作，风险自担。

Resources

• references/nine-facets.md — 9 面完整子项 + 6 条读数原则详解（含原则 6 阈值个股化算法）
• references/scoring-algorithm.md — 九面归一化打分算法：三种转换器、①-⑦ 子指标权重表、绝对档位表、雷达图规则、缺失权重重分配
• references/degradation-spec.md — 异常与数据缺失降级规范：重试与超时预算、逐环节降级矩阵、数据缺失清单强制项
• references/data-sources.md — 数据链路、双版本 --type 坑、自算指标
• references/output-spec.md — 输出规范、措辞红线完整对照、阈值口径（动态）、HTML 章节顺序
• examples/sample-scan.md — 脱敏示例输出（虚构标的）
• README.md — 安装与使用说明 + 版本记录

版本记录

> 对外发布编号：v1.0.0（初版）→ v1.1.0（本版，2026-09-21）。
> 起草过程留档见文末「## 起草过程留档」——按功能主题命名，不代表版本序列。

v1.1.0（2026-09-21）· SkillHub 第 2 版

相较 v1.0.0（5 条读数原则版）的主要变化

1. 读数原则 5 → 6 条，所有阈值改为个股化动态计算（该股近 120 个交易日分布，每日滚动重算）
2. 新增九面归一化算法 references/scoring-algorithm.md：P / P·池 / R / T 四种转换器、
   ①-⑦ 子指标权重表、绝对档位锚点表（可复现）、雷达图 7 轴固定顺序
3. 新增异常与降级规范 references/degradation-spec.md：逐环节降级矩阵、重试与超时预算、缺失清单强制项
4. 新增版式模板 assets/report-template.html + output-spec.md 视觉版式硬性规范
5. 修复：市场版 CLI 没有 quote 命令（实测），行情改用 kline 取数
6. 收盘价只取一个数值：全部价格派生读数统一用「最近一个完整且取值稳定的收盘日」，
   盘中或当日快照未稳定时回退到前一个完整收盘日，并在页脚注明
7. 补齐取数清单：technical×4（macd/kdj/boll/rsi）、shareholder、dividend、notice、risk、
   consensus、profile；kline 取 250 根（供 120 日窗口 + 回撤 / 波动率分布）
8. 新增自算脚本 scripts/compute_indicators.py（纯 Python 标准库）：MA / MACD / KDJ / BOLL /
   多周期 RSI / 量比 / 个股化阈值 / 背离 / 关键价位 / 二次回踩 / 周线结构（按 ISO 周聚合） /
   回撤分位 / 波动率分位
9. 输出结构：结论前置（分级 I / II / III 级）→ 当前状态 → ①–⑧ → 雷达 + 分数条 → 结构摘要 → ⑨ → 页脚
10. 默认产出「对外版」：结论区只给分级与通用分级标准，不含「买入 / 观望 / 减仓」任何买卖措辞；
    含买卖措辞的自用版另存 _internal/，不得外发
11. ① 面估值口径区分价值股 / 成长股（成长股取 PE / PEG 分位，PB 不参与判定）；
    ⑦ 面波动率拆短期（20 日）/ 中期（120 日）双窗口并各自计分，新增「波动的变化」输出行
12. ①-⑦ 每面输出「面分构成（按权重表）」，合计必须与分数条一致（算式只用于自检，不写进报告）
13. 配色定稿：暖白底 + 莫兰迪结构色（小结卡陶土灰粉、备注浅暖、分节左条灰驼），
    评级色 I 陶土红 / II 鹅蛋黄 / III 草绿；全站不使用冷蓝

v1.0.0

• 首次发布：9 面框架、5 条读数原则、个股九面特征雷达、措辞红线对照表

起草过程留档

> 以下按功能主题留档，记录设计取舍的演化过程，不代表版本序列；
> 正式变更请以上方「v1.1.0」条目为准。

起草稿 · 阈值个股化（2026-09-20）

主题：阈值个股化 —— 把"一把尺"换成"每股一尺"

• 新增读数原则 6「阈值必须个股化」（依据：脱敏样本年化波动 40%~106%，差约 2.6 倍）
• 短期急涨判断：固定百分比 → 该股近 120 日「5 日滚动涨幅」均值 + 2 倍标准差（夹取 5%~30%），窗口每日滚动重算，禁止硬编码
• 放量 / 缩量：量比 1.3 / 0.7 降级为全市场通用参考 → 改用该股近 120 日量比分布 80 / 20 分位
• 超买 / 超卖：RSI 70 / 30 降级为通用参考 → 改用该股自身 RSI 分布分位
• 关键价位：明确必须用当日实时 MA20 / MA60 / MA120，禁止引用历史静态数值（旧值仅作"当时的参考位"并标注基准日）
• ⑦ / ⑨ 面波动率：「>55% 属高波动」改为经验分档标签（非判断标准），量级按扫描池分位表述
• kline 取数 60 → 130 根日 K（支撑 120 日滚动窗口）
• output-spec.md 新增「阈值口径（动态）」硬性章节
• 口径澄清（2026-09-21 补）：「5 日滚动涨幅」定义为当日收盘 ÷ 5 个交易日前收盘 − 1，逐日滚动、相邻样本重叠；标准差用总体口径（÷N）；参考线计算用全精度、展示保留 1 位小数且不做向上取整；判定统一用「当前值 ≥ 参考线」

边界未变：只读数、不做决策；不输出买卖结论、不给目标价、不做加减仓排序。

起草稿 · 算法与降级规范（2026-09-21）

主题：可复现 + 抗故障 —— 把"算法"和"降级"从口头约定变成书面规范

• 新增 references/scoring-algorithm.md：九面归一化的具体算法——P/R/T 三种转换器、
  ①-⑦ 子指标权重表、绝对档位表（唯一允许固定阈值的例外）、7 轴固定顺序的雷达图规则、
  缺失项权重重分配公式；解决"算法未给出、不同执行者结果不一致"的问题
• 新增 references/degradation-spec.md：逐环节降级矩阵（search/quote/finance/kline/
  fund flow/technical/WebSearch）、重试与超时预算、数据缺失清单强制项、7 面全失败的兜底
• 步骤 5 改为引用算法文件，并新增步骤 5b「异常与降级」，与取数同步执行
• 修复：市场版 CLI 不支持 quote 命令（实测 2026-09-21：支持 kline / technical / finance / fund /
  consensus / profile / score 等，无 quote），工作流第 2 步改为用 kline ... --limit 1 取行情，
  并补充 consensus（一致预期）与 profile（股本/业务）两个取数命令
• 新增 scripts/compute_indicators.py：把 ⑤ 技术面与个股化动态阈值的计算固化为可复用脚本
  （纯标准库，含 kline 倒序 reverse、背离检测、P·池 兜底），回应"核心逻辑沉淀为工具函数"
• 修复算法漏洞：单标的扫描（扫描池 < 5 只）时 P·池 类指标（⑦ 波动率量级）无池可分位，
  新增强制兜底规则——退出计分、权重重分配、改用经验分档标签表述且不得转成分数
• 硬性约束：任何缺失必须显式标注，禁止静默跳过、禁止用固定值/估算值顶替

边界未变：只读数、不做决策——不输出买入 / 卖出 / 持有结论，不给目标价，不做加减仓排序。

起草稿 · 估值口径与档位锚点补充（同日）

• 补齐取数清单（重要）：原清单只列 5 条命令，导致 ⑤ 面缺 KDJ / BOLL / RSI2·6·12·24 / 换手率，
  ⑥ 面缺十大股东，⑦ 面缺事件清单与风险分类——输出会明显偏薄。现补齐
  technical×4（macd/kdj/boll/rsi） + shareholder + dividend list + notice list + risk，
  并在 references/data-sources.md 登记完整命令表与字段映射
• ① 估值面新增成立条件：至少含 1 个估值水平类子项，否则面分留空（避免"缺同业基准→高分"的误导）

• 绝对档位表补充 静态 PE(TTM) 绝对值与 PEG 两行，供同业池不可得时降级使用

• 新增 assets/report-template.html 版式模板（重要）：此前技能包不含任何 HTML 模板，
  导致每次产出的报告版式各不相同。现固化版式（配色变量名、正文 15px、h1 24px、h2 18px + 下划线、
  header 渐变、表格四边完整边框、.mark/.tag/.note/.grid2/.radar 等类），
  并在 output-spec.md 增补「视觉版式（硬性规范）」章节。

• 步骤 6 改为强制套用模板，禁止自创版式。

起草稿 · 版式修订（2026-09-21）

主题：版式修订 —— 对齐 / 层级 / 拉片式读数 / 分数带方向 / ⑨ 面对外化

• 表头对齐：数值列表头加 class="num"，与数值单元格同向右对齐（此前表头左对齐、数值右对齐）
• 小标题层级：h3 加左侧 3px 蓝色竖条 + 上间距加大，避免与上方表格数据混淆
• 读数拉片式：「读数」由整段文字改为 <ol> 逐条编号（1./2./3./4.），禁止堆积成段
• 分数带方向：分数条每行改为 分数（方向），如 51.5（中性偏弱）；新增「读数方向用词表」统一口径
• ⑨ 面对外化：⑨ 组合结构面改为通用语录，仅说明本面用于多标的组合横向比较，不含任何具体持仓信息，报告可直接对外分享
• output-spec.md 新增「版式修订」章节 + 输出前自检清单（6 项）

起草稿 · 版式回归与取数补齐（2026-09-21）

主题：版式回归本项目基准 + 补齐数据缺口 + 交付物去掉「数据缺失清单」

• 版式回归：报告版式改回本项目基准版式（正文 14px、暖白底 #faf9f6、header 无渐变无卡片、h1 21px / h2 15px 无下划线、
  表格仅下边框、.pill.warn 土黄、变量名 --neutral / --accent），取代初稿误采用的另一套版式
• 七条硬性规则写进 output-spec.md：表头对齐 / h3 竖条 / 读数拉片式逐条 / 分数带方向 / ⑨ 面通用语录 / 结构摘要必附 / 页脚不列数据缺失清单
• ① 同业估值分位改为真实可算：用 consensus 取同业各年度 PE / PB / PS / 净利增速（finance 批量 TTM 口径不可靠）
• ⑤ 周线结构可算：--period week 不可用，改为本地按 ISO 周聚合日 K，计算 MA5周 / MA10周站位与周线 MACD 柱；⑤ 面权重扩为 5 项
• ② 备货强度口径修订：--start/--end 取去年同期返回空，改用「(应收+存货) 合计较年初增速」
• 交付物不再列「数据缺失清单」：读者不关心取数链路，缺口改记入 _internal/数据缺口日志_YYYYMMDD.md

起草稿 · 结论前置与估值分类型（2026-09-21）

主题：结论前置 + 估值口径分类型 + 卡片语义三分

• 结论区前置（重要）：报告第一个 section 必须是「结论」——分级大字（I / II / III 级 + 定义）＋
  双轨表述（对外分级 / 自用「买入 / 观望 / 减仓（不建议买入）」）＋ 三级判定依据 ＋ 本次命中哪一级
• 分层标准补「自用操作结论」列：I 级->买入 / II 级->观望 / III 级->减仓（不建议买入）；
  对外只用分级隐晦表述（自用表述不得出现在对外分享版本）
• 估值口径区分价值股 / 成长股：成长股（次年增速 >= 30%）静态取 PE 分位、动态取 PEG 分位，
  PB 仅列示不参与判定；价值股（增速 < 15% 且股息率 >= 2%）才用 max(PE 分位, PB 分位)；均衡型以 PE 为主
• 卡片语义三分：.read 灰（说明）/ .sum 莫兰迪暖沙（所有「读数」「一句话」-> 标签统一「小结」） / .miss 橙（已剔除信息）
• 数值列居中：th.num,td.num{text-align:center}

起草稿 · 小结卡配色首定（2026-09-21）

主题：小结卡改莫兰迪色系 —— 去掉突兀的冷蓝卡，回归页面暖色调

• 问题：初稿的小结卡用蓝调 #f1f6fe + 蓝条 + 蓝标题。全页是暖白底（--bg #faf9f6 / KPI 卡 --soft #f4f2ec），
  冷蓝与之不同族、视觉突兀，且与语义色「中性蓝 --neutral」撞色
• 新配色：新增三个变量 --sum:#efeae0（莫兰迪暖沙底）/ --sumline:#ab9b82（灰驼左条）/ --sumink:#78694f（深驼标题），
  卡体加 1px solid #e5ddce 细边，靠色深 + 左条 + 细边突出，不靠高饱和色
• 新增配色原则：语义色（涨红 / 跌绿 / 中性蓝 / 强调橙）只用于数据与状态标记；
  结构性卡片（小结 / 说明 / 剔除信息）一律取页面同色族的莫兰迪中性色
• ① 面同业表下方的「估值口径」注释行同步去蓝底，改用 var(--sum)

起草稿 · 全站去冷蓝与全面分构成（2026-09-21）

主题：配色回归莫兰迪灰粉 + ①-⑦ 全面分构成 + 档位锚点补齐

• 小结卡改莫兰迪灰粉：--sum:#f0e6e1 / --sumline:#b3928a / --sumink:#7d635c
• 配色总则（硬性）：语义色只用于数据与状态；结构性元素一律用页面同族的莫兰迪中性色。
  新增 --rule:#bfb2a2（分节小标题左竖条，原为冷蓝）、--mid:#a9977f / --midink:#816f57
  （分数条中档、中性标记）、--chart:#9b8d77（雷达图主线，原为冷蓝）。全站不再出现冷蓝。
• ①-⑦ 每面必须输出「面分构成（按权重表）」（四列：子项 / 读数·档位 / 得分 / 权重 + 公式行），
  合计须与分数条一致；各面小结补「面分为什么是这个值」。修正初稿只给 ① 面的遗漏——
  该遗漏在 scoring-algorithm.md 第 7 节本已列为反模式
• 绝对档位表补锚点值（原表只给区间，无法复现）：净现比 / 备货强度 / 负债+商誉 / 盈利趋势等
  明确锚点，锚点间线性内插；新增「定性档位」规则
• ⑦ 回撤子项补分布定义：近 250 日滚动 120 日窗口的最大回撤序列（≈131 窗口）内取分位
• ⑤ 面权重统一为 5 项：均线 0.25 / 背离 0.25 / 量能 0.20 / RSI 0.20 / 周线结构 0.10
  （消除此前 4 项 vs 5 项的双轨）

起草稿 · 单快照一致性与 250 根取数（同日）

• kline 取数 130 → 250 根：⑦ 面的「近 120 日最大回撤个股化分位」需要近 250 日滚动窗口分布（约 131 个窗口）。
  130 根只能得到 11 个窗口，该子项必然退出计分 —— 这是 ⑦ 面此前被算成 85 分的直接原因
• 新增「单快照一致性」硬性规则：一次扫描的所有价格类读数必须来自同一次取数；页脚必须标注取数时刻。
  实测同日三次调用返回不同 last（287.05 / 282.53 / 289.13），混用会让 ⑤ 面均线站位在 3 条 / 2 条间跳档
• degradation-spec.md：kline 降级阈值由「< 130 根」修订为「< 250 根（⑦ 回撤分布需 ≥ 220）」

起草稿 · 收盘价单值化与对外版分离（2026-09-21）

主题：收盘价只取一个数值 + 默认对外版 + 备注色分族 + 面分构成去算式

• 收盘价规则（硬性）：全部价格派生读数（收盘价 / 均线 / 量比 / MACD / KDJ / BOLL / RSI / 回撤 /
  波动率 / 市值 / 估值倍数）只使用一个数值，取「最近一个完整且取值稳定的收盘日」；
  盘中取数或当日快照未稳定时回退到前一个完整收盘日，并在页脚注明回退原因。
  实测同日 kline 三次调用返回 287.05 / 282.53 / 289.13，而 09-18 收盘 279.73 三方一致
• 默认产出「对外版」：结论区只给分级（I / II / III 级）+ 通用分级标准，
  不含「买入 / 观望 / 减仓」任何买卖措辞——技能已公开上架，默认输出即最终用户看到的版本；
  含买卖措辞的自用版另存 _internal/，pill 标「内部自用版 · 不可外发」
• 配色分族：小结卡灰粉降一档（--sum #e8dcd6 / --sumline #9f8179 / --sumink #6b544d）；
  新增草灰绿用于备注 / 说明 / 观察要点（--note #e9ece4 / --noteline #8f9d88 / --noteink #5f6d59）；
  .read（说明卡）与 .watch（观察要点）及表格下方 inline 注释行统一改草灰绿
• 「面分构成」表去掉算式行：只保留 子项 / 读数·档位 / 得分 / 权重 与合计行
• compute_indicators.py 新增 KDJ(9,3,3) / BOLL(20,2) / 多周期 RSI(2·6·12·24) 本地自算，
  摆脱对 technical 接口快照日期的依赖

起草稿 · 波动率脱离扫描池与配色回退（2026-09-21）

主题：波动率脱离扫描池 + 配色回退 + 评级色

• 年化波动率改「个股化分位」（原为 P·池 扫描池分位）：取该股近 250 日收益率的滚动 20 日年化波动率序列
  （≈ 229 窗口）取分位，反向计分。单标的也能算，不再出现「无池可分位 → 子项退出计分」的退化；
  ⑦ 面三子项全部可算，通常不再触发权重重分配
• 修正年化波动率主读数口径：原为整段 K 线收益率标准差（与标注「近 120 交易日」不符）→ 改为近 120 日
• 配色回退：正文段落（.watch）恢复 --ink2 素色、无底色无左条；说明卡（.read）改回主题色暖白面板
  （--soft + 1px solid --line）。彩色底只保留两类卡：小结卡（灰粉）与已剔除信息（橙）；
  表格下方备注注释行用浅暖色 --note #f4f2ec。草灰绿从正文与说明卡中撤出
• 评级色固定：I 级 陶土红 --lv1 #b3553d / II 级 鹅蛋黄 --lv2 #c0932b / III 级 草绿 --lv3 #5f8757

起草稿补丁（同日）—— ⑦ 面两个价格子项统一 120 日尺度

• 原设计：波动率主读数用 120 日、分位序列却用滚动 20 日 → 同一次扫描出现两个「年化波动率」
  （88.8% vs 54.0%），且与同为 120 日口径的回撤子项尺度不可比（用户质疑成立）
• 修正：分位序列窗口改为滚动 120 日（≈129 个窗口），与主读数、与回撤子项完全同尺度；
  长川实测波动率处自身 93.0 分位（最高位）→ 反向得分 7.0，⑦ 面分 48.1 → 26.9
• 20 日窗口降级为「补充观察（不参与计分）」：近 20 日 54.0%、处自身 22.3 分位——短线收敛，
  但不计入分数、不据此判断方向
• 新增硬性规则：同一子项的主读数与分位必须同口径同数值；同一面内各子项窗口长度一致

起草稿 · 短期/中期双窗口波动率（2026-09-21）

主题：⑦ 面波动率拆为「短期 / 中期」双窗口，让波动的变化可见

• 配色微调（同日）：小结卡陶土灰粉调浅 —— --sum #f2e7e1 / --sumline #b3968d / --sumink #7a6159（原 #e8dcd6 / #9f8179 / #6b544d 偏深，面板在暖白底上显得重）

• ⑦ 面由 3 子项扩为 4 子项：负面事件数 0.40 / 短期波动率（20 日年化） 0.15 /
  中期波动率（120 日年化） 0.20 / 近 120 日最大回撤 0.25（窗口越长权重越高：越接近真实风险，短期噪声更大）

• 术语规范：原「年化波动率」更名「中期波动率（120 日）」，新增「短期波动率（20 日）」；
  每条读数必须写明天数，不再使用笼统的「年化波动率」（两个窗口都是年化口径）
• 新增「波动的变化」输出行：短期 − 中期 差值（pct）+ 量级描述（收敛 / 放大），
  必附「仅描述量级变化，不含方向判断」
• 面内分歧提醒：四个子项分处两端时，小结必须写明「面分是两端相抵的结果，不能只读面分」
• 长川实测：短期 54.0%（自身 22.3 分位）→ 77.7；中期 88.8%（自身 93.0 分位）→ 7.0；回撤 0；
  ⑦ 面分 26.9 → 35.1（上一稿的 26.9 是把短期窗口排除在外的结果）