ltp-rapidx-config

RapidX 配置

仅将此技能用于设置和集成审查。对于投资组合、市场、订单、持仓、算法和实时交易工作流，请使用 ltp-rapidx-trading。

范围

• 将已发布的 RapidX CLI 包配置为唯一的运行时入口。
• 通过从 Agent 自己的工作区 MCP 配置启动 rapidx mcp serve 来配置 MCP。
• 判断此 Agent 宿主属于 MCP_READY、CLI_ONLY_READY 还是 NOT_VERIFIED。
• 通过只读调用验证工具是否实际可用。
• 生成集成审查报告，其中凭据须脱敏，并包含实际证据。

不要在此技能中说明如何安装该技能。假设 Agent 宿主已安装此技能。

参考资料

• 检查预期 CLI 命令、MCP 工具、能力名称或端点覆盖范围时，请阅读 references/capability-overview.md。
• 执行完整的 RapidX Skills / CLI / MCP 设置审查，或说明推荐的外部用户流程时，请阅读 references/best-practices.md。

优先使用工作区

更改 MCP 配置之前，先确定将运行 RapidX 的 Agent 宿主工作区：

1. 根据会话/运行时上下文说明当前 Agent 工作区路径。
2. 确认此 Agent 宿主读取的工作区本地 MCP 配置文件。
3. 如果 MCP 配置路径不明确，请检查已确认的工作区中是否存在现有 MCP 设置。
4. 如果仍不明确，请询问用户应由此 Agent 编辑哪个 MCP 配置文件。
5. 只有在确认工作区和配置路径后，才添加或更新 mcpServers.rapidx。

切勿假定源代码仓库根目录、文件系统根目录或全局 home 配置就是正确目标。

凭据收集

询问用户是否愿意通过用户提供的聊天密钥提交凭据。对于非程序员，这是默认方式；但须先说明风险：即使是受保护的聊天密钥流程，也由 Agent 宿主控制，并可能受该宿主的数据保留、访问或协作设置影响。

如果 Agent 宿主提供专用的聊天密钥界面，请用户创建三个名称完全一致的密钥：LTP_ACCESS_KEY、LTP_SECRET_KEY 和 LTP_API_HOST。如果宿主没有聊天密钥界面，请询问用户是希望 Agent 将脱敏引用占位符写入 MCP 配置，还是希望自行设置本地环境变量。

如果用户希望加强隔离，请提供以下替代方案：

• 本地 shell 环境变量。
• MCP 宿主引用的企业级或操作系统密钥管理器。

规则：

• 必需的变量为 LTP_ACCESS_KEY、LTP_SECRET_KEY 和 LTP_API_HOST。
• LTP_API_HOST 没有默认值。请使用当前环境提供的 API 主机。
• 不要使用 LTP_BASE_URL、RAPIDX_BASE_URL 或 RAPIDX_PORTFOLIO_*。
• 如果有聊天密钥机制，不要在普通聊天文本中索取或回显完整密钥。
• 切勿在日志、配置审查、测试输出或证据中打印完整密钥。只能使用脱敏值。

CLI 安装

RapidX 以官方 npm 包形式发布。安装 CLI：

npm install -g @liquiditytech/rapidx-cli

如果不允许全局安装，请在已确认的 Agent 工作区中安装，并在 MCP 配置中使用工作区本地可执行文件路径：

npm install @liquiditytech/rapidx-cli
./node_modules/.bin/rapidx --version

验证已安装的 CLI：

rapidx --version
rapidx schema --json
rapidx update check --json
rapidx self-check --json

rapidx schema --json 和 MCP rapidx/tools 必须同时返回 capabilities/工具条目以及具体的 inputSchemas。

对于仅支持 CLI 的 Agent，请使用直接的 rapidx ... --json 命令。不要创建临时桥接脚本、用于切换目录的 shell 命令链，或用于 MCP 访问的 shell 命令串联。

升级现有安装

使用 CLI 作为唯一的版本检查入口。如果 rapidx 已可用，请运行：

rapidx update check --json

读取以下字段：

• CLI：currentVersion、latestVersion、status、updateAvailable、writeAllowed、upgrade.global、upgrade.workspace。
• 技能：skillsVersion、currentSkillsVersion、skillsUpdateRecommended、upgrade.skills。

currentSkillsVersion 是 CLI 捆绑的预期技能版本，并不能证明 Agent 本地已安装的技能版本。检查已安装或已加载的 ltp-rapidx-config 和 ltp-rapidx-trading frontmatter。每个当前技能都必须声明 version。已知本地版本时，将其传入检查：

rapidx update check --input '{"installedSkillsVersion":"<local-skill-version>"}' --json

进行升级审核时，强制刷新远程清单：

rapidx update check --input '{"installedSkillsVersion":"<local-skill-version>","force":true}' --json

