速查手册
按使用入口查找常用快捷键、命令与数据位置。具体可用项以当前安装的菜单和 /help 为准。
快捷键
| 入口 | 按键 | 作用 |
|---|---|---|
| 桌面 / Web 输入框 | Enter | 空闲时发送；运行时按当前状态排队。 |
| 桌面 / Web 输入框 | Shift+Enter | 换行。 |
| 桌面文件编辑器 | Ctrl+S | 保存当前可编辑文件。 |
| 桌面终端停靠区 | Ctrl+` | 显示或隐藏底部终端。 |
| TUI | Esc | 等待时中断、退出 Shell 模式或拒绝当前确认。 |
| TUI | Ctrl+C | 第一次清空输入并提示，1 秒内再次按下退出。 |
| TUI | Ctrl+O | 全局展开或折叠工具结果。 |
| TUI | Ctrl+E | 聚焦工具时切换该结果展开；否则移动到输入末尾。 |
| TUI | Ctrl+P | 空闲普通输入状态切换权限；菜单或历史状态按对应导航处理。 |
| @ 候选菜单 | ↑ / ↓、Enter | 选择并引用文件或文件夹。 |
| @ 候选菜单 | Tab / → | 进入选中的文件夹。 |
按键取决于焦点和当前模式。浏览器、操作系统或终端软件可能拦截组合键；遇到冲突优先使用可见按钮或菜单。本文档自身的 Ctrl+K 搜索快捷键不代表 ACECode 产品的同名操作。
斜杠命令
| 命令 | 用途与范围 |
|---|---|
/help | 查看当前注册的可用命令。 |
/model | 模型选择；带名称可切换预设，TUI 支持 --cwd、--default 范围。 |
/mode | 查看或切换权限模式。 |
/config | 打开设置；/config show 查看文本概要。 |
/tokens | 查看会话 token 用量。 |
/compact | 调用模型压缩当前上下文。 |
/init | 分析项目并生成或改进项目规则。 |
/resume | TUI 恢复历史会话。 |
/rewind、/checkpoint | TUI 打开回退选择器；代码恢复取决于检查点可用性。 |
/fork | TUI 从用户回合选择分叉，按选择器确认范围。 |
/archive | 归档当前会话并开始新的对话状态。 |
/clear、/new | 清理当前对话状态，开始新一段工作。 |
/side 问题、/btw 问题 | 独立的一次旁支问答，不调用工具。 |
/turn 补充说明 | 中断当前轮并发送指导；与排队卡片的插话时机不同。 |
/skills、/mcp | 查看或管理技能与 MCP；带参数执行相应子命令。 |
/tools、/hooks、/connectors | 打开对应能力管理入口。 |
/lsp | 查看语言服务器状态。 |
/memory | 列出、查看、编辑、遗忘或重载持久记忆。 |
/tasks | TUI 管理后台子任务。 |
/proxy | 检查有效代理及临时覆盖状态。 |
/rc、/remote-control | 激活已配置的默认渠道；show 查看，off 解绑。 |
/exit | 退出 TUI。 |
不同入口的管理命令可能打开界面或返回文本，不能把 TUI 选择器当作所有前端都有的窗口。桌面/Web 在命令菜单中选择后仍需提交。技能也可能注册自己的斜杠入口，以当前发现的名称为准。
命令行参数
| 命令或参数 | 用途 |
|---|---|
acecode | 在当前目录打开交互式 TUI。 |
acecode configure | 初次配置或重新配置。 |
acecode --version | 显示版本。 |
acecode -r | 打开 TUI 历史会话选择。 |
acecode --resume [ID] | TUI 恢复最近会话或指定会话；print 模式必须带 ID。 |
acecode -p "提示" | 执行无界面单轮任务。 |
--output-format text|json|stream-json | 选择 print 模式输出格式。 |
--model NAME | 选择已保存预设。 |
--permission-mode MODE | print 模式支持 default、accept-edits、plan、yolo。 |
--max-turns N | print 模式的智能体循环上限。 |
--session-id ID | 指定新会话 ID。 |
-c、--continue | print 模式继续当前目录最近会话。 |
--list-tools、--list-skills、--list-mcp | 只列出可发现能力。 |
--enable-skills 名称、--enable-mcp 名称 | 为 print 模式显式开启扩展。 |
--disable-tools 名称 | 为 print 模式禁用指定工具。 |
acecode daemon [start|status|stop] | 独立后台管理。 |
acecode daemon --foreground | 前台运行后台服务。 |
acecode daemon --cwd=路径 --port=端口 | 指定独立后台的起始工作目录与端口。 |
acecode upgrade | 按已配置更新源执行自更新。 |
完整 print 参数运行 acecode -p --help。危险启动参数 --yolo / --dangerous 会绕过权限与路径检查，不作为排错默认步骤。查看脚本示例及退出码，参见 CLI。
本地配置和数据
下面的路径相对于个人数据目录 ~/.acecode/；Windows 为 %USERPROFILE%/.acecode/。Windows 服务另用 %PROGRAMDATA%/acecode/，远端进程使用远端身份的目录。
| 路径 | 内容 |
|---|---|
config.json | 全局配置、模型连接与扩展定义，可能包含凭据。 |
config-backups/ | 有效配置快照和损坏配置备份，也可能含凭据。 |
projects/ | 按项目范围保存的会话、元数据和输入历史等记录。 |
skills/ | 用户技能；还可读取其他已启用根目录。 |
memory/ | MEMORY.md 索引与记忆条目。 |
hooks.json | 用户级 Hooks 定义。 |
logs/ | 按运行方式与日期保存的日志。 |
run/ | 独立后台的 PID、端口、GUID、心跳和 Token。 |
run/desktop-shared/ | 桌面托管后台的独立运行身份。 |
项目规则和项目技能可能保存在仓库本身。TUI 的 acecode.log 位于启动工作目录，不在上述 logs 目录。Git 工作树路径以任务实际记录为准。
备份前先结束相关写入，并同时考虑会话数据与实际项目文件。不要只备份 Markdown 导出就假定能够完整恢复，也不要在运行时随意删除身份文件或数据库。卸载与保留数据见更新与卸载。