lark-remote 0.1.7 → 0.1.9

package/dist/router/index.js

@@ -2,11 +2,10 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import YAML from 'yaml';
-import { getConfigDir, getConfigValue, setConfigValue, setConfigValues, mapAgentKey, assertSafeKeyPart, walkNestedContainer, } from '../config/index.js';
+import { getConfigDir, getConfigValue, setConfigValue, setConfigValues, mapAgentKey, assertSafeKeyPart, walkNestedContainer, getAgentConfig, } from '../config/index.js';
 import { syncAgentChoices } from '../runner/index.js';
 import { WorkspaceStore } from '../workspace/index.js';
 import { OrderStore } from '../order/index.js';
-import { AliasStore } from '../order/alias-store.js';
 import { resolveAlias } from '../order/alias-resolve.js';
 import { getLogger } from '../logger/index.js';
 import { activeRunUsage, clampInt } from './utils.js';
@@ -31,8 +30,11 @@ const ACTIVE_PAGE_SIZE = 20;
  * 2026-08-13 实测：每行 2 个元素（div + column_set，行间 hr），20 行 + 分页栏
  * = 61 个 body 元素，触发飞书 ErrCode 11310 "element exceeds the limit"
  * （21+ 条指令时第 1 页必炸）。改为 15 行：3*15 - 1 + 2 = 46 个元素，留足余量。
+ * 2026-08-19 别名并卡后每行变 3 个元素（文本 div + 操作 column_set + hr），
+ * 从 15 降为 8：3*8 - 1 + 2 = 25 个元素，仍在余量内，同时保证手机窄屏
+ * 每条指令的操作控件（执行/别名/删除）不被挤压。
  */
-const ORDER_PAGE_SIZE = 15;
+const ORDER_PAGE_SIZE = 8;
 /**
  * /ws 列表页大小。从 15 降为 5：头部 2 + 5 行 × 3（div + column_set + hr）+
  * 底栏排序 1 + 分页栏 2 ≈ 20 个 body 元素，远低于单卡 60 元素上限（ErrCode 11310），
@@ -110,6 +112,9 @@ export function isImmediateAction(cmd) {
         cmd === 'queue.input' ||
         cmd === 'order.delete' ||
         cmd === 'order.page' ||
+        cmd === 'order.aliasEdit' ||
+        cmd === 'order.aliasInput' ||
+        cmd === 'order.aliasRemove' ||
         cmd === 'config.toggle' ||
         cmd === 'config.set' ||
         cmd === 'config.input' ||
@@ -121,11 +126,13 @@ export function isImmediateAction(cmd) {
         cmd === 'approval.toggle' ||
         cmd === 'approval.answer' ||
         cmd === 'approval.answerSubmit' ||
-        cmd === 'approval.answerCustom');
+        cmd === 'approval.answerCustom' ||
+        cmd === 'approval.answerNote' ||
+        cmd === 'approval.planFeedback');
 }
 export class CommandRouter {
     /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
-    static VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+    static VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi', 'dsh'];
     sessionStore;
     /** 飞书桥接实例（public：测试直接访问断言，替代 as unknown as）。 */
     bridge;
