codexmate 0.0.5 → 0.0.6

package/cli.js

@@ -5,12 +5,14 @@ const os = require('os');
 const crypto = require('crypto');
 const toml = require('@iarna/toml');
 const JSON5 = require('json5');
+const zipLib = require('zip-lib');
 const { exec, execSync } = require('child_process');
 const http = require('http');
 const https = require('https');
 const readline = require('readline');
 
-const DEFAULT_WEB_PORT = 3737;
+const DEFAULT_WEB_PORT = 3737;
+const DEFAULT_WEB_HOST = '127.0.0.1';
 
 // ============================================================================
 // 配置
@@ -45,15 +47,15 @@ const SESSION_CONTENT_READ_BYTES = SESSION_SUMMARY_READ_BYTES;
 const DEFAULT_CONTENT_SCAN_LIMIT = 10;
 const SESSION_SCAN_FACTOR = 4;
 const SESSION_SCAN_MIN_FILES = 800;
-const MAX_SESSION_PATH_LIST_SIZE = 2000;
-const AGENTS_FILE_NAME = 'AGENTS.md';
-const UTF8_BOM = '\ufeff';
-const MODELS_CACHE_TTL_MS = 60 * 1000;
-const MODELS_NEGATIVE_CACHE_TTL_MS = 5 * 1000;
-const MODELS_CACHE_MAX_ENTRIES = 50;
-const MODELS_RESPONSE_MAX_BYTES = 1024 * 1024;
-const MAX_RECENT_CONFIGS = 3;
-const BOOTSTRAP_TEXT_MARKERS = [
+const MAX_SESSION_PATH_LIST_SIZE = 2000;
+const AGENTS_FILE_NAME = 'AGENTS.md';
+const UTF8_BOM = '\ufeff';
+const MODELS_CACHE_TTL_MS = 60 * 1000;
+const MODELS_NEGATIVE_CACHE_TTL_MS = 5 * 1000;
+const MODELS_CACHE_MAX_ENTRIES = 50;
+const MODELS_RESPONSE_MAX_BYTES = 1024 * 1024;
+const MAX_RECENT_CONFIGS = 3;
+const BOOTSTRAP_TEXT_MARKERS = [
     'agents.md instructions',
     '<instructions>',
     '<environment_context>',
@@ -64,14 +66,26 @@ const BOOTSTRAP_TEXT_MARKERS = [
 const HTTP_KEEP_ALIVE_AGENT = new http.Agent({ keepAlive: true });
 const HTTPS_KEEP_ALIVE_AGENT = new https.Agent({ keepAlive: true });
 
-function resolveWebPort() {
-    const raw = process.env.CODEXMATE_PORT;
-    if (!raw) return DEFAULT_WEB_PORT;
-    const parsed = parseInt(raw, 10);
-    if (!Number.isFinite(parsed) || parsed <= 0) return DEFAULT_WEB_PORT;
-    return parsed;
-}
-
+function resolveWebPort() {
+    const raw = process.env.CODEXMATE_PORT;
+    if (!raw) return DEFAULT_WEB_PORT;
+    const parsed = parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) return DEFAULT_WEB_PORT;
+    return parsed;
+}
+
+function resolveWebHost(options = {}) {
+    const optionHost = typeof options.host === 'string' ? options.host.trim() : '';
+    if (optionHost) {
+        return optionHost;
+    }
+    const envHost = typeof process.env.CODEXMATE_HOST === 'string' ? process.env.CODEXMATE_HOST.trim() : '';
+    if (envHost) {
+        return envHost;
+    }
+    return DEFAULT_WEB_HOST;
+}
+
 const EMPTY_CONFIG_FALLBACK_TEMPLATE = `model = "gpt-5.3-codex"
 model_reasoning_effort = "high"
 disable_response_storage = true
@@ -609,6 +623,27 @@ function resolveOpenclawWorkspaceDir(config) {
     return path.join(OPENCLAW_DIR, resolved);
 }
 
+function normalizeOpenclawWorkspaceFileName(input) {
+    const raw = typeof input === 'string' ? input.trim() : '';
+    if (!raw) {
+        return { error: '文件名不能为空' };
+    }
+    if (raw.includes('\0')) {
+        return { error: '文件名非法' };
+    }
+    if (raw.includes('/') || raw.includes('\\') || raw.includes('..')) {
+        return { error: '文件名非法' };
+    }
+    const baseName = path.basename(raw);
+    if (baseName !== raw) {
+        return { error: '文件名非法' };
+    }
+    if (!raw.toLowerCase().endsWith('.md')) {
+        return { error: '仅支持 .md 文件' };
+    }
+    return { ok: true, name: raw };
+}
+
 function readOpenclawConfigFile() {
     const filePath = OPENCLAW_CONFIG_FILE;
     if (!fs.existsSync(filePath)) {
@@ -708,6 +743,81 @@ function applyOpenclawAgentsFile(params = {}) {
     };
 }
 
+function readOpenclawWorkspaceFile(params = {}) {
+    const nameResult = normalizeOpenclawWorkspaceFileName(params.fileName);
+    if (nameResult.error) {
+        return { error: nameResult.error };
+    }
+    const workspaceInfo = getOpenclawWorkspaceInfo();
+    const baseDir = workspaceInfo.workspaceDir;
+    const filePath = path.join(baseDir, nameResult.name);
+
+    if (!fs.existsSync(baseDir)) {
+        return {
+            exists: false,
+            path: filePath,
+            content: '',
+            lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n',
+            workspaceDir: baseDir,
+            configError: workspaceInfo.configError,
+            baseDirMissing: true
+        };
+    }
+
+    if (!fs.existsSync(filePath)) {
+        return {
+            exists: false,
+            path: filePath,
+            content: '',
+            lineEnding: os.EOL === '\r\n' ? '\r\n' : '\n',
+            workspaceDir: baseDir,
+            configError: workspaceInfo.configError
+        };
+    }
+
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return {
+            exists: true,
+            path: filePath,
+            content: stripUtf8Bom(raw),
+            lineEnding: detectLineEnding(raw),
+            workspaceDir: baseDir,
+            configError: workspaceInfo.configError
+        };
+    } catch (e) {
+        return { error: `读取 OpenClaw 工作区文件失败: ${e.message}` };
+    }
+}
+
+function applyOpenclawWorkspaceFile(params = {}) {
+    const nameResult = normalizeOpenclawWorkspaceFileName(params.fileName);
+    if (nameResult.error) {
+        return { error: nameResult.error };
+    }
+    const workspaceInfo = getOpenclawWorkspaceInfo();
+    const baseDir = workspaceInfo.workspaceDir;
+    ensureDir(baseDir);
+
+    const content = typeof params.content === 'string' ? params.content : '';
+    const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
+    const normalized = normalizeLineEnding(content, lineEnding);
+    const finalContent = ensureUtf8Bom(normalized);
+    const filePath = path.join(baseDir, nameResult.name);
+
+    try {
+        fs.writeFileSync(filePath, finalContent, 'utf-8');
+        return {
+            success: true,
+            path: filePath,
+            workspaceDir: baseDir,
+            configError: workspaceInfo.configError
+        };
+    } catch (e) {
+        return { error: `写入 OpenClaw 工作区文件失败: ${e.message}` };
+    }
+}
+
 function applyOpenclawConfig(params = {}) {
     const content = typeof params.content === 'string' ? params.content : '';
     const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
@@ -1379,10 +1489,60 @@ async function buildConfigHealthReport(params = {}) {
         } else {
             const timeoutMs = Number.isFinite(params.timeoutMs)
                 ? Math.max(1000, Number(params.timeoutMs))
-                : HEALTH_CHECK_TIMEOUT_MS;
-            remote = await runRemoteHealthCheck(provider, modelName, { timeoutMs });
-            if (remote && Array.isArray(remote.issues)) {
-                issues.push(...remote.issues);
+                : undefined;
+            const apiKey = typeof provider.preferred_auth_method === 'string'
+                ? provider.preferred_auth_method.trim()
+                : '';
+            const speedResult = await runSpeedTest(baseUrl, apiKey, { timeoutMs });
+            const status = speedResult && typeof speedResult.status === 'number'
+                ? speedResult.status
+                : 0;
+            const durationMs = speedResult && typeof speedResult.durationMs === 'number'
+                ? speedResult.durationMs
+                : 0;
+            const error = speedResult && speedResult.error ? String(speedResult.error) : '';
+            remote = {
+                type: 'speed-test',
+                url: baseUrl,
+                ok: !!speedResult.ok,
+                status,
+                durationMs,
+                error
+            };
+
+            if (!speedResult.ok) {
+                const errorLower = error.toLowerCase();
+                if (errorLower.includes('timeout')) {
+                    issues.push({
+                        code: 'remote-speedtest-timeout',
+                        message: '远程测速超时',
+                        suggestion: '检查网络或 base_url 是否可达'
+                    });
+                } else if (errorLower.includes('invalid url')) {
+                    issues.push({
+                        code: 'remote-speedtest-invalid-url',
+                        message: '远程测速失败：base_url 无效',
+                        suggestion: '请设置为 http/https 的完整 URL'
+                    });
+                } else {
+                    issues.push({
+                        code: 'remote-speedtest-unreachable',
+                        message: `远程测速失败：${error || '无法连接'}`,
+                        suggestion: '检查网络或 base_url 是否可用'
+                    });
+                }
+            } else if (status === 401 || status === 403) {
+                issues.push({
+                    code: 'remote-speedtest-auth-failed',
+                    message: '远程测速鉴权失败（401/403）',
+                    suggestion: '检查 API Key 或认证方式'
+                });
+            } else if (status >= 400) {
+                issues.push({
+                    code: 'remote-speedtest-http-error',
+                    message: `远程测速返回异常状态: ${status}`,
+                    suggestion: '检查 base_url 或服务状态'
+                });
             }
         }
     }
@@ -1424,6 +1584,16 @@ function toIsoTime(value, fallback = '') {
     return date.toISOString();
 }
 
+function updateLatestIso(currentIso, candidate) {
+    const currentTime = Date.parse(currentIso || '') || 0;
+    const candidateIso = toIsoTime(candidate, '');
+    const candidateTime = Date.parse(candidateIso || '') || 0;
+    if (!candidateTime) {
+        return currentIso;
+    }
+    return candidateTime > currentTime ? candidateIso : currentIso;
+}
+
 function truncateText(text, maxLength = 90) {
     if (!text) return '';
     const normalized = String(text).replace(/\s+/g, ' ').trim();
@@ -2297,7 +2467,7 @@ function parseCodexSessionSummary(filePath) {
 
     for (const record of records) {
         if (record.timestamp) {
-            updatedAt = toIsoTime(record.timestamp, updatedAt);
+            updatedAt = updateLatestIso(updatedAt, record.timestamp);
         }
 
         if (record.type === 'session_meta' && record.payload) {
@@ -2386,7 +2556,7 @@ function parseClaudeSessionSummary(filePath) {
             createdAt = toIsoTime(record.timestamp, createdAt);
         }
         if (record.timestamp) {
-            updatedAt = toIsoTime(record.timestamp, updatedAt);
+            updatedAt = updateLatestIso(updatedAt, record.timestamp);
         }
 
         if (!cwd && record.cwd) {
@@ -2747,7 +2917,269 @@ function resolveSessionFilePath(source, filePath, sessionId) {
     return '';
 }
 
-function buildSessionMarkdown(payload) {
+function findClaudeSessionIndexPath(sessionFilePath) {
+    const root = getClaudeProjectsDir();
+    if (!root || !sessionFilePath) {
+        return '';
+    }
+    if (!isPathInside(sessionFilePath, root)) {
+        return '';
+    }
+    let current = path.dirname(sessionFilePath);
+    const resolvedRoot = path.resolve(root);
+    while (current && isPathInside(current, resolvedRoot)) {
+        const candidate = path.join(current, 'sessions-index.json');
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return '';
+}
+
+function updateClaudeSessionIndex(indexPath, sessionFilePath, sessionId) {
+    if (!indexPath || !fs.existsSync(indexPath)) {
+        return;
+    }
+    const index = readJsonFile(indexPath, null);
+    if (!index || !Array.isArray(index.entries)) {
+        return;
+    }
+    const resolvedFile = sessionFilePath ? path.resolve(sessionFilePath) : '';
+    const resolvedLower = resolvedFile ? resolvedFile.toLowerCase() : '';
+    const filtered = index.entries.filter((entry) => {
+        if (!entry || typeof entry !== 'object') {
+            return false;
+        }
+        const entrySessionId = typeof entry.sessionId === 'string' ? entry.sessionId : '';
+        if (sessionId && entrySessionId === sessionId) {
+            return false;
+        }
+        if (entry.fullPath) {
+            const expanded = expandHomePath(entry.fullPath);
+            const entryPath = expanded ? path.resolve(expanded) : '';
+            if (entryPath && resolvedLower && entryPath.toLowerCase() === resolvedLower) {
+                return false;
+            }
+        }
+        return true;
+    });
+    if (filtered.length === index.entries.length) {
+        return;
+    }
+    index.entries = filtered;
+    try {
+        fs.writeFileSync(indexPath, JSON.stringify(index, null, 2), 'utf-8');
+    } catch (e) {}
+}
+
+async function deleteSessionData(params = {}) {
+    const source = params.source === 'claude' ? 'claude' : (params.source === 'codex' ? 'codex' : '');
+    if (!source) {
+        return { error: 'Invalid source' };
+    }
+
+    const filePath = resolveSessionFilePath(source, params.filePath, params.sessionId);
+    if (!filePath) {
+        return { error: 'Session file not found' };
+    }
+
+    const sessionId = params.sessionId || path.basename(filePath, '.jsonl');
+    try {
+        fs.unlinkSync(filePath);
+    } catch (e) {
+        return { error: `删除会话失败: ${e.message}` };
+    }
+
+    if (source === 'claude') {
+        const indexPath = findClaudeSessionIndexPath(filePath);
+        if (indexPath) {
+            updateClaudeSessionIndex(indexPath, filePath, sessionId);
+        }
+    }
+
+    invalidateSessionListCache();
+
+    return {
+        success: true,
+        source,
+        sessionId,
+        filePath
+    };
+}
+
+function generateCloneSessionId() {
+    if (crypto.randomUUID) {
+        return `clone-${crypto.randomUUID()}`;
+    }
+    const timePart = Date.now().toString(36);
+    const randomPart = crypto.randomBytes(8).toString('hex');
+    return `clone-${timePart}-${randomPart}`;
+}
+
+function allocateCloneSessionTarget(dirPath) {
+    for (let attempt = 0; attempt < 6; attempt += 1) {
+        const sessionId = generateCloneSessionId();
+        const filePath = path.join(dirPath, `${sessionId}.jsonl`);
+        if (!fs.existsSync(filePath)) {
+            return { sessionId, filePath };
+        }
+    }
+    const fallbackId = `clone-${Date.now().toString(36)}-${crypto.randomBytes(8).toString('hex')}`;
+    return { sessionId: fallbackId, filePath: path.join(dirPath, `${fallbackId}.jsonl`) };
+}
+
+function parseTimestampMs(value) {
+    if (value === undefined || value === null || value === '') {
+        return null;
+    }
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        if (value > 1e12) return value;
+        if (value > 1e9) return value * 1000;
+        return value;
+    }
+    if (typeof value === 'string') {
+        const parsed = Date.parse(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+        const numeric = Number(value);
+        if (Number.isFinite(numeric)) {
+            if (numeric > 1e12) return numeric;
+            if (numeric > 1e9) return numeric * 1000;
+            return numeric;
+        }
+    }
+    return null;
+}
+
+async function cloneCodexSession(params = {}) {
+    const source = params.source === 'codex' ? 'codex' : '';
+    if (!source) {
+        return { error: '仅支持 Codex 会话克隆' };
+    }
+
+    const filePath = resolveSessionFilePath(source, params.filePath, params.sessionId);
+    if (!filePath) {
+        return { error: 'Session file not found' };
+    }
+
+    let content = '';
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    } catch (e) {
+        return { error: `读取会话失败: ${e.message}` };
+    }
+
+    if (!content.trim()) {
+        return { error: 'Session file is empty' };
+    }
+
+    const lineEnding = detectLineEnding(content);
+    const rawLines = content.split(/\r?\n/);
+    if (rawLines.length > 0 && rawLines[rawLines.length - 1] === '') {
+        rawLines.pop();
+    }
+
+    let originalSessionId = typeof params.sessionId === 'string' ? params.sessionId.trim() : '';
+    if (!originalSessionId) {
+        originalSessionId = path.basename(filePath, '.jsonl');
+    }
+    let maxTimestampMs = 0;
+
+    for (const line of rawLines) {
+        const trimmed = line.trim();
+        if (!trimmed) continue;
+        try {
+            const record = JSON.parse(trimmed);
+            if (record && record.type === 'session_meta' && record.payload) {
+                if (record.payload.id) {
+                    originalSessionId = record.payload.id;
+                }
+            }
+            if (record && record.timestamp !== undefined) {
+                const ts = parseTimestampMs(record.timestamp);
+                if (Number.isFinite(ts) && ts > maxTimestampMs) {
+                    maxTimestampMs = ts;
+                }
+            }
+        } catch (e) {}
+    }
+
+    const sessionsDir = getCodexSessionsDir();
+    ensureDir(sessionsDir);
+    const target = allocateCloneSessionTarget(sessionsDir);
+    const newSessionId = target.sessionId;
+    const newFilePath = target.filePath;
+    const offsetMs = maxTimestampMs ? (Date.now() - maxTimestampMs) : 0;
+    const cloneTime = new Date(Date.now() + 1);
+    const cloneIso = cloneTime.toISOString();
+
+    const outputLines = [];
+    for (const line of rawLines) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            outputLines.push(line);
+            continue;
+        }
+        let record;
+        try {
+            record = JSON.parse(trimmed);
+        } catch (e) {
+            outputLines.push(line);
+            continue;
+        }
+
+        if (originalSessionId && typeof record.sessionId === 'string' && record.sessionId === originalSessionId) {
+            record.sessionId = newSessionId;
+        }
+        if (originalSessionId && typeof record.session_id === 'string' && record.session_id === originalSessionId) {
+            record.session_id = newSessionId;
+        }
+        if (offsetMs && record.timestamp !== undefined) {
+            const ts = parseTimestampMs(record.timestamp);
+            if (Number.isFinite(ts)) {
+                record.timestamp = new Date(ts + offsetMs).toISOString();
+            }
+        }
+        if (record && record.type === 'session_meta' && record.payload && typeof record.payload === 'object') {
+            record.payload = {
+                ...record.payload,
+                id: newSessionId,
+                timestamp: cloneIso
+            };
+            record.timestamp = cloneIso;
+        }
+
+        outputLines.push(JSON.stringify(record));
+    }
+
+    const output = outputLines.join(lineEnding) + lineEnding;
+    try {
+        fs.writeFileSync(newFilePath, output, 'utf-8');
+    } catch (e) {
+        return { error: `写入克隆会话失败: ${e.message}` };
+    }
+    try {
+        fs.utimesSync(newFilePath, cloneTime, cloneTime);
+    } catch (e) {}
+
+    invalidateSessionListCache();
+
+    return {
+        success: true,
+        source,
+        sourceLabel: 'Codex',
+        sessionId: newSessionId,
+        filePath: newFilePath
+    };
+}
+
+function buildSessionMarkdown(payload) {
     const lines = [
         '# AI Session Export',
         '',
@@ -2776,24 +3208,75 @@ function buildSessionMarkdown(payload) {
         lines.push('');
     });
 
-    return lines.join('\n');
-}
-
-function resolveStateMaxMessages(state) {
-    if (!state || typeof state !== 'object') {
-        return MAX_EXPORT_MESSAGES;
-    }
-
-    if (state.maxMessages === Infinity) {
-        return Infinity;
-    }
-
-    const rawMax = Number(state.maxMessages);
-    if (Number.isFinite(rawMax) && rawMax > 0) {
-        return Math.floor(rawMax);
-    }
-    return MAX_EXPORT_MESSAGES;
-}
+    return lines.join('\n');
+}
+
+function buildSessionPlainText(messages) {
+    if (!Array.isArray(messages) || messages.length === 0) {
+        return '';
+    }
+
+    const lines = [];
+    messages.forEach((message) => {
+        const role = normalizeRole(message && message.role) || 'unknown';
+        const text = message && typeof message.text === 'string' ? message.text : '';
+        lines.push(role);
+        lines.push(text);
+        lines.push('');
+    });
+
+    while (lines.length > 0 && lines[lines.length - 1] === '') {
+        lines.pop();
+    }
+
+    return lines.join('\n');
+}
+
+function parseMaxMessagesValue(value) {
+    if (value === Infinity) {
+        return Infinity;
+    }
+
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            return null;
+        }
+        const lower = trimmed.toLowerCase();
+        if (lower === 'all' || lower === 'infinity' || lower === 'inf') {
+            return Infinity;
+        }
+        const parsed = Number(trimmed);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+
+    if (Number.isFinite(value)) {
+        return value;
+    }
+    return null;
+}
+
+function resolveMaxMessagesValue(value, fallback) {
+    const parsed = parseMaxMessagesValue(value);
+    if (parsed === null) {
+        return fallback;
+    }
+    if (parsed === Infinity) {
+        return Infinity;
+    }
+    return Math.max(1, Math.floor(parsed));
+}
+
+function resolveStateMaxMessages(state) {
+    if (!state || typeof state !== 'object') {
+        return MAX_EXPORT_MESSAGES;
+    }
+
+    return resolveMaxMessagesValue(state.maxMessages, MAX_EXPORT_MESSAGES);
+}
 
 function canAppendMessage(state) {
     const maxMessages = resolveStateMaxMessages(state);
@@ -2830,7 +3313,7 @@ function extractCodexMessageFromRecord(record, state, lineIndex = -1) {
     }
 }
 
-function extractClaudeMessageFromRecord(record, state, lineIndex = -1) {
+function extractClaudeMessageFromRecord(record, state, lineIndex = -1) {
     if (record.timestamp) {
         state.updatedAt = toIsoTime(record.timestamp, state.updatedAt);
     }
@@ -2855,89 +3338,130 @@ function extractClaudeMessageFromRecord(record, state, lineIndex = -1) {
                 recordLineIndex: Number.isInteger(lineIndex) ? lineIndex : -1
             });
         }
-    }
-}
-
-function extractMessagesFromRecords(records, source, options = {}) {
-    const maxMessages = options.maxMessages === Infinity
-        ? Infinity
-        : (Number.isFinite(Number(options.maxMessages)) ? Math.max(1, Number(options.maxMessages)) : MAX_EXPORT_MESSAGES);
-    const state = {
-        sessionId: '',
-        cwd: '',
-        updatedAt: '',
-        messages: [],
-        maxMessages
-    };
-
-    let lineIndex = 0;
-    for (const record of records) {
-        if (source === 'codex') {
-            extractCodexMessageFromRecord(record, state, lineIndex);
-        } else {
-            extractClaudeMessageFromRecord(record, state, lineIndex);
-        }
-
-        lineIndex += 1;
-
-        if (state.maxMessages !== Infinity && state.messages.length >= state.maxMessages) {
-            break;
-        }
-    }
-
-    return state;
-}
-
-async function extractMessagesFromFile(filePath, source, options = {}) {
-    const maxMessages = options.maxMessages === Infinity
-        ? Infinity
-        : (Number.isFinite(Number(options.maxMessages)) ? Math.max(1, Number(options.maxMessages)) : MAX_EXPORT_MESSAGES);
-    const state = {
-        sessionId: '',
-        cwd: '',
-        updatedAt: '',
-        messages: [],
-        maxMessages
-    };
-
-    let stream;
-    let rl;
-    try {
-        stream = fs.createReadStream(filePath, { encoding: 'utf-8' });
-        rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
-
-        let lineIndex = 0;
-        for await (const line of rl) {
-            const currentLineIndex = lineIndex;
-            lineIndex += 1;
+    }
+}
+
+function recordHasCodexMessage(record) {
+    if (!record || record.type !== 'response_item' || !record.payload) {
+        return false;
+    }
+    if (record.payload.type !== 'message') {
+        return false;
+    }
+    const role = normalizeRole(record.payload.role);
+    if (role !== 'user' && role !== 'assistant' && role !== 'system') {
+        return false;
+    }
+    const text = extractMessageText(record.payload.content);
+    return !!text;
+}
+
+function recordHasClaudeMessage(record) {
+    if (!record) {
+        return false;
+    }
+    const role = normalizeRole(record.type);
+    if (role !== 'user' && role !== 'assistant' && role !== 'system') {
+        return false;
+    }
+    const content = record.message ? record.message.content : '';
+    const text = extractMessageText(content);
+    return !!text;
+}
+
+function recordHasMessage(record, source) {
+    return source === 'codex'
+        ? recordHasCodexMessage(record)
+        : recordHasClaudeMessage(record);
+}
+
+function extractMessagesFromRecords(records, source, options = {}) {
+    const maxMessages = resolveMaxMessagesValue(options.maxMessages, MAX_EXPORT_MESSAGES);
+    const state = {
+        sessionId: '',
+        cwd: '',
+        updatedAt: '',
+        messages: [],
+        maxMessages,
+        truncated: false
+    };
+
+    for (let lineIndex = 0; lineIndex < records.length; lineIndex++) {
+        const record = records[lineIndex];
+        if (source === 'codex') {
+            extractCodexMessageFromRecord(record, state, lineIndex);
+        } else {
+            extractClaudeMessageFromRecord(record, state, lineIndex);
+        }
+
+        if (state.maxMessages !== Infinity && state.messages.length >= state.maxMessages) {
+            for (let i = lineIndex + 1; i < records.length; i++) {
+                if (recordHasMessage(records[i], source)) {
+                    state.truncated = true;
+                    break;
+                }
+            }
+            break;
+        }
+    }
+
+    return state;
+}
+
+async function extractMessagesFromFile(filePath, source, options = {}) {
+    const maxMessages = resolveMaxMessagesValue(options.maxMessages, MAX_EXPORT_MESSAGES);
+    const state = {
+        sessionId: '',
+        cwd: '',
+        updatedAt: '',
+        messages: [],
+        maxMessages,
+        truncated: false
+    };
+
+    let stream;
+    let rl;
+    try {
+        stream = fs.createReadStream(filePath, { encoding: 'utf-8' });
+        rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+
+        let lineIndex = 0;
+        let limitReached = false;
+        for await (const line of rl) {
+            const currentLineIndex = lineIndex;
+            lineIndex += 1;
 
             const trimmed = line.trim();
             if (!trimmed) continue;
 
             let record;
-            try {
-                record = JSON.parse(trimmed);
-            } catch (e) {
-                continue;
-            }
-
-            if (source === 'codex') {
-                extractCodexMessageFromRecord(record, state, currentLineIndex);
-            } else {
-                extractClaudeMessageFromRecord(record, state, currentLineIndex);
-            }
-
-            if (state.maxMessages !== Infinity && state.messages.length >= state.maxMessages) {
-                rl.close();
-                if (stream.destroy) {
-                    stream.destroy();
-                }
-                break;
-            }
-        }
-    } catch (e) {
-        const fallbackRecords = readJsonlRecords(filePath);
-        return extractMessagesFromRecords(fallbackRecords, source, { maxMessages });
+            try {
+                record = JSON.parse(trimmed);
+            } catch (e) {
+                continue;
+            }
+
+            if (limitReached) {
+                if (recordHasMessage(record, source)) {
+                    state.truncated = true;
+                    break;
+                }
+                continue;
+            }
+
+            if (source === 'codex') {
+                extractCodexMessageFromRecord(record, state, currentLineIndex);
+            } else {
+                extractClaudeMessageFromRecord(record, state, currentLineIndex);
+            }
+
+            if (state.maxMessages !== Infinity && state.messages.length >= state.maxMessages) {
+                limitReached = true;
+            }
+        }
+    } catch (e) {
+        const fallbackRecords = readJsonlRecords(filePath);
+        return extractMessagesFromRecords(fallbackRecords, source, { maxMessages });
     } finally {
         if (rl) {
             try { rl.close(); } catch (e) {}
@@ -2950,7 +3474,7 @@ async function extractMessagesFromFile(filePath, source, options = {}) {
     return state;
 }
 
-async function readSessionDetail(params = {}) {
+async function readSessionDetail(params = {}) {
     const source = params.source === 'claude' ? 'claude' : (params.source === 'codex' ? 'codex' : '');
     if (!source) {
         return { error: 'Invalid source' };
@@ -2977,37 +3501,83 @@ async function readSessionDetail(params = {}) {
     const startIndex = Math.max(0, allMessages.length - messageLimit);
     const clippedMessages = allMessages.slice(startIndex);
 
-    return {
-        source,
-        sourceLabel,
-        sessionId,
+    return {
+        source,
+        sourceLabel,
+        sessionId,
         cwd: extracted.cwd || '',
         updatedAt: extracted.updatedAt || '',
         totalMessages: allMessages.length,
         clipped: allMessages.length > clippedMessages.length,
         messageLimit,
         messages: clippedMessages,
-        filePath
-    };
-}
-
-async function exportSessionData(params = {}) {
-    const source = params.source === 'claude' ? 'claude' : (params.source === 'codex' ? 'codex' : '');
-    if (!source) {
-        return { error: 'Invalid source' };
-    }
-
-    const filePath = resolveSessionFilePath(source, params.filePath, params.sessionId);
-    if (!filePath) {
-        return { error: 'Session file not found' };
-    }
-
-    let extracted;
-    try {
-        extracted = await extractMessagesFromFile(filePath, source);
-    } catch (e) {
-        extracted = null;
-    }
+        filePath
+    };
+}
+
+async function readSessionPlain(params = {}) {
+    const source = params.source === 'claude' ? 'claude' : (params.source === 'codex' ? 'codex' : '');
+    if (!source) {
+        return { error: 'Invalid source' };
+    }
+
+    const filePath = resolveSessionFilePath(source, params.filePath, params.sessionId);
+    if (!filePath) {
+        return { error: 'Session file not found' };
+    }
+
+    let extracted;
+    try {
+        extracted = await extractMessagesFromFile(filePath, source, { maxMessages: Infinity });
+    } catch (e) {
+        extracted = null;
+    }
+
+    if (!extracted) {
+        return { error: 'Failed to parse session file' };
+    }
+
+    if ((!extracted.messages || extracted.messages.length === 0) && !extracted.sessionId && !extracted.cwd) {
+        const fallbackRecords = readJsonlRecords(filePath);
+        if (fallbackRecords.length === 0) {
+            return { error: 'Session file is empty' };
+        }
+        extracted = extractMessagesFromRecords(fallbackRecords, source, { maxMessages: Infinity });
+    }
+
+    const sessionId = extracted.sessionId || params.sessionId || path.basename(filePath, '.jsonl');
+    const sourceLabel = source === 'codex' ? 'Codex' : 'Claude Code';
+    const messages = removeLeadingSystemMessage(Array.isArray(extracted.messages) ? extracted.messages : []);
+    const text = buildSessionPlainText(messages);
+
+    return {
+        source,
+        sourceLabel,
+        sessionId,
+        title: sessionId,
+        filePath,
+        text
+    };
+}
+
+async function exportSessionData(params = {}) {
+    const source = params.source === 'claude' ? 'claude' : (params.source === 'codex' ? 'codex' : '');
+    if (!source) {
+        return { error: 'Invalid source' };
+    }
+
+    const maxMessages = resolveMaxMessagesValue(params.maxMessages, MAX_EXPORT_MESSAGES);
+    const filePath = resolveSessionFilePath(source, params.filePath, params.sessionId);
+    if (!filePath) {
+        return { error: 'Session file not found' };
+    }
+
+    let extracted;
+    try {
+        extracted = await extractMessagesFromFile(filePath, source, { maxMessages });
+    } catch (e) {
+        extracted = null;
+    }
 
     if (!extracted) {
         return { error: 'Failed to parse session file' };
@@ -3015,11 +3585,11 @@ async function exportSessionData(params = {}) {
 
     if ((!extracted.messages || extracted.messages.length === 0) && !extracted.sessionId && !extracted.cwd) {
         const fallbackRecords = readJsonlRecords(filePath);
-        if (fallbackRecords.length === 0) {
-            return { error: 'Session file is empty' };
-        }
-        extracted = extractMessagesFromRecords(fallbackRecords, source);
-    }
+        if (fallbackRecords.length === 0) {
+            return { error: 'Session file is empty' };
+        }
+        extracted = extractMessagesFromRecords(fallbackRecords, source, { maxMessages });
+    }
 
     extracted.messages = removeLeadingSystemMessage(Array.isArray(extracted.messages) ? extracted.messages : []);
 
@@ -3031,25 +3601,29 @@ async function exportSessionData(params = {}) {
     }
 
     const sessionId = extracted.sessionId || params.sessionId || path.basename(filePath, '.jsonl');
-    const safeSessionId = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_');
-    const sourceLabel = source === 'codex' ? 'Codex' : 'Claude Code';
-    const markdown = buildSessionMarkdown({
-        sourceLabel,
-        sessionId,
-        updatedAt: extracted.updatedAt,
-        cwd: extracted.cwd,
+    const safeSessionId = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_');
+    const sourceLabel = source === 'codex' ? 'Codex' : 'Claude Code';
+    const truncated = !!extracted.truncated;
+    const maxMessagesLabel = maxMessages === Infinity ? 'all' : maxMessages;
+    const markdown = buildSessionMarkdown({
+        sourceLabel,
+        sessionId,
+        updatedAt: extracted.updatedAt,
+        cwd: extracted.cwd,
         filePath,
         messages: extracted.messages
     });
 
-    return {
-        source,
-        sourceLabel,
-        sessionId,
-        fileName: `${source}-session-${safeSessionId}.md`,
-        content: markdown
-    };
-}
+    return {
+        source,
+        sourceLabel,
+        sessionId,
+        fileName: `${source}-session-${safeSessionId}.md`,
+        content: markdown,
+        truncated,
+        maxMessages: maxMessagesLabel
+    };
+}
 
 function buildExportPayload(includeKeys) {
     const { config } = readConfigOrVirtualDefault();
@@ -3213,7 +3787,7 @@ function resolveSpeedTestTarget(params) {
     return { error: 'Missing name or url' };
 }
 
-function runSpeedTest(targetUrl, apiKey) {
+function runSpeedTest(targetUrl, apiKey, options = {}) {
     return new Promise((resolve) => {
         let parsed;
         try {
@@ -3222,6 +3796,10 @@ function runSpeedTest(targetUrl, apiKey) {
             return resolve({ ok: false, error: 'Invalid URL' });
         }
 
+        const timeoutMs = Number.isFinite(options.timeoutMs)
+            ? Math.max(1000, Number(options.timeoutMs))
+            : SPEED_TEST_TIMEOUT_MS;
+
         const transport = parsed.protocol === 'https:' ? https : http;
         const headers = {
             'User-Agent': 'codexmate-speed-test',
@@ -3243,7 +3821,7 @@ function runSpeedTest(targetUrl, apiKey) {
             });
         });
 
-        req.setTimeout(SPEED_TEST_TIMEOUT_MS, () => {
+        req.setTimeout(timeoutMs, () => {
             req.destroy(new Error('timeout'));
         });
 
@@ -3938,8 +4516,67 @@ function applyToClaudeSettings(config = {}) {
     }
 }
 
-// 多线程压缩
-function cmdZip(targetPath, options = {}) {
+function commandExists(command, args = '') {
+    try {
+        execSync(`${command} ${args}`, { stdio: 'ignore' });
+        return true;
+    } catch (e) {
+        return false;
+    }
+}
+
+const SEVEN_ZIP_PATHS = [
+    'C:\\Program Files\\7-Zip\\7z.exe',
+    'C:\\Program Files (x86)\\7-Zip\\7z.exe',
+    '7z'
+];
+
+function findSevenZipExecutable() {
+    for (const candidate of SEVEN_ZIP_PATHS) {
+        try {
+            if (candidate === '7z') {
+                if (commandExists('7z', '--help')) {
+                    return '7z';
+                }
+            } else if (fs.existsSync(candidate)) {
+                return candidate;
+            }
+        } catch (e) {}
+    }
+    return null;
+}
+
+function resolveZipTool() {
+    const sevenZipExe = findSevenZipExecutable();
+    if (sevenZipExe) {
+        return { type: '7z', cmd: sevenZipExe };
+    }
+    return { type: 'lib', cmd: 'zip-lib' };
+}
+
+function resolveUnzipTool() {
+    const sevenZipExe = findSevenZipExecutable();
+    if (sevenZipExe) {
+        return { type: '7z', cmd: sevenZipExe };
+    }
+    return { type: 'lib', cmd: 'zip-lib' };
+}
+
+async function zipWithLibrary(absPath, outputPath) {
+    const stat = fs.lstatSync(absPath);
+    if (stat.isDirectory()) {
+        await zipLib.archiveFolder(absPath, outputPath);
+        return;
+    }
+    await zipLib.archiveFile(absPath, outputPath);
+}
+
+async function unzipWithLibrary(zipPath, outputDir) {
+    await zipLib.extract(zipPath, outputDir);
+}
+
+// 压缩（7-Zip 优先）
+async function cmdZip(targetPath, options = {}) {
     if (!targetPath) {
         console.error('用法: codexmate zip <文件或文件夹路径> [--max:压缩级别]');
         console.log('\n示例:');
@@ -3967,58 +4604,43 @@ function cmdZip(targetPath, options = {}) {
     const outputDir = path.dirname(absPath);
     const outputPath = path.join(outputDir, `${baseName}.zip`);
 
-    // 查找 7-Zip
-    const sevenZipPaths = [
-        'C:\\Program Files\\7-Zip\\7z.exe',
-        'C:\\Program Files (x86)\\7-Zip\\7z.exe',
-        '7z'
-    ];
-
-    let sevenZipExe = null;
-    for (const p of sevenZipPaths) {
-        try {
-            if (p === '7z') {
-                execSync('7z --help', { stdio: 'ignore' });
-                sevenZipExe = '7z';
-                break;
-            } else if (fs.existsSync(p)) {
-                sevenZipExe = p;
-                break;
-            }
-        } catch (e) {}
-    }
-
-    if (!sevenZipExe) {
-        console.error('错误: 未找到 7-Zip，请先安装 7-Zip');
-        console.log('下载地址: https://www.7-zip.org/');
-        process.exit(1);
-    }
+    const zipTool = resolveZipTool();
 
     console.log('\n压缩配置:');
     console.log('  源路径:', absPath);
     console.log('  输出文件:', outputPath);
     console.log('  压缩级别:', compressionLevel);
-    console.log('  多线程: 启用');
+    console.log('  压缩工具:', zipTool.type === '7z' ? '7-Zip' : 'zip-lib');
+    console.log('  多线程:', zipTool.type === '7z' ? '启用' : '未启用（JS 库）');
+    if (zipTool.type !== '7z') {
+        console.log('  提示: JS 库不支持压缩级别，已忽略 --max');
+    }
     console.log('\n开始压缩...\n');
 
     try {
-        const cmd = `"${sevenZipExe}" a -tzip -mmt=on -mx=${compressionLevel} "${outputPath}" "${absPath}"`;
-        const result = execSync(cmd, { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024 });
-
-        // 解析输出获取文件信息
-        const sizeMatch = result.match(/Archive size:\s*(\d+)\s*bytes/);
-        const filesMatch = result.match(/(\d+)\s*files/);
+        if (zipTool.type === '7z') {
+            const cmd = `"${zipTool.cmd}" a -tzip -mmt=on -mx=${compressionLevel} "${outputPath}" "${absPath}"`;
+            const result = execSync(cmd, { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024 });
+            const sizeMatch = result.match(/Archive size:\s*(\d+)\s*bytes/);
+            const filesMatch = result.match(/(\d+)\s*files/);
+
+            console.log('✓ 压缩完成!');
+            console.log('  输出文件:', outputPath);
+            if (sizeMatch) {
+                const sizeBytes = parseInt(sizeMatch[1]);
+                const sizeMB = (sizeBytes / 1024 / 1024).toFixed(2);
+                console.log('  压缩大小:', sizeMB, 'MB');
+            }
+            if (filesMatch) {
+                console.log('  文件数量:', filesMatch[1]);
+            }
+            console.log();
+            return;
+        }
 
+        await zipWithLibrary(absPath, outputPath);
         console.log('✓ 压缩完成!');
         console.log('  输出文件:', outputPath);
-        if (sizeMatch) {
-            const sizeBytes = parseInt(sizeMatch[1]);
-            const sizeMB = (sizeBytes / 1024 / 1024).toFixed(2);
-            console.log('  压缩大小:', sizeMB, 'MB');
-        }
-        if (filesMatch) {
-            console.log('  文件数量:', filesMatch[1]);
-        }
         console.log();
     } catch (e) {
         console.error('压缩失败:', e.message);
@@ -4026,8 +4648,8 @@ function cmdZip(targetPath, options = {}) {
     }
 }
 
-// 多线程解压
-function cmdUnzip(zipPath, outputDir) {
+// 解压（7-Zip 优先）
+async function cmdUnzip(zipPath, outputDir) {
     if (!zipPath) {
         console.error('用法: codexmate unzip <zip文件路径> [输出目录]');
         console.log('\n示例:');
@@ -4053,65 +4675,254 @@ function cmdUnzip(zipPath, outputDir) {
     const defaultOutputDir = path.join(path.dirname(absZipPath), baseName);
     const absOutputDir = outputDir ? path.resolve(outputDir) : defaultOutputDir;
 
-    // 查找 7-Zip
-    const sevenZipPaths = [
-        'C:\\Program Files\\7-Zip\\7z.exe',
-        'C:\\Program Files (x86)\\7-Zip\\7z.exe',
-        '7z'
-    ];
-
-    let sevenZipExe = null;
-    for (const p of sevenZipPaths) {
-        try {
-            if (p === '7z') {
-                execSync('7z --help', { stdio: 'ignore' });
-                sevenZipExe = '7z';
-                break;
-            } else if (fs.existsSync(p)) {
-                sevenZipExe = p;
-                break;
-            }
-        } catch (e) {}
-    }
-
-    if (!sevenZipExe) {
-        console.error('错误: 未找到 7-Zip，请先安装 7-Zip');
-        console.log('下载地址: https://www.7-zip.org/');
-        process.exit(1);
-    }
+    const unzipTool = resolveUnzipTool();
 
     console.log('\n解压配置:');
     console.log('  源文件:', absZipPath);
     console.log('  输出目录:', absOutputDir);
-    console.log('  多线程: 启用');
+    console.log('  解压工具:', unzipTool.type === '7z' ? '7-Zip' : 'zip-lib');
+    console.log('  多线程:', unzipTool.type === '7z' ? '启用' : '未启用（JS 库）');
     console.log('\n开始解压...\n');
 
     try {
-        const cmd = `"${sevenZipExe}" x -mmt=on -o"${absOutputDir}" "${absZipPath}" -y`;
-        const result = execSync(cmd, { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024 });
-
-        // 解析输出获取文件信息
-        const filesMatch = result.match(/(\d+)\s*files/);
+        if (unzipTool.type === '7z') {
+            const cmd = `"${unzipTool.cmd}" x -mmt=on -o"${absOutputDir}" "${absZipPath}" -y`;
+            const result = execSync(cmd, { encoding: 'utf-8', maxBuffer: 50 * 1024 * 1024 });
+            const filesMatch = result.match(/(\d+)\s*files/);
+            console.log('✓ 解压完成!');
+            console.log('  输出目录:', absOutputDir);
+            if (filesMatch) {
+                console.log('  文件数量:', filesMatch[1]);
+            }
+            console.log();
+            return;
+        }
 
+        await unzipWithLibrary(absZipPath, absOutputDir);
         console.log('✓ 解压完成!');
         console.log('  输出目录:', absOutputDir);
-        if (filesMatch) {
-            console.log('  文件数量:', filesMatch[1]);
-        }
         console.log();
     } catch (e) {
         console.error('解压失败:', e.message);
         process.exit(1);
-    }
-}
-
-// 打开 Web UI
-function cmdStart() {
-    const htmlPath = path.join(__dirname, 'web-ui.html');
-    if (!fs.existsSync(htmlPath)) {
-        console.error('错误: web-ui.html 不存在');
-        process.exit(1);
-    }
+    }
+}
+
+function resolveExportOutputPath(outputPath, defaultFileName) {
+    const fallback = path.resolve(process.cwd(), defaultFileName);
+    if (typeof outputPath !== 'string' || !outputPath.trim()) {
+        return fallback;
+    }
+
+    const trimmed = outputPath.trim();
+    const resolved = path.resolve(trimmed);
+    const hasTrailingSep = /[\\\/]$/.test(trimmed);
+    if (hasTrailingSep) {
+        ensureDir(resolved);
+        return path.join(resolved, defaultFileName);
+    }
+
+    if (fs.existsSync(resolved)) {
+        try {
+            const stat = fs.statSync(resolved);
+            if (stat.isDirectory()) {
+                return path.join(resolved, defaultFileName);
+            }
+        } catch (e) {}
+    }
+
+    return resolved;
+}
+
+function printExportSessionUsage() {
+    console.log('\n用法: codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]');
+    console.log('\n示例:');
+    console.log('  codexmate export-session --source codex --session-id 123456');
+    console.log('  codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl"');
+    console.log('  codexmate export-session --source codex --session-id 123456 --max-messages=all');
+}
+
+function parseExportSessionArgs(args = []) {
+    const options = {
+        source: '',
+        sessionId: '',
+        filePath: '',
+        output: '',
+        maxMessages: undefined
+    };
+    const errors = [];
+
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg) continue;
+
+        if (arg.startsWith('--source=')) {
+            options.source = arg.slice('--source='.length);
+            continue;
+        }
+        if (arg === '--source') {
+            options.source = args[i + 1] || '';
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--session-id=')) {
+            options.sessionId = arg.slice('--session-id='.length);
+            continue;
+        }
+        if (arg === '--session-id') {
+            options.sessionId = args[i + 1] || '';
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--file=')) {
+            options.filePath = arg.slice('--file='.length);
+            continue;
+        }
+        if (arg === '--file') {
+            options.filePath = args[i + 1] || '';
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--output=')) {
+            options.output = arg.slice('--output='.length);
+            continue;
+        }
+        if (arg === '--output') {
+            options.output = args[i + 1] || '';
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--max-messages=')) {
+            options.maxMessages = arg.slice('--max-messages='.length);
+            continue;
+        }
+        if (arg === '--max-messages') {
+            options.maxMessages = args[i + 1] || '';
+            i += 1;
+            continue;
+        }
+
+        errors.push(`未知参数: ${arg}`);
+    }
+
+    const normalizedSource = options.source.trim().toLowerCase();
+    if (normalizedSource && normalizedSource !== 'codex' && normalizedSource !== 'claude') {
+        errors.push('参数 --source 仅支持 codex 或 claude');
+    }
+    options.source = normalizedSource;
+
+    if (!options.source) {
+        errors.push('缺少 --source');
+    }
+
+    if (!options.sessionId && !options.filePath) {
+        errors.push('必须指定 --session-id 或 --file');
+    }
+
+    if (options.maxMessages !== undefined) {
+        const parsed = parseMaxMessagesValue(options.maxMessages);
+        if (parsed === null) {
+            errors.push('参数 --max-messages 无效');
+        } else {
+            options.maxMessages = parsed === Infinity ? Infinity : Math.max(1, Math.floor(parsed));
+        }
+    }
+
+    return {
+        options,
+        error: errors.length > 0 ? errors.join('；') : ''
+    };
+}
+
+async function cmdExportSession(args = []) {
+    const parsed = parseExportSessionArgs(args);
+    if (parsed.error) {
+        console.error('错误:', parsed.error);
+        printExportSessionUsage();
+        process.exit(1);
+    }
+
+    const options = parsed.options;
+    const maxMessages = resolveMaxMessagesValue(options.maxMessages, MAX_EXPORT_MESSAGES);
+    let result;
+    try {
+        result = await exportSessionData({
+            source: options.source,
+            sessionId: options.sessionId,
+            filePath: options.filePath,
+            maxMessages
+        });
+    } catch (e) {
+        console.error('导出失败:', e.message || e);
+        process.exit(1);
+    }
+
+    if (result && result.error) {
+        console.error('导出失败:', result.error);
+        process.exit(1);
+    }
+
+    const defaultFileName = (result && result.fileName)
+        ? result.fileName
+        : `${options.source}-session-${options.sessionId || Date.now()}.md`;
+    const outputPath = resolveExportOutputPath(options.output, defaultFileName);
+    ensureDir(path.dirname(outputPath));
+    fs.writeFileSync(outputPath, (result && result.content) ? result.content : '', 'utf-8');
+
+    console.log('\n✓ 会话已导出:', outputPath);
+    if (result && result.truncated) {
+        const label = maxMessages === Infinity ? 'all' : maxMessages;
+        console.log(`! 已截断: 仅导出前 ${label} 条消息`);
+        console.log('  可使用 --max-messages=all 导出完整内容');
+    }
+    console.log();
+}
+
+function parseStartOptions(args = []) {
+    const options = { host: '' };
+    if (!Array.isArray(args)) {
+        return options;
+    }
+
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg) continue;
+        if (arg.startsWith('--host=')) {
+            options.host = arg.slice('--host='.length);
+            continue;
+        }
+        if (arg === '--host') {
+            options.host = args[i + 1] || '';
+            i += 1;
+        }
+    }
+
+    return options;
+}
+
+function isAnyAddressHost(host) {
+    return host === '0.0.0.0' || host === '::';
+}
+
+function formatHostForUrl(host) {
+    const value = typeof host === 'string' ? host.trim() : '';
+    if (!value) return '';
+    if (value.startsWith('[') && value.endsWith(']')) {
+        return value;
+    }
+    if (value.includes(':')) {
+        return `[${value}]`;
+    }
+    return value;
+}
+
+// 打开 Web UI
+function cmdStart(options = {}) {
+    const htmlPath = path.join(__dirname, 'web-ui.html');
+    if (!fs.existsSync(htmlPath)) {
+        console.error('错误: web-ui.html 不存在');
+        process.exit(1);
+    }
 
     const server = http.createServer((req, res) => {
         if (req.url === '/api') {
@@ -4207,6 +5018,12 @@ function cmdStart() {
                         case 'apply-openclaw-agents-file':
                             result = applyOpenclawAgentsFile(params || {});
                             break;
+                        case 'get-openclaw-workspace-file':
+                            result = readOpenclawWorkspaceFile(params || {});
+                            break;
+                        case 'apply-openclaw-workspace-file':
+                            result = applyOpenclawWorkspaceFile(params || {});
+                            break;
                         case 'switch':
                         case 'use':
                         case 'add':
@@ -4255,12 +5072,21 @@ function cmdStart() {
                         case 'export-session':
                             result = await exportSessionData(params);
                             break;
-                        case 'session-detail':
-                            result = await readSessionDetail(params);
+                        case 'delete-session':
+                            result = await deleteSessionData(params || {});
                             break;
-                        default:
-                            result = { error: '未知操作' };
-                    }
+                        case 'clone-session':
+                            result = await cloneCodexSession(params || {});
+                            break;
+                        case 'session-detail':
+                            result = await readSessionDetail(params);
+                            break;
+                        case 'session-plain':
+                            result = await readSessionPlain(params);
+                            break;
+                        default:
+                            result = { error: '未知操作' };
+                    }
 
                     res.writeHead(200, { 'Content-Type': 'application/json' });
                     res.end(JSON.stringify(result));
@@ -4276,18 +5102,28 @@ function cmdStart() {
         }
     });
 
-    const port = resolveWebPort();
-    server.listen(port, () => {
-        console.log('\n✓ Web UI 已启动: http://localhost:' + port);
-        console.log('  按 Ctrl+C 退出\n');
-
-        // 打开浏览器
-        const platform = process.platform;
-        let command;
-        const url = `http://localhost:${port}`;
-
-        if (platform === 'win32') {
-            command = `start "" "${url}"`;
+    const port = resolveWebPort();
+    const host = resolveWebHost(options);
+    const openHost = isAnyAddressHost(host) ? DEFAULT_WEB_HOST : host;
+    const openUrl = `http://${formatHostForUrl(openHost)}:${port}`;
+    server.listen(port, host, () => {
+        console.log('\n✓ Web UI 已启动:', openUrl);
+        if (host && host !== openHost) {
+            console.log('  监听地址:', host);
+        }
+        console.log('  按 Ctrl+C 退出\n');
+        if (isAnyAddressHost(host)) {
+            console.warn('! 安全提示: 当前监听所有网卡（无鉴权）。');
+            console.warn('  建议仅在可信网络使用，或改用 --host 127.0.0.1。');
+        }
+
+        // 打开浏览器
+        const platform = process.platform;
+        let command;
+        const url = openUrl;
+
+        if (platform === 'win32') {
+            command = `start "" "${url}"`;
         } else if (platform === 'darwin') {
             command = `open "${url}"`;
         } else {
@@ -4324,14 +5160,15 @@ async function main() {
         console.log('  codexmate use <模型>       切换模型');
         console.log('  codexmate add <名称> <URL> [密钥]');
         console.log('  codexmate delete <名称>    删除提供商');
-        console.log('  codexmate add-model <模型> 添加模型');
-        console.log('  codexmate delete-model <模型> 删除模型');
-        console.log('  codexmate start            启动 Web 界面');
-        console.log('  codexmate zip <路径> [--max:级别]  多线程压缩');
-        console.log('  codexmate unzip <zip文件> [输出目录]  多线程解压');
-        console.log('');
-        process.exit(0);
-    }
+        console.log('  codexmate add-model <模型> 添加模型');
+        console.log('  codexmate delete-model <模型> 删除模型');
+        console.log('  codexmate start [--host <HOST>]  启动 Web 界面');
+        console.log('  codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]');
+        console.log('  codexmate zip <路径> [--max:级别]  压缩（7-Zip 优先）');
+        console.log('  codexmate unzip <zip文件> [输出目录]  解压（7-Zip 优先）');
+        console.log('');
+        process.exit(0);
+    }
 
     const command = args[0];
 
@@ -4344,12 +5181,13 @@ async function main() {
         case 'use': cmdUseModel(args[1]); break;
         case 'add': cmdAdd(args[1], args[2], args[3]); break;
         case 'delete': cmdDelete(args[1]); break;
-        case 'add-model': cmdAddModel(args[1]); break;
-        case 'delete-model': cmdDeleteModel(args[1]); break;
-        case 'start': cmdStart(); break;
-        case 'zip': {
-            // 解析 --max:N 参数
-            const zipOptions = {};
+        case 'add-model': cmdAddModel(args[1]); break;
+        case 'delete-model': cmdDeleteModel(args[1]); break;
+        case 'start': cmdStart(parseStartOptions(args.slice(1))); break;
+        case 'export-session': await cmdExportSession(args.slice(1)); break;
+        case 'zip': {
+            // 解析 --max:N 参数
+            const zipOptions = {};
             let targetPath = null;
             for (let i = 1; i < args.length; i++) {
                 const arg = args[i];
@@ -4359,10 +5197,10 @@ async function main() {
                     targetPath = arg;
                 }
             }
-            cmdZip(targetPath, zipOptions);
+            await cmdZip(targetPath, zipOptions);
             break;
         }
-        case 'unzip': cmdUnzip(args[1], args[2]); break;
+        case 'unzip': await cmdUnzip(args[1], args[2]); break;
         default:
             console.error('错误: 未知命令:', command);
             console.log('运行 "codexmate" 查看帮助');
@@ -4374,3 +5212,4 @@ main().catch((err) => {
     console.error('错误:', err && err.message ? err.message : err);
     process.exit(1);
 });
+