版本与治理

版本化知识包

内容系统把已发布内容导出为版本化、只读、可校验的知识包 releases/design-kb-vX.Y.Z.json（schemaVersion atlas-kb-v1），带 manifest： 计数、过滤口径、治理统计、批次审校策略。

# 导出 / 一键发布（原子落盘 + 通知 Runtime 热更新）
npm run kb:export
npm run kb:publish

热更新

Runtime 默认监听知识包文件（ATLAS_PACK_WATCH=on），发布后自动换新包， 调用方无感；也可手动 POST /api/atlas/v1/admin/reload。

批次审校

seed（工作层）实体默认 draft/internal（待人工审校）。运营方显式授权后， 导出层给实体补齐有效 published / reviewedBy 并在 manifest 留痕：

KB_BATCH_REVIEWER=editor:design-atlas-v1 \
KB_BATCH_REASON="V1.0 批次审校" npm run kb:export

逐实体人工审校可在 seed 中填写真实审校人，导出时合并、不覆盖批次标记。 详见 docs/DESIGN_ATLAS_CONTENT_OPS.md。

鉴权与用量

• Key 只存 sha256，可单独撤销、立即生效
• 用量日志记录 keyId / product / plan / 端点 / 状态 / 延迟
• 报表与账单见 套餐与限额

计费接口层

套餐模型（@halfway/atlas-core/runtime/billing）、Key 绑定套餐、月度账单聚合均已就绪； 真实收款（Stripe / 支付宝 / 微信）待接入，清单见 docs/DESIGN_ATLAS_BILLING.md。