Skip to content

[P1][Knowledge] Ingest versioned deployment receipts with freshness and provenance #11

Description

@ShuhaoZhangTony

背景

当前公开知识库有 718 份文档,但未检索到本次 DeepSeek-V4-Flash W8A8 MTP 八卡部署记录。因此涉及“目前如何部署”“现在跑什么模型”的问题即使经过知识检索,也可能没有有效依据并退化成模型泛化回答。

部署事实会频繁变化,不能靠人工编辑一份长期不更新的 Markdown,也不能把机器本地路径、密钥或旧部署永久混在普通知识文档中。

目标

让每次成功部署产生版本化、脱敏、可失效的 machine-readable receipt,并由 Sage Mate 知识维护流程自动同步为可引用证据。

设计要求

  • 消费 dev-hub capability-aware deployment receipt,而不是从启动命令文本猜测。
  • receipt schema 包含时间、模型身份/架构、引擎及插件提交、硬件类型与设备数、并行/量化/图模式、speculative requested/resolved/active/reason。
  • 明确 active/superseded/failed 生命周期;新部署成功后旧 active receipt 自动 supersede。
  • runtime 类证据带 TTL/freshness,过期数据不得覆盖实时状态。
  • 建立 provenance、内容 hash、来源 URI 和采集时间;Support 卡片可展示友好的公开摘要。
  • ingestion 前执行敏感字段 allowlist,禁止 API key、token、私网地址、容器秘密和非公开路径进入公开知识库。
  • 同步失败必须可观测并告警,不得让服务悄悄使用旧 receipt。

验收标准

  • 一次成功部署后,无需手工编辑知识文件,公开问答能引用最新 receipt。
  • 连续切换两个 fixture 后只将后者视为 active,前者仍可审计但不会回答成当前状态。
  • stale、schema mismatch、签名/校验失败及含敏感字段的 receipt 均被拒绝并记录原因。
  • 知识库维护报告展示 active deployment receipt 的版本、年龄和同步状态。
  • 添加 schema、ingestion、supersede、redaction、freshness 和引用渲染测试。

依赖/关联

Metadata

Metadata

Labels

documentationImprovements or additions to documentationenhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions