2026-09-30 18:44:17 +00:00
3 changed files with 35 additions and 2 deletions
@@ -0,0 +1,33 @@
+# feature/artifact-unify-r1 任务卡
+
+任务主记录：<PR 链接，task-finish 时填写>；状态：验收通过待合入；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 0be23f9a4d002a977de2998f687bc8555c3edb63
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-artifact-unify-r1（worktree）；分支：feature/artifact-unify-r1
+- 授权与交付终点：提案 §3 第二期 CF-A（artifact 统一，D46/D47）；终点 = backend + documents 模块 PR 合入 + Dev gitlink PR 合入 + worktree 回收。
+
+## 目标与非目标
+
+目标（提案 D46/D47）：
+1. backend：ctxasm ArtifactResolver 回填 artifact_ref 正文（UTF-8 文本、与卡同 12000 字上限、Truncations/artifact(n) 可观测、二进制留占位）；runCtx.Artifact；llm.go 截断工具结果自动产门面卡（摘要 kv + doc-ref，显式卡避让）；mock #doc 门面演示。
+2. documents：usage.md 4.5 工件节增门面卡与回填说明。
+
+非目标：前端零改动（artifact 芯片已有查看器/预览/下载动作，docBridge 已按工件 ID 解析 doc-ref——门面卡开箱即用，盘点结论记录于此）；跨会话（CF3 另立卡）。
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | 0be23f9a4d002a977de2998f687bc8555c3edb63 | 0be23f9a4d002a977de2998f687bc8555c3edb63 | 2026-09-30T18:26Z |
+| 验收 | 0be23f9a4d002a977de2998f687bc8555c3edb63 | b10b83456c（组合 tip：backend 61731cb / documents 96c8404） | 2026-09-30T18:41:16Z |
+
+## 结果与验证
+
+- 结果：backend 61731cb（ctxasm ArtifactResolver + renderArtifactRef、runCtx.Artifact、llm.go 门面卡 + explicitCard 避让、artifactFacadeCard helper、mock #doc 门面、新增单测 4 + e2e 1）；documents 96c8404（usage.md 4.5）。
+- 验证：
+  - backend `go test ./...` 全绿（18 包 ok）：TestAssembleInputArtifactBackfill（回填/截断留痕/二进制占位/无 resolver 占位）、TestLLMRunnerArtifactFacadeCard（截断产门面卡：result/done、kv+doc-ref、消息双部件；未截断不产卡）、TestLLMRunnerArtifactFacadeSuppressed（显式 submit_card 时避让）、e2e TestArtifactFacadeCard（#doc → 门面卡入收件箱 + doc-ref + 引用部件 + 锚点回填）。
+  - Dev 组合：`make test` 退出码 0；task-sync sync_base=0be23f9a tested_head=b10b834（2026-09-30T18:41:16Z）。
+- 影响与剩余项：ctxasm AssembleInput 签名追加 resolveArtifact 参数（唯一生产调用点 llm.go 已同步；测试桩已更新）；下一轮模型对工具大结果不再失忆。剩余：CF3 跨会话收件箱（提案第三期，另立卡）。
+| 同步前验收 | 0be23f9a4d002a977de2998f687bc8555c3edb63 | b8a06cd0e1d35696a9cb8d3c9399f09f51118ee4 | 2026-09-30T18:42:55Z |