From 459f8a60e5a0aa6236fa8075c933952215dda8b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Thu, 17 Sep 2026 16:18:51 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=E5=85=88=E8=A1=8C=EF=BC=9A?=
 =?UTF-8?q?=E5=AE=9A=E6=AD=BB=20DirectProject=20=E5=8E=86=E5=8F=B2?=
 =?UTF-8?q?=E5=88=86=E9=A1=B5=E8=BF=9E=E6=8B=89=E7=9A=84=E5=8F=AF=E8=A7=81?=
 =?UTF-8?q?=E6=80=A7=E5=8F=A3=E5=BE=84=20=E6=8A=8A=E3=80=8C=E5=8F=AF?=
 =?UTF-8?q?=E6=98=BE=E7=A4=BA=E3=80=8D=E5=88=A4=E6=8D=AE=E6=98=8E=E7=A1=AE?=
 =?UTF-8?q?=E4=B8=BA=E5=90=88=E5=B9=B6=E5=90=8E=E8=81=8A=E5=A4=A9=E6=8A=95?=
 =?UTF-8?q?=E5=BD=B1=E5=87=BA=E7=8E=B0=E6=96=B0=E5=9B=9E=E5=90=88=EF=BC=8C?=
 =?UTF-8?q?=E5=B9=B6=E5=86=99=E6=B8=85=E6=AF=8F=E6=93=8D=E4=BD=9C=205=20?=
 =?UTF-8?q?=E9=A1=B5=E4=B8=8A=E9=99=90=E4=B8=8E=E9=94=9A=E7=82=B9=E4=B8=8D?=
 =?UTF-8?q?=E5=89=8D=E8=BF=9B=E5=8D=B3=E5=81=9C=20=E9=87=8C=E7=A8=8B?=
 =?UTF-8?q?=E7=A2=91=E6=8A=8A=E5=8E=9F=E7=AC=AC=2056=20=E6=9D=A1=E6=8C=89?=
 =?UTF-8?q?=E5=90=8E=E7=AB=AF=E9=94=9A=E7=82=B9=E5=9B=9E=E6=89=AB=E4=B8=8E?=
 =?UTF-8?q?=E5=89=8D=E7=AB=AF=E8=BF=9E=E6=8B=89=E6=8B=86=E6=88=90=E4=B8=A4?=
 =?UTF-8?q?=E6=9D=A1=E7=8B=AC=E7=AB=8B=E9=AA=8C=E6=94=B6=E9=A1=B9=EF=BC=8C?=
 =?UTF-8?q?=E5=89=8D=E7=AB=AF=E9=82=A3=E6=9D=A1=E5=85=88=E7=95=99=E5=BE=85?=
 =?UTF-8?q?=E8=A1=A5=E8=AF=81=E6=8D=AE=20=E5=AE=9E=E6=96=BD=E8=AE=A1?=
 =?UTF-8?q?=E5=88=92=E7=AC=AC=206=20=E6=AD=A5=E5=90=8C=E6=AD=A5=E5=8F=A3?=
 =?UTF-8?q?=E5=BE=84=EF=BC=8C=E5=B9=B6=E6=8A=8A=E6=96=B0=E5=88=86=E9=A1=B5?=
 =?UTF-8?q?=E5=8D=95=E6=B5=8B=E5=8A=A0=E5=85=A5=E9=AA=8C=E8=AF=81=E5=91=BD?=
 =?UTF-8?q?=E4=BB=A4=20=E5=86=B3=E7=AD=96=E8=AE=B0=E5=BD=95=E6=96=B0?=
 =?UTF-8?q?=E5=A2=9E=202026-09-17=20=E6=9D=A1=E7=9B=AE=EF=BC=8C=E8=AE=B0?=
 =?UTF-8?q?=E4=B8=8B=E8=90=BD=E7=82=B9=E3=80=81=E4=B8=8A=E9=99=90=E7=B2=92?=
 =?UTF-8?q?=E5=BA=A6=E3=80=81=E5=A4=B1=E8=B4=A5=E4=B8=8E=E7=AB=9E=E6=80=81?=
 =?UTF-8?q?=E8=BE=B9=E7=95=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...�实施计划】DirectProject�天真相�收敛-2026-09-16.md |  4 ++--
 ...�里程碑】DirectProject�天真相�收敛-2026-09-16.md |  6 ++++--
 docs/project-memory/shared-memory/decision-log.md      | 10 ++++++++++
 3 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/docs/project-memory/plans/�实施计划】DirectProject�天真相�收敛-2026-09-16.md b/docs/project-memory/plans/�实施计划】DirectProject�天真相�收敛-2026-09-16.md
