| 1 | # Reasonix CLI 命令参考 |
| 2 | |
| 3 | <a href="../README.zh-CN.md">README</a> |
| 4 | · |
| 5 | <a href="./CLI.md">English</a> |
| 6 | · |
| 7 | <a href="./GUIDE.zh-CN.md">使用指南</a> |
| 8 | |
| 9 | 本文介绍交互式会话、一次性自动化、会话恢复、权限参数和常用会话内命令。Provider |
| 10 | 配置、插件和沙盒策略见[使用指南](./GUIDE.zh-CN.md)。 |
| 11 | |
| 12 | ## 启动会话 |
| 13 | |
| 14 | ```sh |
| 15 | reasonix |
| 16 | reasonix --model deepseek-pro |
| 17 | reasonix --profile delivery --effort high |
| 18 | reasonix --dir /path/to/project |
| 19 | ``` |
| 20 | |
| 21 | 不带子命令运行 `reasonix` 会进入交互式终端界面。尚未配置 provider 时，先运行 |
| 22 | `reasonix setup`。 |
| 23 | |
| 24 | | 参数 | 用途 | |
| 25 | | --- | --- | |
| 26 | | `--model NAME` | 选择已配置的 provider 或 `provider/model` 引用。 | |
| 27 | | `--profile economy\|balanced\|delivery` | 选择运行时工作模式。 | |
| 28 | | `--effort LEVEL` | 覆盖当前会话的 reasoning effort。 | |
| 29 | | `--max-steps N` | 为本次运行设置工具调用轮数上限；`0` 使用自动执行。 | |
| 30 | | `--dir PATH` | 加载配置和工具前切换 workspace 根目录。 | |
| 31 | | `--add-dir PATH` | 增加一个允许工具写入的目录；可重复传入。 | |
| 32 | | `-c`、`--continue` | 恢复最近一次会话。 | |
| 33 | | `-r`、`--resume [QUERY]` | 打开会话选择器，或恢复匹配的会话。 | |
| 34 | | `--copy` | 复制要恢复的会话，并在可写副本中继续。 | |
| 35 | | `--allowed-tools RULES` | 增加仅当前会话生效的权限 allow 规则；可重复传入，`--allowedTools` 是别名。 | |
| 36 | | `--permission-mode MODE` | 以指定的权限姿态启动。 | |
| 37 | | `--yolo` | 以 YOLO 模式启动；是 `--dangerously-skip-permissions` 的别名。 | |
| 38 | |
| 39 | 适用时，参数可以放在 prompt 前面或后面。 |
| 40 | |
| 41 | ## 更新原生 CLI |
| 42 | |
| 43 | ```sh |
| 44 | reasonix upgrade # 安装最新正式版 |
| 45 | reasonix upgrade --check # 只报告目标版本 |
| 46 | reasonix upgrade --force # 重新安装当前正式版 |
| 47 | ``` |
| 48 | |
| 49 | 更新器只选择严格的 `vX.Y.Z` 非 prerelease GitHub Release。1.x 兼容期内，旧渠道 |
| 50 | 位置参数与 `--channel` 仍可使用，但都会解析到同一正式版并打印废弃提示。历史 |
| 51 | `[cli].update_channel` 值不再影响更新，并会在 Reasonix 下次保存配置时移除。别名 |
| 52 | `reasonix update` 的行为完全相同。 |
| 53 | |
| 54 | ## 配置供应商 |
| 55 | |
| 56 | ```sh |
| 57 | reasonix setup # 管理用户全局配置 |
| 58 | reasonix setup --local # 管理 ./reasonix.toml |
| 59 | reasonix setup /path/to/config.toml |
| 60 | ``` |
| 61 | |
| 62 | 在交互式终端中，`reasonix setup` 是一个暂存式供应商管理器。它会列出已配置的 |
| 63 | provider，并支持： |
| 64 | |
| 65 | - 添加 OpenAI-compatible 或 Anthropic-compatible provider； |
| 66 | - 编辑 endpoint 和模型列表； |
| 67 | - 更新 API Key，或测试连接并刷新模型； |
| 68 | - 设置默认模型； |
| 69 | - 删除 provider。 |
| 70 | |
| 71 | 选择“保存并退出”后会先展示并确认待执行操作；取消会丢弃本次修改。保存时 setup 会重新 |
| 72 | 加载最新配置：桌面端或其他 CLI 产生的不相关修改会被保留，改到同一项时则报告冲突， |
| 73 | 不会直接覆盖。 |
| 74 | |
| 75 | Provider 定义只保存 `api_key_env` 变量名。即使使用 `--local`，Key 的真实值也始终保存 |
| 76 | 在 CLI 与桌面端共用的 Reasonix 全局 `.env` 中。如果变量名已被其他 provider 使用， |
| 77 | setup 会询问是否共享该凭据；两个 provider 使用不同 Key 时，应改用不同变量名。通过 |
| 78 | setup 添加或删除 provider 时，也会同步维护桌面端 provider access，因此相同模型可以 |
| 79 | 直接在桌面端使用。 |
| 80 | |
| 81 | ### 配置区域定价货币 |
| 82 | |
| 83 | 使用用户全局货币命令查看或选择 DeepSeek 官方区域价格表： |
| 84 | |
| 85 | ```sh |
| 86 | reasonix config currency # 显示已保存值和最终解析结果 |
| 87 | reasonix config currency auto # 跟随解析后的 locale |
| 88 | reasonix config currency CNY |
| 89 | reasonix config currency USD |
| 90 | ``` |
| 91 | |
| 92 | `auto` 会把简体或繁体中文 locale 解析为 CNY，把英文及其他 locale 解析为 USD。显式 |
| 93 | 选择 `CNY` 或 `USD` 后，货币不再跟随界面语言。该偏好只保存在用户全局配置中，项目 |
| 94 | `reasonix.toml` 无法覆盖，因此不支持 `--local`。自定义 provider 价格不会被修改。 |
| 95 | |
| 96 | 在交互式会话中，`/currency` 显示已保存值和最终解析结果； |
| 97 | `/currency auto|CNY|USD` 会修改偏好并刷新当前运行时，同时保留当前对话。 |
| 98 | |
| 99 | ### 配置自动压缩阈值 |
| 100 | |
| 101 | 桌面端与 CLI 共用用户全局的自动压缩阈值。可以查看当前生效值及来源、修改全局默认值， |
| 102 | 或为当前项目添加覆盖： |
| 103 | |
| 104 | ```sh |
| 105 | reasonix config compact-ratio # 查看生效值及来源 |
| 106 | reasonix config compact-ratio 75 # 设置用户全局默认值 |
| 107 | reasonix config compact-ratio --local 75 # 写入 ./reasonix.toml 项目覆盖 |
| 108 | ``` |
| 109 | |
| 110 | 可设置范围为 65–85%，内置默认值为 80%。数值越低越早压缩，可能降低 prompt prefix |
| 111 | 缓存复用率；数值越高则会在压缩前保留更多上下文。项目 `reasonix.toml` 的优先级高于 |
| 112 | 用户全局配置。修改会应用于新启动的 CLI 会话；已经运行的会话继续使用启动时加载的阈值。 |
| 113 | |
| 114 | ## 一次性运行与自动化 |
| 115 | |
| 116 | 脚本只需要最终回答时，使用 `-p` / `--print`： |
| 117 | |
| 118 | ```sh |
| 119 | reasonix -p "总结这个仓库" |
| 120 | reasonix -p "总结这个仓库" --output-format json |
| 121 | reasonix run "实现 main.go 里的 TODO" |
| 122 | reasonix run --auto "实现 main.go 里的 TODO" |
| 123 | echo "解释这段代码" | reasonix run |
| 124 | ``` |
| 125 | |
| 126 | 未使用 `-p` 或结构化输出格式时，`reasonix run` 保持正常的终端流式展示。它也接受 |
| 127 | `--model`、`--profile`、`--max-steps`、`--effort`、`--dir`、`--add-dir`、 |
| 128 | `--continue`、`--resume QUERY`、`--copy`、`--allowed-tools` 和 |
| 129 | `--permission-mode`，以及作为 `--permission-mode auto` 别名的 `--auto` / `-y`。 |
| 130 | |
| 131 | ### 基准对照组 |
| 132 | |
| 133 | `--ablate` 用于整体关闭某个子系统，让基准测试能把成功率的变化归因到它身上。取值是 |
| 134 | `evidence`、`planner`、`subagent`、`retrieval`、`compaction` 的逗号分隔组合，另外还接受 |
| 135 | `none`（默认，全部启用）和 `all`。子代理继承父代理的对照组配置，对照组名称会写入 |
| 136 | `--metrics` 文件，因此记录下来的每次运行都能自证跑的是哪一组。 |
| 137 | |
| 138 | ```sh |
| 139 | reasonix run --ablate evidence,planner --metrics run.json "修复失败的测试" |
| 140 | ``` |
| 141 | |
| 142 | 这是测量工具，不是调优开关：关掉某个子系统只会让 Reasonix 在它本来负责的工作上变差。 |
| 143 | |
| 144 | ### 输出格式 |
| 145 | |
| 146 | | 格式 | 行为 | |
| 147 | | --- | --- | |
| 148 | | `text` | 人类可读文本；配合 `-p` 时只输出最终回答。 | |
| 149 | | `json` | 输出一个最终结果对象。 | |
| 150 | | `stream-json` | 每行输出一个共用 `eventwire` JSON 对象，最后再输出最终结果对象。 | |
| 151 | |
| 152 | ```sh |
| 153 | reasonix -p "列出有风险的改动" --output-format text |
| 154 | reasonix -p "总结 diff" --output-format json |
| 155 | reasonix run "运行测试" --output-format stream-json |
| 156 | ``` |
| 157 | |
| 158 | 最终结构化对象的格式如下： |
| 159 | |
| 160 | ```json |
| 161 | { |
| 162 | "type": "result", |
| 163 | "subtype": "success", |
| 164 | "is_error": false, |
| 165 | "duration_ms": 123, |
| 166 | "num_turns": 1, |
| 167 | "result": "...", |
| 168 | "session_id": "...", |
| 169 | "total_cost": 0, |
| 170 | "currency": "CNY", |
| 171 | "total_cost_usd": 0, |
| 172 | "usage": { |
| 173 | "input_tokens": 0, |
| 174 | "output_tokens": 0, |
| 175 | "cache_read_input_tokens": 0, |
| 176 | "cache_creation_input_tokens": 0 |
| 177 | } |
| 178 | } |
| 179 | ``` |
| 180 | |
| 181 | `total_cost` 使用 `currency` 给出的 ISO 货币代码计价；DeepSeek 官方价格目前会输出 |
| 182 | `CNY` 或 `USD`。`total_cost_usd` 作为数字兼容别名继续保留，并与 `total_cost` 数值 |
| 183 | 相同；即使 `currency` 为 `CNY`，它也不会按旧字段名自动换算为美元。新接入必须同时读取 |
| 184 | `total_cost` 和 `currency`。如果一次结构化运行包含多种货币，Reasonix 会直接报错， |
| 185 | 不会输出容易误解的合计金额。 |
| 186 | |
| 187 | 执行失败时使用 `subtype: "error_during_execution"` 和 `is_error: true`。 |
| 188 | 结构化模式会把运行时错误保留在 JSON 中，不再额外重复输出一份人类可读错误。 |
| 189 | |
| 190 | ### 脱敏机器接口 |
| 191 | |
| 192 | 自动化只需要生命周期遥测、不能接收 prompt、reasoning、工具参数/输出或审批文本时， |
| 193 | 使用独立的事件参数： |
| 194 | |
| 195 | ```sh |
| 196 | reasonix run --events-jsonl "运行 focused tests" |
| 197 | ``` |
| 198 | |
| 199 | 每行都包含 `schema_version`、`sequence` 和 `kind`，最后一行为 |
| 200 | `kind: "run_done"`。`--events-jsonl` 与包含更多内容的 |
| 201 | `--output-format stream-json` 是两个独立契约，不能和 `--output-format` |
| 202 | 组合使用。 |
| 203 | |
| 204 | 以下只读命令可以查询持久化状态，但不会输出 transcript、label、command、output、路径、 |
| 205 | PID 或 hostname。这里的“只读”是指不会修改 transcript、runtime、recovery 或被查询的 |
| 206 | 状态；首次使用脱敏机器接口时，Reasonix 可能会在用户状态目录初始化一个私有身份密钥： |
| 207 | |
| 208 | ```sh |
| 209 | reasonix session list --json [--dir SESSION_DIR | --project-root PATH] |
| 210 | reasonix session show <machine-session-id> --json [--dir SESSION_DIR | --project-root PATH] |
| 211 | reasonix session status <machine-session-id> --json [--dir SESSION_DIR | --project-root PATH] |
| 212 | reasonix session recovery [<machine-session-id>] --json [--dir SESSION_DIR | --project-root PATH] |
| 213 | reasonix task list --json [--dir SESSION_DIR | --project-root PATH] [--session MACHINE_SESSION_ID] |
| 214 | reasonix task show <task-id> --json [--dir SESSION_DIR | --project-root PATH] [--session MACHINE_SESSION_ID] |
| 215 | reasonix task monitor list --json [--dir PROJECT_DIR] |
| 216 | reasonix task monitor status <task-id> --json [--dir PROJECT_DIR] |
| 217 | reasonix task monitor events <task-id> --json|--jsonl [--dir PROJECT_DIR] [--after N] [--follow] |
| 218 | reasonix hook list --json [--project-root PATH] [--home-dir PATH] |
| 219 | reasonix hook status --json [--project-root PATH] [--home-dir PATH] |
| 220 | ``` |
| 221 | |
| 222 | 对于 `session` 和 `task`，`--dir` 明确指定 session 存储目录，`--project-root` |
| 223 | 则解析指定项目的 session store；两者不能同时使用。都未指定时，Reasonix 选择当前 |
| 224 | 项目的 session store。对于 `hook`，`--dir` 是 `--project-root` 的别名。 |
| 225 | `hook list` 的状态值为 `active` 或 `invalid`；`invalid` 表示配置的 |
| 226 | event 因事件名、命令/context 来源或工具事件 matcher 无效而无法执行。非工具事件 |
| 227 | 会忽略 matcher。 |
| 228 | |
| 229 | 机器 session ID 是带密钥的 opaque hash，不是 transcript 文件名。在同一个 Reasonix |
| 230 | 用户状态目录中，同一 session 的 ID 保持稳定；不同安装密钥会生成互不关联的 ID，无法再 |
| 231 | 根据时间戳或模型 label 离线猜测。迁移 Reasonix 状态目录时，如果自动化依赖已有 machine |
| 232 | ID，需要一并保留该私有身份密钥。任务仍在运行时 |
| 233 | `finished_at` 为空；只有任务已经结束并且持久化产物存在时，才会输出 |
| 234 | `artifact_complete=true`。没有 live session lease 的 `running` 记录会显示为 |
| 235 | `interrupted`；再次打开该 session 时也会自动修复持久化生命周期状态。 |
| 236 | |
| 237 | Schema version 1 的兼容规则： |
| 238 | |
| 239 | - 消费端必须忽略未知字段； |
| 240 | - 同一 schema version 内不会删除字段或改变字段类型； |
| 241 | - 空集合编码为 `[]`； |
| 242 | - 参数错误退出码为 `2`，状态/查询错误退出码为 `1`； |
| 243 | - 机器命令错误是带稳定 `error.code` 的 JSON 对象。 |
| 244 | |
| 245 | ## 恢复会话 |
| 246 | |
| 247 | ```sh |
| 248 | reasonix --continue |
| 249 | reasonix --resume |
| 250 | reasonix --resume provider-config |
| 251 | reasonix --resume <session-id> |
| 252 | reasonix --resume provider-config --copy |
| 253 | ``` |
| 254 | |
| 255 | - `--continue` 立即恢复最新保存的会话。 |
| 256 | - 在交互式终端中，单独使用 `--resume` 会打开可搜索选择器。 |
| 257 | - `--resume QUERY` 接受精确 session ID 或路径，也支持唯一匹配标题或预览内容的 |
| 258 | 子串。没有匹配或匹配不唯一时会返回明确错误。 |
| 259 | - 为保持兼容，仍接受 `--resume=true` 和 `--resume=false`。 |
| 260 | - `--copy` 不修改原 transcript，而是在新的可写会话中继续。原会话已被另一个 |
| 261 | Reasonix 进程占用时可以使用它。 |
| 262 | |
| 263 | 一次性运行可用 `reasonix run --resume QUERY "任务"`，支持 session 文件路径、 |
| 264 | session ID，或来自 `--events-jsonl` / `reasonix session show --json` 的不透明 |
| 265 | machine session ID。Session lease 会阻止桌面端和 CLI 同时写入同一个 transcript。 |
| 266 | |
| 267 | ## 权限 |
| 268 | |
| 269 | ```sh |
| 270 | reasonix --permission-mode plan |
| 271 | reasonix --permission-mode acceptEdits |
| 272 | reasonix -p "运行指定测试" --allowed-tools "Bash(go test ./...)" |
| 273 | reasonix --allowed-tools "Bash(git *) Edit" |
| 274 | reasonix --allowed-tools "Bash(go test ./...)" --allowed-tools read_file |
| 275 | ``` |
| 276 | |
| 277 | | 模式 | 行为 | |
| 278 | | --- | --- | |
| 279 | | `manual`、`ask` | 普通权限决策会弹出审批。 | |
| 280 | | `auto` | 自动批准普通 fallback 操作，同时保留显式 ask 和 deny 规则。 | |
| 281 | | `acceptEdits` | 允许文件编辑工具；不等同于完整 Auto 模式。 | |
| 282 | | `dontAsk` | 未预先允许的请求直接拒绝，不弹出审批。 | |
| 283 | | `plan` | 以只读 Plan 模式启动交互式会话。 | |
| 284 | | `bypassPermissions` | 跳过审批；等同于 YOLO。 | |
| 285 | |
| 286 | 无人值守执行需要放行普通 writer fallback 时，使用 `reasonix run --auto ...` |
| 287 | （或 `-y`）。这个别名不能和显式 `--permission-mode` 同时使用。 |
| 288 | |
| 289 | `--allowed-tools` 是会话权限覆盖，不是 provider tool schema 过滤器。规则可以用逗号 |
| 290 | 或空格分隔，也可重复传入参数。配置中的 deny 规则始终优先于命令行 allow 规则。 |
| 291 | |
| 292 | 在非交互运行（`reasonix run` / `-p`）下没有可应答的审批，各模式都以非阻塞方式解析。 |
| 293 | 默认 `ask` / `manual` 对显式 Ask 决策和普通 writer fallback 失败关闭，只读调用仍会执行； |
| 294 | `acceptEdits` 放行其列出的文件编辑工具，其他 Ask 决策失败关闭；`auto` 放行普通 writer |
| 295 | fallback，但仍拒绝显式 ask 规则；`dontAsk` 拒绝未批准的 writer；`bypassPermissions` |
| 296 | 可越过普通 ask 与 writer fallback，但配置的 deny、Sandbox，以及始终需要人工新鲜批准的 |
| 297 | 工具（记忆、plan、沙箱逃逸、受管配置写入）仍然生效。在所有模式下，拥有当前项目 store |
| 298 | 的顶层 controller 仍可创建有界、非敏感、create-only 的 project/reference 记忆；其他 |
| 299 | 记忆变更在无人确认时仍会被拒绝。 |
| 300 | |
| 301 | ## 附加目录 |
| 302 | |
| 303 | ```sh |
| 304 | reasonix --add-dir ../shared |
| 305 | reasonix -p "同时更新两个项目" \ |
| 306 | --add-dir ../frontend \ |
| 307 | --add-dir ../backend |
| 308 | ``` |
| 309 | |
| 310 | 相对路径从 workspace 根目录解析，并且必须是已存在的目录。Reasonix 会解析符号链接、 |
| 311 | 去重，并在当前会话中扩展文件写入工具和沙盒 Bash 的写入边界。这些目录只在运行时生效， |
| 312 | 不会写入配置。 |
| 313 | |
| 314 | ## 交互操作 |
| 315 | |
| 316 | `/model`、`/provider` 和 `/resume` 使用可搜索选择器。审批提示也使用相同的行选择 |
| 317 | 交互，同时保留原有单键快捷操作。 |
| 318 | |
| 319 | | 按键 | 操作 | |
| 320 | | --- | --- | |
| 321 | | `Up` / `Down`、`Ctrl+P` / `Ctrl+N` | 在选择器或审批行之间移动。 | |
| 322 | | `j` / `k` | 搜索词为空时移动；开始搜索后作为普通 `j` / `k` 字符输入。 | |
| 323 | | 输入文字 | 过滤可搜索选择器。 | |
| 324 | | `Enter` | 选择当前高亮项。 | |
| 325 | | `Esc` | 取消当前选择器或审批。 | |
| 326 | | `y` / `a` / `p` / `n`、数字键 | 执行对应的审批动作。 | |
| 327 | | `Shift+Tab` | 按 `Ask → Auto → Plan → Ask` 循环。 | |
| 328 | | `Ctrl+Y` | 独立切换 YOLO，不进入安全模式循环。 | |
| 329 | |
| 330 | 响应式底栏左侧显示当前交互状态；空间足够时，右侧显示模型、推理强度和工作模式。第二行按 |
| 331 | 可用性显示仓库与会话遥测，例如缓存命中率、上下文占用、压缩余量、后台任务和余额。 |
| 332 | “就绪”表示输入框当前空闲；进入选择器、审批、图片粘贴、shell 模式等需要用户关注的状态 |
| 333 | 时，这个位置会切换。窄终端会移动或压缩完整信息组，不会从中间截断标签。可见标签和工作 |
| 334 | 模式值会跟随 `/language`。 |
| 335 | |
| 336 | 使用 `/theme auto|light|dark` 选择终端背景模式，也可以从 `/theme` 列出的命名配色中选择 |
| 337 | 强调色。输入框上下边线、插入光标、选区、滚动条和底栏都会使用当前 CLI 主题。Transcript |
| 338 | 导航、多行输入、rewind 和剪贴板操作见[快捷键](./GUIDE.zh-CN.md#快捷键)。 |
| 339 | |
| 340 | 剪贴板操作按内容类型明确分开。本地 transcript 和输入框选区写入系统剪贴板，并且只有写入 |
| 341 | 成功后才提示完成；SSH 会回退到明确标记的 OSC 52 请求。文本粘贴继续走终端的 |
| 342 | bracketed-paste 动作（macOS 通常为 `Cmd+V`，其它平台使用终端自身配置）。Reasonix 接管 |
| 343 | 本地会话的鼠标时，没有选区的右键会读取剪贴板文本并走同一粘贴路径，有选区时右键优先复制。 |
| 344 | SSH 下远端进程无法读取本机剪贴板，请使用终端粘贴快捷键；`/mouse` 可恢复终端原生右键菜单。 |
| 345 | 图片粘贴由 Reasonix 接管：macOS/Linux 使用 `Ctrl+V`，Windows 使用 `Alt+V`，也可运行 |
| 346 | `/paste-image`；附件标记准备完成前，底栏会显示“正在粘贴图片…”。 |
| 347 | |
| 348 | ## 会话内命令 |
| 349 | |
| 350 | 在交互式会话中输入 `/help` 可查看完整命令列表。斜杠补全、帮助、dispatch 和别名来自 |
| 351 | 同一份 registry，因此界面展示与 TUI 实际接受的命令保持一致。 |
| 352 | |
| 353 | | 命令 | 用途 | |
| 354 | | --- | --- | |
| 355 | | `/model` | 搜索已配置模型并切换当前模型。 | |
| 356 | | `/provider` | 选择 provider，再选择该 provider 下的模型。 | |
| 357 | | `/resume` | 搜索最近会话并切换。 | |
| 358 | | `/status` | 显示模型、effort、cache、Git、后台任务，以及工作模式或余额信息。 | |
| 359 | | `/work-mode [economy\|balanced\|delivery]` | 查看或切换运行时工作模式；`/profile` 是别名。 | |
| 360 | | `/theme [auto\|light\|dark\|style]` | 查看或切换 CLI 背景模式和强调色。 | |
| 361 | | `/currency [auto\|CNY\|USD]` | 查看或切换用户全局官方定价货币，并刷新当前运行时。 | |
| 362 | | `/paste-image` | 读取剪贴板图片并插入可编辑的附件标记。 | |
| 363 | | `/mouse` | 切换应用内鼠标选区、滚动条和滚轮处理。 | |
| 364 | | `/effort` | 查看或切换 reasoning effort。 | |
| 365 | | `/output-style` | 选择回答风格。 | |
| 366 | | `/verbose` | 切换详细 reasoning 显示。 | |
| 367 | | `/sandbox` | 查看沙盒状态。 | |
| 368 | | `/goal` | 启动、查看或清除长周期 Goal。 | |
| 369 | | `/docs [问题]` | 显示内置语料身份，或先本地检索，再让当前配置的 AI 根据版本匹配证据回答。 | |
| 370 | | `/reasonix:docs [问题]` | 当已有自定义命令或兼容插件/Skill 别名占用 `/docs` 时优先使用的内置后备入口；若这个名称也已被占用，菜单会选择下一个空闲的 `reasonix:` 限定名，不覆盖原命令。 | |
| 371 | | `/mcp`、`/skills`、`/hooks` | 查看和管理扩展。 | |
| 372 | | `/remember <note>` | 把常驻 note 追加到项目指令文档；`# <note>` 是快捷方式。 | |
| 373 | | `/memory [subcommand]` | 查看指令、记忆 provenance、召回、revision 与恢复。 | |
| 374 | | `/rewind` | 把对话和/或代码恢复到更早的 turn。 | |
| 375 | | `/tree`、`/branch`、`/switch` | 查看或切换会话分支。 | |
| 376 | | `/reload` | 重载 agent 运行时（扩展、工具、skills、commands、hooks、providers），保留当前会话。回合运行中只排队一次；失败原子——重建失败时当前运行时不受影响。 | |
| 377 | |
| 378 | 切换模型、effort 或工作模式会重建运行时，同时保留当前对话、会话级权限覆盖、附加目录 |
| 379 | 访问权限和 session ownership。`/reload` 使用同一套失败原子重建语义。 |
| 380 | |
| 381 | ### 记忆诊断与恢复 |
| 382 | |
| 383 | 直接运行 `/memory` 会显示全部 project/global active facts，不会隐藏跨 scope 的同名条目。 |
| 384 | 每条事实包含稳定 ID、revision、scope、type、freshness 和 description。斜杠补全会提供 |
| 385 | 可用子命令、active ID/name，以及当前 store 拥有的 archive path。 |
| 386 | |
| 387 | | 命令 | 用途 | |
| 388 | | --- | --- | |
| 389 | | `/memory instructions` | 显示解析后的指令 precedence、目录、imports 和 diagnostics。 | |
| 390 | | `/memory recall` | 解释最近一次自动召回的 query、hits、score、原因、freshness 和预算。 | |
| 391 | | `/memory revisions <id-or-name>` | 显示 active revision 与不可变历史。 | |
| 392 | | `/memory restore <id-or-name> <revision>` | 把旧内容恢复为一个单调递增的新 revision。 | |
| 393 | | `/memory archived` | 列出 archive facts 及其受管路径。 | |
| 394 | | `/memory recover <archive-path>` | 不覆盖 active data，把 archive 恢复为新 revision。 | |
| 395 | |
| 396 | 这些命令始终作用于当前 session controller。当会话位于远端主机上（`reasonix remote |
| 397 | connect` 或桌面的远程网页窗口）时，它们使用远程 memory catalog，绝不回退读取桌面本机 |
| 398 | 记忆。权限、自动召回、写入确认和迁移行为见 |
| 399 | [Context Engine v2](./SESSION_MEMORY_RETRIEVAL.zh-CN.md)。 |
| 400 |