统一智能体对话层级并完善素材导出与文档预览

当前Agent与策划Agent共用正文和过程表现组件，统一思考及工具调用的小字号浅色样式素材工具栏按实际动作分组，导出紧邻删除并修复空分组重复分隔线文档与代码使用共享Markdown预览和代码高亮，复用按需读取与缓存移除未调用的活跃回合查询命令，保留正式快照恢复链路补充回归用例并同步技术方案和团队约定
2026-09-16 03:59:27 +08:00
parent d3c117de01
commit 5cd02aa8b0
37 changed files with 1439 additions and 239 deletions
@@ -0,0 +1,17 @@
+# 文档素材 Markdown 预览实施计划
+
+- Date: 2026-09-16
+- Status: implemented-awaiting-validation
+- Milestone: `【里程碑】文档素材Markdown预览-2026-09-16.md`
+
+## 边界与顺序
+
+1. 扩展现有 Markdown 渲染器的代码高亮，未知语言、大正文安全降级；文档模式保留原始空行。
+2. 用资源现有预览类型和扩展名生成 Markdown；代码只放行 `detail` 读取。
+3. 工具栏挂载预览入口，复用 ThemedModal 和预览缓存展示加载/空/失败状态，身份变化关闭旧预览。
+4. 补充格式转换、渲染和按需读取回归用例，不执行测试。
+5. 执行 AGC TypeScript、编码、文档索引、CSS 语法与 diff 检查。
+
+## 风险与回滚
+
+重点检查高亮 class 不被自定义 code 渲染丢弃、Markdown 围栏不吞正文、弹窗 Esc 不误清画布选中、文档切换不串内容。回滚仅移除本次入口/渲染增量，保留此前工具栏修改，不改资源数据。
@@ -0,0 +1,23 @@
+# 文档素材 Markdown 预览
+
+- Version: 1
+- Status: implemented-awaiting-validation
+- Date: 2026-09-16
+- Parent Spec: `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md` 的“文档与代码素材预览”。
+
+## 范围与评审
+
+单里程碑：在已有资源画布和 Markdown 渲染链路中增加只读文档/代码预览。
+边界评审：沿用现有权限、scope 与缓存身份；不改 Rust/DTO/持久化数据；代码只在详情请求读取，卡片预取不变；未知语言与大文件退回普通代码，不执行源码。无前置里程碑。
+
+## 验收
+
+- 文档/代码有预览入口，其它素材无此入口；弹窗支持关闭与滚动。
+- Markdown 标题、列表、表格可读；代码有语言高亮，反引号、缩进、空行不丢失。
+- 代码可见性预取仍不读文件；显式详情复用现有队列。
+- 加载、空文件、错误与切换身份不显示错误素材的正文。
+- AGC 类型、编码、文档索引与 diff 检查通过。按用户此前约束不运行测试，补充回归用例，实机验收单列为待验证。
+
+## 验收状态
+
+已实现入口、弹窗、队列按需读取、Markdown 代码围栏与高亮；已通过 AGC TypeScript（含新增预览测试文件的静态类型检查）、编码、文档索引、CSS 语法和 diff 检查。回归用例未执行；原生客户端读取、弹窗焦点/滚动和视觉验收仍待验证，不进入下一里程碑。
@@ -18,6 +18,7 @@

 - 修改范围保持聚焦；优先扩展现有系统、页面、组件、DTO 和脚本，不新建平行入口或业务真相。
 - UI 开发优先复用现有公共组件；跨页面或跨端重复的视觉/交互模式应沉淀到 `packages/shared`，由现有页面迁移使用，禁止在业务页复制同类 UI。共享组件只承载通用表现与交互，不下沉领域规则、后端副作用或正式业务状态。
+- AGC 当前 Agent 与策划 Agent 的消息层级共用 `packages/shared` 的 `AgentMessageContent`：正文使用 `body`，思考、中间输出与工具调用使用 `process`；宿主不按 Agent 类型重新定义过程字号和颜色，错误状态保留语义色。
 - 后端遵循 `module-*`、`spacetime-module`、`spacetime-client`、`api-server`、`platform-*`、`shared-contracts` 的现役边界。
 - 前端只负责表现、交互和临时 UI 状态；正式状态来自后端投影、API 或持久化契约。
 - 对已明确退役且无现役调用方、公开契约、持久化迁移或活跃实例的对象，不写兼容实现、维持旧行为的测试、墓碑注释或墓碑文档。