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

说明

ArkExp 的安装、启动、配置及使用参见 ArkExp 快速入门。

## 核心特性 **本地终端体验** 在熟悉的终端里使用方舟模型，流式查看响应、工具执行和任务状态。 **账号与模型开箱可用** 内置登录、套餐、用量、模型与 API 传输方式管理，减少环境切换。 **持续任务承载** 会话、目标、记忆、上下文与历史记录共同承载持续任务。 **可扩展** 通过 Skills、MCP、工作流、自定义斜杠命令和定时任务扩展能力。 **权限可控** 工具执行经过权限闸门；高风险操作需要明确确认。 **可恢复** 检查点、验证与失败记忆帮助任务在本地端更稳定地推进。 ## 斜杠命令

注意

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

### 账号、模型与 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]` | ### 会话与历史 |命令 |作用 |用法 | |---|---|---| |`/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` | ### 任务模式与目标 |命令 |作用 |用法 | |---|---|---| |`/agents` |切换可用任务 Agent / 模式。 |`/agents` | |`/plan` |进入规划模式。 |`/plan` | |`/implement` |退出规划模式并回到执行模式。 |`/implement` | |`/goal` |设置、查看、暂停、恢复、完成或清除持久目标。 |`/goal [--criteria "a;b"]`

`/goal [status\\\|pause\\\|resume\\\|complete\\\|clear]` | |`/btw` |基于当前上下文提一个旁路问题，不写入持久会话历史。 |`/btw ` | ### 工作流与扩展 |命令 |作用 |用法 | |---|---|---| |`/workflow` |打开工作流面板，运行或停止已保存工作流。 |`/workflow [list\\\|run [json]\\\|stop ]` | |`/workflows` |`/workflow` 的兼容别名。 |`/workflows [list\\\|run [json]\\\|stop ]` | |`/cron` |创建和管理持久化的一次性或周期任务。 |`/cron` | |`/mcp` |查看、连接、认证、启停和刷新 MCP 服务。 |`/mcp` | |`/tools` |检查工具可见性、可用性、Schema 成本和权限风险。 |`/tools` | |`/skills` |查看、启停、安装或移除 Skills。 |`/skills`

`/skills install\\\|remove ` | ### 工作区与内容 |命令 |作用 |用法 | |---|---|---| |`/memory` |浏览和配置用户、项目、会话与系统摘要记忆。 |`/memory`

`/memory show user\\\|project\\\|session\\\|system-summary` | |`/context` |查看上下文 token、预算与使用率。 |`/context` | |`/init` |为当前项目生成 `AGENTS.md` 指令。 |`/init` | ### 界面与诊断 |命令 |作用 |用法 | |---|---|---| |`/help` |打开快捷键与内置命令帮助。 |`/help` | |`/theme` |选择并预览界面主题。 |`/theme` | |`/timestamps` |显示或隐藏消息时间戳。 |`/timestamps` | |`/thinking` |显示或隐藏推理摘要。 |`/thinking` | |`/status` |查看 MCP、Skills 与 Commands 状态。 |`/status` | |`/feedback` |提交产品反馈。 |`/feedback ` | |`/exit` |退出 CLI。 |`/exit` | |`/quit` |`/exit` 的兼容别名。 |`/quit` | ### 随包 Skill 命令以下命令来自随包 Skills；是否可执行取决于当前连接、权限与 Skill 启用状态。 |命令 |作用 |用法 | |---|---|---| |`/add-resources` |把本地路径或远程 URL 导入 OpenViking Resources。 |`/add-resources [--to ]` | |`/arkexp-docs` |查询产品用法、配置与排障信息。

> `/arkexp-docs` 是随包 Skill 提供的技术命令名。 |`/arkexp-docs ` | |`/byted-web-search` |在当前连接为 Agent Plan 时使用随包豆包搜索能力。 |`/byted-web-search ` | ### 别名速查 |推荐命令 |可用别名 |说明 | |---|---|---| |`/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` |退出。 | ## /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。

## 快捷键 |快捷键 |操作 | |---|---| |`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 历史。 | ## 扩展斜杠命令 ### 项目命令把可复用 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 生成一份简洁、可执行的任务简报。 ``` ### Skills ```text /skills /skills install /skills remove ``` ### MCP 使用 `/mcp` 管理 MCP 服务；使用 `/tools` 检查工具可见性、可用性、Schema 成本与权限风险。

说明

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

## CLI 模式与更新 ### 交互式 TUI ```bash arkexp ``` ### 单次 CLI 调用 ```bash arkexp run "总结当前目录中的资料，并给出下一步建议" ``` ### 更新 ```bash arkexp update --check --refresh arkexp update ``` 全局安装建议始终使用 npm 的 `@latest` 标签；升级前可先执行检查命令。 ## 相关资源 * [ArkExp 快速入门](https://ark.volcengine.com/region:cn-beijing/docs/82379/2687228?lang=zh) * [Ark CLI：Agent Plan 个人版使用指南](https://ark.volcengine.com/region:cn-beijing/docs/82379/2656113?lang=zh) * [npm 安装包](https://www.npmjs.com/package/@volcengine/ark-tui)

火山方舟