fix trace scroll preservation

docs/reference/cloud-workbench.md

@@ -108,6 +108,12 @@ session identifiers, the visible detail must include a short redacted
 [Code Agent readiness](code-agent-chat-readiness.md) 合同返回 completed
 且非空的 assistant response 前，Workbench 不得暗示已有真实 assistant reply。
 
+Code Agent trace 在消息卡片内使用独立滚动容器展示。SSE、轮询或“回放 trace”
+更新只能刷新内容，不得重置用户已展开/折叠状态，也不得把
+`.message-trace-events` 的内部滚动位置跳回顶部；渲染前后必须按
+`messageId/traceId` 保存并恢复 trace list 的 `scrollTop/scrollLeft`。完整 trace
+可通过复制/下载获取，页面内默认保持“显示全部 + 内部滚动”的单一模式。
+
 ## Lightweight Checks
 
 Use the existing lightweight checks unless a task explicitly authorizes a