# ArkExp 命令参考

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

ArkExp 是一款面向通用模型体验、任务处理与本地工作流的 CLI。在终端中连接方舟模型与 ArkCLI 能力，通过清晰、可交互、可扩展的 TUI 完成日常任务。

> **说明**
>
> ArkExp 的安装、启动、配置及使用参见 [ArkExp 快速入门](/docs/agent-plan-personal-arkexp-quickstart)。

<span id="core-features"></span>
## 核心特性

**本地终端体验**
在熟悉的终端里使用方舟模型，流式查看响应、工具执行和任务状态。

**账号与模型开箱可用**
内置登录、套餐、用量、模型与 API 传输方式管理，减少环境切换。

**持续任务承载**
会话、目标、记忆、上下文与历史记录共同承载持续任务。

**可扩展**
通过 Skills、MCP、工作流、自定义斜杠命令和定时任务扩展能力。

**权限可控**
工具执行经过权限闸门；高风险操作需要明确确认。

**可恢复**
检查点、验证与失败记忆帮助任务在本地端更稳定地推进。

<span id="slash-commands"></span>
## 斜杠命令

> **注意**
>
> 斜杠命令、别名和参数是兼容性标识，必须按下表原样输入。

<span id="slash-commands-account"></span>
### 账号、模型与 API

| 命令 | 作用 | 用法 |
|-|-|-|
| `/login` | 登录火山引擎并建立方舟连接。 | `/login` |
| `/logout` | 退出登录并移除本地凭证。 | `/logout` |
| `/plans` | 发现、查看并选择可用套餐或连接。 | `/plans` |
| `/usage` | 查看当前方舟套餐的额度使用情况。 | `/usage` |
| `/models` | 打开模型选择器。 | `/models` |
| `/api` | 查看或切换 API 传输方式。 | `/api [status\\|auto\\|responses\\|chat] [--save]` |
| `/apm` | 查看遥测门禁，或启用 / 停用遥测。 | `/apm [status\\|on\\|off]` |
| `/language` | 查看或固定响应语言。 | `/language [status\\|auto\\|Chinese\\|English\\|Japanese]` |

<span id="slash-commands-sessions"></span>
### 会话与历史

| 命令 | 作用 | 用法 |
|-|-|-|
| `/new` | 开始新会话。 | `/new` |
| `/sessions` | 浏览并恢复历史会话。 | `/sessions` |
| `/resume` | 按 ID 或标题恢复会话；无参数时打开选择。 | `/resume [session-id-or-title]` |
| `/clear` | 清空当前聊天视图。 | `/clear` |
| `/timeline` | 打开时间线并跳转到指定消息。 | `/timeline` |
| `/fork` | 从时间线中的位置派生新会话。 | `/fork` |
| `/copy` | 复制完整会话记录。 | `/copy` |
| `/copy-last` | 复制最近一条用户消息。 | `/copy-last` |
| `/export` | 将会话导出为 Markdown。 | `/export` |
| `/compact` | 把较早历史压缩为摘要，释放上下文空间。 | `/compact` |
| `/summarize` | `/compact` 的兼容别名。 | `/summarize` |
| `/undo` | 撤销上一次会话回退。 | `/undo` |
| `/redo` | 重做被撤销的会话变更。 | `/redo` |
| `/stash` | 打开已暂存的输入草稿。 | `/stash` |
| `/stash-save` | 暂存当前输入，或直接暂存给定文本。 | `/stash-save [draft]` |
| `/stash-pop` | 恢复最近暂存的草稿。 | `/stash-pop` |

<span id="slash-commands-task-modes"></span>
### 任务模式与目标

| 命令 | 作用 | 用法 |
|-|-|-|
| `/agents` | 切换可用任务 Agent / 模式。 | `/agents` |
| `/plan` | 进入规划模式。 | `/plan` |
| `/implement` | 退出规划模式并回到执行模式。 | `/implement` |
| `/goal` | 设置、查看、暂停、恢复、完成或清除持久目标。 | `/goal <text> [--criteria "a;b"]`  <br/>`/goal [status\\|pause\\|resume\\|complete\\|clear]` |
| `/btw` | 基于当前上下文提一个旁路问题，不写入持久会话历史。 | `/btw <question>` |

