MINARA子命令
所有在 REPL 前運行的 `minara <subcommand>` 調用。
REPL 前子命令由 apps/agent/src/gateway/cli.ts 分發，每個子命令會委託給 apps/agent/src/gateway/*-cli.ts 下的專用模塊。每次調用運行一次、輸出結果並退出。
minara / minara chat
啟動交互式 REPL。裸 minara 和 minara chat 是等價入口。首次運行嚮導（如需要）完成、已配置的 MCP 服務器連接、速查表打印後，進程進入 readline。
minara
minara chat每次 REPL 運行都有各自持久化的聊天會話，按輪記錄到 SQLite 存儲。可在 REPL 中用 /resume 恢復過去的 CLI 會話。REPL 內可用功能請參閱斜槓命令。
minara setup / minara init
運行交互式首次使用嚮導。它配置 LLM 提供商；Minara 網關為默認值（無需第三方密鑰），Anthropic、OpenAI、OpenRouter、Kimi 和 xAI 是自帶密鑰選項。隨後登錄 Minara、探測 ~/.minara/ 中可導入的狀態、搭建工作區、運行 doctor 並打印速查表。
minara setup
minara init # alias實現位於 apps/agent/src/gateway/setup-wizard.ts。
minara auth <action>
統一憑據入口：LLM 提供商登錄/退出/狀態、出站消息提供商憑據和數據源 API 密鑰。
minara auth # status (default)
minara auth status
minara auth login <provider> # sign in / save an LLM provider credential
minara auth logout <provider> # clear an LLM provider profile
minara auth messaging # configure outbound messaging providers
minara auth key list # data-source API keys (masked)
minara auth key set <ENV_VAR> <value>
minara auth key remove <ENV_VAR>status：輸出所有已配置認證資料和已設置的*_API_KEY環境變量摘要。login <provider>：認證 LLM 提供商；與頂級別名minara login使用相同解析。logout <provider>：清除已保存的 LLM 提供商資料；與minara logout相同。messaging [list|add|test|remove] [id]：配置出站消息提供商。key list：顯示數據源 API 密鑰的掩碼值和來源，原始密鑰保留在磁盤上。key set <ENV_VAR> <value>：保存數據源 API 密鑰覆蓋項；該值是操作者主機上的位置 CLI 參數，絕不會傳給 LLM。key remove <ENV_VAR>：清除數據源 API 密鑰覆蓋項。
實現位於 apps/agent/src/gateway/auth-command.ts。完整的命令、標誌、示例及返回碼以 CLI --help 和當前實現為準。
常用操作組
CLI 還提供用於賬戶、資料、偏好、市場、交易、永續子錢包、自動駕駛、工作流、技能、記憶、文件、遷移、診斷和網關管理的子命令。所有命令名、標誌、環境變量和示例值均為穩定的代碼標識符，不隨界面語言改變。
資金移動、提現、交易執行和任何有風險的操作仍會遵循確認與權限策略。執行前檢查 minara <subcommand> --help，並在 REPL 內使用 /help 獲取實時命令目錄。
minara factors <action>
建立和控制持久化時序因子研究任務，查看候選、審核合格因子，並查詢統一指標目錄。
minara factors campaign create --spec <json-or-file> [--idempotency-key <key>] [--json]
minara factors campaign list|show <id> [--json]
minara factors campaign pause|resume|cancel <id> [--json]
minara factors campaign extend-budget <id> --extension <json-or-file> [--json]
minara factors campaign fork <id> --input <json-or-file> [--idempotency-key <key>] [--json]
minara factors candidates list --campaign <id> [--status <status>] [--limit <n>] [--cursor <cursor>] [--json]
minara factors candidates show <id> [--json]
minara factors library list [--include-archived] [--limit <n>] [--cursor <cursor>] [--json]
minara factors library show <factor-id> [version] [--json]
minara factors library approve|reject <candidate-id> --input <json-or-file> [--json]
minara factors library archive <factor-id> <version> --reason <text> [--json]
minara factors metrics list|show <metric-id> [--json]
minara factors providers list [--json]
minara factors providers add|test --definition <json-or-file> [--credential <value>] [--json]
minara factors providers inspect --url <openapi-url> [--network-trust public|private_confirmed] [--json]
minara factors providers enable|disable|archive|check <source-id> [--json]最佳化目標決定優先搜尋什麼以及候選如何排序；停止條件決定何時暫停或結束，不改變品質門檻。因子研究獨立於 Strategy RL，核准或拒絕一律由使用者明確執行。