Fill the ext-9 task card with surface and acceptance scope

Why: EXT-9 is accepted (Documents #49) as the other step-4 hard prerequisite; the publish/revoke surface and the upload pre-index switch must be scoped before implementation.
Evidence: Knowledge store shapes verified (owner column, DeleteKnowledgeByRef, vectors-by-ref cleanup precedent).
Impact: Task card only.
Refs: EXT-9 proposal; U0 section 5 C5 / section 10 step 4.
This commit is contained in:
2026-10-08 15:50:22 +00:00
parent d32b58829c
commit d42ec175ad
+13 -2
View File
@@ -7,7 +7,9 @@
- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= 7b73dd19b8566446c137a6e3a46fed17bfa548d4
- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-ext-9-index-publish(worktree);分支:feature/ext-9-index-publish
- 授权与交付终点:<本次允许的动作与终点;未授权事项写明>
- 授权与交付终点:用户目标(含合入清理)+ 验证器指令「启动 EXT-9(索引发布与撤销)
基座实现:红测先行——存疑资料确认前不得进正式检索、撤销后检索即停」。EXT-9 已受理
(Documents #49)。允许:Backend 实现(Backend PR)+ Dev gitlink PR + CI 绿后合入 + 清理。
- 交付模式:manual(逐阶段人工评审);明确授权后可记为 authorized-continuous
- 自动推进授权:无;授权范围:无;授权来源:无;授权终点:无;停止条件:无(未授权)
- 当前阶段:需求拆解;当前增量:I1(待定义)
@@ -15,7 +17,16 @@
## 目标与非目标
<预期结果、受影响入口/模块/契约;明确不做什么。>
**公开面(EXT-9 切片 1)**:①`extension.Options.DisableUploadIndexing`(零值=现状 true
索引;RDM 部署置 true,索引决定移交其命令层);②`Host.KnowledgePublish(docs, embed)`
——按 ref 幂等替换写(清旧行+旧向量后走既有 KnowledgeWrite 路径;重试同结果);
③`Host.KnowledgeDelete(sourcePrefix)`——仅允许 `plugin:<自身ID>` 前缀(manual/他人来源
拒绝),删行+向量,幂等。SurfaceVersion 2.1.0→**2.2.0-experimental**(surface.txt 同步)。
**存储**:新增 `DeleteKnowledgeBySource(owner, prefix)`(含向量清理,经 ref 关联)。
**验收断言(红测)**:上传开关关→检索零命中(原件仍在);publish 两次→命中数=块数
(不重复);delete 后检索即停;重复 delete 无错;manual 来源经 host 不可删。
**非目标**:知识检索跨 owner(EXT-8 切片 2);按版本粒度发布令牌(后续按需);RDM 侧
发布状态机(下游任务)。
## 关联方向与规划