将本地 version 与 rapidx update check --json 中的 latestSkillsVersion 或旧版 skillsVersion 进行比较。如果本地版本缺失、低于最新技能版本或无法读取，请使用 Agent 宿主的常规技能安装程序更新或重新安装两个 RapidX 技能，然后重启或重新加载 Agent，以加载新的技能内容。

升级顺序：

1. 如果两个 RapidX 技能的本地 version 已过时、缺失或未知，请更新或重新安装它们。
2. 重启或重新加载 Agent，使新技能生效。
3. 当 updateAvailable=true、status=UPGRADE_REQUIRED 或 status=WRITE_BLOCKED 时，升级 CLI。
4. 如果已配置 MCP，请重启或重新加载 MCP 宿主。
5. 运行 rapidx --version、rapidx update check --json 和 rapidx self-check --json。
6. 如果支持 MCP，请验证 rapidx/tools、rapidx/update/check 和 rapidx/self-check。

官方 npm CLI 升级：

npm install -g @liquiditytech/rapidx-cli@latest

工作区本地 CLI 升级：

npm install @liquiditytech/rapidx-cli@latest
./node_modules/.bin/rapidx --version

运行时路径选择

安装 CLI 后，并在可用时完成 MCP 配置后，对 Agent 进行分类。不要仅根据 Agent 产品名称或配置文件是否存在来分类。

安装前，只选择候选路径：

• 如果宿主提供工作区 MCP 配置以及原生工具发现／调用接口，请尝试 MCP 路径。
• 如果宿主只提供 shell、exec 或终端命令，请使用仅 CLI 路径。
• 如果无法确定，请先安装 CLI 并运行 CLI 自检；在 MCP 工具实际可调用之前，将 MCP 标记为 NOT_VERIFIED。

安装／配置后，设置以下其中一种状态：

• CLI_READY：rapidx --version 和 rapidx schema --json 均通过。
• MCP_READY：满足 CLI_READY；initialize 返回 serverInfo.name=rapidx；tools/list 显示 46 个 rapidx/... 工具；并且可以将 rapidx/tools、rapidx/update/check 和 rapidx/self-check 作为 MCP 工具调用。
• CLI_ONLY_READY：满足 CLI_READY，但宿主无法配置、发现或调用 MCP 工具。
• NOT_VERIFIED：没有实际调用证据，或仅编辑了配置文件。

写入 mcpServers.rapidx 仅表示尝试设置 MCP，并不能证明 MCP 已就绪。如果 MCP 状态不是 MCP_READY，请将其标记为 NOT_VERIFIED，并使用直接的 rapidx ... --json 命令。

MCP 配置

MCP 由 CLI 启动。将此服务添加到 Agent 工作区的 MCP 配置中：

{
  "mcpServers": {
    "rapidx": {
      "command": "rapidx",
      "args": ["mcp", "serve"],
      "env": {
        "LTP_ACCESS_KEY": "<user-provided-secret-or-env-reference>",
        "LTP_SECRET_KEY": "<user-provided-secret-or-env-reference>",
        "LTP_API_HOST": "<user-provided-secret-or-env-reference>"
      }
    }
  }
}

当 rapidx 位于 MCP 主机的 PATH 中时，MCP 服务命令应为 rapidx，参数为 ["mcp", "serve"]。如果无法保证 PATH 中有该命令，则将已安装的 rapidx 可执行文件的绝对路径用作 command，并保持参数为 ["mcp", "serve"]。不要让 MCP 工具指向一次性 CLI 命令，也不要添加 shell 脚本包装器。

特定主机的设置示例：

Codex:
  codex mcp add rapidx -- rapidx mcp serve

Claude Code:
  claude mcp add --transport stdio rapidx -- rapidx mcp serve

Cursor:
  Add to mcp.json:
  {"mcpServers":{"rapidx":{"command":"rapidx","args":["mcp","serve"],"env":{"LTP_ACCESS_KEY":"<secret>","LTP_SECRET_KEY":"<secret>","LTP_API_HOST":"<secret>"}}}}

Gemini CLI:
  gemini mcp add rapidx rapidx -- mcp serve

OpenCode:
  Add to opencode.jsonc:
  {"mcp":{"rapidx":{"type":"local","command":["rapidx","mcp","serve"],"enabled":true}}}

OpenClaw:
  openclaw mcp add rapidx --command rapidx --arg mcp --arg serve
  openclaw mcp doctor rapidx --probe

Hermes:
  hermes mcp add rapidx --command rapidx --args mcp serve

对于 OpenClaw，请使用重复的 --arg 条目。不要使用 --args。

对于 Hermes，请使用单个 --args，并将 mcp serve 放在其后。不要重复使用 --args，因为 Hermes 会将第一个 --args 视为子命令参数的起始位置。

