@@ -482,6 +482,8 @@ writes finish and refills the password from the authenticated settings response.
 - [src/apps/tui/render_mode.hpp](src/apps/tui/render_mode.hpp): pure terminal render-mode decision logic.
 - [src/base/utils/paths.cpp](src/base/utils/paths.cpp): user vs service data directory resolution.
 
+**斜杠命令别名只挂在原名上,不单独注册。** `SlashCommand::aliases`(TUI)与 `/api/commands` builtin 的 `aliases` 数组(Web)是唯一来源;`commands()` 只有原名,下拉与 `/help` 一条命令一行。下拉只在查询命中别名、且别名档位高于原名时显示 `/原名 (别名)`(三名命令敲 `/new` 显示 `/generate (new)`,敲 `/create` 显示 `/generate (create)`,空查询不标别名),选中插入原名。`has_command` 对别名也返回 true —— skill / opencode 命令撞名检查靠它挡住 `rc`、`new`;dispatch 把使用计数记到原名(排序时再加上旧版按别名记的次数),用户实际敲的名字放在 `CommandContext::invoked_command_name`(`/side` 回显 `[/side]` 用它)。纯逻辑:`slash_command_ranking.cpp`、`web/src/lib/slashCommands.js::slashCommandMatchedAlias`;回归:`tests/tui/commands/command_alias_test.cpp`、`slashCommands.test.js` 的别名组。
+
 ## Maintenance Notes
 
 **Daemon mode:** main thread blocks in `Crow::App::run()`. Plus:
@@ -785,7 +787,7 @@ The existing region detector still probes DuckDuckGo once at startup through `Pr
     "max_depth": 8,
     "max_bytes": 262144,
     "max_total_bytes": 1048576,
-    "filenames": ["AGENT.md", "AGENTS.md", "CLAUDE.md"],
+    "filenames": ["AGENTS.md", "AGENTS.md", "CLAUDE.md"],
     "read_claude_md": true
   },
   "models_dev": {
 
@@ -33,9 +33,9 @@ ctest --test-dir build --output-on-failure
 - When touching tests: every TEST body gets a Chinese comment explaining the scenario.
 
 <!--
-Tip: acecode reads AGENT.md first, then AGENTS.md, and CLAUDE.md as a compatibility
+Tip: acecode reads AGENTS.md first, then AGENTS.md, and CLAUDE.md as a compatibility
 fallback, picking only one project-instructions file per directory. You can drop
-AGENT.md in subdirectories for module-specific overrides (outer-first in the merged
+AGENTS.md in subdirectories for module-specific overrides (outer-first in the merged
 prompt, so inner directories can tighten outer rules).
 
 Toggle read_claude_md in ~/.acecode/config.json to ignore CLAUDE.md, or override
 
@@ -27,7 +27,7 @@
     }
     setText($('working-count'),working);setText($('resting-count'),(6-working)+' 位待命 / 休息');
     const a=sim.agents[sim.selected],task=sim.tasks[sim.selected],status=sim.status(sim.selected),percent=Math.floor(task.elapsed/task.duration*100);
-    setText($('detail-name'),a.name);setText($('detail-role'),a.role);setText($('detail-id'),'AGENT '+String(a.index+1).padStart(2,'0'));
+    setText($('detail-name'),a.name);setText($('detail-role'),a.role);setText($('detail-id'),'AGENTS '+String(a.index+1).padStart(2,'0'));
     setText($('detail-state'),status.label);
     const description=task.elapsed>=task.duration?'已完成'+task.title+'。休息一下，准备迎接下一个好想法。':!sim.ready(a.index)?'等待'+task.deps.filter(i=>sim.tasks[i].elapsed<sim.tasks[i].duration).map(i=>sim.agents[i].name).join('、')+'交接，然后开始'+task.title+'。':task.text;
     setText($('detail-task'),description);setText($('detail-percent'),percent+'%');$('detail-progress').style.width=percent+'%';
 
@@ -55,7 +55,7 @@
           <div class="panel-heading"><h2>今天的伙伴</h2><span class="count-label">6 位</span></div>
           <div class="team-summary"><span><i class="status-dot"></i><span id="working-count">4</span> 位工作中</span><span id="resting-count">2 位准备中</span></div>
           <div class="agent-list" id="agent-list"></div>
-          <section class="agent-detail" aria-label="选中成员详情"><div class="detail-heading"><span class="detail-label">正在关注</span><span id="detail-id">AGENT 01</span></div><div class="detail-name"><strong id="detail-name">阿策</strong><span id="detail-role">团队协调</span><span id="detail-state" class="state-tag">构思中</span></div><p id="detail-task">把一个好想法拆成可执行的步骤。</p><div class="detail-meter"><span>当前任务</span><span id="detail-percent">0%</span></div><div class="meter"><span id="detail-progress"></span></div></section>
+          <section class="agent-detail" aria-label="选中成员详情"><div class="detail-heading"><span class="detail-label">正在关注</span><span id="detail-id">AGENTS 01</span></div><div class="detail-name"><strong id="detail-name">阿策</strong><span id="detail-role">团队协调</span><span id="detail-state" class="state-tag">构思中</span></div><p id="detail-task">把一个好想法拆成可执行的步骤。</p><div class="detail-meter"><span>当前任务</span><span id="detail-percent">0%</span></div><div class="meter"><span id="detail-progress"></span></div></section>
           <section class="activity-section" aria-label="团队动态"><div class="activity-heading"><h3>办公室动态</h3><span class="activity-live">LIVE</span></div><ol class="activity-list" id="activity-list" aria-live="off"></ol></section>
           <div class="team-footer"><svg><use href="#i-coffee"/></svg><span>好代码和好咖啡，都值得等待。</span></div>
         </aside>
 
@@ -2512,17 +2512,24 @@ empty `commands` array plus enabled global skills only:
 ```json
 {
   "builtins": [
-    {"name":"init","description":"Analyze this codebase and generate (or improve) AGENT.md"},
+    {"name":"init","description":"Analyze this codebase and generate (or improve) AGENTS.md"},
     {"name":"compact","description":"Compress conversation history"},
     {"name":"goal","description":"Create, view, pause, resume, edit, or clear the thread goal"},
-    {"name":"plan","description":"Enter plan mode or start planning a described task"}
+    {"name":"plan","description":"Enter plan mode or start planning a described task"},
+    {"name":"remote-control","description":"...","aliases":["rc"]}
   ],
   "skills": [
     {"name":"my-skill","description":"..."}
   ]
 }
 ```
 
+A builtin's aliases are listed in its optional `aliases` array instead of as
+separate entries; the slash picker shows one row per command and appends the
+alias in parentheses only when the typed query matches that alias (for example
+`remote-control (rc)`). `POST /api/sessions/:id/commands` still accepts both
+the name and its aliases.
+
 For backward compatibility, omitting the `workspace` query entirely returns
 the builtin-only response and omits both `commands` and `skills`.
 
 
@@ -208,7 +208,7 @@ At handoff, git status additionally shows modifications to `.gitignore` and
 `AGENTS.md`, and an untracked `.comet/` directory. These were not part of the
 rollback changes listed above; investigate if needed and do not revert them.
 
-Read current AGENT.md/AGENTS.md and follow the active session's instructions.
+Read current AGENTS.md/AGENTS.md and follow the active session's instructions.
 Use apply_patch for manual edits, and do not change vendored/submodule sources.
 Codegraph was unavailable/not indexed in the previous session; ordinary bounded
 source inspection was used. `rg` is not installed; use grep or built-in tools.
 
@@ -70,14 +70,14 @@
 
 "project-rules": page("把项目约定写成可随仓库维护的规则，让 ACECode 在理解和修改代码时遵循相同的边界。", [
     section("files", "项目规则文件",
-        '''<p>ACECode 默认识别 <code>AGENT.md</code>、<code>AGENTS.md</code> 和 <code>CLAUDE.md</code>。同一目录按配置中的文件名顺序选用第一个匹配文件，默认顺序如上；不会把同目录三个文件无条件全部合并。</p><p>加载先读取用户数据目录中的全局规则，再按项目目录层级从外到内收集。是否读取、文件名顺序及内容长度都受配置控制，CLAUDE.md 还受独立读取开关控制。</p><p>规则适合记录目录职责、构建测试命令、编码风格、禁止修改的区域和交付标准。不要把临时任务状态、长日志和密钥放进去，冗长规则也会占用模型上下文。</p>'''),
+        '''<p>ACECode 默认识别 <code>AGENTS.md</code>、<code>AGENTS.md</code> 和 <code>CLAUDE.md</code>。同一目录按配置中的文件名顺序选用第一个匹配文件，默认顺序如上；不会把同目录三个文件无条件全部合并。</p><p>加载先读取用户数据目录中的全局规则，再按项目目录层级从外到内收集。是否读取、文件名顺序及内容长度都受配置控制，CLAUDE.md 还受独立读取开关控制。</p><p>规则适合记录目录职责、构建测试命令、编码风格、禁止修改的区域和交付标准。不要把临时任务状态、长日志和密钥放进去，冗长规则也会占用模型上下文。</p>'''),
     section("init", "使用初始化命令",
-        '''<p>在正确的项目中提交 <code>/init</code>，让 ACECode 分析仓库并生成或改进 <code>AGENT.md</code>。它会调用模型，可能需要阅读文件和写入确认；生成后仍应检查其中的目录与命令是否真实可用。</p>''',
+        '''<p>在正确的项目中提交 <code>/init</code>，让 ACECode 分析仓库并生成或改进 <code>AGENTS.md</code>。它会调用模型，可能需要阅读文件和写入确认；生成后仍应检查其中的目录与命令是否真实可用。</p>''',
         code("/init", "在 ACECode 输入框中提交"),
-        '''<p>已有团队维护的 AGENTS.md 时，先明确希望更新哪个文件，避免无意引入优先级更高但内容重复的 AGENT.md。桌面/Web 选择命令只把文本填入输入框，提交后才执行。</p>''',
+        '''<p>已有团队维护的 AGENTS.md 时，先明确希望更新哪个文件，避免无意引入优先级更高但内容重复的 AGENTS.md。桌面/Web 选择命令只把文本填入输入框，提交后才执行。</p>''',
         figure("CF-04", "初始化后的项目规则检查", "展示提交 /init 的位置以及生成规则的文件预览，标出构建命令、测试命令和禁止修改范围。")),
     section("example", "一份小而明确的规则",
-        code("项目使用 Python，业务代码放在 src/，测试放在 tests/。\n修改前先阅读相关模块与测试；不要修改 generated/ 下的生成文件。\n保持现有公开接口，新增行为需要相应测试。\n完成后运行项目 README 中记录的验证命令，并报告未执行的检查。", "AGENT.md 内容示例"),
+        code("项目使用 Python，业务代码放在 src/，测试放在 tests/。\n修改前先阅读相关模块与测试；不要修改 generated/ 下的生成文件。\n保持现有公开接口，新增行为需要相应测试。\n完成后运行项目 README 中记录的验证命令，并报告未执行的检查。", "AGENTS.md 内容示例"),
         '''<p>把示例中的语言、路径和验证命令替换成自己的项目约定。稳定的个人偏好放在个性化或记忆中，可复用的操作流程整理为<a href="skills.html">技能</a>；本项目特有的约束留在项目规则里。</p>''')
 ], ["src/domain/project_instructions/instructions_loader.cpp", "src/base/config/config.hpp", "src/apps/tui/commands/builtin_commands.cpp", "docs/user-manual.md"]),
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@`
`27`	`27`	`}`
`28`	`28`	`setText($('working-count'),working);setText($('resting-count'),(6-working)+' 位待命 / 休息');`
`29`	`29`	`const a=sim.agents[sim.selected],task=sim.tasks[sim.selected],status=sim.status(sim.selected),percent=Math.floor(task.elapsed/task.duration*100);`
`30`		`- setText($('detail-name'),a.name);setText($('detail-role'),a.role);setText($('detail-id'),'AGENT '+String(a.index+1).padStart(2,'0'));`
	`30`	`+ setText($('detail-name'),a.name);setText($('detail-role'),a.role);setText($('detail-id'),'AGENTS '+String(a.index+1).padStart(2,'0'));`
`31`	`31`	`setText($('detail-state'),status.label);`
`32`	`32`	`const description=task.elapsed>=task.duration?'已完成'+task.title+'。休息一下，准备迎接下一个好想法。':!sim.ready(a.index)?'等待'+task.deps.filter(i=>sim.tasks[i].elapsed<sim.tasks[i].duration).map(i=>sim.agents[i].name).join('、')+'交接，然后开始'+task.title+'。':task.text;`
`33`	`33`	`setText($('detail-task'),description);setText($('detail-percent'),percent+'%');$('detail-progress').style.width=percent+'%';`