lark-remote 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.9] - 2026-08-20
+
+### 新增
+
+- ExitPlanMode 计划审批：计划全文折叠展示 + 五决策对齐 TUI（自动放行 / 附意见 / 采纳修改）
+- 卡片别名管理重构：`alias-store` 并入 `alias-resolve`，`/order` 卡片新增「＋别名」交互（绑定/修改/删除，已绑定指令显示 `$name` 标签 + ✕）
+- DSH / connection-based runner 启动 / 配置热更 / 失败路径修复（CC-01~CC-08）
+
+### 变更
+
+- 别名 API 由「触发词 → 文本」改为「指令 → 别名」：`/order alias add <orderId|序号> <别名>` 绑定、`/order alias rm` 移除；别名随指令持久化在 `orders.json`，删除指令时别名一并删除；名称不能为保留子命令、不能数字开头
+- 用户文档同步别名卡片化交互，移除 `/order alias <name> <text>` 旧用法
+
+### 修复
+
+- 别名卡片成功回调：携带 `card` 替换 pre-click 卡，删除文案对齐新交互
+- kimi ACP runner 模型下发：迁移到纯 ACP 后 `session/set_config_option` 必须紧跟 `session/new|resume` 下发，否则实际跑的是默认模型（CC-07）
+
 ## [0.1.8] - 2026-08-19
 
 ### 新增

package/dist/bridge/approval-coordinator.d.ts

@@ -22,6 +22,8 @@ export interface TrackedApproval {
     answers?: Map<number, string[]>;
     /** AskUserQuestion 补充说明（Codex user_note）：问题索引 → 文本。 */
     notes?: Map<number, string>;
+    /** 计划审批修改意见（ExitPlanMode）：planFeedback 回流，供反馈类决策注入。 */
+    feedback?: string;
 }
 type ApprovalResponder = (requestId: number | string, response: unknown) => Promise<void>;
 export type { ApprovalAction } from '../runner/types.js';
@@ -115,6 +117,17 @@ export declare class ApprovalCoordinator {
         requestId: number | string;
         nonce?: string;
     }): Promise<void>;
+    /**
+     * 计划审批修改意见（ExitPlanMode）：输入框提交 → coordinator 记录并回流
+     * 卡片回显，随后「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     * 同一请求可多次修改（新 nonce 来自新渲染）。
+     */
+    planFeedback(action: {
+        text: string;
+    }, ctx: {
+        requestId: number | string;
+        nonce?: string;
+    }): Promise<void>;
     /**
      * Update a pending approval's view (out-of-order item/started arrives late).
      * Only applies while the approval is still pending — resolved/expired
@@ -132,6 +145,8 @@ export declare class ApprovalCoordinator {
     private recordAnswer;
     private getPendingQuestion;
     private allQuestionsAnswered;
+    /** 推送审批卡视图更新（approval_view_updated 重渲染；失败仅记日志）。 */
+    private pushApprovalViewUpdate;
     /** 推送 question 卡片视图更新（选项勾选状态变化）。 */
     private pushQuestionViewUpdate;
     /** 全部问题已答：构建 answers 并提交（非空校验 + 原子状态迁移）。 */

package/dist/bridge/approval-coordinator.js