如果主机 CLI 尝试运行交互式 mcp add 流程，并在启用所有工具等提示处卡住，不要在非交互终端中反复重试。请按主机原生格式编辑已确认的工作区 MCP 配置，然后重启或重新加载 Agent 主机，并通过实际的 MCP 工具发现进行验证。JSON 配置通常使用 mcpServers.rapidx；YAML 配置通常使用 mcp_servers.rapidx。

MCP 环境变量实例化回退方案

首先使用主机官方的 MCP 配置路径，例如 hermes mcp add、codex mcp add、claude mcp add、openclaw mcp add，或主机文档中说明的 mcp.json / YAML 配置。

如果 MCP 已加载且能看到 rapidx/tools，但 rapidx/self-check 报告凭据/身份验证失败，例如 Invalid URL、credential-auth: FAIL 或缺少 RapidX 凭据，则仅检查 rapidx MCP 服务的 env 块。以下字面占位值应视为尚未实例化：

${LTP_ACCESS_KEY}
$LTP_ACCESS_KEY
${LTP_SECRET_KEY}
$LTP_SECRET_KEY
${LTP_API_HOST}
$LTP_API_HOST
<secret>
<secret-ref>
<provided-api-host>
""

修复规则：

1. 从 Agent 可读取的机密来源中读取真实值：用户在聊天中提供的机密、.env、OS 环境变量、Agent 机密存储，或经用户授权的工作区机密文件。
2. 使用结构化解析器更新 MCP 配置：YAML 使用 yaml.safe_load / safe_dump，JSON 使用 json.load / json.dump。
3. 仅替换 mcp_servers.rapidx、mcpServers.rapidx 或主机等效 MCP 服务映射下的 rapidx 服务块。
4. 不要使用 mcp_servers:.* 等宽泛正则表达式删除配置。
5. 如果已有 rapidx 块，不要再追加第二个。
6. 切勿在聊天、日志、审查摘要或证据中完整打印凭据值。

对于 Hermes，如果 hermes mcp add 创建的配置包含未解析的 ${VAR} 值，请编辑当前生效的配置文件，通常为：

~/.hermes/profiles/<profile>/config.yaml

最终生成的 rapidx 块应使用已实例化的值，或使用 Hermes 在运行时确实会展开的机密机制。不要照抄示例中的占位值：

mcp_servers:
  rapidx:
    command: rapidx
    args:
      - mcp
      - serve
    env:
      LTP_ACCESS_KEY: "actual-access-key-or-host-supported-secret-reference"
      LTP_SECRET_KEY: "actual-secret-key-or-host-supported-secret-reference"
      LTP_API_HOST: "actual-api-host"

修复后，重新加载 MCP 主机。对于 Hermes，可在支持时运行 /reload-mcp。如果主机无法热重载 MCP，请重启 Agent 会话或网关。

重新加载后的验证：

rapidx/tools
rapidx/update/check
rapidx/self-check

在将主机归类为 MCP_READY 之前，rapidx/self-check 必须报告 credential-auth 为 PASS。

预期的 MCP 工具

健康的 MCP 发现结果会显示 46 个工具：

Discovery: rapidx/tools, rapidx/self-check, rapidx/update/check
Market:    rapidx/market/get-ticker, rapidx/market/get-orderbook, rapidx/market/get-klines,
           rapidx/market/get-funding-rate, rapidx/market/get-mark-price,
           rapidx/market/get-symbol-info, rapidx/market/get-open-interest
Portfolio: rapidx/portfolio/overview, rapidx/portfolio/assets,
           rapidx/portfolio/statement, rapidx/portfolio/user-fee-rate,
           rapidx/portfolio/position-bracket, rapidx/portfolio/set-position-mode
Trade:     rapidx/trade/preview, rapidx/trade/verify-live
Automation:
           rapidx/automation/start, rapidx/automation/list,
           rapidx/automation/status, rapidx/automation/extend,
           rapidx/automation/stop
Order:     rapidx/order/place-preview, rapidx/order/replace-preview,
           rapidx/order/cancel-preview,
           rapidx/order/place, rapidx/order/replace, rapidx/order/cancel,
           rapidx/order/cancel-all, rapidx/order/query,
           rapidx/order/open-orders, rapidx/order/history
Transactions:
           rapidx/transaction/executions
Position:  rapidx/position/query, rapidx/position/history,
           rapidx/position/get-leverage, rapidx/position/close,
           rapidx/position/close-all, rapidx/position/set-leverage
Algo:      rapidx/algo/place, rapidx/algo/replace, rapidx/algo/cancel,
           rapidx/algo/open-orders, rapidx/algo/history, rapidx/algo/query

open-orders 表示当前未处于终态的订单，而不是“开立订单”。这些订单仍可能成交、被替换或被取消。algo/open-orders 表示当前未处于终态的算法订单，例如尚未触发、取消或以其他方式结束的条件单或 TPSL 订单。

