模型状态规则
KTransformers 文档区分“代码存在”和“已验证支持”。这样可以避免把旧教程或模型特定实验升级成通用支持。
状态标签
| 状态 | 含义 |
|---|---|
| Current | 代码入口存在，文档接口与当前包路径一致。 |
| Current, narrow | 只在明确模型、包版本、硬件或 backend 约束下支持。 |
| Needs smoke | 代码或文档存在，但生产声明前需要复跑精确 runtime tuple。 |
| Legacy | 依赖旧入口或过时包结构。 |
| Do not advertise | 内部、不完整或仅 enum 级特性，不是公开路径。 |
必填 Tuple
每条支持声明都应包含：
模型家族 + checkpoint + KT method/backend + 硬件类别 + serving/training 入口 + 包/版本限制
何时降级声明
出现以下情况时，使用 Needs smoke 或 Legacy：
- 页面依赖
local_chat.py、ktransformers/server/main.py、balance_serve或旧 optimize-rule 流程； - registry defaults 和教程命令不一致；
- 需要特殊或 pin 住的包版本；
- 模型路径需要非默认转换步骤，但未复跑；
- 上次测试后硬件 backend 已变化。