打分规则
每条「成分 × 机制」连接分四个轴显示,不压成一个综合分。下面先说明页面上的记号,再给出完整规则(与仓库中的 docs/scoring.md 为同一份文本)。
页面记号
| 强度 | 0 2 4 0 可忽略 · 1 弱 · 2 中 · 3 强 · 4 标杆 |
|---|---|
| 证据 | L1 体外 · L2 动物 · L3 人体靶点/药代 · L4 人体对照试验 · L5 多项试验/荟萃 |
| 可达性 | 可达·高 可达·中 可达·低 可达·局部 |
| 状态 | ✎草稿 起草中,可能没有文献 · ✓已核 文献已核验并对照过主张 · ✔已复核 头儿复核认可 |
| 文献 | 已核验 PMID/DOI 与标题、年份经 PubMed/Crossref 核对一致 · 未核验 尚未核对 |
局限
- 机器检查只证明结构完整、规则自洽,不证明科学正确。
- 「已核」表示起草者(可能是 AI agent)读过至少摘要;阅读层级逐篇标在文献上。
- 机制分不等于疗效分,也不等于适合任何具体的人。
打分规则
修改规则先改本文件,再改数据;sa.py check 会执行下面的硬规则。
原则
- 打分对象是一条连接:「成分(可限定形式)× 机制标签」,不是给成分打总分。
- 四个轴并列,不压成一个数:强度、证据、可达性、状态分开显示。
- 只在同一机制内可比:姜黄素的 NF-κB 强度 2 和镁的 NMDA 强度 2 不能互相比较。每个机制用锚点来校准。
- 机制分不等于疗效分:疗效属于结局层(见
docs/plan.md)。 - 保留 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 日期;只能由头儿确认后登记 |
附加字段
role:primary 或 secondary,表示这是不是该成分的主要机制。forms:连接适用的形式;同一机制在不同形式下可以各有一条连接。dose:该分数对应的剂量条件。deficiency_dependent:主要在缺乏时起效。A 类辅因子通常为 true。contested:存在实质争议,如白藜芦醇的 SIRT1 激活。rationale:必填。说明为什么给这个分,以及哪些证据会改变它。
硬规则(由 sa.py check 执行)
- 每条连接都要有
rationale。 exposure: low时,strength不超过 1。evidence为 L1 或 L2 时,strength不超过 2。strength达到 3 时,至少要有一条能支撑 L3 及以上的文献(human-mech、rct 或 meta)。- 状态为
sourced或reviewed时,必须有文献,且全部通过核验。 - 同一成分里,同一机制的多条连接适用的形式不能重叠(省略
forms视为覆盖全部形式)。 - 机制有 3 条以上连接时必须有锚点;锚点强度必须等于该机制的最高强度。
- 连接引用的机制、形式和文献编号必须存在。
- 状态为
sourced或reviewed时,evidence不能高于所引文献能支撑的最高层级(见上表)。 - 状态为
reviewed时必须有reviewed_on。 - 整个条目的
review.status不能高于其中最低的连接状态。
排序
机制页默认先按强度降序,再按证据层级降序,最后按状态排序;不计算综合分。如果头儿以后决定要一个排序用的值,在这里定义权重,并在页面上标明「仅用于排序」。