lark-remote 0.1.2 → 0.1.3

package/dist/router/config/codex.js

@@ -6,14 +6,12 @@ export class CodexConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
         // 从 codex config.toml 动态读取 provider 和 model
-        const codexBinary = displayConfig.agents?.codex?.binary ?? 'codex';
-        const codexCfg = loadCodexConfig({ binary: codexBinary });
+        const codexCfg = loadCodexConfig();
         const codexProviderNames = codexCfg.providerNames;
         const currentModelProvider = displayConfig.agents?.codex?.modelProvider ?? codexCfg.currentProvider;
         const currentCodexModel = displayConfig.agents?.codex?.model ?? codexCfg.currentModel;
-        const currentReasoningEffort = displayConfig.agents?.codex?.reasoningEffort ??
-            getDefaultReasoningEffort(currentCodexModel, codexBinary);
-        // 传入当前 provider 过滤模型列���
+        const currentReasoningEffort = displayConfig.agents?.codex?.reasoningEffort ?? getDefaultReasoningEffort(currentCodexModel);
+        // 传入当前 provider 过滤模型列表
         const codexModelOptions = codexCfg.modelOptions(currentModelProvider);
         fields.push({
             key: 'agents.codex.modelProvider',
@@ -42,7 +40,7 @@ export class CodexConfigBuilder {
             label: '推理强度',
             type: 'select',
             // 档位按目录实际声明透传（P2-5）：codex 支持 none/Custom，不再按标准枚举过滤
-            options: getReasoningEffortOptions(currentCodexModel, codexBinary),
+            options: getReasoningEffortOptions(currentCodexModel),
             currentValue: currentReasoningEffort,
         });
         return fields;
@@ -50,10 +48,9 @@ export class CodexConfigBuilder {
     handleFieldChange(key, value, config) {
         const patches = [];
         patches.push({ key, value });
-        // provider 变更时，重置 model 为�� provider 的首个模型
+        // provider 变更时，重置 model 为新 provider 的首个模型
         if (key === 'agents.codex.modelProvider' && typeof value === 'string') {
-            const codexBinary = config.agents?.codex?.binary ?? 'codex';
-            const codexCfg = loadCodexConfig({ binary: codexBinary });
+            const codexCfg = loadCodexConfig();
             const newModelOptions = codexCfg.modelOptions(value);
             const currentModel = config.agents?.codex?.model;
             const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
@@ -86,14 +83,13 @@ export class CodexConfigBuilder {
      *   对 undefined 做键删除，P1）。
      */
     effortPatchForModel(config, newModel) {
-        const codexBinary = config.agents?.codex?.binary ?? 'codex';
         const currentReasoningEffort = config.agents?.codex?.reasoningEffort;
-        const newModelSupportedEfforts = getReasoningEffortOptions(newModel, codexBinary);
+        const newModelSupportedEfforts = getReasoningEffortOptions(newModel);
         const isCurrentEffortValid = currentReasoningEffort && newModelSupportedEfforts.includes(currentReasoningEffort);
         if (isCurrentEffortValid)
             return null;
         const middle = newModelSupportedEfforts[Math.floor((newModelSupportedEfforts.length - 1) / 2)];
-        const newEffort = middle ?? getDefaultReasoningEffort(newModel, codexBinary);
+        const newEffort = middle ?? getDefaultReasoningEffort(newModel);
         return { key: 'agents.codex.reasoningEffort', value: newEffort };
     }
 }

package/dist/router/index.d.ts

@@ -73,6 +73,8 @@ interface CardActionResponse {
     [key: string]: unknown;
 }
 export declare class CommandRouter {
+    /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
+    static readonly VALID_AGENTS: readonly ["claude", "codex", "opencode", "pi", "kimi"];
     private sessionStore;
     private bridge;
     private config;
@@ -187,6 +189,11 @@ export declare class CommandRouter {
      * Mirrors handleLsPage — updates the same card, never sends a new one.
      */
     private handleResumePage;
+    /**
+     * Handle active.page: paginate the /active run list in place.
+     * Mirrors handleResumePage — updates the same card, never sends a new one.
+     */
+    private handleActivePage;
     /**
      * Handle ls.browse: browse directory without switching cwd.
      */
@@ -223,6 +230,11 @@ export declare class CommandRouter {
      * Handle order.delete: remove the order and update card in place.
      */
     private handleOrderDelete;
+    /**
+     * Handle order.page: paginate the /order list in place.
+     * Mirrors handleLsPage — updates the same card, never sends a new one.
+     */
+    private handleOrderPage;
     /**
      * Handle ws.remove: remove the workspace alias and refresh the /ws list card
      * in place (mirrors handleOrderDelete). Without this the stale alias would
@@ -273,7 +285,7 @@ export declare class CommandRouter {
      */
     private propagateConfigSave;
     private executeCommand;
-    private cmdHelp;
+    cmdHelp(): CommandResult;
     private cmdStatus;
     private cmdPs;
     private cmdStop;
@@ -307,6 +319,7 @@ export declare class CommandRouter {
     /**
      * Build CardKit 2.0 /active card from bridge memory (not file system).
      * Shows only runs that were started by THIS bridge process.
+     * Paginates with ACTIVE_PAGE_SIZE (default 20) items per page.
      */
     private buildActiveCardFromMemory;
     private cmdReconnect;

package/dist/router/index.js

@@ -13,6 +13,7 @@ import { MAX_FILE_UPLOAD_SIZE } from '../connector/file-limits.js';
 import { atomicWrite } from '../persistence/atomic-write.js';
 /** Config card builder - delegates to per-agent builders */
 import { getConfigBuilder, listRegisteredAgents } from './config/index.js';
+import { probeAllAgents, getCachedAvailability } from '../runner/probe.js';
 import { buildConfigCardFromTabs } from './config/common/render.js';
 /** Max events to read for auto-resume and /resume cards.
  * Limits events at the read stage so enforceCardBudget rarely needs to truncate.
@@ -20,6 +21,10 @@ import { buildConfigCardFromTabs } from './config/common/render.js';
 const AUTO_RESUME_MAX_EVENTS = 5;
 /** /resume 列表页大小；`/resume [N]` 的 N clamp 到 [1, RESUME_PAGE_SIZE]。 */
 const RESUME_PAGE_SIZE = 5;
+/** /active 卡片每页显示的最大条目数（agent run + bash run 合计）。 */
+const ACTIVE_PAGE_SIZE = 20;
+/** /order 列表页大小；指令超过此数量时显示分页导航栏。 */
+const ORDER_PAGE_SIZE = 20;
 /** /resume 列表页内全量预取（readSessionContent）的行数上限；其余行用轻量 summary 兜底。 */
 const RESUME_CONTENT_PREFETCH = 5;
 /**
@@ -61,6 +66,7 @@ export function isImmediateAction(cmd) {
         cmd === 'ls.switch' ||
         cmd === 'ls.page' ||
         cmd === 'resume.page' || // control operation: paginate only, never spawns claude
+        cmd === 'active.page' || // control operation: paginate active card
         cmd === 'ws.remove' ||
         cmd === 'resume.use' ||
         cmd === 'ws.use' ||
@@ -70,12 +76,15 @@ export function isImmediateAction(cmd) {
         cmd === 'queue.edit' ||
         cmd === 'queue.input' ||
         cmd === 'order.delete' ||
+        cmd === 'order.page' ||
         cmd === 'config.toggle' ||
         cmd === 'config.set' ||
         cmd === 'config.input' ||
         cmd === 'config.save');
 }
 export class CommandRouter {
+    /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
+    static VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
     sessionStore;
     bridge;
     config;
@@ -200,10 +209,10 @@ export class CommandRouter {
             case 'ws.remove':
                 return await this.handleWsRemove(value, ctx);
             case 'resume.use': {
-                // resume.use can carry an agent field when called from /resume [agent] list
+                // resume.use carries an agent field from /resume [agent] list cards
+                // (both active and completed cards include the agent field).
                 const resumeAgent = value.agent ?? this.config.defaultAgent;
-                // Validate agent is a valid type
-                const validAgents = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+                const validAgents = CommandRouter.VALID_AGENTS;
                 const resolvedAgent = validAgents.includes(resumeAgent)
                     ? resumeAgent
                     : this.config.defaultAgent;
@@ -226,6 +235,8 @@ export class CommandRouter {
             }
             case 'resume.page':
                 return this.handleResumePage(value, ctx);
+            case 'active.page':
+                return this.handleActivePage(value, ctx);
             case 'new-session':
                 this.sessionStore.clearSessionId(ctx.userId, this.config.defaultAgent, {
                     clearSessionCwd: true,
@@ -260,6 +271,8 @@ export class CommandRouter {
                 return await this.handleQueueInput(value, ctx);
             case 'order.delete':
                 return await this.handleOrderDelete(value, ctx);
+            case 'order.page':
+                return await this.handleOrderPage(value, ctx);
             case 'config.toggle':
             case 'config.set':
             case 'config.input':
@@ -633,9 +646,11 @@ export class CommandRouter {
         const inputTask = this.bridge.getQueuedTask(workspace, messageId);
         if (!inputTask) {
             // Task already left the queue (began or was cancelled) before we could
-            // register the replacement. The user must be told the edit failed.
-            await this.bridge.sendResult({ text: '⚠️ 任务已不在队列中（可能已开始执行或被撤销）' }, ctx);
-            return;
+            // register the replacement. Return a toast so the edit-form card gets
+            // dismissed — sendResult alone leaves the card stuck in the edit state
+            // (Feishu keeps the pre-click card when the callback response has no
+            // toast/card field).
+            return { toast: { type: 'info', content: '任务已不在队列中（可能已开始执行或被撤销）' } };
         }
         this.bridge.setTaskReplacement(workspace, messageId, async () => {
             await this.handle(newMessage, ctx, { cwdOverride: workspace, binding: inputTask.binding });
@@ -767,8 +782,7 @@ export class CommandRouter {
      */
     async handleResumePage(value, ctx) {
         const resumeAgent = value.agent ?? this.config.defaultAgent;
-        // Validate agent is a valid type (same as resume.use); fall back to default.
-        const validAgents = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+        const validAgents = CommandRouter.VALID_AGENTS;
         const resolvedAgent = validAgents.includes(resumeAgent)
             ? resumeAgent
             : this.config.defaultAgent;
@@ -804,6 +818,21 @@ export class CommandRouter {
         await this.bridge.updateCardInPlace(result.card, ctx);
         return { toast: { type: 'success', content: '' } };
     }
+    /**
+     * Handle active.page: paginate the /active run list in place.
+     * Mirrors handleResumePage — updates the same card, never sends a new one.
+     */
+    async handleActivePage(value, ctx) {
+        const rawOffset = Number(value.offset);
+        const offset = Number.isFinite(rawOffset) ? Math.max(0, Math.trunc(rawOffset)) : 0;
+        const alignedOffset = Math.floor(offset / ACTIVE_PAGE_SIZE) * ACTIVE_PAGE_SIZE;
+        const result = this.cmdActive([], ctx, alignedOffset);
+        if (!result.card) {
+            return { toast: { type: 'error', content: '当前没有正在进行中的任务' } };
+        }
+        await this.bridge.updateCardInPlace(result.card, ctx);
+        return { toast: { type: 'success', content: '' } };
+    }
     /**
      * Handle ls.browse: browse directory without switching cwd.
      */
@@ -886,11 +915,23 @@ export class CommandRouter {
         }
         // Delete the order
         this.orderStore.remove(orderId);
-        // Refresh the order list and update card in place
-        const result = this.cmdOrder([], ctx);
+        // Refresh the order list and update card in place, preserving current page
+        const currentOffset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        const result = this.cmdOrder([], ctx, currentOffset);
         await this.bridge.updateCardInPlace(result.card, ctx);
         return { toast: { type: 'success', content: '已删除指令' } };
     }
+    /**
+     * Handle order.page: paginate the /order list in place.
+     * Mirrors handleLsPage — updates the same card, never sends a new one.
+     */
+    async handleOrderPage(value, ctx) {
+        const offset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        // cmdOrder internally clamps stale/out-of-range offsets
+        const result = this.cmdOrder([], ctx, offset);
+        await this.bridge.updateCardInPlace(result.card, ctx);
+        return { toast: { type: 'success', content: '' } };
+    }
     /**
      * Handle ws.remove: remove the workspace alias and refresh the /ws list card
      * in place (mirrors handleOrderDelete). Without this the stale alias would
@@ -1323,7 +1364,7 @@ export class CommandRouter {
                 return await this.cmdReconnect();
             case 'config':
             case 'c':
-                return this.cmdConfig(args, ctx);
+                return await this.cmdConfig(args, ctx);
             case 'order':
             case 'o':
                 return this.cmdOrder(args, ctx);
@@ -2115,7 +2156,7 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         const entry = this.sessionStore.get(ctx.userId);
         const cwd = entry?.cwd;
         // Valid agent kinds for the /resume [agent] [N] feature
-        const VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+        const VALID_AGENTS = CommandRouter.VALID_AGENTS;
         // Parse arguments: /resume [agent] [N] or /resume [sessionId] or /resume [agent] [sessionId]
         let agentKind = this.config.defaultAgent;
         let limit;
@@ -2470,7 +2511,7 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         };
         return { card };
     }
-    cmdActive(_args, _ctx) {
+    cmdActive(_args, _ctx, offset = 0) {
         // List all active runs from bridge memory (not from file system scan)
         // New semantics (2026-07-20): only shows runs started by THIS bridge process
         const activeRuns = this.bridge.getActiveRuns();
@@ -2479,18 +2520,40 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
             return { text: '当前没有正在进行中的任务' };
         }
         // Build CardKit 2.0 card showing memory-based active runs
-        return this.buildActiveCardFromMemory(activeRuns, activeBashRuns);
+        return this.buildActiveCardFromMemory(activeRuns, activeBashRuns, offset);
     }
     /**
      * Build CardKit 2.0 /active card from bridge memory (not file system).
      * Shows only runs that were started by THIS bridge process.
+     * Paginates with ACTIVE_PAGE_SIZE (default 20) items per page.
      */
-    buildActiveCardFromMemory(activeRuns, activeBashRuns) {
+    buildActiveCardFromMemory(activeRuns, activeBashRuns, offset = 0) {
+        const totalCount = activeRuns.length + activeBashRuns.length;
+        const pageSize = ACTIVE_PAGE_SIZE;
+        const safeOffset = Math.max(0, Math.min(offset, Math.max(0, totalCount - 1)));
+        const totalPages = Math.max(1, Math.ceil(totalCount / pageSize));
+        const currentPage = Math.floor(safeOffset / pageSize) + 1;
+        // Slice: distribute offset across agent runs first, then bash runs
         const elements = [];
+        // Page info
+        if (totalPages > 1) {
+            elements.push({
+                tag: 'div',
+                text: {
+                    tag: 'lark_md',
+                    content: `**第 ${currentPage}/${totalPages} 页** （共 ${totalCount} 项）`,
+                },
+            });
+        }
+        let remaining = pageSize;
+        let skipped = safeOffset;
         // Agent runs section
-        if (activeRuns.length > 0) {
+        if (activeRuns.length > 0 && skipped < activeRuns.length && remaining > 0) {
             elements.push({ tag: 'div', text: { tag: 'lark_md', content: '## 🤖 Agent 任务' } });
-            for (const run of activeRuns) {
+            const start = skipped;
+            const end = Math.min(start + remaining, activeRuns.length);
+            for (let i = start; i < end; i++) {
+                const run = activeRuns[i];
                 const statusLabel = run.terminal === 'running' ? '运行中' : '处理中';
                 elements.push({
                     tag: 'div',
@@ -2513,11 +2576,19 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 });
                 elements.push({ tag: 'hr' });
             }
+            remaining -= end - start;
+            skipped = 0;
+        }
+        else {
+            skipped -= activeRuns.length;
         }
         // Bash runs section
-        if (activeBashRuns.length > 0) {
+        if (activeBashRuns.length > 0 && skipped < activeBashRuns.length && remaining > 0) {
             elements.push({ tag: 'div', text: { tag: 'lark_md', content: '## 💻 Bash 命令' } });
-            for (const run of activeBashRuns) {
+            const start = skipped;
+            const end = Math.min(start + remaining, activeBashRuns.length);
+            for (let i = start; i < end; i++) {
+                const run = activeBashRuns[i];
                 const statusLabel = run.terminal === 'running' ? '运行中' : '处理中';
                 elements.push({
                     tag: 'div',
@@ -2538,6 +2609,38 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 elements.push({ tag: 'hr' });
             }
         }
+        // Pagination buttons
+        if (totalPages > 1) {
+            const paginationButtons = [];
+            if (currentPage > 1) {
+                const prevOffset = (currentPage - 2) * pageSize;
+                paginationButtons.push({
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '◀ 上一页' },
+                    type: 'default',
+                    size: 'small',
+                    behaviors: [{ type: 'callback', value: { cmd: 'active.page', offset: prevOffset } }],
+                });
+            }
+            if (currentPage < totalPages) {
+                const nextOffset = currentPage * pageSize;
+                paginationButtons.push({
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '下一页 ▶' },
+                    type: 'primary',
+                    size: 'small',
+                    behaviors: [{ type: 'callback', value: { cmd: 'active.page', offset: nextOffset } }],
+                });
+            }
+            elements.push({
+                tag: 'column_set',
+                columns: paginationButtons.map((btn) => ({
+                    tag: 'column',
+                    width: 'auto',
+                    elements: [btn],
+                })),
+            });
+        }
         const card = {
             schema: '2.0',
             config: { wide_screen_mode: true },
@@ -2558,7 +2661,9 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
             return { text: '重连失败，请检查网络和配置' };
         }
     }
-    cmdConfig(args, ctx) {
+    async cmdConfig(args, ctx) {
+        // Ensure probe cache is populated before building the card.
+        await probeAllAgents();
         // Check if this is a direct set command: /config <key> <value>
         // Command-style set: immediate write to disk, clear pendingConfig
         if (args.length >= 2) {
@@ -2604,25 +2709,58 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         // 使用 pendingConfig（若存在）或当前 config
         const displayConfig = this.pendingConfig ?? this.config;
         // 定义字段分组：defaultAgent 选择器 + 该 agent 的配置字段 + idle.watchdogMinutes +
-        // output/logging。stopGraceMs / claude.binary 等实现细节走 YAML，不在卡片暴露。
+        // output/logging。stopGraceMs 等实现细节走 YAML，不在卡片暴露。
         // 根据 defaultAgent 构建完整的 Agent 配置字段组
         // 使用 agent config builder 获取该 agent 的配置字段
         const defaultAgent = displayConfig.defaultAgent ?? 'claude';
         const configBuilder = getConfigBuilder(defaultAgent);
-        const agentConfigFields = configBuilder.buildFields(displayConfig);
-        // 使用共享渲染模块构建 tabs 和卡片
-        // 添加 defaultAgent 选择器作为第一个字段
-        agentConfigFields.unshift({
-            key: 'defaultAgent',
-            label: '默认 Agent',
-            type: 'select',
-            options: listRegisteredAgents(),
+        // Build defaultAgent selector with availability annotations.
+        // Direct inline construction (not via ConfigField) so that text (display label)
+        // and value (agentKind for config storage) can differ — uninstalled agents get
+        // a "⚠️ (未安装)" suffix in the label while the value stays clean.
+        const allAgents = listRegisteredAgents();
+        const agentOptions = allAgents.map((kind) => {
+            const available = getCachedAvailability(kind);
+            const label = available === false ? `${agentDisplayName(kind)} ⚠️ (未安装)` : agentDisplayName(kind);
+            return { text: { tag: 'plain_text', content: label }, value: kind };
         });
+        const selectedAgent = displayConfig.defaultAgent ?? 'claude';
+        const agentSelector = {
+            tag: 'column_set',
+            flex_mode: 'none',
+            columns: [
+                {
+                    tag: 'column',
+                    width: 'weighted',
+                    weight: 2,
+                    vertical_align: 'center',
+                    elements: [{ tag: 'div', text: { tag: 'lark_md', content: '默认 Agent' } }],
+                },
+                {
+                    tag: 'column',
+                    width: 'weighted',
+                    weight: 3,
+                    vertical_align: 'center',
+                    elements: [
+                        {
+                            tag: 'select_static',
+                            placeholder: { tag: 'plain_text', content: '请选择' },
+                            options: agentOptions,
+                            initial_option: selectedAgent,
+                            behaviors: [{ type: 'callback', value: { cmd: 'config.set', key: 'defaultAgent' } }],
+                        },
+                    ],
+                },
+            ],
+        };
+        // Agent config fields — no longer include defaultAgent as a ConfigField
+        // (it's rendered inline above with text/value separation).
+        const agentConfigFieldsNoSelector = configBuilder.buildFields(displayConfig);
         const tabs = [
             {
                 id: 'agent',
                 label: `🤖 ${agentDisplayName(defaultAgent)}`,
-                fields: agentConfigFields,
+                fields: agentConfigFieldsNoSelector,
             },
             {
                 id: 'idle',
@@ -2653,11 +2791,30 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         ];
         // 使用共享渲染模块构建卡片
         const card = buildConfigCardFromTabs(tabs, displayConfig);
+        // Inject the agent selector as the first element in the agent tab section,
+        // right after the "**🤖 ..." header, so text/value can differ for uninstalled agents.
+        // NOTE: findIndex relies on the agent tab header starting with "**🤖" — if the
+        // tab label format changes, this fallback will fire and the selector moves to top.
+        const body = card.body;
+        if (body && Array.isArray(body.elements)) {
+            const headerIdx = body.elements.findIndex((el) => typeof el === 'object' &&
+                el !== null &&
+                el.tag === 'div' &&
+                el.text?.tag === 'lark_md' &&
+                (el.text?.content ?? '').startsWith('**🤖'));
+            if (headerIdx >= 0) {
+                body.elements.splice(headerIdx + 1, 0, agentSelector);
+            }
+            else {
+                getLogger().warn('[buildConfigCard] agent tab header not found, falling back to unshift');
+                body.elements.unshift(agentSelector);
+            }
+        }
         return { card };
     }
-    cmdOrder(args, _ctx) {
+    cmdOrder(args, _ctx, offset = 0) {
         const sub = args[0]?.toLowerCase();
-        // /order — list orders (simple CardKit 2.0 list, no tabs)
+        // /order — list orders (CardKit 2.0 with pagination)
         if (!sub || sub === 'list') {
             this.orderStore.reload();
             const allOrders = this.orderStore.get();
@@ -2666,8 +2823,17 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 elements.push({ tag: 'div', text: { tag: 'lark_md', content: '暂无指令' } });
             }
             else {
-                for (let i = 0; i < allOrders.length; i++) {
-                    const order = allOrders[i];
+                // Pagination calculations
+                const totalCount = allOrders.length;
+                const totalPages = Math.max(1, Math.ceil(totalCount / ORDER_PAGE_SIZE));
+                // Clamp offset to last page boundary to avoid empty pages
+                const maxOffset = Math.max(0, (totalPages - 1) * ORDER_PAGE_SIZE);
+                const safeOffset = Math.min(Math.max(offset, 0), maxOffset);
+                const currentPage = Math.floor(safeOffset / ORDER_PAGE_SIZE) + 1;
+                const pageOrders = allOrders.slice(safeOffset, safeOffset + ORDER_PAGE_SIZE);
+                const hasPagination = totalCount > ORDER_PAGE_SIZE;
+                for (let i = 0; i < pageOrders.length; i++) {
+                    const order = pageOrders[i];
                     const displayText = order.text.length > 100 ? order.text.slice(0, 97) + '...' : order.text;
                     // 文字在上方
                     elements.push({ tag: 'div', text: { tag: 'lark_md', content: displayText } });
@@ -2700,7 +2866,10 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                                         type: 'danger',
                                         size: 'small',
                                         behaviors: [
-                                            { type: 'callback', value: { cmd: 'order.delete', orderId: order.id } },
+                                            {
+                                                type: 'callback',
+                                                value: { cmd: 'order.delete', orderId: order.id, offset: safeOffset },
+                                            },
                                         ],
                                     },
                                 ],
@@ -2708,10 +2877,81 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                         ],
                     });
                     // 非最后一项，添加分隔线
-                    if (i < allOrders.length - 1) {
+                    if (i < pageOrders.length - 1) {
                         elements.push({ tag: 'hr' });
                     }
                 }
+                // Pagination bar (only shown when there are more items than ORDER_PAGE_SIZE)
+                if (hasPagination) {
+                    const hasPrev = safeOffset > 0;
+                    const hasNext = safeOffset + ORDER_PAGE_SIZE < totalCount;
+                    const pageColumns = [];
+                    if (hasPrev) {
+                        pageColumns.push({
+                            tag: 'column',
+                            width: 'auto',
+                            vertical_align: 'center',
+                            elements: [
+                                {
+                                    tag: 'button',
+                                    text: { tag: 'plain_text', content: '⬅ 上一页' },
+                                    type: 'default',
+                                    size: 'small',
+                                    behaviors: [
+                                        {
+                                            type: 'callback',
+                                            value: {
+                                                cmd: 'order.page',
+                                                offset: safeOffset - ORDER_PAGE_SIZE,
+                                            },
+                                        },
+                                    ],
+                                },
+                            ],
+                        });
+                    }
+                    pageColumns.push({
+                        tag: 'column',
+                        width: 'weighted',
+                        weight: 1,
+                        vertical_align: 'center',
+                        elements: [
+                            {
+                                tag: 'div',
+                                text: {
+                                    tag: 'lark_md',
+                                    content: `**第 ${currentPage}/${totalPages} 页**（共 ${totalCount} 条）`,
+                                },
+                            },
+                        ],
+                    });
+                    if (hasNext) {
+                        pageColumns.push({
+                            tag: 'column',
+                            width: 'auto',
+                            vertical_align: 'center',
+                            elements: [
+                                {
+                                    tag: 'button',
+                                    text: { tag: 'plain_text', content: '下一页 ➡' },
+                                    type: 'default',
+                                    size: 'small',
+                                    behaviors: [
+                                        {
+                                            type: 'callback',
+                                            value: {
+                                                cmd: 'order.page',
+                                                offset: safeOffset + ORDER_PAGE_SIZE,
+                                            },
+                                        },
+                                    ],
+                                },
+                            ],
+                        });
+                    }
+                    elements.push({ tag: 'hr' });
+                    elements.push({ tag: 'column_set', columns: pageColumns });
+                }
             }
             return {
                 card: {

package/dist/router/utils.d.ts

@@ -5,6 +5,8 @@
 import type { ActiveRunSnapshot } from '../bridge/index.js';
 export interface SessionDisplayUsage {
     contextLength?: number;
+    /** 当前模型 context window 上限（仅 codex 提供）；用于渲染 "Context - X (Y%)"。 */
+    contextLimit?: number;
     compactCount?: number;
     cacheReadTokens?: number;
     cacheCreationTokens?: number;
@@ -18,6 +20,7 @@ export declare function activeRunUsage(activeRun: ActiveRunSnapshot | undefined)
  */
 export declare function formatUsageStats(usage?: {
     contextLength?: number;
+    contextLimit?: number;
     compactCount?: number;
     cacheReadTokens?: number;
     cacheCreationTokens?: number;

package/dist/router/utils.js

@@ -14,10 +14,18 @@ export function activeRunUsage(activeRun) {
 }
 // --- Extracted helpers for refactoring ---
 /**
- * Format number to K unit string, rounding to the nearest integer K
- * (e.g., 120000 → 120K, 1500 → 2K, 1950 → 2K). Values < 1000 are returned as-is.
+ * Format number to human-readable unit string.
+ * - >= 1M: one decimal, M suffix (e.g., 1200000 → 1.2M, 25000000 → 25M)
+ * - >= 1K: rounded to nearest integer K (e.g., 1500 → 2K, 120000 → 120K)
+ * - < 1K: as-is (e.g., 500 → "500")
  */
 function formatTokenK(n) {
+    if (n >= 1_000_000) {
+        const m = n / 1_000_000;
+        const rounded = Math.round(m * 10) / 10;
+        // Drop unnecessary ".0" for whole numbers (2.0M → 2M)
+        return rounded === Math.floor(rounded) ? `${Math.floor(rounded)}M` : `${rounded}M`;
+    }
     if (n >= 1000) {
         const k = Math.round(n / 1000);
         return `${k}K`;
@@ -40,7 +48,11 @@ export function formatUsageStats(usage, options) {
     }
     // 2. Context 长度
     if (usage?.contextLength !== undefined) {
-        lines.push(`Context - ${formatTokenK(usage.contextLength)}`);
+        const ctxLimit = usage.contextLimit;
+        const ctxPercent = ctxLimit !== undefined && ctxLimit > 0
+            ? ` (${Math.round((usage.contextLength / ctxLimit) * 100)}%)`
+            : '';
+        lines.push(`Context - ${formatTokenK(usage.contextLength)}${ctxPercent}`);
     }
     // 3. Compact 次数
     if (usage?.compactCount) {