feat: add project-aware agent workspace

docs/agent-answer-ui.md

@@ -1,5 +1,7 @@
 # 本地交互式回答
 
+统一样式见 [样式设计指南](style-design-guide.md)，聊天布局与报告交互见 [Agent 交互与报告设计](agent-chat-ui-design.md)。本文保留协议、组件参数与业务交互约定。
+
 聊天保留 AI SDK `UIMessage`、AI Elements 与现有 Agent 后端，新增
 `@json-render/core` / `@json-render/react` 的本地注册组件。
 组件代码随前端构建发布，无 ChatKit iframe、domain key 或 Vercel/OpenAI
@@ -9,7 +11,8 @@
 
 `Stack`、`Section`、`Text`、`Metric`、`Table`、`Chart`、`Evidence`、
 `MapLocation`、`FollowUpForm` 共九种组件。图表可切换折线、柱状和数据表；
-证据可折叠并标注来源；地图定位通过现有控制器执行；表单从空值开始，
+表格可搜索、排序和选择行，图表可切换已加载区间、显隐序列并选点追问；
+证据可按类别筛选、折叠并标注来源；地图定位通过现有控制器执行；表单从空值开始，
 由用户主动提交，提交形成普通用户消息。业务证据是否保存以 Agent 实际工具结果为准。
 
 Agent 通过 `present_answer` 发布完整的局部界面块，可在两块之间继续输出文字。
@@ -29,13 +32,44 @@ Agent 通过 `present_answer` 发布完整的局部界面块，可在两块之
 
 后台调查执行继续走任务报告与任务展示通道，聊天界面块不构成业务完成或浏览器回执。
 
+## 正式报告与主工作区
+
+正式报告可携带 `ui_blocks?: Array<{ block: AnswerUiBlock; evidence_refs: string[] }>`，最多 8 块，总 UTF-8 JSON 不超过 400000 字节。每块绑定报告中的已有证据，Server 验证任务归属；事实字段与审批不由 UI 块替代。组件树与聊天共用 `answer-ui@1`。例如：
+
+```json
+{
+  "ui_blocks": [{
+    "evidence_refs": ["saved-evidence-id"],
+    "block": {
+      "version": "answer-ui@1",
+      "block_id": "pressure-summary",
+      "fallback_text": "已保存记录中的压力为 0.30 MPa。",
+      "spec": {
+        "root": "pressure",
+        "elements": {
+          "pressure": { "type": "Metric", "children": [], "props": {
+            "label": "压力", "value": "0.30", "unit": "MPa", "source": "已保存监测记录"
+          } }
+        }
+      }
+    }
+  }]
+}
+```
+
+此片段仅展示新增字段，发布时仍需完整报告与真实存在的证据编号。保存沿用 `agent-artifacts`、报告 JSON、幂等键和 revision；读取沿用报告列表、指定版本、任务详情及 Agent context，不新增写入端点或数据库表。
+
+`InvestigationReportBlocks` 将正式报告接入 `AnswerUiView`，证据组件使用保存记录中的摘要、来源、时间与类别。未知版本或无法解析的块展示 fallback，报告固定事实仍可读。报告追问携带 `report_revision`、`reportGeneration` 和引用文本；表单先带入会话，确认后才发送。
+
+`ExpandableReading` 将同一个 React 内容实例移至主工作区，保留图表视图、搜索、行选择、表单草稿。关闭恢复入口焦点，重开恢复阅读位置。主工作区宽度至少 960px 可对照地图，其余宽度在两者之间切换；原地图实例保留。
+
 ## 扩展组件
 
 1. 在 `src/features/agent/answer-ui/catalog.ts` 增加严格的 Zod 参数定义、用途描述与必要的数据上限。
 2. 在 `answer-ui-view.tsx` 注册 React 组件。需要工作台交互时通过 Agent 公共 API 的回调接入，保持依赖方向。
 3. 从本仓库运行 `pnpm export:answer-ui-contract`，更新相邻 Agent 仓库的
-   `src/chat/answer-ui-catalog.json`。组件目录是唯一参数定义源，生成文件需随两边一起交付。
-4. 如新组件存在跨字段约束，同时更新两端的协议校验并加边界和交互测试。
+   `src/chat/answer-ui-catalog.json` 和 Server 的 `contracts/answer-ui-catalog.json`。组件目录是唯一参数定义源，生成文件需随三端一起交付。
+4. 如新组件存在跨字段约束，同时更新三端的协议校验并加边界和交互测试。
 
 导出脚本接受可选目标文件：
 
@@ -50,8 +84,8 @@ node scripts/export-answer-ui-contract.mjs /path/to/agent/src/chat/answer-ui-cat
 
 ## 校验边界
 
-两端拒绝未知组件、额外属性、任意脚本/事件定义、缺失引用、循环、重复或游离节点。
-每块最多 48 节点、深度 12、约 100 KB，图表必须对齐且数值有限；表格每行与列数
+三端拒绝未知组件、额外属性、任意脚本/事件定义、缺失引用、循环、重复或游离节点。
+每块最多 48 节点、深度 12、完整序列化结果不超过 100000 个 JavaScript UTF-16 代码单元，图表必须对齐且数值有限；表格每行与列数
 一致，表单字段名唯一。组件只消费明确的 props，没有动态代码、网络 URL 或任意动作 DSL。
 无法解析的历史内容显示该块的 `fallback_text`。
 
@@ -61,7 +95,7 @@ node scripts/export-answer-ui-contract.mjs /path/to/agent/src/chat/answer-ui-cat
 pnpm lint
 pnpm typecheck
 pnpm test src/features/agent/answer-ui src/features/workbench/hooks/agent-session-message-state.test.ts
-pnpm test:browser tests/browser/agent-answer-ui.e2e.ts tests/browser/agent-start-page.e2e.ts
+pnpm test:browser tests/browser/agent-answer-ui.e2e.ts tests/browser/agent-start-page.e2e.ts tests/browser/agent-report-workspace.e2e.ts
 pnpm build
 ```
 
@@ -77,8 +111,8 @@ bun run tests/integration/answer-ui-smoke.ts
 事件验证组件、更新、历史恢复、键盘展开证据、表单提交和 320/375px 布局，不能当作
 真实模型已正确选择组件或现场资料已核验的证明。
 
-前端与 Agent 需一起更新，Agent 进程需重新加载原生插件。无需新增环境变量、
-domain key 或数据库迁移。当前开发实例通过现有监听机制重新加载；既有聊天与调查工作进程保留。
+前端、Agent 与 Server 需同步更新；Agent 进程需重新加载原生插件，Server 需加载新报告 schema。无需新增环境变量、
+domain key 或数据库迁移。本轮不重启既有服务；浏览器演练和本地测试不代表运行中的服务已完成同步。
 
 ## 真实模型验收（显式启用）