diff --git a/.task/feature-ext-9-index-publish.md b/.task/feature-ext-9-index-publish.md index bfd1f6b9..4a670f36 100644 --- a/.task/feature-ext-9-index-publish.md +++ b/.task/feature-ext-9-index-publish.md @@ -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 侧 +发布状态机(下游任务)。 ## 关联方向与规划