index ab8c8f5c5..21bd38c00 100644
--- a/docs/project-memory/plans/�实施计划】DirectProject�天真相�收敛-2026-09-16.md
+++ b/docs/project-memory/plans/�实施计划】DirectProject�天真相�收敛-2026-09-16.md
@@ -19,7 +19,7 @@
 3. 删掉回�身份：`turn.started` 无载��`turn.completed{status}`，�目 / 增� / 请求 / 生命周期锚点都�带 turn id；队列 `append` 直接收 `DirectThreadEvent`，`seq` 内部自算。
 4. �考正文��：`item/reasoning/summaryTextDelta` 与 `item/reasoning/textDelta` 产出 `item.delta{kind:"reasoning"}`；plan 文本与命令输出��活动状�。
 5. �端收敛为�一 reducer：`subscribe` 返回的 bootstrap 事件就是已暂存的�行�，游标已�在队尾，�端直接 reduce 这批事件��（�需�为了拿这批事件�补一次 `consume`）；此��由 notify 唤醒 `consume`。唯一例外是回执竞�：Rust 注册完 subscriber 就开始通知，而�端�等回执�知� `subscriptionId`，这段时间到达的通知�能记欠账，回执到达�立刻补一次 `consume`（�则整轮最�一个事件之��能�无通知，事件会�死在队列里）。�并规则��留"先到定形��到补空白"（正文�增���工具状��许从 running �级到终�），`item.delta` 直接追加到�行��目正文，删掉 `deltaText` 缓冲，`turn.completed` 把�行��目并入历��清空。
-6. 首�与分页：以 `lastCompletedItemId` 为锚点�最近切片，历�读�改为从文件尾��扫�；锚点按原始 item id 推进，切片无���目时自动连拉（上� 5 页）。
+6. 首�与分页：以 `lastCompletedItemId` 为锚点�最近切片，历�读�改为从文件尾��扫�；锚点按原始 item id 推进；一次翻页�作在�端连拉，直到�并��天投影出现新回�（新的用户气泡）或 `hasMore=false`，�个�作上� 5 页；锚点未推进（`items` 为空 / `firstItemId` 为 null / 与请求锚点相�）时立��止。��性�径�在 `features/project-workspace/directHistoryPaging.ts` 实现一份，首�与「显示更早�共用。
 7. App.tsx 接线：订阅 + 立� reduce bootstrap + notify 唤醒 consume，�天视图改由 reducer 状�投影（�工具�片），删除 Direct 回�事件订阅与 `directTurnStream` / `directToolCalls` 状�。
 8. 删除��务旧读路径的命令与�端调用（`read_direct_project_history`�`read_direct_turn_stream`�`read_direct_tool_calls`），DirectRuntime 自己的写入�留。`list_game_creator_direct_active_turns` 是唯一的例外并有��留：它�务首页跨页�的「�行中的项目�列表（`WorkspaceLauncher` / `directActiveTurns.ts`），�是�天框读路径。
 9. 测试与文档收�：补 reducer �测�解�跳过的工具�片用例�更新主规范并把冲�的实施计划与工具�片文档改写为当�状�。
@@ -28,7 +28,7 @@
 
 1. `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml direct_thread -- --nocapture`
 2. `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml export_bindings`（生� `src/features/project-workspace/generated/`），��用 `prettier --write` 格�化生�目录，��未格�化的 ts-rs 输出混进�交
-3. `npx vitest run apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directTurnPresentation.test.ts`
+3. `npx vitest run apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directTurnPresentation.test.ts apps/ai-game-creator-shell/tests/directHistoryPaging.test.ts`
 4. `npx vitest run apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts`
 5. TypeScript 类型检查与 ESLint（范围��次 DirectProject �移）。
 6. `npm run check:encoding`�`npm run check:doc-index`�`git diff --check`
