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

本頁目錄