@very_aq/codex-cli-web 0.0.8 → 0.0.10

package/server/dist/history/http/historyRoutes.js

@@ -5,13 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHistoryRoutes = createHistoryRoutes;
 const express_1 = __importDefault(require("express"));
+const env_1 = require("../../env");
 /**
- * 解析消息查询 limit，默认 200，范围 [1, 500]。
+ * 解析消息查询 limit，范围 [1, 500]。
  */
-function parseHistoryLimit(rawLimit) {
+function parseHistoryLimit(rawLimit, defaultLimit) {
     const parsedLimit = Number(rawLimit);
     if (!Number.isFinite(parsedLimit))
-        return 200;
+        return Math.min(500, Math.max(1, Math.floor(defaultLimit)));
     return Math.min(500, Math.max(1, Math.floor(parsedLimit)));
 }
 /**
@@ -36,9 +37,26 @@ function createHistoryRoutes(options) {
         }
         if (!(await options.requireThreadAccess(req, res, threadId)))
             return;
-        const limit = parseHistoryLimit(req.query?.limit);
+        const limit = parseHistoryLimit(req.query?.limit, (0, env_1.getWebHistoryPageLimit)());
         const beforeTs = parseBeforeTs(req.query?.beforeTs);
-        const items = options.historyQuery.listMessages({ threadId, limit, beforeTs });
+        const items = await options.historyQuery.listMessages({ threadId, limit, beforeTs });
+        res.json({ ok: true, items });
+    });
+    router.get("/threads/:threadId/file-changes", async (req, res) => {
+        const threadId = String(req.params.threadId ?? "").trim();
+        if (!threadId) {
+            res.status(400).json({ ok: false, error: "invalid_request" });
+            return;
+        }
+        if (!(await options.requireThreadAccess(req, res, threadId)))
+            return;
+        // listThreadFileChanges：专用索引链路；若未启用则返回 404，避免误用旧 messages 扫描接口。
+        const listThreadFileChanges = options.historyQuery.listThreadFileChanges;
+        if (typeof listThreadFileChanges !== "function") {
+            res.status(404).json({ ok: false, error: "not_found" });
+            return;
+        }
+        const items = await Promise.resolve(listThreadFileChanges(threadId));
         res.json({ ok: true, items });
     });
     router.get("/threads/:threadId/messages/:messageId/diff", async (req, res) => {
@@ -55,7 +73,7 @@ function createHistoryRoutes(options) {
             res.status(404).json({ ok: false, error: "not_found" });
             return;
         }
-        const diff = getMessageDiff({ threadId, messageId });
+        const diff = await getMessageDiff({ threadId, messageId });
         if (!diff) {
             res.status(404).json({ ok: false, error: "not_found" });
             return;

package/server/dist/history/http/historyRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"historyRoutes.js","sourceRoot":"","sources":["../../../src/history/http/historyRoutes.ts"],"names":[],"mappings":";;;;;AAsCA,kDA4CC;AAlFD,sDAA8B;AAiB9B;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAiB;IAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,WAAoB;IACzC,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,OAAmC;IACrE,MAAM,MAAM,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,CAAC,GAAG,CAAC,6BAA6B,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YAAE,OAAO;QAErE,MAAM,KAAK,GAAG,iBAAiB,CAAE,GAAG,CAAC,KAAa,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,aAAa,CAAE,GAAG,CAAC,KAAa,EAAE,QAAQ,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/E,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,6CAA6C,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YAAE,OAAO;QAErE,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC;QAC3D,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"historyRoutes.js","sourceRoot":"","sources":["../../../src/history/http/historyRoutes.ts"],"names":[],"mappings":"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"}

package/server/dist/history/index.d.ts

@@ -15,6 +15,12 @@ export type WebHistoryRuntime = {
 export type CreateWebHistoryRuntimeOptions = {
     mode: WebHistoryMode;
     dbPath: string;
+    /**
+     * historyWorkerCount：
+     * - 0：禁用 worker（回退主线程直连 SQLite）；
+     * - >=1：启用 worker pool。
+     */
+    workerCount: number;
 };
 /**
  * 根据配置模式创建历史运行时：

package/server/dist/history/index.js

@@ -7,6 +7,7 @@ exports.createWebHistoryRuntime = createWebHistoryRuntime;
 const historyIngestService_1 = require("./ingest/historyIngestService");
 const historyQueryService_1 = require("./query/historyQueryService");
 const sqliteHistoryStore_1 = require("./sqlite/sqliteHistoryStore");
+const historyWorkerPool_1 = require("./worker/historyWorkerPool");
 /**
  * 根据配置模式创建历史运行时：
  * - off: 不创建任何历史资源；
@@ -15,6 +16,24 @@ const sqliteHistoryStore_1 = require("./sqlite/sqliteHistoryStore");
 function createWebHistoryRuntime(options) {
     if (options.mode === "off")
         return null;
+    const normalizedWorkerCount = Number.isFinite(options.workerCount) ? Math.max(0, Math.floor(options.workerCount)) : 0;
+    if (normalizedWorkerCount > 0) {
+        try {
+            const pool = (0, historyWorkerPool_1.createHistoryWorkerPool)({ dbPath: options.dbPath, workerCount: normalizedWorkerCount });
+            return {
+                ingest: pool.ingest,
+                query: pool.query,
+                async close() {
+                    await pool.close();
+                },
+            };
+        }
+        catch (err) {
+            // worker 启动失败时回退主线程直连，保证服务可用性。
+            // eslint-disable-next-line no-console
+            console.warn(`history worker pool init failed; fallback to main-thread sqlite. err=${String(err)}`);
+        }
+    }
     // SQLite store 负责底层读写，ingest 负责事件编排与投影。
     const store = (0, sqliteHistoryStore_1.createSqliteHistoryStore)({ dbPath: options.dbPath });
     const ingest = (0, historyIngestService_1.createHistoryIngestService)({ store });

package/server/dist/history/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":";;AAsCA,0DAeC;AArDD;;GAEG;AACH,wEAA2E;AAC3E,qEAAwE;AACxE,oEAAuE;AA4BvE;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,OAAuC;IAC7E,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAExC,wCAAwC;IACxC,MAAM,KAAK,GAAG,IAAA,6CAAwB,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,iDAA0B,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAA,+CAAyB,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAEnD,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":";;AA6CA,0DAiCC;AA9ED;;GAEG;AACH,wEAA2E;AAC3E,qEAAwE;AACxE,oEAAuE;AACvE,kEAAqE;AAkCrE;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,OAAuC;IAC7E,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtH,IAAI,qBAAqB,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAA,2CAAuB,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;YACrG,OAAO;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,CAAC,KAAK;oBACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,+BAA+B;YAC/B,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,wEAAwE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,KAAK,GAAG,IAAA,6CAAwB,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAA,iDAA0B,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAA,+CAAyB,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAEnD,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/server/dist/history/query/historyQueryService.d.ts

@@ -1,5 +1,15 @@
 import type { ChatItem, DiffData } from "../../chat/types";
 import type { SqliteHistoryStore } from "../sqlite/sqliteHistoryStore";
+/**
+ * 可同步或异步返回值类型（便于 worker 线程实现与现有同步实现共存）。
+ */
+export type MaybePromise<T> = T | Promise<T>;
+/**
+ * 会话文件变更列表查询输入参数（专用索引链路）。
+ */
+export type ListThreadFileChangesInput = {
+    threadId: string;
+};
 /**
  * 历史消息查询输入参数。
  */
