@epoch-agent/tui 0.27.0 → 0.28.0

package/dist/index.d.ts

@@ -991,6 +991,15 @@ interface SlashCommand {
     name: string;
     /** 别名，同样不带斜杠 */
     aliases?: string[];
+    /**
+     * 给人看的称呼（自定义命令 frontmatter 的 `displayName`，2026-10-10）。
+     * 内置命令不写。
+     *
+     * ⚠️ 终端里**左列照旧印 `/name`** —— 那是用户真要敲的东西，换成称呼等于让他
+     * 照着屏幕敲一个认不出来的命令。称呼印在右列说明的前面，见 `parse.ts` 的
+     * `describeCommand`。
+     */
+    displayName?: string;
     /** 一行说明，出现在补全面板和 /help 里 */
     description: string;
     /** 参数占位符，例如 `[level]`；只用于展示 */
@@ -1397,6 +1406,11 @@ declare function findCommand(commands: readonly SlashCommand[], name: string): S
  *
  * `/` 单独一个字符时列出全部命令（用户刚敲下斜杠，正等着看有什么可用）。
  * 已经带了参数（有空格）时不再补全 —— 那时候用户在填参数，不该再弹列表。
+ *
+ * 称呼（`displayName`）也按前缀认（2026-10-10）：插件命令的名字是
+ * `aione:bailing_daily_report` 这种，用户记得住的是「百灵投放日报」，打 `/百灵`
+ * 该找得到它。⚠️ 同样是**前缀**不是子串，判据和名字那一支一致 —— 子串的话
+ * `/c` 会捞出所有称呼里带个 c 的命令。web 那一份（`composer/commands.tsx`）逐字镜像。
  */
 declare function matchCommands(commands: readonly SlashCommand[], text: string): readonly SlashCommand[];
 

package/dist/index.js

@@ -25,9 +25,12 @@ function matchCommands(commands, text) {
   const prefix = body.toLowerCase();
   if (!prefix) return commands;
   return commands.filter(
-    (c) => c.name.startsWith(prefix) || c.aliases?.some((a) => a.startsWith(prefix))
+    (c) => c.name.startsWith(prefix) || c.aliases?.some((a) => a.startsWith(prefix)) || c.displayName?.toLowerCase().startsWith(prefix) === true
   );
 }
+function describeCommand(cmd) {
+  return cmd.displayName ? `${cmd.displayName} \xB7 ${cmd.description}` : cmd.description;
+}
 // src/commands/prefix.ts
 function classifyInput(text, commands) {
   if (text.includes("\n")) return { kind: "text" };
@@ -708,7 +711,7 @@ function CommandPalette({
       return /* @__PURE__ */ jsxs5(Box5, { flexDirection: "row", children: [
         /* @__PURE__ */ jsx6(Box5, { width: 2, flexShrink: 0, children: /* @__PURE__ */ jsx6(Text5, { color: selected ? accent3 : dim4, children: selected ? "\u276F " : "  " }) }),
         /* @__PURE__ */ jsx6(Box5, { flexShrink: 0, children: /* @__PURE__ */ jsx6(Text5, { color: selected ? accent3 : "#F8F8F2", bold: selected, children: padEndByWidth(label, nameWidth + 1) }) }),
-        /* @__PURE__ */ jsx6(Text5, { color: dim4, dimColor: true, children: cmd.description })
+        /* @__PURE__ */ jsx6(Text5, { color: dim4, dimColor: true, children: describeCommand(cmd) })
       ] }, cmd.name);
     }),
     /* @__PURE__ */ jsx6(Box5, { flexDirection: "row", children: /* @__PURE__ */ jsxs5(Text5, { color: dim4, dimColor: true, children: [
@@ -5403,7 +5406,7 @@ var help = {
     ) + 2;
     const format = (c) => {
       const label = `/${c.name}${c.argHint ? " " + c.argHint : ""}`;
-      return `  ${padEndByWidth(label, width)}${c.description}`;
+      return `  ${padEndByWidth(label, width)}${describeCommand(c)}`;
     };
     const builtin = ctx.commands.filter((c) => !c.source);
     const custom = ctx.commands.filter((c) => c.source);
@@ -5779,6 +5782,7 @@ function availableCommands(host, commands = BUILTIN_COMMANDS) {
 function toSlashCommand(def) {
   return {
     name: def.name,
+    ...def.displayName ? { displayName: def.displayName } : {},
     description: def.description,
     source: def.source,
     ...def.argumentHint ? { argHint: def.argumentHint } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/tui",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "private": false,
   "description": "epoch-agent Ink TUI 界面",
   "repository": {
@@ -29,8 +29,8 @@
     "mnemonist": "0",
     "string-width": "8",
     "strip-ansi": "7",
-    "@epoch-agent/protocol": "0.27.0",
-    "@epoch-agent/view": "0.27.0"
+    "@epoch-agent/protocol": "0.28.0",
+    "@epoch-agent/view": "0.28.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",