MINARA
参考CLI 参考

斜杠命令

REPL 中可用的 `/command` 命令。

REPL 斜杠命令在 apps/agent/src/gateway/repl-commands.ts 中注册,并由 /help 读取的 ReplCommand 注册表提供。该注册表是唯一真相来源;本页说明其使用约定。

在 REPL 中输入但不以 / 开头的内容会作为自然语言提示词发送给 Minara。

命名约定

命令名是小写、以连字符分隔的扁平 token(^/[a-z0-9]+(-[a-z0-9]+)*$)。次级操作写入名称中,以连字符连接,不以空格分隔。

  • /workflow-new/workflow-run/autopilot-new/autopilot-pause/strategy-deploy/agent-run
  • 单词命令保留给列表或导航动词:/workflows/autopilot/watchlist/markets/profile
  • 尾随参数可以是值,例如 /strategy-deploy <id>/deposit <crypto|card>;不能是操作动词。请使用 /agent-new,不要使用 /agents create
  • 视图切换(/context)保持单词形式。

旧的空格子操作形式(例如 /agents create)和 /? 帮助别名目前仍受支持,但新命令应使用连字符形式。

REPL 与 Web UI

Web UI 有独立的斜杠命令注册表:apps/web-ui/src/lib/slash-commands.ts。它不会从 REPL 注册表生成,两者因能力不同而独立演进。Web 命令可作为管线、技能收敛模板、路由快捷方式或直通消息分发;分发器位于 apps/web-ui/src/lib/slash-command-dispatch.ts

本页和 /help 中显示的详细命令、参数和示例,以当前 REPL 注册表为准。

交互式参数提示

带必填位置参数的命令会逐步询问缺失字段,而不是立即报错。输入裸命令后,REPL 会依次验证每个字段;可修正错误而无需重输整行。

you> /swap
› Amount (number or 'all'): 0.5
› From token (e.g. USDC): usdc
› To token (e.g. ETH): eth
  • 仅提示必填参数;可选尾随参数仍应在命令行中传入。
  • 无效值只会重新提示错误字段,已验证字段会保留。
  • 连续三次空回答会以 × cancelled 取消。
  • /close/cancel 会显示实时选择器。
  • HTTP 网关等非交互界面保持经典的 Usage: ... 错误;提示仅在真实 TTY 中生效。

提示辅助函数位于 apps/agent/src/gateway/repl-prompts.ts

权限模式

/permission [ask|smart|auto|full|reset]

查看或切换当前 REPL 会话的权限模式。不带参数时列出四种模式并标出当前项。/permission reset 回到已保存的偏好。

模式普通操作资金操作
ask每次由你确认由你确认
smart由审核助手代你批准由你确认
auto自动执行由你确认
full自动执行自动执行

该选择只作用于当前会话,不写入磁盘。重启后回到已保存的偏好(safety.autoReviewsafety.skipPermissions,其默认值来自 MINARA_AUTO_REVIEWMINARA_DANGEROUSLY_SKIP_PERMISSIONS)。这两项偏好属于关键风险写入,有独立的解锁步骤,会话内切换不替代该步骤。Web UI 在对话的权限菜单里提供同样的四种模式。

深度研究

/deep-research [<主题…>] [--mode light|heavy]

别名:/deep/dr。这三个命令使用同一个 Deep Research 处理器和兼容参数。省略主题时,命令会恢复上次选择的档位(首次为标准)并持续生效;已开启时再次运行会关闭。开启或直接研究主题时可用 --mode heavy 选择专业档位。

/deep-research BTC ETF flows in 2026
/deep "NVDA competitive position" --mode light
/dr "SPX mean reversion" --mode heavy

因子研究

/factors

打开交互式因子研究菜单,可创建持久化时序研究任务、控制任务、审核合格候选、浏览正式因子版本并查询指标说明。创建时默认只询问研究需求、资产与周期、优化目标和预算四组核心输入。 providers 操作可列出、检测、启用、禁用、导入和归档因子数据源,且不会显示已保存的凭据。

优化目标决定优先搜索什么以及候选如何排序;停止条件决定何时暂停或结束,不改变质量门槛。该命令不会自动批准因子、部署策略、交易或移动资金。

快捷键

REPL 提示符上的输入覆盖层仅在 TTY 中生效,且不会干扰斜杠命令自动完成下拉列表。Ctrl+R 用于反向历史搜索;其他可用快捷键与完整命令目录请在 REPL 中运行 /help 查看。

本页目录