ArkExp 是一款面向通用模型体验、任务处理与本地工作流的 CLI。在终端中连接方舟模型与 ArkCLI 能力，通过清晰、可交互、可扩展的 TUI 完成日常任务。
核心特性#
本地终端体验
在熟悉的终端里使用方舟模型，流式查看响应、工具执行和任务状态。
账号与模型开箱可用
内置登录、套餐、用量、模型与 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 status
/api auto
/api responses --save
/api chat --save
快捷键#
| 快捷键 | 操作 |
|---|---|
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)。
---
description: 生成任务简报
argument-hint: "[topic]"
---
围绕 $ARGUMENTS 生成一份简洁、可执行的任务简报。
Skills#
/skills
/skills install <package-name>
/skills remove <package-name>
MCP#
使用 /mcp 管理 MCP 服务；使用 /tools 检查工具可见性、可用性、Schema 成本与权限风险。
CLI 模式与更新#
交互式 TUI#
arkexp
单次 CLI 调用#
arkexp run "总结当前目录中的资料，并给出下一步建议"
更新#
arkexp update --check --refresh
arkexp update
全局安装建议始终使用 npm 的 @latest 标签；升级前可先执行检查命令。