Document artifact facade cards and context backfill (CF-A)

Why: D46/D47 add inbox facade cards for truncated tool results and artifact text backfill; guide needs the unified presentation story. Evidence: usage.md 4.5 gains facade/backfill bullet. Impact: docs-only. Refs: 2026-09-30-card-stream-artifact-unify-project-inbox.md (D46/D47).
Merge pull request 'Document card streaming three-tool flow (CF-S)' (#28 ) from feature/card-stream-r1 into main
2026-09-30 18:40:50 +00:00 · 2026-09-30 18:21:41 +00:00 · 2026-09-30 18:19:39 +00:00 · 2026-09-30 17:45:16 +00:00
1 changed files with 2 additions and 1 deletions
@@ -83,7 +83,7 @@ AGENT_SYSTEM_CONFIG=/etc/agent-system.json agent-system serve   # 环境变量
 - **流式渲染**：正文逐字输出；思考过程（灰字竖线）与工具调用（芯片）实时展示；顶部状态点显示事件流连接。
 - **过程折叠（Cursor 式）**：流式期间思考/工具/中间轮解说照常显示；**最终回复一开始流式，过程立即折叠**为「过程输出 · N 次工具调用」摘要行，只显式显示回复（工具恢复时重新展开）；任务终态后保持折叠，点击展开回看（设置 → 界面 → 可改默认行为）。
 - **长回复折叠**：终态后超过 800 字的回复自动收成「📄 长回复 · N 字（点击展开）」摘要行——流式期间全文可见，历史消息同样适用。
- **长结果进右侧卡片（默认关）**：设置 → 界面 →「长结果进右侧卡片」开启后，报告/纪要/方案/对比/文档草稿等**产物型**长内容经 `submit_card` 进右栏收件箱（result 卡，可置顶/收纳）；中栏保留结论摘要 + 锚点部件（`📄 标题 · N 字 ▸ 展开全文 · ↗ 收件箱`）——锚点可无跳转展开全文，右栏收起时阅读不残废；解释型长回答不进卡。下一轮对话上下文自动回填卡片全文（「🧩 上下文构成」可见 card(n) 条目）。
+- **长结果进右侧卡片（默认关）**：设置 → 界面 →「长结果进右侧卡片」开启后，报告/纪要/方案/对比/文档草稿等**产物型**长内容进右栏收件箱（result 卡，可置顶/收纳）；长正文优先流式三段式——`card_begin` 建卡（收件箱即时出现 active 卡）→ `card_append` 逐段追加（卡片实时刷新，事件按 250ms 窗口节流）→ `card_commit` 收尾（转 done 并锚定到对话）；一次性短产物走 `submit_card`。中栏保留结论摘要 + 锚点部件（`📄 标题 · N 字 ▸ 展开全文 · ↗ 收件箱`）——锚点可无跳转展开全文，右栏收起时阅读不残废；解释型长回答不进卡。下一轮对话上下文自动回填卡片全文（「🧩 上下文构成」可见 card(n) 条目）；run 异常终止时未收尾的流式卡自动置 done/failed 并标注「未正常收尾」，内容不丢。
 - **上下文构成观测**：每条助手消息尾部「🧩 上下文构成」折叠芯片——该轮模型实际看到什么（系统提示/历史条数/附件/知识命中）与裁剪记录（历史超窗/工具结果超限），输入规模可解释。
 - **附件**：📎 上传 md/txt/docx/pdf/图片——文档经内置解析器（确定性代码解析：md/txt 直读、docx 解 OOXML、pdf 提取文本层）转为中间表示注入对话；解析结果与警告显式可见（不静默）。
 - **输入增强**：`/` 唤起命令菜单（/new /mock /model /profile /help）；`@knowledge` 在消息中触发知识检索注入。
@@ -134,6 +134,7 @@ AGENT_SYSTEM_CONFIG=/etc/agent-system.json agent-system serve   # 环境变量
 - 上传与模型产出统一入 Artifacts；`write_artifact` 工具可被模型调用。
 - 查看：markdown 在线渲染；文本类可**编辑保存**；二进制（docx/pdf）下载；图片内联预览。
 - 文档工件与上传文本自动进**知识索引**（全文检索）。
+- **工件门面卡（与产物卡统一呈现）**：工具结果被截断超限时自动在收件箱留一张 `result` 门面卡（摘要 + 来源工具 + `doc-ref` 引用，点击直开查看器）——字节权威仍在工件（可编辑/下载），卡只做门面与锚；下一轮对话上下文会自动回填工件文本（上限与产物卡同为 12000 字，超限在「🧩 上下文构成」可见 `artifact(n)` 与截断记录），模型不再对工具大结果失忆。

 ### 4.6 知识检索
Author	SHA1	Message	Date
weichen	96c8404c5e	Document artifact facade cards and context backfill (CF-A) Why: D46/D47 add inbox facade cards for truncated tool results and artifact text backfill; guide needs the unified presentation story. Evidence: usage.md 4.5 gains facade/backfill bullet. Impact: docs-only. Refs: 2026-09-30-card-stream-artifact-unify-project-inbox.md (D46/D47).	2026-09-30 18:40:50 +00:00
weichen	f5aa687cb1	Merge pull request 'Document card streaming three-tool flow (CF-S)' (#28 ) from feature/card-stream-r1 into main	2026-09-30 18:21:41 +00:00
weichen	3d2da4eb0b	Document card streaming three-tool flow in usage guide Why: CF-S (D44/D45) adds card_begin/card_append/card_commit; users need the streaming flow and crash-fallback behavior documented. Evidence: usage.md cardflow bullet updated to v2 flow. Impact: docs-only. Refs: 2026-09-30-card-stream-artifact-unify-project-inbox.md (D44/D45).	2026-09-30 18:19:39 +00:00
weichen	437af31118	Merge pull request 'Propose card stream, artifact unification, and project inbox (D44-D52)' (#27 ) from feature/cardflow-future-plan into main	2026-09-30 17:45:16 +00:00