@@ -19,14 +29,24 @@ export type GetHistoryMessageDiffInput = {
  * 历史查询服务接口。
  */
 export type HistoryQueryService = {
-    listMessages: (input: ListHistoryMessagesInput) => ChatItem[];
-    getMessageDiff?: (input: GetHistoryMessageDiffInput) => DiffData | null;
+    listMessages: (input: ListHistoryMessagesInput) => MaybePromise<ChatItem[]>;
+    /**
+     * 列出线程内的 file_change 列表（摘要模式），按时间倒序返回。
+     *
+     * 说明：
+     * - 该接口用于“文件变更”弹窗首屏加载；
+     * - 仅返回 path/kind 摘要，正文 diff/output 仍通过 getMessageDiff 按需拉取。
+     */
+    listThreadFileChanges?: (threadId: string) => MaybePromise<Array<ChatItem & {
+        diff: DiffData;
+    }>>;
+    getMessageDiff?: (input: GetHistoryMessageDiffInput) => MaybePromise<DiffData | null>;
 };
 /**
  * 创建查询服务时的依赖参数。
  */
 export type CreateHistoryQueryServiceOptions = {
-    store: Pick<SqliteHistoryStore, "listMessagesByThread">;
+    store: Pick<SqliteHistoryStore, "listMessagesByThread"> & Partial<Pick<SqliteHistoryStore, "listMessagesByThreadUaBoundaryPage" | "getMessageByThreadAndMessageId">> & Partial<Pick<SqliteHistoryStore, "listFileChangeEntriesByThread">>;
 };
 /**
  * 创建历史查询服务。

package/server/dist/history/query/historyQueryService.js

@@ -26,6 +26,51 @@ function normalizeChatRole(rawRole) {
         return role;
     return "assistant";
 }
+/**
+ * 判断角色是否属于分页“边界”（仅 user/assistant）。
+ */
+function isUaBoundaryRole(role) {
+    return role === "user" || role === "assistant";
+}
+/**
+ * 按“user/assistant 边界数量”截取窗口（升序数组）。
+ *
+ * 规则：
+ * - limit 只统计 user/assistant；
+ * - 夹在边界之间的 system/reasoning 等会跟随窗口一起返回；
+ * - 若窗口落在“第一条边界”，则需要把其之前的前导非边界一并返回（方案 A）。
+ */
+function sliceByUaBoundaryLimit(itemsAsc, limit) {
+    // normalizedLimit：收敛为非负整数，避免出现 NaN/小数导致的意外行为。
+    const normalizedLimit = Math.max(0, Math.floor(Number(limit)));
+    if (normalizedLimit <= 0)
+        return [];
+    // firstBoundaryIndex：第一条 user/assistant 边界的下标（用于判断是否需要并入前导非边界）。
+    const firstBoundaryIndex = itemsAsc.findIndex((item) => isUaBoundaryRole(item.role));
+    if (firstBoundaryIndex === -1)
+        return itemsAsc;
+    // boundaryCount：已累计的 user/assistant 边界数量（从尾部向前扫描）。
+    let boundaryCount = 0;
+    // startBoundaryIndex：命中的窗口起点边界下标（包含该条消息）。
+    let startBoundaryIndex = null;
+    for (let i = itemsAsc.length - 1; i >= 0; i -= 1) {
+        const item = itemsAsc[i];
+        if (!isUaBoundaryRole(item.role))
+            continue;
+        boundaryCount += 1;
+        if (boundaryCount === normalizedLimit) {
+            startBoundaryIndex = i;
+            break;
+        }
+    }
+    // 边界不足 limit：直接返回全部（自然包含第一条边界之前的前导非边界）。
+    if (startBoundaryIndex === null)
+        return itemsAsc;
+    // 若窗口起点落在第一条边界，则需要并入其之前的前导非边界（方案 A）。
+    if (startBoundaryIndex === firstBoundaryIndex)
+        return itemsAsc;
+    return startBoundaryIndex >= itemsAsc.length ? [] : itemsAsc.slice(startBoundaryIndex);
+}
 /**
  * 安全解析 file_change 的 changes JSON；解析失败时返回空数组。
  */
@@ -69,6 +114,55 @@ function toSummaryChanges(changes) {
         diff: "",
     }));
 }
