lark-remote 0.1.8 → 0.1.10

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,55 @@ export class OrderStore {
             this.persist();
         }
     }
+    /**
+     * 修改指令文本。保留 usedAt / alias / createdAt（编辑不应重置使用统计或别名）。
+     * newText===oldText 短路 persist，避免空写盘。长度 > MAX_TEXT_LENGTH 抛错（与 save 一致）。
+     * 内部统一 trim：卡片（handleOrderTextInput）与 CLI（/order edit）都直接传原始文本，
+     * 避免双 trim 语义混淆、也避免两条入口存出不同结果。纯空白（trim 后空）抛错。
+     * @returns 更新后的 entry；id 不存在返回 undefined。
+     */
+    updateText(id, newText) {
+        const trimmed = newText.trim();
+        if (trimmed === '') {
+            throw new Error('指令文本不能为空');
+        }
+        if (trimmed.length > MAX_TEXT_LENGTH) {
+            throw new Error(`指令文本超过 ${MAX_TEXT_LENGTH} 字符限制`);
+        }
+        const entry = this.data.find((e) => e.id === id);
+        if (!entry)
+            return undefined;
+        if (entry.text === trimmed)
+            return entry; // no-op: 短路 persist
+        entry.text = trimmed;
+        this.persist();
+        return entry;
+    }
+    /**
+     * 给指令绑定别名（或解绑）。别名全局唯一，撞名抛错；名称必须通过
+     * `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,34 @@ 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 order.textEdit: 展示指令文本编辑卡（input + ✓ 提交图标）。
+     * 预填当前 text（完整内容，不截断——input 组件有自有滚动条）；
+     * 提交 `order.textInput` 处理（trim + 长度校验 + OrderStore.updateText）。
+     * 完全镜像 handleOrderAliasEdit 的 4 段结构（reload → find → 构造 editCard →
+     * updateCardInPlace）。
+     */
+    private handleOrderTextEdit;
+    /**
+     * Handle order.textInput: 提交指令文本编辑。校验 orderId → OrderStore.updateText
+     * （store 内部统一 trim + 空/超长校验）。成功 toast + 原地重渲染列表卡（同
+     * handleOrderAliasInput 语义：toast-only 响应会让飞书停留在 pre-click 编辑卡，
+     * 必须把 card 放进 callback 响应体）；失败仅 error toast。
+     * 保留 usedAt / alias / createdAt（OrderStore.updateText 只动 text 字段）。
+     */
+    private handleOrderTextInput;
     /**
      * 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 +493,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 {};