SDK 案例：知识变化后，核对引用它的载体

本案例展示已实现的知识维护链路：关联后续来源、限定旧说法的适用场景、修订或舍弃知识，再核对和更新载体。材料来自 sentry-miniapp 的既有 SDK 维护验收；2026-10-14 已用当前 OMK 实现读回独立副本，并在 Studio 打开 v4／v5 核对。

截图与冻结记录来自 main 源码验收，不是已发布的 Beta.13。从 npm 复现这套维护界面需要 1.0.0-beta.14 或更新版本；安装 @next 后用 omk --version 核对。

第一次使用先按知识维护动线建立自己的工作区。本页用于理解具体结果，不要求你安装 SDK 或调用模型。

材料与范围

• 对象是本项目的 @sentry/core 组件；版本是观察条件，不自动成为另一个组件身份。
• 历史窗口包含 protected 覆写与 Session 隔离的讨论。旧说法保留为历史记录，不能直接当成当前未解决缺口。
• 后续观察冻结 SDK 源码 30ffb003，记录 @sentry/core 11.6.0 的依赖、源码接缝和测试源码。它是人工整理的静态材料，没有执行 SDK 动态测试。
• 维护验收记录见 #1166；知识变化提醒和更新核对见 #1168。本次副本读回未改写原始 27 份文件，没有新增模型调用。

从来源到新载体

环节	案例中的实际变化	应核对什么
持续积累	人工确认后，core 对象的来源窗口成员从 2 个增至 3 个。	来源与对象含义；同名不自动归并。
旧知识修订	将旧修正要求限定为历史场景；新修订重新作保留决定。	原文、适用条件、未知和修订理由。
停止沿用	舍弃“历史公开接口缺口说法（原窗口版本未知）”。	舍弃保留历史，不让它进入当前使用载体。
补充条件	静态知识明确“只证明源码，不证明动态通过”。	保存测试源码不等于执行测试通过。
变化提醒	历史 v4 仍引用三条知识，其中两条需复核。	当前新修订与保留状态；提醒不判断真伪或语义过时。
明确更新	v5 选择两条当前保留知识，沿用一条、替换一条、移除一条。	本次引用变化、正文、精确修订和依赖资产。
历史回看	v4 的旧正文和三条引用继续可读；v5 的引用检查为零项变化。	“没有引用变化”不等于内容正确或效果已验证。

核对精确引用

冻结读回记录保存观察时间、OMK 运行时 commit、载体身份与 v4／v5 的完整修订身份，也记录来源可用状态和对象历史成员数（2 → 1 → 2 → 3）。期间解除再重新关联的历史保留，随后接入第三个来源窗口。

知识	历史 v4	当前 v5
历史 protected 覆写与 Session 审查	引用修订 1009571e	沿用同一精确修订
历史公开接口缺口说法	引用修订 6bce64dd	舍弃后明确移除
core 11.6.0 静态接缝快照	引用修订 7113ba63	替换为 6f23942d，限定为只证明源码

这是冻结案例事实，不是 SDK 实时状态。记录不包含本地工作区路径与原始对话；来源及限制由链接的验收 Issue 保留。核对底层材料时，使用 JSON 中的完整身份，不仅凭标题匹配。

在 Studio 核对

1. 打开知识库，查看对象的来源成员，再从知识条目回到原文。候选先核对条件与证据，按理由保留或舍弃。
2. 打开已保存载体，从版本选择进入历史 v4，再进入“变化核对”。案例中的两项提醒分别来自知识修订和不再保留。
3. 展开变化，比较“载体引用的旧修订”与“知识当前修订”，核对标题、陈述和条件；按引用进入对应知识详情。
4. 回到当前版本，选择“生成新版本”，逐项确认沿用、替换和移除，再明确保存。这里只更新本次选择的知识区；手工内容与依赖资产保留。
5. 重新读取最新载体，核对正文和“知识引用”；再切回历史版本，确认旧内容仍然可读。只有需要验证任务效果时，再从明确版本进入评测。

截图来自既有中文案例的真实阅读区，展示历史引用和当前知识的核对；它不是新一次模型提取结果。截图中的版本和时间属于本次案例。

来源缺失、读取失败或载体被外部修改时，先检查提示并重新读取，不能把失败当成没有变化。检查只覆盖这个版本已引用的知识，不覆盖尚未引用的新知识。完整行为边界见知识维护契约。

这份证据支持什么

支持持续维护、修订与精确引用的可回查链路：v4 的历史三条引用保留，v5 只引用所选的两条当前修订，正文与保存清单一致。

没有证明 SDK 升级后动态行为正确、节省时间、跨 Agent 自动复用或每条知识的独立贡献。它使用已暴露材料和作者复核，人工记录适配器不计作自动提取成功。知识收益研究继续单独记录实际使用与收益。