diff --git a/docs/project-memory/plans/�里程碑】DirectProject�天真相�收敛-2026-09-16.md b/docs/project-memory/plans/�里程碑】DirectProject�天真相�收敛-2026-09-16.md
index e04466315..d1c3af086 100644
--- a/docs/project-memory/plans/�里程碑】DirectProject�天真相�收敛-2026-09-16.md
+++ b/docs/project-memory/plans/�里程碑】DirectProject�天真相�收敛-2026-09-16.md
@@ -19,7 +19,7 @@ AGC 项目开�对�的显示与����赖两项输入：**项目对�
 - 线上模型与�示���：�目与事件是 ts-rs 导出的 tagged enum，�端消费生�绑定（改 Rust 模型�跑 `cargo test export_bindings`）；毫秒时间戳用 `#[ts(as = "f64")]` 对� Tauri JSON 通�的 `number`。
 - �目身份归一：进队列�收敛�一个 `itemId`（工具�目在 `project.jsonl` 里带调用 id 与 response item id 两个值）；历�切片�给 `firstItemId` 作为分页锚点，锚点始终是文件里的原始 item id。
 - �考正文��：`item/reasoning/summaryTextDelta` 与 `item/reasoning/textDelta` 以 `item.delta{kind:"reasoning"}` 下�正文；plan 文本与命令输出���级为活动状�。
-- 历�读�以 `subscribe` 返回的 `lastCompletedItemId` 为首�锚点，切片从**文件尾��扫�**；��显示�目由�端跳过并继续�页（上� 5 页）。
+- 历�读�以 `subscribe` 返回的 `lastCompletedItemId` 为首�锚点，切片从**文件尾��扫�**；�端切片�按原始�目切片，��性判断留在�端�天投影；一次翻页�作在�端连拉�页，直到�并��天投影出现新回�或 `hasMore=false`，�个�作上� 5 页。
 - �端收敛为�一事件 reducer 与�一�天投影；活动回��由 `turn.started` 与 `turn.completed` 判定（事件�带 turn id，�端�有一个 `turnRunning` 布尔）；`item.delta` 直接追加到�行��目正文，��留增�缓冲；`turn.completed` 把该回��行��目并入历��清空。
 - 删除�端对 Direct 回�事件�`turn-stream.jsonl`�`tool-calls.jsonl`�活动回�快照的读�，以���务这些读�的命令与状�。
 
@@ -41,6 +41,7 @@ AGC 项目开�对�的显示与����赖两项输入：**项目对�
 - 失败与中止说明�在�行期显示（�写 `project.jsonl`），页��进���出现。
 - 未知 item 类型由 Rust 原样�传（�有类型与身份，Rust 侧留 TODO），当�由�端投影丢弃。
 - �端�天�片的工具形状是 `Omit<GameCreatorDirectToolCall, 'turnId'>`；`tool-calls.jsonl` 的�久化形状与 DirectRuntime 的写入����。
+- 「�显示�的判��**�端回��馈**：一次翻页�作连拉到「�并��天投影的回�数增加�为止。工具�片与�考文本虽然能通过 `projectDirectThreadItem`，但�能整页�进已渲染回�的折�「执行过程�，�构�用户���馈；�径�在 `directHistoryPaging.ts` 里实现一份，首�与「显示更早�共用。
 
 ## �赖与�置�件
 
@@ -53,7 +54,8 @@ AGC 项目开�对�的显示与����赖两项输入：**项目对�
 - [x] 一次回�内，实时渲染的文本段与工具�片顺�，与回�结���进项目看到的顺�一致。�自动化：`project-development.suite.ts` 空对�首轮 + 历�切片工具�片用例】
 - [ ] 回�进行中终止并��进程��进项目：已�盘的部分文本与工具�片按原顺�出现，且界��显示忙碌�。�待真实 app-server �行时验收】
 - [ ] 进程存活期间的页��进（�切走�切回）能���行中回�，并�许终止。�待真实 app-server �行时验收】