<span id="slash-commands-workflow"></span>
### 工作流与扩展

| 命令 | 作用 | 用法 |
|-|-|-|
| `/workflow` | 打开工作流面板，运行或停止已保存工作流。 | `/workflow [list\\|run <name> [json]\\|stop <id>]` |
| `/workflows` | `/workflow` 的兼容别名。 | `/workflows [list\\|run <name> [json]\\|stop <id>]` |
| `/cron` | 创建和管理持久化的一次性或周期任务。 | `/cron` |
| `/mcp` | 查看、连接、认证、启停和刷新 MCP 服务。 | `/mcp` |
| `/tools` | 检查工具可见性、可用性、Schema 成本和权限风险。 | `/tools` |
| `/skills` | 查看、启停、安装或移除 Skills。 | `/skills`  <br/>`/skills install\\|remove <package-name>` |

<span id="slash-commands-workspace"></span>
### 工作区与内容

| 命令 | 作用 | 用法 |
|-|-|-|
| `/memory` | 浏览和配置用户、项目、会话与系统摘要记忆。 | `/memory`  <br/>`/memory show user\\|project\\|session\\|system-summary` |
| `/context` | 查看上下文 token、预算与使用率。 | `/context` |
| `/init` | 为当前项目生成 `AGENTS.md` 指令。 | `/init` |

<span id="slash-commands-interface"></span>
### 界面与诊断

| 命令 | 作用 | 用法 |
|-|-|-|
| `/help` | 打开快捷键与内置命令帮助。 | `/help` |
| `/theme` | 选择并预览界面主题。 | `/theme` |
| `/timestamps` | 显示或隐藏消息时间戳。 | `/timestamps` |
| `/thinking` | 显示或隐藏推理摘要。 | `/thinking` |
| `/status` | 查看 MCP、Skills 与 Commands 状态。 | `/status` |
| `/feedback` | 提交产品反馈。 | `/feedback <report>` |
| `/exit` | 退出 CLI。 | `/exit` |
| `/quit` | `/exit` 的兼容别名。 | `/quit` |

<span id="slash-commands-bundled-skills"></span>
### 随包 Skill 命令

以下命令来自随包 Skills；是否可执行取决于当前连接、权限与 Skill 启用状态。

| 命令 | 作用 | 用法 |
|-|-|-|
| `/add-resources` | 把本地路径或远程 URL 导入 OpenViking Resources。 | `/add-resources <source> [--to <target>]` |
| `/arkexp-docs` | 查询产品用法、配置与排障信息。 | `/arkexp-docs <question>` | \
| | > `/arkexp-docs` 是随包 Skill 提供的技术命令名。| |
| `/byted-web-search` | 在当前连接为 Agent Plan 时使用随包豆包搜索能力。 | `/byted-web-search <query>` |

<span id="slash-commands-aliases"></span>
### 别名速查

| 推荐命令 | 可用别名 | 说明 |
|-|-|-|
| `/models` | `/model` | 模型选择器。 |
| `/theme` | `/themes` | 主题选择器。 |
| `/sessions` | `/session` | 历史会话。 |
| `/skills` | `/skill` | Skill 管理。 |
| `/agents` | `/agent` | 任务模式选择。 |
| `/timestamps` | `/toggle-timestamps` | 时间戳显示开关。 |
| `/thinking` | `/toggle-thinking` | 推理摘要显示开关。 |
| `/stash-pop` | `/unstash` | 恢复最近草稿。 |
| `/compact` | `/summarize` | 会话压缩。 |
| `/workflow` | `/workflows` | 工作流管理。 |
| `/exit` | `/quit` | 退出。 |

<span id="api-detail"></span>
## /api 详解

`/api` 用于查看或切换当前模型连接的 API 传输方式。它不会更换模型、Endpoint 或套餐。

