第 4 章 · 05 命令行参考

第 4 章 · 05 命令行参考

本节摘要:命令行(CLI)是 Vibe-Trading 最快的操作面,适合可重复的研究任务。本节把常用 CLI 命令集中梳理——从最基础的 vibe-trading(启动交互模式)、init(初始化配置)、run -p(跑研究任务),到 --upload(上传文件)、memory(持久记忆)、serve(启动 Web UI)、alpha(因子浏览)、connector(连接器管理)、vibe-trading-mcp(MCP 服务)。每条命令给出用途、典型用法和注意事项。本节是查阅型参考,不必一次读完,用到时回查即可。

内容来源:英文文档 reference/cli 汉化,补充全书各章已出现的命令汇总。

学习目标

阅读完本节,你应当能够:

1. 掌握 Vibe-Trading 的核心 CLI 命令及其用途。
2. 区分交互模式与单次运行模式的适用场景。
3. 知道每条命令的典型参数与注意事项。
4. 用 CLI 完成研究全流程:初始化 → 跑研究 → 上传文件 → 看记忆 → 启动 Web UI。
5. 理解斜杠命令(slash commands)在交互模式下的作用。

一、CLI 是最快的操作面

Vibe-Trading 提供两种主要操作面:CLI(命令行)和 Web UI。对于可重复的研究任务,CLI 通常更快——一句命令搞定,不用开浏览器、不用点界面。

💡 CLI vs Web UI 的取舍:

• CLI:快、可脚本化、适合日常研究和重复任务。
• Web UI:可视化、支持上传文件、流式查看 swarm 进度、Settings 集中管理、产物集中查看。
  日常快速研究用 CLI 即可;需要可视化或上传文件时再开 Web UI。

二、常用命令一览

下面是 Vibe-Trading 最常用的命令,按使用频率从高到低排列:

# 启动交互模式(默认入口,支持斜杠命令)
vibe-trading

# 初始化本地配置(模型、密钥、数据源)
vibe-trading init

# 跑一次研究任务
vibe-trading run -p "your research prompt"

# 上传文件(交易流水、报告、PDF 等)
vibe-trading --upload report.pdf

# 查看持久记忆
vibe-trading memory list

# 启动本地 Web UI
vibe-trading serve --port 8899

# 启动 MCP 服务(接入 Claude Desktop/Cursor 等)
vibe-trading-mcp
​

三、命令详解

vibe-trading:启动交互模式

vibe-trading
​

这是默认入口,启动后进入交互模式——你可以连续输入多个研究提示,像对话一样推进研究。交互模式支持斜杠命令(slash commands),用于快速访问常用功能:

• 查看最近的运行(recent runs)。
• 切换 swarm 预设。
• 管理记忆(memory)。
• 在研究主题间导航。

💡 什么时候用交互模式:当你想连续探索多个相关问题、逐步深入时,交互模式比反复敲 run -p 更顺手。

vibe-trading init:初始化配置

vibe-trading init
​

以交互方式引导你完成本地配置:选择模型厂商、填入密钥、配置数据源等。配置结果写入本地环境文件(如 .env)。

💡 何时重新 init:换了模型、新增数据源 token、或配置出错时,重新跑 init 即可。详见第 4 章 06「配置」。

vibe-trading run -p:跑一次研究任务

vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024, summarize return and drawdown, then export the report"
​

这是最核心的研究命令。-p 后跟你的自然语言研究提示。agent 会按第 2 章 01 的五步工作流(Plan → Ground → Execute → Validate → Deliver)处理这条提示,产出答案和 artifacts。

典型提示模式:

• 回测类:"Backtest a ... strategy for ... with benchmark comparison"
• 因子类:"Compute IC/IR for momentum factors on SP500 from 2020 to 2025"
• 分析类:"Analyze my trading behavior, extract my shadow strategy"
• 导出类:"... then export the report"

⚠️ run -p 默认只做研究,不连券商、不下单。除非你的提示显式涉及账户操作并已配置相应 profile。

vibe-trading --upload:上传文件

vibe-trading --upload trades_export.csv
vibe-trading --upload report.pdf
​

上传文件到工作区,供后续研究使用。典型场景:

