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.autoReview 与 safety.skipPermissions,其默认值来自 MINARA_AUTO_REVIEW 与 MINARA_DANGEROUSLY_SKIP_PERMISSIONS)。这两项偏好属于关键风险写入,有独立的解锁步骤,会话内切换不替代该步骤。Web UI 在对话的权限菜单里提供同样的四种模式。

深度研究

/deep-research [<主题…>]

在 Chat 中使用 Deep Research 开关,或输入 /deep <主题> 进行一次研究。/deep-research 和 /dr 是别名。不带主题时,这些命令开启或关闭后续普通消息的深度研究,无需选择档位。

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

因子研究

/factors

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

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

股票数据工具

股票命令通过 tool_search({ sources: ["cap_fmp"], query }) 发现 FMP 工具,再用 tool_describe 查看参数。

快捷键

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

/compact

桌面端、Web UI 和 CLI 均可使用。/compress 仍可作为别名使用。请等待当前回复完成后再运行命令。

立即将全部已完成的对话历史整理成摘要,只有一轮对话时同样可用。手动压缩没有轮数门槛,会合并已有摘要与新增历史。用户原话在上下文预算内保留,原始聊天记录保持不变。自动压缩沿用原有触发条件和近期内容保留策略。

空会话会跳过。压缩后没有新增内容时,再次执行不会请求模型。桌面端和 Web UI 在对话消息流中展示进度和结果,复用自动压缩的状态行。

手动和自动压缩共用收益检查:可替换历史少于 512 tokens 时不请求模型。计入保留的用户原话和摘要标记后,摘要必须至少节省 128 tokens,否则继续使用原上下文。

/compact

本页目录