diff --git a/.task/feature-regulations-kb.md b/.task/feature-regulations-kb.md index cf89eaeb..6fdf621c 100644 --- a/.task/feature-regulations-kb.md +++ b/.task/feature-regulations-kb.md @@ -1,12 +1,12 @@ # feature/regulations-kb 任务卡 -任务主记录：；状态：进行中；owner：weichen +任务主记录：[Dev #614](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/614)；状态：进行中；owner：weichen ## 基线与授权 - 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= b5e23daed2f0ea46261979de1d62e4de0cfa88f9 - 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-regulations-kb（worktree）；分支：feature/regulations-kb -- 分支类型：initiative；initiative_id：feature-regulations-kb；root_target：main；immediate_target：main；accepting_requirements：true +- 分支类型：initiative；initiative_id：feature-regulations-kb；root_target：main；immediate_target：main；accepting_requirements：false - 需求分流：verdict=NEW；selected_initiative=无；requirement_sha256=fa6ff4c75a01064e0aa767dc91455b8e5bcd0f5f29f59958962543c633bf2ba2；triage_receipt=/tmp/regkb-triage-20261018.json；receipt_sha256=907151e982da280292647462e8342fbbd1453a87565c887ef4cb2269f29eae03 - 授权与交付终点：用户 2026-10-18 指示“按照方案一步一步实现所有内容，并在完成后进行清理”（/goal）。授权范围 = 计划 U1–U9 的实施、验证、Review、各仓 PR 合入与安全收口，含新建 `Agent-System-KB-Regulations` 仓。未授权：生产部署、生产全量语料导入、发布受保护标准原文、法律适用性裁定、新增外部付费调用（真实搜索/MinerU 实网调用前须用户确认提供方与凭据）、高后果双钥匙操作。 @@ -14,7 +14,7 @@ - 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md） - 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入） - 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收 -- 当前阶段：需求拆解；当前增量：I1（待定义） +- 当前阶段：合入核验与收口；当前增量：U1–U9 全部合入组件仓，Dev 承载 U1/U7 规格与 U8 组合 - 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位） ## 目标与非目标 @@ -35,7 +35,7 @@ | 子任务分支 | 必需 | 状态 | PR | |---|---|---|---| -| 待登记 | 否 | — | — | +| 无（各单元在组件仓独立分支交付，见「跨仓交付登记」） | — | — | — | ## Agent 实施收据 @@ -43,19 +43,27 @@ | 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | |---|---|---|---|---|---|---|---|---|---|---| -| 待定义 | — | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | — | +| dev-u8-regulations-composition | modules/{backend,documents,frontend,ui}、tests/integration/regulations-kb、tests/test_regulations_kb_pin.py、Makefile、PROJECT.md | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session，session not-observable） | success | 05a60f7 | never | /tmp/regkb-u8dev-receipt.json（收口后清理） | +| dev-u8-regulations-scan-default | run.sh、README、pin 测试（扫描默认目录去掉服务端 bin/） | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session） | success | 4764cb4 | never | /tmp/regkb-u8dev-fix-receipt.json（收口后清理） | +| dev-u8-merge-prep-frontend-pin | modules/frontend 还原到分支基线 92864db 以干净合并 main #617 | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session） | success | c1181d4 | never | /tmp/regkb-u8dev-prep-receipt.json（收口后清理） | +| dev-u8-readd-frontend-pin | modules/frontend → 50ec836（426d104 后代） | caefcb72b970 | implementation | cursor→agy→pi | 1 | cursor（fresh_session） | success | 9dd9f1a | never | /tmp/regkb-u8dev-readd-receipt.json（收口后清理） | +| 组件仓单元 | U2–U7、提供方、组合与 KB/RDM U8 | 各仓 AGENT-EXECUTION.md | implementation | cursor→agy→pi | 各 1 | cursor | success | 见各仓 PR 与任务卡 | never | 各仓任务卡 | ## 关联方向与规划 -- 适用状态：待核对（无适用规划时说明原因） -- 主记录路径/版本：待核对（路径按仓库根目录定位，归档后不变；只引用唯一正文） -- 对应里程碑：待核对 +- 适用状态：适用 +- 主记录路径/版本：docs/superpowers/plans/2026-10-18-regulations-knowledge-base-plan.md（本 PR 合入版本） +- 对应里程碑：法规知识库 U1–U9 ## 需求分析 | ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 | |---|---|---|---|---|---|---| -| R1 | 待填写 | 待评估 | 待定 | 待定义 | 待确认 | 待评审 | +| R1 | 受控法规语料：来源/许可盘点、解析切片、检索与版本发布（U1–U5） | 符合计划，KB 仓独立 | P0 | 计划 U1–U5 测试场景 | — | 已交付 | +| R2 | RDM 双源核验：缺任一通道报降级，不得显示已核验；审计批次防篡改（U6） | 符合 | P0 | U6 场景 | R1、R5 | 已交付 | +| R3 | 结构化引用：对话/文档/审计中定位到版本、条款与片段（U7） | 符合 | P0 | 引用合同 + U7 场景 | R2 | 已交付 | +| R4 | 组合、恢复、隐私与发布就绪（U8） | 符合 | P0 | 组合门禁 PASS | R1–R3 | 已交付（部署/发布另行门禁） | +| R5 | EXT-20 公开扩展契约与提供方（U9） | 符合 | P0 | Backend/Documents 合入 | — | 已交付 | ## 方案与计划 @@ -78,29 +86,32 @@ | EXT-20 提供方 | KB-Regulations `feature/kbreg-provider` | [KB #5](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-KB-Regulations/pulls/5) | 已合入 d6d7056 | | U7 前端 | Frontend `feature/regulations-kb-citations` | [Frontend #109](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Frontend/pulls/109) | 已合入 2d65a81 | | U7 契约 | Dev `docs/superpowers/specs/2026-10-18-regulations-citation-contract.md` | [Dev #614](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/614) | 已提交 06dd79c | -| U7 RDM | RDM `feature/regulations-kb-citations` | 待建 | 实施中 | -| 组合注册 | RDM `feature/regulations-kb-composition`（KB pin、kbreg 垫片、Frontend pin） | 待建 | 实施中 | +| U7 RDM | RDM `feature/regulations-kb-citations` | [RDM #437](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-RDM/pulls/437) | 已合入 3cc91de | +| 组合注册 + RDM U8 测试 | RDM `feature/regulations-kb-composition`（KB gitlink、kbreg 插件、组合测试） | [RDM #438](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-RDM/pulls/438) | 已合入 ece91da | +| U8 KB 运维与恢复测试 | KB-Regulations `feature/u8-operations` | [KB #6](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-KB-Regulations/pulls/6) | 已合入 5dddad2 | +| U7 前端卡状态修正 | Frontend `fix/close-regulations-kb-citations-card` | [Frontend #110](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Frontend/pulls/110) | 已合入 50ec836 | +| U8 Dev 组合 | Dev `feature/regulations-kb`（四个 gitlink + `make test-regulations-kb`） | [Dev #614](https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/614) | 随本 PR 合入 | ## 阶段记录 | 阶段 | 对象版本 | 状态 | 决策/执行者 | 时间 | 依据 | |---|---|---|---|---|---| -| 需求拆解 | 待定 | 待执行 | — | — | — | -| 需求评估 | 待定 | 待执行 | — | — | — | -| 需求表确认 | 待定 | 待执行 | — | — | — | -| 方案设计 | 待定 | 待执行 | — | — | — | -| 实施计划 | 待定 | 待执行 | — | — | — | -| 实施与自检 | 待定 | 待执行 | — | — | — | -| 正式测试与验收 | 待定 | 待执行 | — | — | — | -| 代码 Review | 待定 | 待执行 | — | — | — | -| 合入 | 待定 | 待执行 | — | — | — | -| 合入核验与收口 | 待定 | 待执行 | — | — | — | +| 需求拆解 | 计划 f61737b | 完成 | 用户 /goal + host | 2026-10-18 | 计划 U1–U9 | +| 需求评估 | 计划 f61737b | 完成 | host | 2026-10-18 | 需求表 R1–R5 | +| 需求表确认 | 计划 f61737b | 完成 | 用户（/goal 一次确认 + AskQuestion 三项决策） | 2026-10-18 | 基线与授权 | +| 方案设计 | 计划 + 引用合同 06dd79c | 完成 | host | 2026-10-18 | docs/superpowers | +| 实施计划 | 计划 U1–U9 | 完成 | host | 2026-10-18 | 跨仓交付登记 | +| 实施与自检 | 各仓 PR head | 完成 | cursor worker（新进程/隔离工作区） | 2026-10-18 | Agent 实施收据 | +| 正式测试与验收 | Dev 4764cb4 + RDM ece91da + KB 5dddad2 | 完成（SELF 本地；GATE 见各仓 CI） | host | 2026-10-18 | 证据表 | +| 代码 Review | 各单元 diff | 完成 | host 主模型（未复用实施会话） | 2026-10-18 | 合入与清理 | +| 合入 | Dev #614 | 进行中 | host | 2026-10-18 | 当前 HEAD CI 通过后合入 | +| 合入核验与收口 | — | 待执行 | host | — | 清理记录 | ## 探索试验与迭代 | 增量/试验 | 假设 | 范围 | 判断和停止条件 | 授权/决策依据 | 结果 | 变更影响 | 需重审补测 | |---|---|---|---|---|---|---|---| -| 待定义 | — | — | — | 待核对 | NOT_RUN | 待评估 | 待评估 | +| 无 | — | — | — | — | — | — | — | ## 同步记录 @@ -124,24 +135,24 @@ ## 结果与验证（完成后填写） -- 结果： -- 验证：<结论摘要 PASS/FAIL/SKIP/NOT_RUN 逐项；逐条证据由 make evidence 写入上方证据表> -- 影响与剩余项： +- 结果：U1 盘点规格与 U7 引用合同（本 PR）；KB-Regulations #1–#6（基础契约、解析切片/MinerU 适配、网络搜索与 SSRF 安全抓取、检索/发布门禁、EXT-20 提供方、运维与恢复测试）；Backend #212、Documents #113（EXT-20）；RDM #434（双源核验与封印审计批次）、#437（结构化引用）、#438（kbreg 组合与组合测试）；Frontend #109/#110（引用渲染）；本 PR 固定 backend 56a7f9f、documents 5bb4877、frontend 50ec836、ui 5c2b103，并新增 `make test-regulations-kb`（固定 RDM ece91da、KB 5dddad2）。 +- 验证：GATE——KB main 5dddad2（test、test-pg、governance）、d6d7056；RDM main 3cc91de、ece91da（build-and-test 首跑因既有不稳定测试 TestSlowLedgerPersistsLifecycle 失败，重跑 job 6149 通过；governance）；Frontend 2d65a81、50ec836（governance）；Dev 本 PR 当前 HEAD CI 见合入记录。SELF——Dev `make test` exit 0（umask 022；此前两次失败分别因嵌套子模块未物化与本机 umask 077 使 Backend TestDSNFileMode 误报，均已如实记录）；`make test-regulations-kb` PASS（一次性 pgvector pg16，三阶段 kb-test-pg / rdm-kbreg 12 个目标测试 / 客户端制品凭据扫描）。NOT_RUN——真实智谱搜索、MinerU 实网调用与真实嵌入（待用户确认提供方与凭据）。 +- 影响与剩余项：新仓 Agent-System-KB-Regulations 分支保护待用户设置；RDM 需求文档同步为非阻塞后续；部署、版本发布、生产语料导入与业务/法务验收为后续独立门禁。非阻塞记录：RDM TestSlowLedgerPersistsLifecycle 存在内存终态先于台账回写的竞态（waitDone 只等内存状态）。 ## 规划进展与下一步 -- 本次推进/剩余：待核对（依据实际成果更新适用方案/规划） -- 首选下一任务：待核对（无适用规划、已完成或受阻时如实说明，不虚构任务） -- 推荐依据：待填写 -- 前置条件/待确认：待核对 -- 预期产物/验收条件：待定义 -- 重复任务核对：待核对（已有/在途任务、PR 与规划记录） +- 本次推进/剩余：计划 U1–U9 全部交付；剩余为实网联调与部署类后续门禁 +- 首选下一任务：真实搜索/MinerU/嵌入实网联调（需用户确认提供方、凭据与费用） +- 推荐依据：计划 Verification Contract 中唯一 NOT_RUN 的能力验证 +- 前置条件/待确认：用户批准外部付费调用并经环境注入凭据 +- 预期产物/验收条件：KB `KBREG_*` 实网冒烟记录，不入库任何凭据 +- 重复任务核对：无在途同类任务 - 启动授权：未授权（建议不自动启动新任务，仍须明确授权） ## 合入与清理 -- Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据） -- 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测） +- Review 记录：host 主模型逐个审阅各单元 diff（Dev 05a60f7/4764cb4/c1181d4/9dd9f1a，组件仓见各 PR），实施均由独立 cursor worker 新进程完成，审阅未复用实施会话；Dev U8 审阅发现扫描默认目录含服务端 bin/ 必然误报，已由 dev-u8-regulations-scan-default 修复；其余无阻塞项。 +- 冲突记录：main #617 将 modules/frontend 改钉 426d104，与本分支 50ec836 冲突；准备单元还原到基线后干净合并（d5d6f70），再由单元钉回 50ec836（426d104 的后代，仅加卡状态修正）；modules/ui 两侧同为 5c2b103。 - CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果） - 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验） - 清理记录：NOT_RUN（授权依据、写者退出确认、worktree/分支/任务卡处置）