@@ -97,12 +97,33 @@ export class ApprovalCoordinator {
         if (!tracked.view.availableDecisions.includes(decision) && !safetyOverride) {
             throw new Error(`Decision "${decision}" not in available decisions: ${tracked.view.availableDecisions.join(', ')}`);
         }
+        // 反馈类决策：注入用户已填写的修改意见（卡片输入框经 planFeedback 回流到
+        // coordinator）。decisionToApprovalAction 只带决策名，payload 在此补齐；
+        // 调用方直接传完整 payload 时以显式值为准。
+        let effectiveAction = action;
+        if (action.action === 'decline_with_feedback' || action.action === 'accept_with_feedback') {
+            const explicit = action.action === 'decline_with_feedback' ? action.message : action.plan;
+            const text = explicit.trim() || tracked.feedback?.trim() || '';
+            if (!text) {
+                throw new Error('请先填写修改意见');
+            }
+            effectiveAction =
+                action.action === 'decline_with_feedback'
+                    ? { action: 'decline_with_feedback', message: text }
+                    : {
+                        action: 'accept_with_feedback',
+                        // 批准并采纳修改：新计划 = 原计划 + 用户意见（无原计划时意见即计划）。
+                        plan: tracked.view.plan?.trim()
+                            ? `${tracked.view.plan.trim()}\n\n## 用户修改意见\n${text}`
+                            : `# 用户修改意见\n\n${text}`,
+                    };
+        }
         // Atomic state transition: pending → submitting（同步，无 await）
         tracked.state = 'submitting';
         this.clearTimer(tracked);
         // Send response via the responder
         try {
-            await this.responder(ctx.requestId, action);
+            await this.responder(ctx.requestId, effectiveAction);
             tracked.state = 'resolved';
             // 提交成功后立即从卡片移除审批区（agent 无关）：claude 控制协议没有
             // resolved 回发，不推就会「已点允许按钮仍在」残留 UI；codex 的 server
@@ -249,6 +270,28 @@ export class ApprovalCoordinator {
         q.note = text;
         this.pushQuestionViewUpdate(ctx.requestId, tracked);
     }
+    /**
+     * 计划审批修改意见（ExitPlanMode）：输入框提交 → coordinator 记录并回流
+     * 卡片回显，随后「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     * 同一请求可多次修改（新 nonce 来自新渲染）。
+     */
+    async planFeedback(action, ctx) {
+        const tracked = this.approvals.get(ctx.requestId);
+        if (!tracked) {
+            throw new Error(`Approval request ${ctx.requestId} not found`);
+        }
+        if (tracked.state !== 'pending') {
+            throw new Error(`Approval request ${ctx.requestId} is no longer pending`);
+        }
+        const text = action.text.trim();
+        if (!text) {
+            throw new Error('请输入修改意见');
+        }
+        this.assertFreshNonce(ctx.requestId, ctx.nonce);
+        tracked.feedback = text;
+        tracked.view.planFeedback = text;
+        this.pushApprovalViewUpdate(ctx.requestId, tracked);
+    }
     /**
      * Update a pending approval's view (out-of-order item/started arrives late).
      * Only applies while the approval is still pending — resolved/expired
@@ -320,8 +363,8 @@ export class ApprovalCoordinator {
         }
         return true;
     }
-    /** 推送 question 卡片视图更新（选项勾选状态变化）。 */
-    pushQuestionViewUpdate(requestId, tracked) {
+    /** 推送审批卡视图更新（approval_view_updated 重渲染；失败仅记日志）。 */
+    pushApprovalViewUpdate(requestId, tracked) {
         void this.pushToCard([
             {
                 type: 'approval_view_updated',
@@ -333,6 +376,10 @@ export class ApprovalCoordinator {
             getLogger().warn(`[approval-coordinator] question view update failed requestId=${requestId}: ${err instanceof Error ? err.message : String(err)}`);
         });
     }
+    /** 推送 question 卡片视图更新（选项勾选状态变化）。 */
+    pushQuestionViewUpdate(requestId, tracked) {
+        this.pushApprovalViewUpdate(requestId, tracked);
+    }
     /** 全部问题已答：构建 answers 并提交（非空校验 + 原子状态迁移）。 */
     async respondQuestionAnswers(tracked, ctx) {
         this.assertFreshNonce(ctx.requestId, ctx.nonce);
@@ -413,6 +460,10 @@ export class ApprovalCoordinator {
                 return 'acceptAll';
             case 'answer':
                 return 'answer';
+            case 'decline_with_feedback':
+                return 'declineWithFeedback';
+            case 'accept_with_feedback':
+                return 'acceptWithFeedback';
             case 'decline':
                 return 'decline';
             case 'cancel':
@@ -431,6 +482,10 @@ export function decisionToApprovalAction(decision) {
             return { action: 'accept_with_execpolicy_amendment' };
         case 'acceptAll':
             return { action: 'accept_all' };
+        case 'declineWithFeedback':
+            return { action: 'decline_with_feedback', message: '' };
+        case 'acceptWithFeedback':
+            return { action: 'accept_with_feedback', plan: '' };
         case 'decline':
             return { action: 'decline' };
         case 'cancel':

package/dist/bridge/index.d.ts

@@ -121,6 +121,13 @@ export declare class Bridge {
      * blocked the queue forever.
      */
     private runners;
+    /**
+     * Runner 槽位在「活跃运行期间配置变更」时被标 stale（CC-06/P1）：clearRunners() 对
+     * 活跃 workspace 只标 stale、不立即 evict（避免误杀长驻连接），当前 run 结束后由
+     * finalizeRun 安全 evict+dispose，下一轮 getRunner 创建新配置的 runner。
+     * key 为 `${cwd}\u0000${agentKind}`。
+     */
+    private staleRunnerSlots;
     /** Queue manager for per-workspace serial processing queue. */
     /** 普通消息队列管理器（public：测试注入 queue-card 状态用）。 */
     queueManager: QueueManager;
@@ -383,6 +390,16 @@ export declare class Bridge {
         decision: string;
         nonce: string;
     }): Promise<void>;
+    /**
+     * 计划审批修改意见（ExitPlanMode 输入框）：记录到 coordinator 并回流卡片。
+     * 「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     */
+    handleApprovalPlanFeedback(opts: {
+        runId: string;
+        requestId: number | string;
+        text: string;
+        nonce: string;
+    }): Promise<void>;
     /**
      * Handle a permission toggle from a card button click.
      * Routes to the ApprovalCoordinator for the given run.

package/dist/bridge/index.js

@@ -89,6 +89,13 @@ export class Bridge {
      * blocked the queue forever.
      */
     runners = new Map();
+    /**
+     * Runner 槽位在「活跃运行期间配置变更」时被标 stale（CC-06/P1）：clearRunners() 对
+     * 活跃 workspace 只标 stale、不立即 evict（避免误杀长驻连接），当前 run 结束后由
+     * finalizeRun 安全 evict+dispose，下一轮 getRunner 创建新配置的 runner。
+     * key 为 `${cwd}\u0000${agentKind}`。
+     */
+    staleRunnerSlots = new Set();
     /** Queue manager for per-workspace serial processing queue. */
     /** 普通消息队列管理器（public：测试注入 queue-card 状态用）。 */
     queueManager;
@@ -259,10 +266,18 @@ export class Bridge {
         // keeping it is correct; finalizeRun deletes the cache entry when the run
         // ends, and the next run picks up the new config/agent via getRunner.
         for (const cwd of [...this.runners.keys()]) {
-            if (this.activeRuns.has(cwd))
+            if (this.activeRuns.has(cwd)) {
+                // CC-06/P1: 活跃 workspace 不能立即 evict（会误杀长驻连接），但必须标记 stale，
+                // 否则 finalizeRun 对 workspace-lifetime runner 也不 evict → 下一轮复用旧配置实例。
+                // 这里只标待淘汰，当前 run 结束后由 finalizeRun 安全 evict。
+                for (const kind of [...this.runners.get(cwd).keys()]) {
+                    this.staleRunnerSlots.add(`${cwd}\u0000${kind}`);
+                }
                 continue;
+            }
             for (const kind of [...this.runners.get(cwd).keys()]) {
                 this.evictRunnerSlot(cwd, kind);
+                this.staleRunnerSlots.delete(`${cwd}\u0000${kind}`);
             }
         }
     }
@@ -287,6 +302,7 @@ export class Bridge {
             void evicted.dispose();
         }
         workspaceMap.delete(kind);
+        this.staleRunnerSlots.delete(`${cwd}\u0000${kind}`);
         if (workspaceMap.size === 0) {
             this.runners.delete(cwd);
         }
@@ -1302,9 +1318,13 @@ export class Bridge {
                 // evicted+disposed by clearRunners (/config) and interruptCurrentRun
                 // (/stop). Spawn-per-message runners are evicted as before to prevent
                 // stale process references accumulating.
-                if (activeRun.runner.lifetime !== 'workspace') {
+                // CC-06/P1: 配置变更期间（clearRunners 标了 stale）的 workspace-lifetime
+                // runner 也必须在 run 结束后 evict，否则下一轮复用旧配置实例。
+                const slotKey = `${cwd}\u0000${activeRun.agentKind}`;
+                if (activeRun.runner.lifetime !== 'workspace' || this.staleRunnerSlots.has(slotKey)) {
                     this.evictRunnerSlot(cwd, activeRun.agentKind);
                 }
+                this.staleRunnerSlots.delete(slotKey);
                 // Compact 卡片需要 runId + sessionId；record 供终态卡上的 Compact 按钮
                 // 校验与取参（activeRuns 已清空，无法再查到）。异常退出（error/
                 // interrupted/idle_timeout）同样记录——上下文往往更大，压缩后再续。
@@ -1447,6 +1467,15 @@ export class Bridge {
             await coordinator.submit(action, { requestId: opts.requestId, nonce: opts.nonce });
         });
     }
+    /**
+     * 计划审批修改意见（ExitPlanMode 输入框）：记录到 coordinator 并回流卡片。
+     * 「拒绝并附意见」/「批准并采纳修改」按钮复用该文本。
+     */
+    async handleApprovalPlanFeedback(opts) {
+        return this.withCoordinator(opts.runId, async (coordinator) => {
+            await coordinator.planFeedback({ text: opts.text }, { requestId: opts.requestId, nonce: opts.nonce });
+        });
+    }
     /**
      * Handle a permission toggle from a card button click.
      * Routes to the ApprovalCoordinator for the given run.

package/dist/card/approval-render.js

@@ -4,10 +4,14 @@
  * Renders command/file/permissions approval areas with button mappings per §8.3.
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
+import { collapsibleMarkdownPanel } from './collapsible.js';
+import { truncateUtf8, truncateMarkdownTables } from './text-truncate.js';
 /** Unique nonce for card button callbacks (SDK dedup + router validation). */
 function mkNonce() {
     return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
+/** 计划面板正文字节预算（折叠展示 + 截断保护 28KB 卡片预算）。 */
+const PLAN_PANEL_BYTES = 6000;
 /** reason div（3 处共用）；反引号中和防 lark_md 解析错误（review P2-2）。 */
 function reasonDiv(approval) {
     if (!approval.reason)
@@ -71,20 +75,26 @@ function renderDecisionButtons(approval, expired, runId) {
             },
         ];
     }
+    // ExitPlanMode 计划审批用 TUI 语义文案；其他审批保持原文案。
+    const isPlanExit = approval.kind === 'tool' && approval.toolName === 'ExitPlanMode';
     const BUTTONS = {
-        accept: { label: '✅ 允许', type: 'primary' },
+        accept: { label: isPlanExit ? '✅ 批准并执行' : '✅ 允许', type: 'primary' },
         acceptForSession: { label: '✅ 允许本次会话', type: 'primary' },
         acceptWithExecpolicyAmendment: { label: '🔒 允许并记住命令', type: 'primary' },
-        acceptAll: { label: '✅ 允许所有', type: 'primary' },
+        acceptAll: { label: isPlanExit ? '✅ 批准并自动放行' : '✅ 允许所有', type: 'primary' },
+        acceptWithFeedback: { label: '✍️ 批准并采纳修改', type: 'primary' },
+        declineWithFeedback: { label: '✏️ 拒绝并附意见', type: 'default' },
         decline: { label: '❌ 拒绝', type: 'danger' },
     };
     // Fixed presentation order; only offer decisions the protocol listed
-    // (accept/decline are always available; acceptAll is Claude 专属「允许所有」)。
+    // (accept/decline are always available; 其余按 availableDecisions 出现)。
     const offered = [
         'accept',
         'acceptForSession',
         'acceptWithExecpolicyAmendment',
         'acceptAll',
+        'acceptWithFeedback',
+        'declineWithFeedback',
         'decline',
     ].filter((d) => d === 'accept' || d === 'decline' || approval.availableDecisions.includes(d));
     // 决策按钮逐个作为 body 直接元素返回（CardKit body 纵向堆叠 = 上下排列）。
@@ -113,18 +123,21 @@ function renderDecisionButtons(approval, expired, runId) {
 // =============================================================================
 /**
  * 通用工具权限请求（kind === 'tool'）：展示工具名 + 用途说明（reason）+ 原始
- * input（若有）。ExitPlanMode 的 input 为空对象，工具名本身即审批内容，
- * 不再落入 command 槽位显示无意义 `{}`。
+ * input（若有）。ExitPlanMode 走独立计划审批分支（计划全文 + 修改意见输入）。
  */
 function renderToolApproval(approval, expired, runId) {
+    // ExitPlanMode：对齐 TUI「先看完整计划再交互」——计划全文折叠面板 +
+    // 修改意见输入 + 五决策按钮（批准并执行 / 批准并自动放行 / 拒绝并附意见 /
+    // 批准并采纳修改 / 拒绝）。
+    if (approval.toolName === 'ExitPlanMode') {
+        return renderPlanApproval(approval, expired, runId);
+    }
     const elements = [];
-    // ExitPlanMode 是「退出计划模式」：标题用计划审批语义；其他工具用通用标题。
-    const isPlanExit = approval.toolName === 'ExitPlanMode';
     elements.push({
         tag: 'div',
         text: {
             tag: 'lark_md',
-            content: isPlanExit ? '**📋 计划审批**' : '**🔧 工具请求**',
+            content: '**🔧 工具请求**',
         },
     });
     const toolLabel = approval.toolName ?? '(unknown tool)';
@@ -144,6 +157,90 @@ function renderToolApproval(approval, expired, runId) {
     elements.push(...renderDecisionButtons(approval, expired, runId));
     return elements;
 }
+/**
+ * ExitPlanMode 计划审批区：
+ * - 计划全文（input.plan 或计划文件读取）折叠展示，反引号中和 + 表格限数 +
+ *   字节预算截断；
+ * - 计划文件路径（有则展示，含模型写错目录的退化场景）；
+ * - 修改意见输入框（approval.planFeedback → coordinator 回流回显），供
+ *   「拒绝并附意见」/「批准并采纳修改」复用；
+ * - 决策按钮由 renderDecisionButtons 按 availableDecisions 渲染。
+ */
+function renderPlanApproval(approval, expired, runId) {
+    const elements = [];
+    elements.push({
+        tag: 'div',
+        text: { tag: 'lark_md', content: '**📋 计划审批**' },
+    });
+    pushIf(elements, reasonDiv(approval));
+    if (approval.planFilePath) {
+        const neutralizedPath = approval.planFilePath.replace(/`/g, '·');
+        elements.push({
+            tag: 'div',
+            text: { tag: 'lark_md', content: `📄 ${neutralizedPath}` },
+        });
+    }
+    if (approval.plan) {
+        // 反引号中和防 11311（同 reasonDiv/command 策略）；表格限数防 11310；
+        // 字节预算截断防 28KB 超限。
+        const neutralized = approval.plan.replace(/`/g, '·');
+        const tableSafe = truncateMarkdownTables(neutralized);
+        const content = truncateUtf8(tableSafe, PLAN_PANEL_BYTES);
+        elements.push(collapsibleMarkdownPanel({
+            title: '📋 计划',
+            expanded: false,
+            border: 'blue',
+            content,
+        }));
+    }
+    else {
+        elements.push({
+            tag: 'div',
+            text: {
+                tag: 'lark_md',
+                content: '📋 未获取到计划文件内容（可参考上方正文摘要）',
+            },
+        });
+    }
+    if (!expired) {
+        elements.push(renderPlanFeedbackInput(approval.requestId, runId));
+        if (approval.planFeedback) {
+            const neutralized = approval.planFeedback.replace(/`/g, '·');
+            elements.push({
+                tag: 'div',
+                text: { tag: 'lark_md', content: `📝 ${neutralized}` },
+            });
+        }
+    }
+    elements.push(...renderDecisionButtons(approval, expired, runId));
+    return elements;
+}
+/**
+ * 计划修改意见输入行：输入后点击右侧 ✓ 提交图标，input_value 经 connector
+ * raw 事件回传（CardKit input 的 input_value 会被 SDK normalizer 丢弃，
+ * 必须走 includeRawEvent 路径，同 answerNote）。
+ */
+function renderPlanFeedbackInput(requestId, runId) {
+    return {
+        tag: 'input',
+        name: `plan-feedback-${requestId}`,
+        placeholder: {
+            tag: 'plain_text',
+            content: '填写修改意见（可配合「拒绝并附意见」/「批准并采纳修改」）…',
+        },
+        behaviors: [
+            {
+                type: 'callback',
+                value: {
+                    cmd: 'approval.planFeedback',
+                    requestId,
+                    runId,
+                    nonce: mkNonce(),
+                },
+            },
+        ],
+    };
+}
 // =============================================================================
 // Command Approval
 // =============================================================================

package/dist/index.js

@@ -241,7 +241,13 @@ function initializeRunner(config, configDir, cliArgs) {
     sessionReaderRegistry.register('kimi', kimiSessionReader);
     // Register DshRunner (HTTP-only DSH Web Host agent) and DshSessionReader.
     const dshSessionReader = new DshSessionReader({
-        host: getAgentConfig(config, 'dsh')?.host,
+        // hostProvider 每次调用读最新 config：/config 修改 host 后 runner 重建为
+        // 新 host，reader（/resume、用量、完成卡）也跟随新 host（CC-02）。
+        hostProvider: () => {
+            const container = agentRegistry.getConfigContainer();
+            const latestConfig = container?.current ?? config;
+            return getAgentConfig(latestConfig, 'dsh')?.host;
+        },
     });
     agentRegistry.register('dsh', (_ws) => {
         // Read latest config from container so /config host changes take effect
@@ -526,19 +532,24 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         // 直返列表外，过期/重复 nonce/非法选项等错误 toast 被静默吞掉）。
         // 审批响应尤其不能落串行队列：run 任务占用队列头直到 turn 结束，审批响应
         // 排在后面会形成死锁（run 不结束不执行、run 结束 coordinator 已删响应空转）。
+        // order.aliasInput / order.aliasRemove 也返回 toast，需直返避免被吞。
         if (actionValue.cmd === 'queue.input' ||
+            actionValue.cmd === 'order.aliasInput' ||
+            actionValue.cmd === 'order.aliasRemove' ||
             actionValue.cmd === 'config.save' ||
             actionValue.cmd === 'approval.respond' ||
             actionValue.cmd === 'approval.toggle' ||
             actionValue.cmd === 'approval.answer' ||
             actionValue.cmd === 'approval.answerSubmit' ||
-            actionValue.cmd === 'approval.answerCustom') {
+            actionValue.cmd === 'approval.answerCustom' ||
+            actionValue.cmd === 'approval.answerNote') {
             return router.handleCardAction(fullValue, { userId, chatId, messageId });
         }
         // order.exec → equivalent queued message (Plan A): resolve the order text
         // at the enqueue boundary and route it through router.handle, exactly like
         // a hand-typed message. See order-exec-dispatch.ts for the contract and
         // why an internal key replaces the Feishu card messageId.
+        // （order.aliasEdit 是控制动作，走 enqueueImmediate 弹卡即可，不需直返。）
         if (actionValue.cmd === 'order.exec') {
             void dispatchOrderExecForQueue({
                 router,
@@ -650,7 +661,6 @@ async function main() {
         configPath: path.join(configDir, 'config.yaml'),
         workspacePath: path.join(configDir, 'workspace.json'),
         ordersPath: path.join(configDir, 'orders.json'),
-        aliasesPath: path.join(configDir, 'aliases.json'),
         restartSpawner: () => spawnReplacementBridge(path.join(configDir, 'logs')),
         sessionReaderRegistry,
         devMode: cliArgs.dev,

package/dist/order/alias-resolve.d.ts

@@ -1,4 +1,8 @@
-import type { AliasEntry } from './alias-store.js';
+/** 参与别名展开的条目：别名名 + 展开文本（即指令文本）。 */
+export interface AliasResolveEntry {
+    name: string;
+    text: string;
+}
 /**
  * 一次别名展开。
  *
@@ -10,4 +14,4 @@ import type { AliasEntry } from './alias-store.js';
  *
  * @returns 展开后的完整消息；无匹配时返回 undefined。
  */
-export declare function resolveAlias(message: string, aliases: readonly AliasEntry[]): string | undefined;
+export declare function resolveAlias(message: string, aliases: readonly AliasResolveEntry[]): string | undefined;

package/dist/order/index.d.ts

@@ -1,8 +1,10 @@
-interface OrderEntry {
+export interface OrderEntry {
     id: string;
     text: string;
     createdAt: string;
     usedAt?: string;
+    /** 可选别名名（该指令的 $name 触发词）。全局唯一，由 OrderStore 校验。 */
+    alias?: string;
 }
 /**
  * Global persistent order store.
@@ -20,8 +22,13 @@ export declare class OrderStore {
     private persist;
     save(text: string): OrderEntry;
     updateUsedAt(id: string): void;
+    /**
+     * 给指令绑定别名（或解绑）。别名全局唯一，撞名抛错；名称必须通过
+     * `ALIAS_NAME_PATTERN`（字母/数字/下划线、不能数字开头、≤20 字符）。
+     * @returns 绑定后的条目。
+     */
+    setAlias(id: string, name: string | undefined): OrderEntry | undefined;
     get(): OrderEntry[];
     has(id: string): boolean;
     remove(id: string): void;
 }
-export {};

package/dist/order/index.js

@@ -4,6 +4,9 @@ import { atomicWriteJson } from '../persistence/atomic-write.js';
 import { loadJsonFile } from '../persistence/load-json-file.js';
 const MAX_TEXT_LENGTH = 200;
 const MAX_ORDERS = 50;
+/** 别名名称规则：`[A-Za-z_][A-Za-z0-9_]*`，≤20 字符，不能数字开头。 */
+const ALIAS_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const MAX_ALIAS_NAME_LENGTH = 20;
 /**
  * Global persistent order store.
  *
@@ -45,6 +48,11 @@ export class OrderStore {
                 };
                 if (typeof e.usedAt === 'string')
                     entry.usedAt = e.usedAt;
+                if (typeof e.alias === 'string' &&
+                    ALIAS_NAME_PATTERN.test(e.alias) &&
+                    e.alias.length <= MAX_ALIAS_NAME_LENGTH) {
+                    entry.alias = e.alias;
+                }
                 valid.push(entry);
             }
         }
@@ -76,6 +84,31 @@ export class OrderStore {
             this.persist();
         }
     }
+    /**
+     * 给指令绑定别名（或解绑）。别名全局唯一，撞名抛错；名称必须通过
+     * `ALIAS_NAME_PATTERN`（字母/数字/下划线、不能数字开头、≤20 字符）。
+     * @returns 绑定后的条目。
+     */
+    setAlias(id, name) {
+        const entry = this.data.find((e) => e.id === id);
+        if (!entry)
+            return undefined;
+        if (name === undefined || name === '') {
+            delete entry.alias;
+            this.persist();
+            return entry;
+        }
+        if (!ALIAS_NAME_PATTERN.test(name) || name.length > MAX_ALIAS_NAME_LENGTH) {
+            throw new Error(`别名名称只能包含字母/数字/下划线，不能数字开头，且不超过 ${MAX_ALIAS_NAME_LENGTH} 字符`);
+        }
+        const existing = this.data.find((e) => e.id !== id && e.alias === name);
+        if (existing) {
+            throw new Error(`别名 $${name} 已被其他指令占用`);
+        }
+        entry.alias = name;
+        this.persist();
+        return entry;
+    }
     get() {
         return [...this.data];
     }

package/dist/router/index.d.ts

@@ -101,7 +101,6 @@ export declare class CommandRouter {
     configPath: string;
     private workspaceStore;
     private orderStore;
-    private aliasStore;
     private exitHandler;
     private pendingExit;
     /**
@@ -156,8 +155,6 @@ export declare class CommandRouter {
         configPath: string;
         workspacePath?: string;
         ordersPath?: string;
-        /** 别名存储路径（<configDir>/aliases.json）。 */
-        aliasesPath?: string;
         exitHandler?: () => void;
         /** Spawn the detached replacement bridge process and return its pid (throws on failure). */
         restartSpawner?: () => number;
@@ -193,6 +190,7 @@ export declare class CommandRouter {
     /**
      * 一次别名展开：bridge 收到用户消息后、命令分发前调用。
      * 仅 `$name` 开头的消息可能被展开；未知别名 / 非 `$` 消息原样返回。
+     * 别名来自 order 的 `alias` 字段（1 条指令 = 1 个别名），展开文本即指令文本。
      */
     expandAliasMessage(message: string): string;
     /**
@@ -298,6 +296,18 @@ export declare class CommandRouter {
      * Mirrors handleLsPage — updates the same card, never sends a new one.
      */
     private handleOrderPage;
+    /**
+     * Handle order.aliasEdit: 展示别名编辑卡（input + ✓ 提交图标）。
+     * 有别名时预填；提交 `order.aliasInput` 处理（含校验与唯一性）。
+     */
+    private handleOrderAliasEdit;
+    /**
+     * Handle order.aliasInput: 提交别名（绑/改/解绑），随后重渲染 /order 列表卡。
+     * 留空 = 解绑；非空按命名规则 + 全局唯一校验，失败仅 toast 不重渲染。
+     */
+    private handleOrderAliasInput;
+    /** Handle order.aliasRemove: 删除某条指令的别名并原地重渲染列表卡。 */
+    private handleOrderAliasRemove;
     /**
      * Handle ws.use card action: switch to the workspace, then refresh the /ws
      * list card in place so "recent" sort order is immediately visible.
@@ -467,5 +477,11 @@ export declare class CommandRouter {
     buildConfigCard(): CommandResult;
     /** /order 实现（public：测试直接调用，替代 as unknown as）。 */
     cmdOrder(args: string[], _ctx: CommandContext, offset?: number): CommandResult;
+    /** /order alias add：按 orderId 或列表序号（1 基）解析目标指令并绑定别名。 */
+    private cmdOrderAliasAdd;
+    /** /order alias rm：按 orderId 或列表序号（1 基）移除指令的别名。 */
+    private cmdOrderAliasRemove;
+    /** 将 `/order alias add|rm` 的目标解析为 order：优先 orderId 精确匹配，回退列表序号（1 基）。 */
+    private resolveOrderTarget;
 }
 export {};