diff --git a/.gitignore b/.gitignore
index 918af1e6..afad76fc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 /bin/
 node_modules/
 /data/
+/data-test/
 .zcode/plans/
diff --git a/.task/feature-chat-scroll-fix.md b/.task/feature-chat-scroll-fix.md
new file mode 100644
index 00000000..a87beabf
--- /dev/null
+++ b/.task/feature-chat-scroll-fix.md
@@ -0,0 +1,32 @@
+# feature/chat-scroll-fix 任务卡
+
+任务主记录：<PR 链接，task-finish 时填写>；状态：进行中；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= e7aeb6bc1721c8a046f8f0117a98621fd2a04eb7
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-chat-scroll-fix（worktree）；分支：feature/chat-scroll-fix
+- 授权与交付终点：用户测试报告缺陷并授权修复；终点 = PR 合入 main + 任务卡闭合（建 PR/合入/回收按自主闭环执行）
+
+## 目标与非目标
+
+- 目标：修复聊天页消息超出视口后无法向下滚动、回复看不全、输入栏被顶出视口的布局缺陷。根因：中栏列向 flex 链（.main→.chat→.chat-body）缺 min-height:0，.chat 的自动最小高度=内容高度，撑破视口后 chat-body 永不触发 overflow 滚动。
+- 受影响入口：modules/frontend src/styles.css（.chat/.chat-body 两条规则）；经 gitlink 推进至本仓。
+- 非目标：不改消息渲染、过程折叠、HITL、收件箱等行为；不做移动端/触控适配。
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | e7aeb6bc1721c8a046f8f0117a98621fd2a04eb7 | e7aeb6bc1721c8a046f8f0117a98621fd2a04eb7 | 2026-09-30T09:05:30Z |
+
+## 结果与验证（完成后填写）
+
+- 结果：styles.css 为 .chat 与 .chat-body 补 min-height:0 并注释该约束链；Frontend 仓提交 a54022c（分支 feature/chat-scroll-fix）。
+- 验证：
+  - 无头 Chromium（playwright-core + 本地缓存 Chromium）实测，1024x620、mock 长会话：修复前 .chat=2130px、input-bar 底边 717px（超视口 97px）、chat-body scrollable=false；修复后 .chat=620px=视口、chat-body clientH 501/scrollH 2011（可滚且自动滚到底）、input-bar 底边=620px。
+  - 变体：空会话、单条短消息、1024x400（滚轮上滚 600px 后回底成功）、720x600 —— 输入栏全部贴底可见，文档级不出现滚动。
+  - 组合验证：make test 全绿（core + backend + frontend 9 + ui 23 + agentcmd）。
+- 影响与剩余项：仅中栏布局链，无行为变化；无剩余项。附带：.gitignore 增补 /data-test/（本地测试运行数据目录，与 /data/ 同类约定，防 precheck 误报 BUSY；既有测试数据已完整移至 ~/projects/agent-system-data-test）。
+| 同步前验收 | e7aeb6bc1721c8a046f8f0117a98621fd2a04eb7 | 813abf17db01da8501f257549b094ae7fb3d4042 | 2026-09-30T09:16:52Z |
+| 同步前验收 | e7aeb6bc1721c8a046f8f0117a98621fd2a04eb7 | 5929bc07882d0f34621fc0758f79d06bb28b8d05 | 2026-09-30T09:18:22Z |
diff --git a/modules/frontend b/modules/frontend
index a6175042..a54022c4 160000
--- a/modules/frontend
+++ b/modules/frontend
@@ -1 +1 @@
-Subproject commit a61750426893cf688715f9bd2bac30c10d095827
+Subproject commit a54022c438ece0edcfeb23a9cd0c746707868268