get_ticker、place_order 或 list_positions 等旧版 snake_case 名称表明集成已过时，不应使用。

只读自检

自检用于证明已配置的运行环境真实可用。不要模拟结果、捏造余额，也不要仅凭文档声称成功。

运行快速检查：

1. 使用 rapidx --version 和 rapidx schema --json 确认 CLI_READY，并检查 inputSchemas 是否可读。
2. 在设置或审查期间运行 rapidx update check --json。此操作可能会读取 GitHub 发布清单并在本地缓存结果。
3. 如果尝试使用 MCP，请通过 MCP 主机发现工具，并确认工具总数为 46。
4. 在主机支持调用 MCP 工具时，调用 rapidx/update/check。
5. 在主机支持调用 MCP 工具时，调用 rapidx/self-check。
6. 调用一个公开市场路由，优先选择 rapidx/market/get-ticker，查询 BINANCE_PERP_BTC_USDT。如果用户提供 Binance 原生交易对，请先将其规范化，再调用 RapidX：BTCUSDT 变为 BINANCE_PERP_BTC_USDT，中文基础资产（例如 币安人生USDT）变为 BINANCE_PERP_币安人生_USDT。
7. 调用读取路由，检查投资组合概览、投资组合资产、未完成订单、持仓和算法订单。

如果主机暂时无法调用 MCP 工具，请运行等效的只读 CLI 检查，并将 MCP 工具调用标记为 NOT_VERIFIED；不要把 CLI 成功当作 MCP 成功。

收到集成审查或自我验证请求时，运行更深入的审查：

1. rapidx/tools
2. rapidx/update/check
3. rapidx/self-check
4. rapidx/market/get-ticker
5. rapidx/market/get-orderbook
6. rapidx/market/get-klines
7. rapidx/market/get-funding-rate
8. rapidx/market/get-mark-price
9. rapidx/market/get-symbol-info
10. rapidx/market/get-open-interest
11. rapidx/portfolio/overview
12. rapidx/portfolio/assets
13. rapidx/order/open-orders
14. rapidx/order/history
15. rapidx/order/query with a deliberately nonexistent self-check order id
16. rapidx/position/query
17. rapidx/position/history
18. rapidx/algo/open-orders
19. rapidx/algo/history
20. rapidx/algo/query with a deliberately nonexistent self-check algo order id

设置期间不要调用已移除的 mode="account" 投资组合资产检查。对于投资组合凭据，rapidx/portfolio/assets 是受支持的余额／资产读取接口。

结果类别

• PASS：实际工具或命令返回了成功的真实响应。
• EXPECTED_ERROR：路由正常运行，并返回了真实的业务错误、权限错误、不支持的模式错误或有意触发的未找到错误。
• INVALID_INPUT：请求提交前，schema 或本地输入验证拒绝了请求。
• NOT_FOUND：语法有效的请求资源不存在，例如 RapidX 找不到格式有效的订单 ID。
• PERMISSION_SCOPE_ERROR：凭据有效，但不涵盖所请求的路由或投资组合范围。
• BUSINESS_ERROR：RapidX 或交易平台因业务规则拒绝了请求。
• FAIL：工具缺失、启动／身份验证／网络失败、响应格式错误，或必需的调用超时。
• NOT_VERIFIED：Agent 无法调用该工具，或用户拒绝提供凭据。

如果更新检查返回 WRITE_BLOCKED、UPGRADE_REQUIRED 或 skillsUpdateRecommended=true，请在审查结果中报告。CLI 升级至不再返回 WRITE_BLOCKED 或 UPGRADE_REQUIRED，且 MCP 主机重启之前，不要执行交易写入操作。

每一行都必须包含 toolOrCommandEvidence 或等效的实测代码／消息证据。如果响应真实且格式正确，空的订单、持仓或历史列表应判定为 PASS。

集成审查输出

收到设置审查请求时，返回以下结构：

# RapidX Integration Review

## Verdict
- status: PASS / PARTIAL / FAIL / NOT_VERIFIED
- runtime path: MCP_READY / CLI_ONLY_READY / NOT_VERIFIED
- main issues:

## Workspace And Config
- agent workspace:
- MCP config path:
- MCP command: rapidx mcp serve
- CLI package:
- host:
- credentials: configured and masked / missing / not verified

## Tool Discovery
- expected MCP tools: 46
- actual MCP tools:
- missing tools:
- legacy tools found:

## Version And Upgrade
- current CLI:
- latest CLI:
- minimum write version:
- update status:
- skills update recommended:

## Read-Only Checks
| check | result | evidence |
| --- | --- | --- |

## Required Fixes
- ...

任何写入验证或实盘交易测试，请切换到 ltp-rapidx-trading。