| 命令 | 行为 |
|-|-|
| `/api` | 显示当前传输方式；等价于 `/api status`。 |
| `/api status` | 显示当前传输方式与生效状态。 |
| `/api auto` | 优先使用 Responses API，并在兼容条件下安全回退到 Chat Completions。 |
| `/api responses` | 仅使用 Responses API。 |
| `/api chat` | 仅使用 Chat Completions API。 |
| `--save` | 追加到切换命令后，将选择持久化到后续会话。 |

```Bash
/api status
/api auto
/api responses --save
/api chat --save
```

> **说明**
>
> 不确定时使用 `/api auto`。只有在排障、兼容性验证或明确依赖某一协议时，才固定为 `responses` 或 `chat`。

<span id="keyboard-shortcuts"></span>
## 快捷键

| 快捷键 | 操作 |
|-|-|
| `Ctrl+C` | 运行中中断；空闲时退出。 |
| `Ctrl+H` | 打开帮助。 |
| `Ctrl+K` | 打开命令面板。 |
| `Ctrl+O` | 切换模型。 |
| `Ctrl+T` | 切换主题。 |
| `Ctrl+B` | 显示或隐藏侧边栏。 |
| `Ctrl+G` | 展开或折叠工具执行详情。 |
| `Enter` | 发送；运行中在安全边界调整当前任务。 |
| `Alt+Enter` | 将内容排队为当前任务后的独立追问。 |
| `Shift+Enter` / `Ctrl+Enter` | 输入换行。 |
| `Shift+Tab` | 循环切换权限姿态。 |
| `Esc` | 关闭对话框；运行中立即中断。 |
| `Fn+↑ / Fn+↓` | macOS 内置键盘：跳到上一 / 下一条用户 Prompt。 |
| `Page Up / Page Down` | Windows、Linux 或全尺寸键盘：跳到上一 / 下一条用户 Prompt。 |
| `Home / End` | 跳到记录开头 / 返回实时底部。 |
| `↑`（空输入框） | 打开当前目录的 Prompt 历史。 |

<span id="extend-slash-commands"></span>
## 扩展斜杠命令

<span id="extend-project-commands"></span>
### 项目命令

把可复用 Prompt 保存为 Markdown 文件，文件名就是命令名。例如 `.arkexp/commands/brief.md` 会生成 `/brief`。

- 项目范围会扫描 `.arkexp/command(s)`、`.agents/command(s)`、`.claude/command(s)`、`.codex/command(s)`、`.cursor/command(s)` 与根目录 `command(s)`。
- 个人范围使用 `~/.arkexp/command(s)`。

```markdown
---
description: 生成任务简报
argument-hint: "[topic]"
---

围绕 $ARGUMENTS 生成一份简洁、可执行的任务简报。
```

<span id="extend-skills"></span>
### Skills

```text
/skills
/skills install <package-name>
/skills remove <package-name>
```

<span id="extend-mcp"></span>
### MCP

使用 `/mcp` 管理 MCP 服务；使用 `/tools` 检查工具可见性、可用性、Schema 成本与权限风险。

> **说明**
>
> 命令优先级：内置命令 > 已启用 Skills > 项目 / 个人自定义命令。不要用自定义文件覆盖内置命令名。

<span id="cli-mode-updates"></span>
## CLI 模式与更新

<span id="cli-mode-tui"></span>
### 交互式 TUI

```bash
arkexp
```

<span id="cli-mode-one-shot"></span>
### 单次 CLI 调用

```bash
arkexp run "总结当前目录中的资料，并给出下一步建议"
```

<span id="cli-mode-update"></span>
### 更新

```bash
arkexp update --check --refresh
arkexp update
```

全局安装建议始终使用 npm 的 `@latest` 标签；升级前可先执行检查命令。

<span id="resources"></span>
## 相关资源

* [ArkExp 快速入门](/docs/agent-plan-personal-arkexp-quickstart)
* [Ark CLI：Agent Plan 个人版使用指南](/docs/agent-plan-personal-ark-cli)
* [npm 安装包](https://www.npmjs.com/package/@volcengine/ark-tui)