文档中心

火山方舟

ArkExp

ArkExp 命令参考

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 <text> [--criteria "a;b"] /goal [status\\\|pause\\\|resume\\\|complete\\\|clear]
/btw	基于当前上下文提一个旁路问题，不写入持久会话历史。	/btw <question>

工作流与扩展

命令	作用	用法
/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 /skills install\\\|remove <package-name>

工作区与内容

命令	作用	用法
/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 <report>
/exit	退出 CLI。	/exit
/quit	/exit 的兼容别名。	/quit

随包 Skill 命令

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

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

别名速查

推荐命令	可用别名	说明
/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	追加到切换命令后，将选择持久化到后续会话。

说明

不确定时使用 /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)。

Skills

MCP

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

说明

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

CLI 模式与更新

交互式 TUI

单次 CLI 调用

更新

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