+/**
+ * 将 file_change_entries 的索引行按 messageId 聚合为摘要 diff 数据。
+ */
+function groupFileChangeEntriesByMessageId(entries) {
+    // groupByMessageId：按 messageId 聚合，同一消息下可能有多条 path。
+    const groupByMessageId = new Map();
+    for (const entry of entries) {
+        const messageId = String(entry.messageId ?? "").trim();
+        if (!messageId)
+            continue;
+        const existing = groupByMessageId.get(messageId);
+        const tsMs = Math.max(0, Math.floor(Number(entry.tsMs)));
+        const changePath = String(entry.path ?? "").trim();
+        if (!changePath)
+            continue;
+        // changeKind：兜底为 change，避免空值导致 UI 断言失败。
+        const changeKind = String(entry.kind ?? "change").trim() || "change";
+        const change = { path: changePath, kind: changeKind, diff: "" };
+        if (!existing) {
+            groupByMessageId.set(messageId, { messageId, tsMs, changes: [change] });
+            continue;
+        }
+        existing.tsMs = Math.max(existing.tsMs, tsMs);
+        existing.changes.push(change);
+    }
+    const groups = Array.from(groupByMessageId.values());
+    groups.sort((a, b) => b.tsMs - a.tsMs || b.messageId.localeCompare(a.messageId));
+    return groups;
+}
+/**
+ * 将索引聚合结果转为可渲染的 diff ChatItem（摘要模式）。
+ */
+function toDiffChatItemFromEntryGroup(group) {
+    // title：索引表不存 diffTitle，统一兜底为“文件变更”（展开详情时再按 messageId 拉取完整 title）。
+    const title = "文件变更";
+    const baseItem = {
+        id: group.messageId,
+        ts: group.tsMs,
+        role: "system",
+        text: title,
+        streaming: false,
+        render: "diff",
+        diff: {
+            title,
+            changes: group.changes,
+        },
+    };
+    return (0, chatItemEnricher_1.enrichChatItemForUi)(baseItem);
+}
 /**
  * 从消息记录构建 diff 渲染数据。
  * - summary：用于聊天列表，隐藏 patch/output 正文；
@@ -139,17 +233,50 @@ function toChatItem(message) {
 function createHistoryQueryService(options) {
     return {
         /**
-         * 按线程查询历史消息，按时间升序输出，并支持 beforeTs + limit。
+         * 列出线程内 file_change 列表（摘要），用于“文件变更”弹窗首屏。
+         */
+        listThreadFileChanges(threadId) {
+            const normalizedThreadId = String(threadId ?? "").trim();
+            if (!normalizedThreadId)
+                return [];
+            const listEntries = options.store.listFileChangeEntriesByThread;
+            if (typeof listEntries === "function") {
+                const entries = listEntries(normalizedThreadId);
+                const groups = groupFileChangeEntriesByMessageId(entries);
+                return groups.map(toDiffChatItemFromEntryGroup);
+            }
+            // 回退：旧 store 不支持索引表时，扫描 messages 并筛选 diff（性能较差，但保持功能可用）。
+            const records = options.store.listMessagesByThread(normalizedThreadId);
+            const items = records.map((record) => toChatItem(record));
+            const diffItems = items.filter((item) => item.render === "diff" && Boolean(item.diff));
+            diffItems.sort((a, b) => b.ts - a.ts || b.id.localeCompare(a.id));
+            return diffItems;
+        },
+        /**
+         * 按线程查询历史消息：
+         * - 查询窗口按 UA 边界计数；
+         * - 返回结果按时间降序（最新在前），便于“先看最新，再向上翻更早”。
          */
         listMessages(input) {
+            const listByUaBoundaryPage = options.store.listMessagesByThreadUaBoundaryPage;
+            if (typeof listByUaBoundaryPage === "function") {
+                const records = listByUaBoundaryPage({
+                    threadId: input.threadId,
+                    limit: input.limit,
+                    beforeTs: input.beforeTs,
+                });
+                // itemsAsc：store 下推返回的是时间升序窗口，这里统一转为“最新在前”。
+                const itemsAsc = records.map((record) => toChatItem(record));
+                return itemsAsc.reverse();
+            }
             const records = options.store.listMessagesByThread(input.threadId);
             const items = records.map((record) => toChatItem(record));
             // 显式收敛 beforeTs 类型，避免闭包里出现 `number | null` 推断。
             const beforeTs = input.beforeTs;
             const filteredItems = beforeTs === null ? items : items.filter((item) => item.ts < beforeTs);
-            if (filteredItems.length <= input.limit)
-                return filteredItems;
-            return filteredItems.slice(filteredItems.length - input.limit);
+            // pageItemsAsc：内存算法返回时间升序窗口，这里统一转为“最新在前”。
+            const pageItemsAsc = sliceByUaBoundaryLimit(filteredItems, input.limit);
+            return pageItemsAsc.reverse();
         },
         /**
          * 查询单条 file_change 的完整 diff 详情（按需加载专用）。
@@ -159,6 +286,15 @@ function createHistoryQueryService(options) {
             const normalizedMessageId = String(input.messageId ?? "").trim();
             if (!normalizedThreadId || !normalizedMessageId)
                 return null;
+            // getMessageByThreadAndMessageId：若 store 支持主键直查，优先使用以避免长线程全量扫描。
+            const getById = options.store.getMessageByThreadAndMessageId;
+            if (typeof getById === "function") {
+                const record = getById(normalizedThreadId, normalizedMessageId);
+                if (!record)
+                    return null;
+                return buildMessageDiffData(record, "full");
+            }
+            // 回退：旧 store 仅支持按线程全量列出，再在内存里定位目标消息。
             const records = options.store.listMessagesByThread(normalizedThreadId);
             const targetRecord = records.find((record) => record.messageId === normalizedMessageId);
             if (!targetRecord)

package/server/dist/history/query/historyQueryService.js.map

@@ -1 +1 @@
-{"version":3,"file":"historyQueryService.js","sourceRoot":"","sources":["../../../src/history/query/historyQueryService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"historyQueryService.js","sourceRoot":"","sources":["../../../src/history/query/historyQueryService.ts"],"names":[],"mappings":"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"}

package/server/dist/history/sqlite/schema.js

@@ -29,6 +29,53 @@ function applyHistorySchema(db) {
 
     CREATE INDEX IF NOT EXISTS idx_messages_thread_created
       ON messages(thread_id, created_at_ms);
+
+    -- ts_ms：与 HistoryQueryService.resolveMessageTimestamp 的语义保持一致（优先 finished -> started -> created -> updated）。
+    -- 注意：该表达式会同时用于索引与后续分页 SQL，必须保持完全一致。
+    CREATE INDEX IF NOT EXISTS idx_messages_thread_ts_message
+      ON messages(
+        thread_id,
+        (
+          CASE
+            WHEN finished_at_ms IS NOT NULL AND finished_at_ms > 0 THEN finished_at_ms
+            WHEN started_at_ms > 0 THEN started_at_ms
+            WHEN created_at_ms > 0 THEN created_at_ms
+            WHEN updated_at_ms > 0 THEN updated_at_ms
+            ELSE 0
+          END
+        ),
+        message_id
+      );
+
+    -- 边界分页专用索引：仅覆盖 user/assistant（partial index）。
+    CREATE INDEX IF NOT EXISTS idx_messages_thread_ts_message_boundary
+      ON messages(
+        thread_id,
+        (
+          CASE
+            WHEN finished_at_ms IS NOT NULL AND finished_at_ms > 0 THEN finished_at_ms
+            WHEN started_at_ms > 0 THEN started_at_ms
+            WHEN created_at_ms > 0 THEN created_at_ms
+            WHEN updated_at_ms > 0 THEN updated_at_ms
+            ELSE 0
+          END
+        ),
+        message_id
+      )
+      WHERE role IN ('user', 'assistant');
+
+    -- file_change_entries：file_change 的“文件变更摘要索引表”，用于快速返回文件变更列表（无需扫描 messages）。
+    CREATE TABLE IF NOT EXISTS file_change_entries (
+      thread_id TEXT NOT NULL,
+      message_id TEXT NOT NULL,
+      ts_ms INTEGER NOT NULL,
+      path TEXT NOT NULL,
+      kind TEXT NOT NULL DEFAULT 'change',
+      PRIMARY KEY(thread_id, message_id, path)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_file_change_entries_thread_ts_message
+      ON file_change_entries(thread_id, ts_ms, message_id);
   `);
 }
 //# sourceMappingURL=schema.js.map

package/server/dist/history/sqlite/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/history/sqlite/schema.ts"],"names":[],"mappings":";;AAUA,gDA0BC;AA7BD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,EAAsB;IACvD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;GAwBP,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/history/sqlite/schema.ts"],"names":[],"mappings":";;AAUA,gDAyEC;AA5ED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,EAAsB;IACvD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEP,CAAC,CAAC;AACL,CAAC"}

package/server/dist/history/sqlite/sqliteHistoryStore.d.ts

@@ -53,12 +53,43 @@ export type MessageRecord = {
     createdAtMs: number;
     updatedAtMs: number;
 };
+/**
+ * file_change_entries 的行结构（用于文件变更列表的“索引查询”）。
+ */
+export type FileChangeEntryRecord = {
+    threadId: string;
+    messageId: string;
+    tsMs: number;
+    path: string;
+    kind: string;
+};
+/**
+ * 按“user/assistant 边界计数”的分页查询输入参数。
+ */
+export type ListMessagesByThreadUaBoundaryPageInput = {
+    threadId: string;
+    limit: number;
+    beforeTs: number | null;
+};
 /**
  * SQLite 历史存储接口。
  */
 export type SqliteHistoryStore = {
     upsertMessage: (input: UpsertMessageInput) => void;
     listMessagesByThread: (threadId: string) => MessageRecord[];
+    /**
+     * 列出线程内 file_change 的索引条目（按消息时间倒序）。
+     */
+    listFileChangeEntriesByThread: (threadId: string) => FileChangeEntryRecord[];
+    /**
+     * 按 (threadId, messageId) 主键查询单条消息。
+     *
+     * 说明：
+     * - 用于历史 diff 详情等“按 id 点查”场景；
+     * - 避免通过 listMessagesByThread 全量扫描长线程导致的延迟。
+     */
+    getMessageByThreadAndMessageId: (threadId: string, messageId: string) => MessageRecord | null;
+    listMessagesByThreadUaBoundaryPage: (input: ListMessagesByThreadUaBoundaryPageInput) => MessageRecord[];
     incrementalVacuum: () => void;
     withTransaction: <T>(callback: () => T) => T;
     close: () => void;