• 上传交易流水(CSV)→ 触发 Shadow Account 分析(见第 4 章 01)。
• 上传研究报告(PDF)→ 让 agent 读取并基于它回答问题。
• 上传自有数据(CSV/Parquet)→ 用作 local 数据源。

vibe-trading memory:持久记忆

vibe-trading memory list
​

查看 Vibe-Trading 的持久记忆——它会在多次研究间保留上下文(比如你之前研究过什么、用过什么参数)。memory list 列出当前的记忆条目。

💡 记忆的价值:让你不用每次重复说明背景。比如你之前告诉 agent「我重点关注 A 股大盘股」,后续研究它会记住这个偏好。

vibe-trading serve:启动 Web UI

vibe-trading serve --port 8899
​

启动本地 Web UI,默认端口可指定。Web UI 适合:

• 上传文件(比 CLI 更直观)。
• 流式查看 swarm 进度(多智能体团队的实时进度,见 swarm 章节)。
• Settings 配置(可视化改配置)。
• 产物集中管理(生成的报告、图表集中查看)。

启动后用浏览器访问 http://localhost:8899(或你指定的端口)。

vibe-trading alpha:因子浏览

# 列出某 zoo 的因子
vibe-trading alpha list --zoo academic

# 查看某因子的公式
vibe-trading alpha show academic_mkt_rf

# 在 universe 上测因子
vibe-trading alpha bench --zoo academic --universe sp500 --period 2020-2025 --top 10
​

这组命令用于浏览和测试 Alpha Zoo 的 456 个因子,详见第 1 章 04。

vibe-trading connector:连接器管理

# 列出可用连接器
vibe-trading connector list

# 选择/启用某连接器
vibe-trading connector use

# 检查连接器状态
vibe-trading connector check
​

管理券商连接器。看 connector 时先看 profile 的安全属性(read-only/paper/live),再看能力,详见第 3 章 03。

⚠️ 涉及 connector 的命令可能触及真实账户。学习阶段请只用 read-only 和 paper,live 需经授权边界与 kill switch。

vibe-trading-mcp:启动 MCP 服务

vibe-trading-mcp
​

启动 MCP(Model Context Protocol)服务,把 Vibe-Trading 的工具暴露给 Claude Desktop、Cursor 等 MCP 客户端。它作为 stdio 子进程运行,由 MCP 客户端拉起。详见第 4 章的 MCP 服务章节(P1)。

四、命令分组速查

按功能分组,便于查阅:

五、交互模式的斜杠命令

在交互模式(vibe-trading)下,除了输入自然语言提示,还可以用斜杠命令快速访问功能:

• 查看最近的运行(recent runs):快速回到之前的研究。
• 切换 swarm 预设:选择不同的多智能体团队(见 swarm 章节)。
• 管理记忆:查看、清除持久记忆。
• 研究导航:在不同研究主题间跳转。

💡 斜杠命令的价值:把常用功能做成快捷入口,避免反复敲长命令。具体支持的斜杠命令以你本地版本的交互模式提示为准。

六、一条命令的安全分级

把命令按「是否涉及真实账户」分级,帮助你建立安全意识:

⚠️ 任何涉及 connector 的命令可能触及真实账户。即使 connector check 只是读状态,也建议确认 profile 是 read-only。本教程所有命令示例均不构成投资建议。

本节要点回顾

1. CLI 是最快操作面:适合可重复研究任务;Web UI 适合可视化与上传文件。
2. 核心命令:vibe-trading(交互)、init(配置)、run -p(研究)、--upload(上传)、memory(记忆)、serve(Web UI)。
3. 因子命令:alpha list / alpha show / alpha bench(详见第 1 章 04)。
4. 连接器命令:connector list / connector use / connector check,先看 profile 再看能力。
5. MCP 命令:vibe-trading-mcp 启动 MCP 服务,接入外部 Agent 客户端。
6. 交互模式:支持斜杠命令(recent runs、swarm 预设、memory、导航)。
7. 安全分级:纯研究命令安全,connector 命令谨慎,涉及 live 需经 mandate/kill switch。

⚠️ 本节所有命令示例均不构成投资建议。涉及账户与实盘的命令需谨慎,学习阶段只用 read-only 和 paper。

下一节,我们将讲配置(环境变量与密钥)——.env 配置项、密钥与数据源关系、API_AUTH_KEY 与 Bearer 鉴权、模型选择对工具调用质量的影响。