子命令
所有在 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,批准或拒绝始终由用户明确执行。
Provider 支持只读 JSON/CSV 接口和 OpenAPI 3.x 发现;凭据独立保存,--json 永远不会输出明文。