diff --git a/.task/feature-card-stream-r1.md b/.task/feature-card-stream-r1.md index 74407a20..09ca0d61 100644 --- a/.task/feature-card-stream-r1.md +++ b/.task/feature-card-stream-r1.md @@ -6,21 +6,29 @@ - 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= f65d89e59b6974c7a5db63be0677d192bfaa7e9c - 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-card-stream-r1(worktree);分支:feature/card-stream-r1 -- 授权与交付终点:<本次允许的动作与终点;未授权事项写明> +- 授权与交付终点:用户批准 D44–D52 提案并指示「按方案开始实施」;本卡为提案 §3 第一期 CF-S(卡片内容流式),终点 = backend + documents 模块 PR 合入 + Dev gitlink PR 合入 + worktree 回收。 ## 目标与非目标 -<预期结果、受影响入口/模块/契约;明确不做什么。> +目标(提案 D44/D45): +1. backend:内置流式三段式工具 card_begin/card_append/card_commit(ui.cardflow 门控声明、幻觉拒绝);cardsvc.Append(逐次持久化 + card.updated 250ms 节流);runmgr Begin/Append/CommitStreamCard + finishRun 兜底(未收尾流式卡按 run 结果置 done/failed,tone=warn「未正常收尾」);mock `#cardstream` 演示;style-cardflow v2(长正文优先流式)。 +2. documents:usage.md 卡流条目更新(流式流程 + 兜底语义)。 + +非目标:frontend/ui 流式视觉(shimmer)可选项本卡不做;CF-A/CF3 另立卡。 ## 同步记录 | 节点 | sync_base_sha | tested_head_sha | checked_at | |---|---|---|---| -| 启动 | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | 2026-09-30T18:03:18Z | +| 启动 | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | 2026-09-30T18:02Z | +| 验收 | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | e1f996815a(组合 tip:backend 24a2873 / documents 3d2da4e) | 2026-09-30T18:20:27Z | -## 结果与验证(完成后填写) +## 结果与验证 -- 结果: +- 结果:backend 24a2873(cardsvc Append 节流、runmgr 三方法 + 兜底、runner 接口三方法、llm.go 三工具声明与编排、mock #cardstream、style-cardflow v2、新增单测 3 + e2e 1);documents 3d2da4e(usage.md 流式条目)。 - 验证: + - backend `go test ./...` 全绿(18 包 ok):新增 TestLLMRunnerCardStreamTools(begin→append×2→commit → done 卡 + 正文合并 + cardId 部件 + commit 后拒绝)、TestLLMRunnerCardStreamGated(关闭不声明、幻觉不产卡)、TestAppendStreamThrottleAndMerge(窗口内 1 次发布、跨窗口+终态 3 次、正文逐段合并)、e2e TestMockCardflowStreamLoop(#cardstream → 收件箱 done 卡 + 三段正文 + 引用部件 + 锚点回填)。 + - Dev 组合:`make test` 退出码 0(core/backend 全 ok、frontend/ui vitest 全绿、agent-command ok);task-sync sync_base=f65d89e tested_head=e1f9968(2026-09-30T18:20:27Z)。 - 影响与剩余项: -| 同步前验收 | f65d89e59b6974c7a5db63be0677d192bfaa7e9c | e1f996815a51411456528f9cc03f8a9003b0e3e2 | 2026-09-30T18:20:27Z | + - submit_card 路径与线协议不变;card.updated 仍整卡投影(节流=省略中间投影)。 + - 剩余(可选项):frontend/ui 流式中视觉(shimmer);CF-A、CF3 按提案顺序另立卡。