打分规则

每条「成分 × 机制」连接分四个轴显示,不压成一个综合分。下面先说明页面上的记号,再给出完整规则(与仓库中的 docs/scoring.md 为同一份文本)。

页面记号

强度0 2 4 0 可忽略 · 1 弱 · 2 中 · 3 强 · 4 标杆
证据L1 体外 · L2 动物 · L3 人体靶点/药代 · L4 人体对照试验 · L5 多项试验/荟萃
可达性可达·高 可达·中 可达·低 可达·局部
状态草稿 起草中,可能没有文献 · 已核 文献已核验并对照过主张 · 已复核 头儿复核认可
文献已核验 PMID/DOI 与标题、年份经 PubMed/Crossref 核对一致 · 未核验 尚未核对

局限

打分规则

修改规则先改本文件,再改数据;sa.py check 会执行下面的硬规则。

原则

  1. 打分对象是一条连接:「成分(可限定形式)× 机制标签」,不是给成分打总分。
  2. 四个轴并列,不压成一个数:强度、证据、可达性、状态分开显示。
  3. 只在同一机制内可比:姜黄素的 NF-κB 强度 2 和镁的 NMDA 强度 2 不能互相比较。每个机制用锚点来校准。
  4. 机制分不等于疗效分:疗效属于结局层(见 docs/plan.md)。
  5. 保留 0 分连接:常被宣传但在体内基本不成立的机制也要记录,用来纠正误解。

轴 1:作用强度 strength(0–4)

指在常用补充剂量、人体可达暴露下,对该机制靶点的作用幅度。

分 含义 参考
4 标杆:该机制的参照物,或接近药物级的作用 红曲米之于 HMG-CoA 还原酶;肌酸之于磷酸肌酸;萝卜硫素之于 Nrf2
3 强:作用稳定、可测、幅度大,在同类中靠前 —
2 中:可测但幅度中等,或需要增强制剂/较高剂量 —
1 弱:幅度小或结果不一致,或只在缺乏者/特定人群中出现 —
0 可忽略:在体内可达浓度下基本不起作用 姜黄素之于系统性直接清除自由基

锚点:在连接上写 anchor: true,表示这是该机制里已知作用最强的成分,也是同一机制其他连接打分的参照。机制有 3 条以上连接后必须有锚点;锚点的强度必须等于该机制的最高强度。如果没有成分达到药物级,最高分就是 3。

轴 2:机制证据层级 evidence(L1–L5)

指支持「该成分在人体内作用于该机制」的最高一级证据。

层级 含义
L1 体外或计算研究
L2 动物体内研究
L3 人体药代或靶点证据:可达浓度、组织分布、人体样本中靶基因或酶活性的改变
L4 人体对照试验中,机制相关生物标志物出现改变
L5 多项对照试验或荟萃分析,结果方向一致

下游指标(如 hs-CRP)不特异于某一机制时,可以按 L4 计,但必须在理由中写明特异性有限。

文献类型与层级的对应(refs 中的 type 字段):

type 能支撑的层级
in-vitro L1
animal L2
human-mech(人体药代、靶点、组织样本研究) L3
rct L4
meta(荟萃分析,或对照试验的系统综述) L5
review、cohort、case-report、guideline 不支撑机制层级;可用于背景、安全与剂量

轴 3:体内可达性 exposure

值 含义
high 活性形式在靶组织能稳定达到有效浓度
medium 部分达到,或依赖特定制剂/剂量
low 可达浓度明显低于有效浓度
local 只在肠腔或局部起作用(不计为系统作用)

轴 4:状态 status

值 条件
draft 起草中,可以没有文献
sourced 承重文献已通过 verify-refs,并且起草者(可以是 agent)已对照至少摘要核对过主张;read 字段如实记录阅读层级
reviewed 头儿看过并认可,记录 reviewed_on 日期;只能由头儿确认后登记

附加字段

硬规则(由 sa.py check 执行)

  1. 每条连接都要有 rationale。
  2. exposure: low 时,strength 不超过 1。
  3. evidence 为 L1 或 L2 时,strength 不超过 2。
  4. strength 达到 3 时,至少要有一条能支撑 L3 及以上的文献(human-mech、rct 或 meta)。
  5. 状态为 sourced 或 reviewed 时,必须有文献,且全部通过核验。
  6. 同一成分里,同一机制的多条连接适用的形式不能重叠(省略 forms 视为覆盖全部形式)。
  7. 机制有 3 条以上连接时必须有锚点;锚点强度必须等于该机制的最高强度。
  8. 连接引用的机制、形式和文献编号必须存在。
  9. 状态为 sourced 或 reviewed 时,evidence 不能高于所引文献能支撑的最高层级(见上表)。
  10. 状态为 reviewed 时必须有 reviewed_on。
  11. 整个条目的 review.status 不能高于其中最低的连接状态。

排序

机制页默认先按强度降序,再按证据层级降序,最后按状态排序;不计算综合分。如果头儿以后决定要一个排序用的值,在这里定义权重,并在页面上标明「仅用于排序」。