@@ -135,7 +142,6 @@ export class CommandRouter {
     configPath;
     workspaceStore;
     orderStore;
-    aliasStore;
     exitHandler;
     pendingExit = false;
     /**
@@ -190,7 +196,6 @@ export class CommandRouter {
         this.configPath = opts.configPath;
         this.workspaceStore = new WorkspaceStore(opts.workspacePath);
         this.orderStore = new OrderStore(opts.ordersPath);
-        this.aliasStore = new AliasStore(opts.aliasesPath);
         this.exitHandler = opts.exitHandler ?? (() => process.exit(0));
         this.restartSpawner = opts.restartSpawner;
         // idle watchdog 窗口从 config.idle.watchdogMinutes 读取
@@ -254,9 +259,14 @@ export class CommandRouter {
     /**
      * 一次别名展开：bridge 收到用户消息后、命令分发前调用。
      * 仅 `$name` 开头的消息可能被展开；未知别名 / 非 `$` 消息原样返回。
+     * 别名来自 order 的 `alias` 字段（1 条指令 = 1 个别名），展开文本即指令文本。
      */
     expandAliasMessage(message) {
-        return resolveAlias(message, this.aliasStore.list()) ?? message;
+        const entries = this.orderStore
+            .get()
+            .filter((o) => typeof o.alias === 'string')
+            .map((o) => ({ name: o.alias, text: o.text }));
+        return resolveAlias(message, entries) ?? message;
     }
     /**
      * Handle a CardKit card button click (§6.2).
@@ -351,6 +361,12 @@ export class CommandRouter {
                 return await this.handleOrderDelete(value, ctx);
             case 'order.page':
                 return await this.handleOrderPage(value, ctx);
+            case 'order.aliasEdit':
+                return await this.handleOrderAliasEdit(value, ctx);
+            case 'order.aliasInput':
+                return await this.handleOrderAliasInput(value, ctx);
+            case 'order.aliasRemove':
+                return await this.handleOrderAliasRemove(value, ctx);
             case 'config.toggle':
             case 'config.set':
             case 'config.input':
@@ -365,6 +381,8 @@ export class CommandRouter {
             case 'approval.answer':
             case 'approval.answerSubmit':
             case 'approval.answerCustom':
+            case 'approval.answerNote':
+            case 'approval.planFeedback':
                 return this.handleApprovalAction(value, ctx);
             case 'codex.compact':
                 await this.bridge.handleCodexCompact(value, ctx);
@@ -403,6 +421,14 @@ export class CommandRouter {
      * Routes to the appropriate bridge method based on value.cmd.
      * Returns a toast response for immediate user feedback.
      */
+    /** 答案类操作的统一失败反馈：重复投递（同一 nonce 第二次点击）是已生效的
+     *  中性事件，报 error 会误导（首次点击实际已成功）。 */
+    answerFailureToast(msg) {
+        if (/already submitted \(duplicate nonce\)/.test(msg)) {
+            return { toast: { type: 'info', content: '该选项已处理，请勿重复点击' } };
+        }
+        return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+    }
     async handleApprovalAction(value, _ctx) {
         const { runId, requestId, decision, nonce, permId } = value;
         if (value.cmd === 'approval.respond') {
@@ -465,7 +491,7 @@ export class CommandRouter {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+                return this.answerFailureToast(msg);
             }
         }
         if (value.cmd === 'approval.answerSubmit') {
@@ -483,7 +509,7 @@ export class CommandRouter {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+                return this.answerFailureToast(msg);
             }
         }
         if (value.cmd === 'approval.answerCustom') {
@@ -506,7 +532,48 @@ export class CommandRouter {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                return { toast: { type: 'error', content: `答案提交失败：${msg}` } };
+                return this.answerFailureToast(msg);
+            }
+        }
+        if (value.cmd === 'approval.answerNote') {
+            if (!runId ||
+                requestId === undefined ||
+                value.questionIndex === undefined ||
+                !nonce ||
+                !value.inputValue) {
+                return { toast: { type: 'error', content: '缺少补充说明参数' } };
+            }
+            try {
+                await this.bridge.handleApprovalAnswerNote({
+                    runId,
+                    requestId,
+                    questionIndex: value.questionIndex,
+                    text: value.inputValue,
+                    nonce,
+                });
+                return { toast: { type: 'success', content: '补充说明已保存' } };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return this.answerFailureToast(msg);
+            }
+        }
+        if (value.cmd === 'approval.planFeedback') {
+            if (!runId || requestId === undefined || !nonce || !value.inputValue) {
+                return { toast: { type: 'error', content: '缺少修改意见参数' } };
+            }
+            try {
+                await this.bridge.handleApprovalPlanFeedback({
+                    runId,
+                    requestId,
+                    text: value.inputValue,
+                    nonce,
+                });
+                return { toast: { type: 'success', content: '修改意见已保存' } };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { toast: { type: 'error', content: `修改意见保存失败：${msg}` } };
             }
         }
         return { toast: { type: 'error', content: '未知的审批操作' } };
@@ -1124,6 +1191,136 @@ export class CommandRouter {
         await this.bridge.updateCardInPlace(result.card, ctx);
         return { toast: { type: 'success', content: '' } };
     }
+    /**
+     * Handle order.aliasEdit: 展示别名编辑卡（input + ✓ 提交图标）。
+     * 有别名时预填；提交 `order.aliasInput` 处理（含校验与唯一性）。
+     */
+    async handleOrderAliasEdit(value, ctx) {
+        const orderId = value.orderId;
+        const offset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        if (!orderId) {
+            return { toast: { type: 'error', content: '卡片 payload 缺少必要信息' } };
+        }
+        this.orderStore.reload();
+        const order = this.orderStore.get().find((o) => o.id === orderId);
+        if (!order) {
+            return { toast: { type: 'error', content: '指令不存在或已被删除' } };
+        }
+        const displayText = order.text.length > 100 ? order.text.slice(0, 97) + '...' : order.text;
+        // CardKit 2.0 input 自带 ✓ 提交图标（input_value 经 raw 回传，红线）。
+        // 不用 form 容器（触发 300123 无 submit button / 200621 嵌套 column）。
+        const editCard = {
+            schema: '2.0',
+            config: { wide_screen_mode: true },
+            header: {
+                template: 'blue',
+                title: { tag: 'plain_text', content: '✏️ 给指令起别名' },
+            },
+            body: {
+                elements: [
+                    {
+                        tag: 'div',
+                        text: { tag: 'lark_md', content: `**当前指令:**\n\`${displayText}\`` },
+                    },
+                    { tag: 'hr' },
+                    {
+                        tag: 'div',
+                        text: {
+                            tag: 'lark_md',
+                            content: '💡 输入别名名后点击右侧 ✓ 提交；留空提交 = 删除该别名',
+                        },
+                    },
+                    {
+                        tag: 'column_set',
+                        columns: [
+                            {
+                                tag: 'column',
+                                width: 'weighted',
+                                weight: 3,
+                                elements: [
+                                    {
+                                        tag: 'input',
+                                        name: 'aliasName',
+                                        placeholder: { tag: 'plain_text', content: '输入 $别名名（如 all）...' },
+                                        default_value: order.alias ?? '',
+                                        behaviors: [
+                                            {
+                                                type: 'callback',
+                                                value: { cmd: 'order.aliasInput', orderId, offset },
+                                            },
+                                        ],
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        await this.bridge.updateCardInPlace(editCard, ctx);
+    }
+    /**
+     * Handle order.aliasInput: 提交别名（绑/改/解绑），随后重渲染 /order 列表卡。
+     * 留空 = 解绑；非空按命名规则 + 全局唯一校验，失败仅 toast 不重渲染。
+     */
+    async handleOrderAliasInput(value, ctx) {
+        const orderId = value.orderId;
+        const offset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        const name = value.inputValue ?? value.formValue?.['aliasName'];
+        if (!orderId) {
+            return { toast: { type: 'error', content: '卡片 payload 缺少必要信息' } };
+        }
+        this.orderStore.reload();
+        const order = this.orderStore.get().find((o) => o.id === orderId);
+        if (!order) {
+            return { toast: { type: 'error', content: '指令不存在或已被删除' } };
+        }
+        const trimmed = name?.trim() ?? '';
+        // 变更前快照旧别名：setAlias 会原地变异 order 对象（delete entry.alias），
+        // 删除后 order.alias 已为 undefined，直接用会让成功文案显示 `$undefined`。
+        const prevAlias = order.alias;
+        try {
+            this.orderStore.setAlias(order.id, trimmed === '' ? undefined : trimmed);
+        }
+        catch (err) {
+            return { toast: { type: 'error', content: err.message } };
+        }
+        // 成功：重渲染列表卡（保持页码）。必须把 card 放进 callback 响应体让飞书
+        // 原地替换 pre-click 编辑卡——toast-only 响应会停留在编辑界面（飞书保留
+        // 点击前那张卡），见 handleQueueInput 同款注释。
+        const result = this.cmdOrder([], ctx, offset);
+        return {
+            toast: {
+                type: 'success',
+                content: trimmed === '' ? `✅ 已移除别名 $${prevAlias ?? ''}` : `✅ 已绑定别名 $${trimmed}`,
+            },
+            card: { type: 'raw', data: result.card },
+        };
+    }
+    /** Handle order.aliasRemove: 删除某条指令的别名并原地重渲染列表卡。 */
+    async handleOrderAliasRemove(value, ctx) {
+        const orderId = value.orderId;
+        const offset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        if (!orderId) {
+            return { toast: { type: 'error', content: '卡片 payload 缺少必要信息' } };
+        }
+        this.orderStore.reload();
+        const order = this.orderStore.get().find((o) => o.id === orderId);
+        if (!order || !order.alias) {
+            return { toast: { type: 'error', content: '指令不存在或没有别名' } };
+        }
+        // 变更前快照旧别名：setAlias(undefined) 会原地变异 order（delete alias），
+        // 删除后 order.alias 已为 undefined，直接拼会让成功文案显示 `$undefined`。
+        const removedAlias = order.alias;
+        this.orderStore.setAlias(order.id, undefined);
+        // 必须把 card 放进 callback 响应体让飞书原地替换 pre-click 卡片，否则删除
+        // 后卡片停留在旧状态（别名视觉上未消失）。同 handleQueueInput 语义。
+        const result = this.cmdOrder([], ctx, offset);
+        return {
+            toast: { type: 'success', content: `✅ 已移除别名 $${removedAlias}` },
+            card: { type: 'raw', data: result.card },
+        };
+    }
     /**
      * Handle ws.use card action: switch to the workspace, then refresh the /ws
      * list card in place so "recent" sort order is immediately visible.
@@ -1144,7 +1341,7 @@ export class CommandRouter {
         // immediate action the callback response is swallowed by enqueueImmediate
         // (fire-and-forget), and even if delivered it is transient — the user gets
         // no perceivable feedback on the switch. Same rationale as config.save
-        // agent-switch notice (74e99f0): persistent message first, toast only as a
+        // agent-switch notice: persistent message first, toast only as a
         // fallback if sendResult fails.
         let fallbackToast;
         if (useResult.card || useResult.text) {
@@ -1377,6 +1574,8 @@ export class CommandRouter {
                     // 2026-08-03: 卡片刷新失败不吞切换通知——保存已成功，仅记录日志，
                     // 后续切换消息照常发送；真正写盘/传播阶段的失败才走外层 catch 报「保存失败」。
                     try {
+                        // host 可能已变更 → 重新预取 DSH 目录（内部按 host 缓存，未变不重复拉）
+                        await this.prefetchConfigCardCatalogs();
                         await this.bridge.updateCardInPlace(this.buildConfigCard().card, ctx);
                     }
                     catch (refreshErr) {
@@ -1553,6 +1752,38 @@ export class CommandRouter {
                 switchSessionId = '';
             }
         }
+        // DSH preset 变更 = 下次 run 新建 session（§4.3 D1）：
+        // preset 在 session 创建时固定，中途切换会被服务端拒绝（agent-preset-conflict）。
+        // 旧 sessionId 存入 previousSessions 停车位（可手动 /resume，但 /resume 会做
+        // preset 一致性校验），当前 sessionId 清空——下次 run 走 session.create 新建。
+        const hasDshPresetChange = Object.keys(updates).some((k) => k === 'agents.dsh.agentPreset');
+        // 已发生 agent 切换时（switchNotice 已设置）preset 分支跳过，避免覆盖切换 notice；
+        // 切换分支对 dsh 的 session 已做恢复/清空处理。
+        if (hasDshPresetChange && this.config.defaultAgent === 'dsh' && !switchNotice) {
+            const oldSessionId = this.sessionStore.getSessionId(ctx.userId, 'dsh');
+            if (oldSessionId) {
+                this.sessionStore.setPreviousSessionId(ctx.userId, 'dsh', oldSessionId);
+                this.sessionStore.clearSessionId(ctx.userId, 'dsh');
+                switchNotice = `DSH preset 已变更，旧会话已停放到恢复槽（可 /resume 校验后恢复），下次消息将新建会话`;
+            }
+            else {
+                switchNotice = `DSH preset 已变更，下次消息将新建会话`;
+            }
+        }
+        // DSH host 变更 = 换服务（CC-02）：旧 host 的 sessionId 发往新 host 是错的。
+        // 视为 session 边界，仿 preset 分支停车 + 清空当前 sessionId，下次 run 新建会话。
+        const hasDshHostChange = Object.keys(updates).some((k) => k === 'agents.dsh.host');
+        if (hasDshHostChange && this.config.defaultAgent === 'dsh' && !switchNotice) {
+            const oldSessionId = this.sessionStore.getSessionId(ctx.userId, 'dsh');
+            if (oldSessionId) {
+                this.sessionStore.setPreviousSessionId(ctx.userId, 'dsh', oldSessionId);
+                this.sessionStore.clearSessionId(ctx.userId, 'dsh');
+                switchNotice = `DSH host 已变更，旧会话已停放到恢复槽（可 /resume 校验后恢复），下次消息将新建会话`;
+            }
+            else {
+                switchNotice = `DSH host 已变更，下次消息将新建会话`;
+            }
+        }
         // 2026-07-13: 同步 agent 配置到 agentChoices（用于切换 agent 时恢复配置）
         const currentAgent = this.config.defaultAgent;
         const currentAgentConfigKey = `agents.${currentAgent}`;
@@ -1667,7 +1898,7 @@ export class CommandRouter {
             {
                 cmd: 'order',
                 label: '/order /o save|list',
-                desc: '收藏指令 /order save，快捷别名 /order alias',
+                desc: '收藏指令 /order save，指令可起别名（卡片上 ＋别名）',
             },
         ];
         const bodyElements = [];
@@ -1731,6 +1962,16 @@ export class CommandRouter {
                 content: '**快捷命令**\n`!<bash-command>` — 执行 bash 命令并流式输出到卡片',
             },
         });
+        // 快捷别名（$name）
+        bodyElements.push({ tag: 'hr' });
+        bodyElements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: '**快捷别名**\n`$<name>` — 触发已保存指令的别名（在 /order 卡片给指令起别名后生效），' +
+                    '如 `$all` 等价于执行「跑全量测试」。只匹配消息开头的 `$name`，`!`/`/` 开头不展开',
+            },
+        });
         // Agent 说明
         bodyElements.push({ tag: 'hr' });
         bodyElements.push({
@@ -2579,6 +2820,32 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
      * /resume 核心实现（public：handleResumePage / handle / resume.use 共用，
      * 也是测试的直接 seam，避免测试用 @ts-expect-error 摸私有方法）。
      */
+    /**
+     * DSH /resume preset 一致性校验：返回 mismatch 详情，或 undefined（一致/不可判定）。
+     *
+     * session 的 preset 在创建时固定（§2.1）。通过 listSessions 拿到目标 session 的
+     * agentPreset 与当前配置比对：不一致时不静默复用（返回提示），一致或查询失败
+     * （无法判定）时不阻断，避免 DSH 离线导致 /resume 完全不可用。
+     */
+    dshPresetMismatch(reader, sessionId, cwd) {
+        const currentPreset = this.config.agents?.dsh?.agentPreset;
+        if (!currentPreset)
+            return undefined; // 配置跟随服务端默认，无法判定 → 放行
+        let sessionPreset;
+        try {
+            const { sessions } = reader.listSessions(cwd, { limit: 100 });
+            sessionPreset = sessions.find((s) => s.sessionId === sessionId)?.agentPreset;
+        }
+        catch (err) {
+            getLogger().warn(`[router] dshPresetMismatch listSessions failed for ${sessionId}: ${err.message}`);
+            return undefined;
+        }
+        if (!sessionPreset)
+            return undefined; // 服务端未返回 preset → 无法判定，放行
+        if (sessionPreset === currentPreset)
+            return undefined;
+        return { sessionPreset, currentPreset };
+    }
     cmdResume(args, ctx, offset = 0) {
         const entry = this.sessionStore.get(ctx.userId);
         const cwd = entry?.cwd;
@@ -2625,6 +2892,19 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                     text: `未找到 session ${sessionIdArg}（当前目录: ${cwd}）。请确认该 session 属于此目录，或先 /cd 到正确目录。`,
                 };
             }
+            // DSH preset 一致性校验（§6 风险 1）：session 的 preset 在创建时固定，
+            // 若与当前配置不符，直接复用会让后续 run 报 agent-preset-conflict。
+            // 不静默复用——明确提示用户，由用户决定是否继续（配置里手动改/清 preset）。
+            if (agentKind === 'dsh' && this.config.defaultAgent === 'dsh') {
+                const presetMismatch = this.dshPresetMismatch(reader, sessionIdArg, cwd);
+                if (presetMismatch) {
+                    return {
+                        text: `⚠️ 该 DSH session 的 preset 是「${presetMismatch.sessionPreset}」，与当前配置「${presetMismatch.currentPreset}」不一致。\n` +
+                            `preset 在 session 创建时固定，无法中途切换（DSH 返回 agent-preset-conflict）。\n` +
+                            `继续恢复将在下次 run 失败。请在 /config 中把预设模式改回「${presetMismatch.sessionPreset}」后重试，或保持当前配置并发新消息新建会话。`,
+                    };
+                }
+            }
             // L3: 校验通过后才写入
             this.sessionStore.setSessionId(ctx.userId, agentKind, sessionIdArg, cwd);
             const { events: content, usage, isActive, aiTitle, recap, displayTitle, activeRunRunId, } = this.readSessionDisplayState(sessionIdArg, cwd, {
@@ -2984,6 +3264,8 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
     async cmdConfig(args, ctx) {
         // Ensure probe cache is populated before building the card.
         await probeAllAgents();
+        // 动态清单预取（DSH 模型/预设目录）：卡渲染前拉取，失败回退兜底清单
+        await this.prefetchConfigCardCatalogs();
         // Check if this is a direct set command: /config <key> <value>
         // Command-style set: immediate write to disk, clear pendingConfig
         if (args.length >= 2) {
@@ -3030,6 +3312,18 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         this.ensurePendingConfig();
         return this.buildConfigCard();
     }
+    /**
+     * DSH /config 卡片构建前异步预取模型/预设目录（§4.2 动态清单）。
+     * 只在 defaultAgent 为 dsh 时生效；其他 agent 无 prefetch 钩子直接跳过。
+     * 预取失败不阻断——DshConfigBuilder 内部已回退固定兜底清单。
+     */
+    async prefetchConfigCardCatalogs() {
+        if (this.config.defaultAgent !== 'dsh')
+            return;
+        const builder = getConfigBuilder('dsh');
+        const dshConf = getAgentConfig(this.config, 'dsh');
+        await builder.prefetch?.(dshConf?.host);
+    }
     /** Build an interactive config card with CardKit 2.0 tabs + batch save */
     buildConfigCard() {
         // 使用 pendingConfig（若存在）或当前 config
@@ -3143,11 +3437,9 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
     /** /order 实现（public：测试直接调用，替代 as unknown as）。 */
     cmdOrder(args, _ctx, offset = 0) {
         const sub = args[0]?.toLowerCase();
-        // /order — list orders + aliases (CardKit 2.0 with pagination)
-        // `/order alias`（无参数）也并入列表卡片。
-        if (!sub || sub === 'list' || (sub === 'alias' && !args[1])) {
+        // /order — list orders (CardKit 2.0 with pagination)
+        if (!sub || sub === 'list') {
             this.orderStore.reload();
-            this.aliasStore.reload();
             const allOrders = this.orderStore.get();
             const elements = [];
             if (allOrders.length === 0) {
@@ -3166,40 +3458,119 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 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 } });
-                    // 按钮在下方，一左一右
+                    // 文字在上方（有别名时用 `$name` 前缀标识触发词）
                     elements.push({
-                        tag: 'column_set',
-                        columns: [
+                        tag: 'div',
+                        text: {
+                            tag: 'lark_md',
+                            content: order.alias ? `\`$${order.alias}\` ${displayText}` : displayText,
+                        },
+                    });
+                    // 操作行：左侧别名按钮（无别名显示 ＋别名，有别名点击可改），
+                    // 右侧「删除指令」按钮。两列均 weighted 1:1，跨行对齐。
+                    const leftColumn = order.alias
+                        ? [
                             {
-                                tag: 'column',
-                                width: 'auto',
-                                elements: [
+                                tag: 'button',
+                                text: { tag: 'plain_text', content: `$${order.alias}` },
+                                type: 'default',
+                                size: 'small',
+                                behaviors: [
                                     {
-                                        tag: 'button',
-                                        text: { tag: 'plain_text', content: '▶ 执行' },
-                                        type: 'primary',
-                                        size: 'small',
-                                        behaviors: [
-                                            { type: 'callback', value: { cmd: 'order.exec', orderId: order.id } },
-                                        ],
+                                        type: 'callback',
+                                        value: { cmd: 'order.aliasEdit', orderId: order.id, offset: safeOffset },
+                                    },
+                                ],
+                            },
+                            {
+                                tag: 'button',
+                                text: { tag: 'plain_text', content: '✕' },
+                                type: 'default',
+                                size: 'small',
+                                behaviors: [
+                                    {
+                                        type: 'callback',
+                                        value: {
+                                            cmd: 'order.aliasRemove',
+                                            orderId: order.id,
+                                            aliasName: order.alias,
+                                            offset: safeOffset,
+                                        },
+                                    },
+                                ],
+                            },
+                        ]
+                        : [
+                            {
+                                tag: 'button',
+                                text: { tag: 'plain_text', content: '＋别名' },
+                                type: 'default',
+                                size: 'small',
+                                behaviors: [
+                                    {
+                                        type: 'callback',
+                                        value: { cmd: 'order.aliasEdit', orderId: order.id, offset: safeOffset },
                                     },
                                 ],
                             },
+                        ];
+                    elements.push({
+                        tag: 'column_set',
+                        columns: [
                             {
                                 tag: 'column',
-                                width: 'auto',
+                                width: 'weighted',
+                                weight: 1,
+                                elements: leftColumn,
+                            },
+                            {
+                                tag: 'column',
+                                width: 'weighted',
+                                weight: 1,
+                                vertical_align: 'center',
                                 elements: [
                                     {
-                                        tag: 'button',
-                                        text: { tag: 'plain_text', content: '删除' },
-                                        type: 'danger',
-                                        size: 'small',
-                                        behaviors: [
+                                        tag: 'column_set',
+                                        columns: [
                                             {
-                                                type: 'callback',
-                                                value: { cmd: 'order.delete', orderId: order.id, offset: safeOffset },
+                                                tag: 'column',
+                                                width: 'auto',
+                                                elements: [
+                                                    {
+                                                        tag: 'button',
+                                                        text: { tag: 'plain_text', content: '▶ 执行' },
+                                                        type: 'primary',
+                                                        size: 'small',
+                                                        behaviors: [
+                                                            {
+                                                                type: 'callback',
+                                                                value: { cmd: 'order.exec', orderId: order.id },
+                                                            },
+                                                        ],
+                                                    },
+                                                ],
+                                            },
+                                            {
+                                                tag: 'column',
+                                                width: 'auto',
+                                                elements: [
+                                                    {
+                                                        tag: 'button',
+                                                        text: { tag: 'plain_text', content: '删除' },
+                                                        type: 'danger',
+                                                        size: 'small',
+                                                        behaviors: [
+                                                            {
+                                                                type: 'callback',
+                                                                value: {
+                                                                    cmd: 'order.delete',
+                                                                    orderId: order.id,
+                                                                    offset: safeOffset,
+                                                                },
+                                                            },
+                                                        ],
+                                                    },
+                                                ],
                                             },
                                         ],
                                     },
@@ -3225,22 +3596,6 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                     elements.push(bar);
                 }
             }
-            // 别名区：并入 /order 卡片（`/order alias` 列出全部）。
-            const aliases = this.aliasStore.list();
-            if (aliases.length > 0) {
-                elements.push({ tag: 'hr' });
-                elements.push({
-                    tag: 'div',
-                    text: { tag: 'lark_md', content: '**⚡ 别名**（输入 $name 触发）' },
-                });
-                for (const alias of aliases) {
-                    const text = alias.text.length > 100 ? alias.text.slice(0, 97) + '...' : alias.text;
-                    elements.push({
-                        tag: 'div',
-                        text: { tag: 'lark_md', content: `$${alias.name} → ${text}` },
-                    });
-                }
-            }
             return {
                 card: {
                     schema: '2.0',
@@ -3250,46 +3605,34 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 },
             };
         }
-        // /order alias <name> <text> — 注册；/order alias <name> — 查看；/order alias remove <name> — 删除
+        // /order alias — CLI 别名管理（卡片是主入口，命令是备选）：
+        //   /order alias add <orderId|N> <name>   — 给某条指令绑定别名
+        //   /order alias rm <orderId|N>           — 移除某条指令的别名
+        //   /order alias list                     — 列出已绑定的别名（并入列表卡片）
         if (sub === 'alias') {
-            const name = args[1];
-            if (name === 'remove') {
+            const op = args[1];
+            if (op === 'add') {
                 const target = args[2];
-                if (!target) {
-                    return { text: '用法: /order alias remove <name>' };
-                }
-                // remove 是保留子命令，不能作为别名名：后面跟多词文本说明用户想注册
-                // 名为 remove 的别名，明确报错而不是静默删除已存在的 target（P2 review）。
-                if (args.length > 3) {
-                    return { text: '`remove` 是保留子命令，不能作为别名名，请换一个名称' };
+                const name = args[3];
+                if (!target || !name) {
+                    return { text: '用法: /order alias add <orderId|序号> <别名名>' };
                 }
-                const entry = this.aliasStore.get(target);
-                if (!entry) {
-                    return { text: `别名 $${target} 不存在` };
-                }
-                this.aliasStore.remove(target);
-                // 回显原内容：单词场景无法区分「注册 remove」与「删除」，误删后
-                // 用户可直接按回显内容重新注册，消除静默破坏（P3 review）。
-                const preview = entry.text.length > 50 ? entry.text.slice(0, 50) + '...' : entry.text;
-                return { text: `✅ 已删除别名 $${target}（原内容：${preview}）` };
+                return this.cmdOrderAliasAdd(target, name);
             }
-            const text = args.slice(2).join(' ');
-            if (!text) {
-                const entry = name ? this.aliasStore.get(name) : undefined;
-                if (!entry) {
-                    return { text: name ? `别名 $${name} 不存在` : '用法: /order alias <name> <text>' };
+            if (op === 'rm') {
+                const target = args[2];
+                if (!target) {
+                    return { text: '用法: /order alias rm <orderId|序号>' };
                 }
-                return { text: `$${entry.name} → ${entry.text}` };
+                return this.cmdOrderAliasRemove(target);
             }
-            try {
-                const existed = this.aliasStore.has(name);
-                this.aliasStore.set(name, text);
-                const preview = text.length > 50 ? text.slice(0, 50) + '...' : text;
-                return { text: `${existed ? '✅ 已更新别名' : '✅ 已保存别名'} $${name} → ${preview}` };
-            }
-            catch (err) {
-                return { text: `保存失败: ${err.message}` };
+            if (!op || op === 'list') {
+                // 别名管理列表并入列表卡片
+                return this.cmdOrder([], _ctx, offset);
             }
+            return {
+                text: '用法: /order alias [add <orderId|序号> <别名名> | rm <orderId|序号> | list]',
+            };
         }
         // /order save <text>
         if (sub === 'save') {
@@ -3305,7 +3648,45 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 return { text: `保存失败: ${err.message}` };
             }
         }
-        return { text: '用法: /order [list|save <text>|alias <name> <text>|alias remove <name>]' };
+        return {
+            text: '用法: /order [list|save <text>|alias add <orderId|序号> <别名名>|alias rm <orderId|序号>]',
+        };
+    }
+    /** /order alias add：按 orderId 或列表序号（1 基）解析目标指令并绑定别名。 */
+    cmdOrderAliasAdd(target, name) {
+        const order = this.resolveOrderTarget(target);
+        if (!order)
+            return { text: `指令不存在: ${target}` };
+        try {
+            this.orderStore.setAlias(order.id, name);
+            return { text: `✅ 已给指令绑定别名 $${name}` };
+        }
+        catch (err) {
+            return { text: `保存失败: ${err.message}` };
+        }
+    }
+    /** /order alias rm：按 orderId 或列表序号（1 基）移除指令的别名。 */
+    cmdOrderAliasRemove(target) {
+        const order = this.resolveOrderTarget(target);
+        if (!order)
+            return { text: `指令不存在: ${target}` };
+        if (!order.alias)
+            return { text: '该指令没有别名' };
+        // 先读别名名再解绑：setAlias(undefined) 会 delete 同一对象引用上的 alias 字段。
+        const aliasName = order.alias;
+        this.orderStore.setAlias(order.id, undefined);
+        return { text: `✅ 已移除别名 $${aliasName}` };
+    }
+    /** 将 `/order alias add|rm` 的目标解析为 order：优先 orderId 精确匹配，回退列表序号（1 基）。 */
+    resolveOrderTarget(target) {
+        const all = this.orderStore.get();
+        const byId = all.find((o) => o.id === target);
+        if (byId)
+            return byId;
+        const n = Number(target);
+        if (Number.isInteger(n) && n >= 1 && n <= all.length)
+            return all[n - 1];
+        return undefined;
     }
 }
 //# sourceMappingURL=index.js.map