merge: release v0.1.29 session improvements

feat(sessions): improve export, search, and UI clarity

Author: ymkiux

cli.js

@@ -5172,6 +5172,7 @@ function createSessionQueryScanState(tokens, options = {}) {
         count: 0,
         snippets: [],
         positions: [],
+        complete: true,
         leadingSystem: roleFilter !== 'system'
     };
 }
@@ -5210,11 +5211,13 @@ function consumeSessionQueryMessage(state, message) {
             timestamp: typeof message.timestamp === 'string' ? message.timestamp : ''
         });
     }
+    if (state.count >= state.maxMatches) state.complete = false;
     return state.count >= state.maxMatches;
 }
 
 function buildSessionQueryScanResult(state) {
     return {
+        complete: !!(state && state.complete),
         hit: !!(state && state.count > 0),
         count: state && Number.isFinite(state.count) ? state.count : 0,
         snippets: state && Array.isArray(state.snippets) ? state.snippets : [],
@@ -5259,6 +5262,7 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
     const state = createSessionQueryScanState(tokens, options);
     if (session.source === 'opencode') {
         const extracted = queryOpencodeSessionMessages(session.sessionId || parseOpencodeVirtualSessionId(filePath), { maxMessages: Infinity });
+        state.complete = !!extracted && !extracted.truncated;
         const messages = extracted && Array.isArray(extracted.messages) ? extracted.messages : [];
         for (let i = 0; i < messages.length; i += 1) {
             const message = { ...messages[i], recordLineIndex: i };
@@ -5268,6 +5272,7 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
     }
     if (session.source === 'zed') {
         const zedExtracted = queryZedSessionMessages(session.sessionId || parseZedVirtualSessionId(filePath), { maxMessages: Infinity });
+        state.complete = !!zedExtracted && !zedExtracted.truncated;
         const zedMessages = zedExtracted && Array.isArray(zedExtracted.messages) ? zedExtracted.messages : [];
         for (let i = 0; i < zedMessages.length; i += 1) {
             const message = { ...zedMessages[i], recordLineIndex: i };
@@ -5283,6 +5288,7 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
             } catch (_) {
                 json = null;
             }
+            state.complete = !!json;
             const rawMessages = json && Array.isArray(json.messages) ? json.messages : [];
             for (const entry of rawMessages) {
                 if (!entry || typeof entry !== 'object') continue;
@@ -5310,12 +5316,14 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
             const buf = Buffer.alloc(targetBytes);
             const bytes = fs.readSync(fd, buf, 0, targetBytes, 0);
             fs.closeSync(fd);
+            state.complete = bytes >= stat.size;
             text = bytes > 0 ? buf.slice(0, bytes).toString('utf-8') : '';
         } catch (_) {
             try {
                 text = fs.readFileSync(filePath, 'utf-8');
             } catch (_) {
                 text = '';
+                state.complete = false;
             }
         }
 
@@ -5340,6 +5348,7 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
             const currentLineIndex = lineIndex;
             lineIndex += 1;
             if (maxBytes > 0 && bytesRead >= maxBytes) {
+                state.complete = false;
                 break;
             }
 
@@ -5369,6 +5378,7 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
 
         return buildSessionQueryScanResult(state);
     } catch (e) {
+        state.complete = false;
         return scanSessionContentForQueryInRecords(readJsonlRecords(filePath), session.source, state);
     } finally {
         if (rl) {
@@ -5383,7 +5393,9 @@ async function scanSessionContentForQuery(session, tokens, options = {}) {
 async function applySessionQueryFilter(sessions, options = {}) {
     const tokens = Array.isArray(options.tokens) ? options.tokens : [];
     if (tokens.length === 0) {
-        return sessions;
+        const result = sessions.slice();
+        Object.defineProperty(result, 'searchInfo', { value: null });
+        return result;
     }
 
     const mode = normalizeQueryMode(options.queryMode);
@@ -5397,10 +5409,12 @@ async function applySessionQueryFilter(sessions, options = {}) {
         : 0;
 
     let scanned = 0;
+    let complete = true;
     const results = [];
 
     for (const session of sessions) {
         if (scope === 'content' && scanned >= contentScanLimit) {
+            complete = false;
             break;
         }
 
@@ -5420,6 +5434,10 @@ async function applySessionQueryFilter(sessions, options = {}) {
                 snippetLimit: 2
             });
             contentHit = contentInfo.hit;
+            // 命中已完成候选的存在性判定，无需穷尽匹配或消息。
+            if (!contentHit && !contentInfo.complete) complete = false;
+        } else if (shouldScanContent) {
+            complete = false;
         }
 
         const hit = scope === 'summary'
@@ -5441,6 +5459,9 @@ async function applySessionQueryFilter(sessions, options = {}) {
         results.push(session);
     }
 
+    Object.defineProperty(results, 'searchInfo', {
+        value: { scanned, candidates: sessions.length, complete }
+    });
     return results;
 }
 function collectRecentJsonlFiles(rootDir, options = {}) {
@@ -7632,7 +7653,9 @@ async function listAllSessions(params = {}) {
             contentScanBytes: params.contentScanBytes
         });
     }
+    const searchInfo = hasQuery ? result.searchInfo : null;
     result = mergeAndLimitSessions(result, limit);
+    Object.defineProperty(result, 'searchInfo', { value: searchInfo });
     setSessionListCache(cacheKey, result);
     return result;
 }
@@ -7665,6 +7688,7 @@ async function listAllSessionsData(params = {}) {
         delete normalized.__messageCountExact;
         return normalized;
     });
+    Object.defineProperty(result, 'searchInfo', { value: sessions.searchInfo || null });
     if (!hasQuery) {
         setSessionListCache(cacheKey, result);
     }
@@ -7676,7 +7700,7 @@ async function listSessionBrowse(params = {}) {
         ...params,
         browseLightweight: true
     });
-    return Array.isArray(sessions)
+    const result = Array.isArray(sessions)
         ? sessions.map((item) => {
             if (!item || typeof item !== 'object' || Array.isArray(item)) {
                 return item;
@@ -7686,6 +7710,8 @@ async function listSessionBrowse(params = {}) {
             return normalized;
         })
         : [];
+    Object.defineProperty(result, 'searchInfo', { value: sessions.searchInfo || null });
+    return result;
 }
 
 async function listSessionUsage(params = {}) {
@@ -10008,8 +10034,7 @@ async function exportSessionData(params = {}) {
         if (!extracted) {
             return { error: 'Failed to parse session file' };
         }
-    }
-    if (source === 'zed') {
+    } else if (source === 'zed') {
         const zedSessionId = params.sessionId || parseZedVirtualSessionId(filePath);
         extracted = queryZedSessionMessages(zedSessionId, { maxMessages });
         if (!extracted) {
@@ -14760,9 +14785,11 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
                                 if (source && !isSessionSourceOrAll(source)) {
                                     result = { error: 'Invalid source. Must be codex, claude, gemini, codebuddy, workbuddy, pi, opencode, or all' };
                                 } else {
+                                    const sessions = await listSessionBrowse(params);
                                     result = {
-                                        sessions: await listSessionBrowse(params),
-                                        source: source || 'all'
+                                        sessions,
+                                        source: source || 'all',
+                                        searchInfo: sessions.searchInfo
                                     };
                                 }
                             }

desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexmate-desktop",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Codex Mate 桌面启动器（Electron 壳，内嵌 codexmate Web UI）",
   "main": "electron.js",
   "private": true,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexmate",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Codex/Claude Code/OpenClaw 配置、会话与任务编排 CLI + Web 工具",
   "main": "cli.js",
   "bin": {

site/guide/sessions.md

@@ -7,9 +7,9 @@
 1. 按[快速开始](/guide/quick-start)启动，进入 Web UI 会话视图。
 2. 在「会话来源」选择已有记录的工具，再按项目路径或时间缩小范围。可输入关键词并按回车检索；界面有检索入口不代表所有来源的记录格式都已经验证。
 3. 打开会话，核对项目、时间和讨论内容。
-4. 点击「导出记录」，打开下载的 Markdown，检查需要的文字是否完整，并留意截断提示。
+4. 在「导出范围」选择最近 1000 条或全部可提取消息，再点击「导出记录」。打开下载的 Markdown 核对内容；截断说明会保留在当前会话预览中，可选择全部后重新导出。
 
-没有记录时先确认原工具在本机保存过会话，再清除筛选条件并刷新。配置 Provider 不会生成历史会话。
+关键词查询会显示实际扫描数与本次候选数。未完成时请缩小来源或项目范围；候选范围不等于全部历史记录。筛选无结果时可直接点击「清除筛选」。没有记录时先确认原工具在本机保存过会话，再刷新。配置 Provider 不会生成历史会话。
 
 ## 来源与存储位置
 
@@ -26,7 +26,7 @@
 | `opencode` | OpenCode | 数据目录中的 `opencode.db`，默认 `~/.local/share/opencode` |
 | `zed` | Zed | Zed 数据目录下的 `threads/threads.db` |
 
-OpenCode 导出分支存在尚未完成运行验证的兼容性疑点，请先用一条样例确认导出结果，不把来源出现在列表中视为导出成功保证。首次体验可先使用已有的 Codex 或 Claude Code 记录。
+OpenCode 导出的来源分支现已互斥，避免数据库读取结果被通用文件读取覆盖。各工具版本的存储格式仍可能不同，先用一条记录核对结果；来源出现在列表中不代表所有版本均已验证。
 
 ## CLI 导出
 

tests/e2e/test-setup.js

@@ -36,8 +36,8 @@ module.exports = async function testSetup(ctx) {
     assert(configContent.includes(`base_url = "${mockProviderUrl}"`), 'base_url missing or mismatched');
 
     const authPath = path.join(tmpHome, '.codex', 'auth.json');
-    const auth = JSON.parse(fs.readFileSync(authPath, 'utf-8'));
-    assert(auth.OPENAI_API_KEY === 'sk-test', 'auth api_key mismatch');
+    assert(!fs.existsSync(authPath), 'auth.json should not be written in single-file auth mode');
+    assert(configContent.includes('experimental_bearer_token = "sk-test"'), 'bearer token missing from config.toml');
 
     const modelsPath = path.join(tmpHome, '.codex', 'models.json');
     const models = JSON.parse(fs.readFileSync(modelsPath, 'utf-8'));

tests/unit/config-tabs-ui.test.mjs

@@ -432,7 +432,7 @@ test('config template keeps expected config tabs in top and side navigation', ()
     assert.match(openclawModal, /<div class="modal modal-wide" role="dialog" aria-modal="true" aria-labelledby="openclaw-config-modal-title">/);
     assert.match(openclawModal, /<div class="modal-title" id="openclaw-config-modal-title">{{ openclawEditorTitle }}<\/div>/);
     assert.match(openclawModal, /:readonly="openclawSaving \|\| openclawApplying"/);
-    assert.match(openclawModal, /<button class="btn btn-cancel" @click="closeOpenclawConfigModal" :disabled="openclawSaving \|\| openclawApplying">取消<\/button>/);
+    assert.match(openclawModal, /<button class="btn btn-cancel" @click="closeOpenclawConfigModal" :disabled="openclawSaving \|\| openclawApplying">\{\{ t\('common\.cancel'\) \}\}<\/button>/);
     assert.match(openclawModal, /<button class="btn btn-confirm" @click="saveOpenclawConfig" :disabled="openclawSaving \|\| openclawApplying \|\| \(openclawEditing\.lockName && isDefaultOpenclawConfig\(openclawEditing\.name\)\)">/);
     assert.match(openclawModal, /<button class="btn btn-confirm secondary" @click="saveAndApplyOpenclawConfig" :disabled="openclawSaving \|\| openclawApplying">/);
     assert.doesNotMatch(baseTheme, /fonts\.googleapis\.com/);

tests/unit/run.mjs

@@ -13,6 +13,7 @@ await import(pathToFileURL(path.join(__dirname, 'api-module.test.mjs')));
 await import(pathToFileURL(path.join(__dirname, 'web-ui-startup-init.test.mjs')));
 await import(pathToFileURL(path.join(__dirname, 'reset-main.test.mjs')));
 await import(pathToFileURL(path.join(__dirname, 'session-query.test.mjs')));
+await import(pathToFileURL(path.join(__dirname, 'session-export-range.test.mjs')));
 await import(pathToFileURL(path.join(__dirname, 'web-ui-url-canonicalization.test.mjs')));
 await import(pathToFileURL(path.join(__dirname, 'mcp-stdio.test.mjs')));
 await import(pathToFileURL(path.join(__dirname, 'workflow-engine.test.mjs')));

tests/unit/session-export-range.test.mjs

@@ -0,0 +1,27 @@
+import assert from 'node:assert/strict';
+import { createCodexConfigMethods } from '../../web-ui/modules/app.methods.codex-config.mjs';
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+test('session backend export and search contracts', () => {
+    execFileSync(process.execPath, [fileURLToPath(new URL('./session-search-export.test.cjs', import.meta.url))], { timeout: 10000 });
+});
+test('session export range preserves default and clears truncation after full export', async () => {
+    const requests = [], downloads = [];
+    const methods = createCodexConfigMethods({ api: async (_, params) => {
+        requests.push(params);
+        return { content: 'message', truncated: params.maxMessages !== 'all', maxMessages: 1000 };
+    } });
+    const context = { sessionExporting: {}, sessionExportRange: 'default', getSessionExportKey: () => 's',
+        downloadTextFile: (_, text) => downloads.push(text), showMessage() {}, t: key => key };
+    const session = { source: 'codex', sessionId: 's', filePath: '/sample' };
+    await methods.exportSession.call(context, session);
+    assert.equal(Object.hasOwn(requests[0], 'maxMessages'), false);
+    assert.deepEqual(context.sessionExportNotice, { key: 's' });
+    context.sessionExportRange = 'all';
+    await methods.exportSession.call(context, session);
+    assert.equal(requests[1].maxMessages, 'all');
+    assert.equal(context.sessionExportNotice, null);
+    assert.equal(context.sessionExporting.s, false);
+    assert.deepEqual(downloads, ['message', 'message']);
+});

tests/unit/session-search-export.test.cjs

@@ -0,0 +1,27 @@
+const assert = require('node:assert/strict'), vm = require('node:vm'), fs = require('node:fs');
+const source = fs.readFileSync(require('node:path').join(__dirname, '../../cli.js'), 'utf8');
+const names = ['normalizeQueryMode','normalizeQueryScope','normalizeRoleFilter','buildSessionSummaryText','createSessionQueryScanState','consumeSessionQueryMessage','buildSessionQueryScanResult','scanSessionContentForQueryInRecords','scanSessionContentForQuery','applySessionQueryFilter','getSessionListCache','setSessionListCache','listSessionBrowse','exportSessionData'];
+let generic = 0, specialized = 0;
+const messages = [{ role: 'user', text: 'needle' }];
+const ctx = vm.createContext({ ...require('../../lib/cli-sessions'), ...require('../../lib/cli-session-utils'), Buffer, path: require('node:path'), readline: require('node:readline'), DEFAULT_CONTENT_SCAN_LIMIT: 10, MAX_EXPORT_MESSAGES: 100, SESSION_LIST_CACHE_TTL_MS: 1000, g_sessionListCache: new Map(), normalizeSessionSourceName: x => x, resolveSessionFilePath: () => '/memory', getSessionFileArg: () => '', queryOpencodeSessionMessages: () => { specialized++; return { messages: [...messages] }; }, extractMessagesFromFile: async () => { generic++; return { messages: [...messages] }; }, normalizeGeminiMessageRole: () => 'user', extractGeminiMessageText: x => x, getSessionSourceLabel: x => x, buildSessionMarkdown: x => x.messages.map(m => m.text).join(''), fs: { readFileSync: () => JSON.stringify({ messages: [{ type: 'user', content: 'needle' }] }), createReadStream: () => require('node:stream').Readable.from([JSON.stringify({ type: 'response_item', payload: { type: 'message', role: 'user', content: [{ type: 'input_text', text: 'needle' }] } }) + '\n']) } });
+vm.runInContext(names.map(name => { const m = source.match(new RegExp('^(?:async )?function ' + name + '\\([^]*?^}', 'm')); assert.ok(m, name); return m[0]; }).join('\n'), ctx);
+(async () => {
+  for (const kind of ['opencode', 'codex', 'gemini']) assert.equal((await ctx.exportSessionData({ source: kind, sessionId: 's' })).content, 'needle');
+  assert.equal(specialized, 1); assert.equal(generic, 1);
+  const sessions = [1, 2, 3].map(sessionId => ({ sessionId, source: 'codex', title: 'needle' }));
+  const result = await ctx.applySessionQueryFilter(sessions, { tokens: ['needle'], queryScope: 'content', contentScanLimit: 2 });
+  assert.equal(result.length, 2); assert.equal(JSON.stringify(result.searchInfo), '{"scanned":2,"candidates":3,"complete":false}');
+  const full = await ctx.applySessionQueryFilter(sessions, { tokens: ['needle'], queryScope: 'content', contentScanLimit: 3 });
+  assert.equal(full.searchInfo.complete, true); assert.equal(full.searchInfo.scanned, 3);
+  const summary = await ctx.applySessionQueryFilter(sessions, { tokens: ['needle'], queryScope: 'summary' });
+  assert.equal(summary.searchInfo.scanned, 0); assert.equal(summary.length, 3);
+  const all = await ctx.applySessionQueryFilter(sessions, { tokens: ['needle'], queryScope: 'all', contentScanLimit: 1 });
+  assert.equal(all.searchInfo.complete, false); assert.equal(all.searchInfo.scanned, 1);
+  ctx.setSessionListCache('query', result); assert.equal(ctx.getSessionListCache('query'), result); assert.equal(ctx.getSessionListCache('query').searchInfo, result.searchInfo);
+  assert.equal(Object.keys(result).includes('searchInfo'), false); assert.ok(Array.isArray(result)); assert.equal(JSON.parse(JSON.stringify(result)).length, 2);
+  ctx.listAllSessions = async () => result; const browse = await ctx.listSessionBrowse(); assert.equal(browse.searchInfo, result.searchInfo);
+  const empty = await ctx.applySessionQueryFilter(result, { tokens: [] }); assert.equal(empty.searchInfo, null); assert.equal(empty.length, 2);
+  ctx.setSessionListCache('empty', empty); assert.equal(ctx.getSessionListCache('empty').searchInfo, null);
+  assert.equal(ctx.getSessionListCache('query', true), null);
+  console.log('通过：真实函数 VM 隔离；OpenCode/Codex/Gemini 导出；JSONL 实扫计数；早停完成性；摘要免扫描；缓存与浏览元数据；空查询及数组兼容。');
+})().catch(error => { console.error(error); process.exitCode = 1; });

tests/unit/web-ui-behavior-parity.test.mjs

@@ -374,6 +374,9 @@ test('captured bundled app skeleton only exposes expected data key drift versus
         'toolConfigPermissionSaving',
         'toolConfigPermissions',
         'promptsHint',
+        'sessionExportRange',
+        'sessionExportNotice',
+        'sessionSearchInfo',
         'promptsSubTab',
         '__skipNextPromptsSubTabLoad',
         'promptPresetNameDraft',
@@ -429,6 +432,9 @@ test('captured bundled app skeleton only exposes expected data key drift versus
         'showEditClaudeConfigKey',
         'showEditProviderKey',
         'promptsHint',
+        'sessionExportRange',
+        'sessionExportNotice',
+        'sessionSearchInfo',
         'promptsSubTab',
         '__skipNextPromptsSubTabLoad',
         'promptPresetNameDraft',