-- [x] 历�分页在切片内全部是��显示�目时�能继续��，�出现锚点�滞。�自动化：`direct_project_history` 尾部回扫与分页锚点用例】
+- [x] 历�切片从文件尾��回扫，锚点始终是文件里的原始 item id；切片内全部是��显示�目时�能继续��，�出现锚点�滞。�自动化：`direct_project_history` 尾部回扫与分页锚点用例】
+- [ ] �端一次翻页�作自动连拉，直到�并��天投影出现新回�或 `hasMore=false`，�个�作上� 5 页；锚点��进时立��止，�空转。�待补：`directHistoryPaging` �测 + `project-development.suite.ts` 跨页�回�用例】
 - [x] �天视图��读� `turn-stream.jsonl` / `tool-calls.jsonl` / Direct 回�事件 / 活动回�快照；`read_direct_turn_stream` 与 `read_direct_tool_calls` 命令已删除。`list_game_creator_direct_active_turns` **有��留**：它�务首页跨页�的「�行中的项目�列表（`WorkspaceLauncher` / `directActiveTurns.ts`），�属于�天框读路径。
 - [x] �一工具调用在实时与回读��出现一张�片（两个 id 空间按归一�的 `itemId` 对�）。�自动化：reducer「先到定形��到补空��并�测 + 工具�片渲染用例】
 - [x] �端�天状�里��出现第二个 id 概念与任何回�身份字段；事件解�统一�自 ts-rs 生�绑定。�自动化：`directThreadChat` / `directTurnPresentation` �测 + `cargo test export_bindings` 生�绑定无差异】
diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md
index 2b0554396..855eac7d3 100644
--- a/docs/project-memory/shared-memory/decision-log.md
+++ b/docs/project-memory/shared-memory/decision-log.md
@@ -2,6 +2,16 @@
 
 > 用途：记录已�确认�会影��续开�的长期技术/产�/�作决策。短期讨论��写在这里。
 > 当��径：历��目的旧路径�旧版本和已退役对象�用于追溯，�构�现行实现��；如与当�代�或 `docs/README.md` 冲�，以当�代�和最新专题文档为准。
+## 2026-09-17 DirectProject 历�分页的「�显示��径定为�端回��馈，一次翻页连拉上� 5 页
+
+- 背景：ADR 与里程碑�求「一次翻页�作在�端自动连拉，直到出现�显示�目或 `hasMore=false`，上� 5 页�，但实现��地了�端锚点与文件尾回扫，�端�是��一页。历�切片的 `limit` 按原始�目计，一整页全是工具�片 / �考文本且�进�一个已渲染回�的折�「执行过程�时，用户点「显示更早的对��看�到任何�化。
+- 决策（�显示 = 出现新回�）：一次翻页�作连续�页，�止判�是**�并��天投影的回�数增加**（出现新的用户气泡）。工具�片与�考文本虽然能通过 `projectDirectThreadItem`，但它们�能整页�进已渲染回�的折�过程区，�构�用户���馈。
+- 决策（粒度和上�）：�个用户�作最多 5 次请求，首�那次算第 1 页�之��次点击�新计数；�页�是 `limit = CONVERSATION_VISIBLE_STEP`，上��约�请求次数，�改页大�契约。
+- 决策（硬性终止）：`items` 为空�`firstItemId` 为 null 或与请求锚点相� → 立��止，�� 5 页上�兜底。
+- 决策（�点）：�径与循环�在 `features/project-workspace/directHistoryPaging.ts` 一份实现里，首�与「显示更早�共用；`DIRECT_HISTORY_MAX_PAGES_PER_ACTION` 放 `app/constants.ts`。
+- 边界：循环内�累积�结��一次性并入�天 state；�页失败时�留已�功页并沿用现有报错文案；切�项目时丢弃整批；�新增 loading / �用�与新文案，��滚动锚定补�；�行中回��许连拉历�。
+- 验�：`directHistoryPaging` �测覆盖�径�上��`hasMore=false` 早��锚点��进��页失败；`project-development.suite.ts` 新增「跨页�回��集�用例作为真实回归网。
+
 ## 2026-09-16 图标图集自动拆图上��高到 256
 
 - 背景：AGC 图标图集自动连通域识别在一次生�中识别出 86 个区域，原有 64 片上�在�处�阶段阻断了请求；该上��时影� api-server 自动 / 手动切片�SpacetimeDB 批��库和统一生�结果 item 数�。