desic-okx-agent 0.2.0 → 0.3.0

package/README.md

@@ -1,55 +1,57 @@
 # Desic OKX Agent
 
-An independent local OKX runtime, MCP server, CLI, and reusable agent skills for Codex, Claude Code, and other MCP clients.
+[简体中文](README.md) | [English](README.en.md)
 
-> [!IMPORTANT]
-> Desic OKX Agent is an independent community project. It is not affiliated with, endorsed by, or an official product of OKX.
-
-## What it provides
+面向 Codex、Claude Code 及其他 MCP 客户端的独立 OKX 本地 Runtime、MCP Server、CLI 和 Agent Skills。
 
-- A shared local Runtime reused by multiple MCP and CLI clients
-- In-memory ticker, order book, trades, candles, funding, mark price, and open-interest data
-- Time-aligned decision snapshots with freshness and consistency metadata
-- Public market and derivatives tools that work without API credentials
-- Named OKX accounts for balances, positions, orders, fills, bills, and risk summaries
-- Direct ordinary-order, algo-order, leverage, amend, cancel, and close-position operations
-- Experimental News and Smart Money intelligence with SQLite history fallback
-- Seven reusable analysis and trading skills
-- SQLite WAL persistence for closed candles, intelligence history, derived events, and execution records
-
-The project does not expose withdrawal, deposit, transfer, asset-movement, or API-key-management tools.
+> [!IMPORTANT]
+> Desic OKX Agent 是独立的社区项目，并非 OKX 官方产品，也未获得 OKX 的认可或背书。
 
-## Requirements
+> [!NOTE]
+> 本项目的所有交易工具仅支持 OKX 永续合约（`instId` 必须以 `-SWAP` 结尾）。不支持现货、交割合约、期权或其他品种的交易。公共行情和账户查询不受此限制。
 
-- Node.js 22.12 or newer
-- npm
-- Network access to OKX, or an HTTP/HTTPS proxy that can reach OKX
+## 安装
 
-## Install
+要求 Node.js 22.12 或更高版本，以及能够访问 OKX 的网络或 HTTP/HTTPS 代理。
 
-Install the published package:
+首次安装只需两条命令：
 
 ```bash
 npm install --global desic-okx-agent
+desic-okx setup
 ```
 
-This registers the `desic-okx` command on the local machine.
+两条命令作用不同：
+
+1. `npm install` 安装 `desic-okx` 程序。
+2. `desic-okx setup` 接入 AI 客户端、安装 Skills、检查网络，并询问是否配置 OKX API 账户。
 
-## Set up an AI client
+首次安装后需要运行一次 `setup`。以后正常升级无需重复运行；只有新增 AI 客户端、修复配置或重新配置代理时才需要再次运行。
 
-Run the guided setup after installation:
+完成后重启已选择的 AI 客户端，并验证：
 
 ```bash
-desic-okx setup
+desic-okx doctor
 ```
 
-The terminal guide lets you select Codex, Claude Code, Cursor, VS Code / GitHub Copilot, Cline, or all supported clients with the arrow keys and Space. It safely adds the `desic-okx` MCP entry without replacing other MCP servers.
+## Setup 会做什么
 
-For Codex and Claude Code, setup also installs all bundled Skills automatically. Cursor, VS Code / GitHub Copilot, and Cline receive MCP configuration only because they do not share a portable `SKILL.md` installation format.
+交互式向导会依次完成：
 
-Setup then checks both OKX REST and WebSocket connectivity. Transient TLS and network failures are retried before setup asks for action. When direct and detected system-proxy connections still fail, it offers to test and save an HTTP proxy URL, retry, or continue without network access.
+1. 选择 Codex、Claude Code、Cursor、VS Code / GitHub Copilot、Cline，或全部客户端。
+2. 注册 `desic-okx` MCP Server，保留已有 MCP 配置。
+3. 为 Codex 和 Claude Code 自动安装全部 9 个 Skills。
+4. 检查 OKX REST 与 WebSocket；连接失败时引导测试并保存 HTTP 代理。
+5. 解释不同功能的 API Key 要求，并让用户选择“现在配置”或“以后配置”。
+6. 如果现在配置，隐藏凭证输入，自动识别实盘或模拟盘，验证成功后才写入本地配置。
 
-For automation, choose explicit targets without opening the UI:
+API 账户是可选的。跳过后公共行情和公共衍生品仍可使用，以后运行下面的命令即可配置：
+
+```bash
+desic-okx account add
+```
+
+自动化或无人值守安装可以指定客户端；该模式不会询问或保存 API 凭证：
 
 ```bash
 desic-okx setup --targets codex --yes
@@ -58,111 +60,159 @@ desic-okx setup --all --yes
 desic-okx setup --targets codex --yes --skip-network-check
 ```
 
-Non-interactive setup exits with an error when the network check fails. Use `--skip-network-check` only when connectivity will be configured later.
+## 配置 OKX API
 
-Restart the selected client after setup. The MCP server starts the local Runtime automatically when it is first used. Run `desic-okx doctor` at any time to verify the package, client configuration, Skills, network, Runtime, SQLite, public market data, and configured accounts.
+在 OKX 官方网站或 App 中创建 API Key。实盘账户与模拟交易账户使用各自环境的 API Key，Desic OKX Agent 会通过只读验证自动识别，不需要用户选择实盘或模拟盘。
 
-## Ask an AI to install it
+按实际用途授予权限：
 
-Paste this into Codex, Claude Code, Cursor, VS Code / GitHub Copilot, or Cline. Replace `codex` with `claude-code`, `cursor`, `vscode`, `cline`, or `all` when appropriate.
+| 功能 | 是否需要 API Key | 所需条件 |
+| --- | --- | --- |
+| 公共行情、K 线、盘口、衍生品分析 | 否 | 无 |
+| 余额、持仓、订单、成交、风险摘要 | 是 | 读取权限 |
+| 远程 News、Smart Money | 是 | `live` 账户，读取权限即可 |
+| 永续合约下单、改单、撤单、平仓、设置杠杆 | 是 | OKX API Key 具备交易权限；仅支持 `*-SWAP` |
 
-```text
-Install Desic OKX Agent for me. Check that Node.js is at least 22.12, then run:
-npm install --global desic-okx-agent
-desic-okx setup --targets codex --yes
+本项目不提供提现、充值、资金划转、资产转出或 API Key 管理工具，不需要为此授予相关权限。建议先使用 OKX 模拟交易账户验证交易流程，并按自己的安全策略在 OKX 配置 IP 白名单。
 
-Verify the installation with `desic-okx doctor`. Do not ask for or configure any OKX API credentials. Confirm that public market tools are ready to use.
+交互式添加账户：
+
+```bash
+desic-okx account add --name demo
+desic-okx account add --name main
 ```
 
-For development from source:
+输入 API Key、Secret Key 和 Passphrase 时终端会隐藏文本。`account add` 会先连接 OKX 验证，验证失败不会保存凭证。凭证保存在系统配置目录的 `config.json` 中；Unix 权限为 `0600`：
 
 ```bash
-git clone https://github.com/xiazhi88/desic-okx-agent.git
-cd desic-okx-agent
-npm ci
-npm run build
-npm link
+desic-okx config-path
+```
+
+也支持环境变量覆盖同名账户：
+
+```text
+OKX_ACCOUNT
+OKX_API_KEY
+OKX_API_SECRET
+OKX_API_PASSPHRASE
+```
+
+三个凭证变量必须同时提供。Runtime 会自动探测账户环境；能否交易完全取决于 OKX 为该 API Key 配置的官方权限。
+
+## 让 AI 自动安装
+
+可将下面的提示词交给 Codex、Claude Code、Cursor、VS Code / GitHub Copilot 或 Cline。将 `codex` 替换为 `claude-code`、`cursor`、`vscode`、`cline` 或 `all`：
+
+```text
+请为我安装 Desic OKX Agent：
+1. 检查 Node.js 是否为 22.12 或更高版本。
+2. 运行 npm install --global desic-okx-agent。
+3. 运行 desic-okx setup --targets codex --yes。
+4. 运行 desic-okx doctor 验证 MCP、Skills 和 OKX 网络。
+5. 不要要求我在聊天中发送任何 API Key、Secret 或 Passphrase。
+6. 告诉我公共工具已可使用；如果我需要账户、News、Smart Money 或交易功能，引导我直接在自己的终端运行 desic-okx account add，并由我在隐藏输入框中填写凭证。
 ```
 
-## Quick start
+## 快速开始
 
-Public market tools do not require an account:
+公共行情不需要账户：
 
 ```bash
-desic-okx start
 desic-okx call market_get_ticker --json '{"instId":"BTC-USDT-SWAP"}'
 desic-okx call market_get_decision_snapshot --json '{"instId":"BTC-USDT-SWAP","bar":"1m"}'
 ```
 
-The Runtime starts automatically when an MCP client or CLI call needs it. `desic-okx start` is optional.
-The stdio MCP adapter does not load the native SQLite module itself, which avoids holding the package binary open during Windows upgrades. Stop a running Runtime with `desic-okx stop` before upgrading.
+Runtime 会在 MCP 或 CLI 首次调用时自动启动，通常不需要手动运行 `desic-okx start`。
 
-Useful Runtime commands:
+常用命令：
 
 ```bash
 desic-okx status
-desic-okx status --json
 desic-okx doctor
 desic-okx tools
 desic-okx tool market_get_decision_snapshot
-desic-okx stop
+desic-okx account list
+desic-okx update --check
 ```
 
-`status` shows the Runtime version, uptime, redacted proxy route, public/business/private WebSocket state, subscriptions and data ages, accounts, and database size. `doctor` performs active network, SQLite, market-data, account, MCP-client, Skill, and package checks. Both support machine-readable JSON.
+`status` 显示 Runtime 版本、运行时间、代理路径、WebSocket 状态、订阅与数据年龄、账户和数据库状态。`doctor` 主动检查安装、网络、SQLite、行情、账户、MCP 客户端和 Skills。两者均支持 `--json`。
 
-## Connect Codex
+## 主要能力
 
-The recommended option is `desic-okx setup`, which also installs all Skills. To register only the local stdio MCP server manually:
+- 共享单例 Runtime，可被多个 MCP 和 CLI 客户端复用
+- 内存中的 ticker、盘口、逐笔成交、K 线、资金费率、标记价格和持仓量
+- 带新鲜度、交易所时间和一致性元数据的统一决策快照
+- 公共行情、指标扫描和公共衍生品分析
+- 账户余额、持仓、委托、成交、账单及风险摘要
+- 仅限永续合约的普通单、策略单、杠杆、改单、撤单和平仓操作
+- 实验性的 News 与 Smart Money 能力，以及 SQLite 历史回退
+- SQLite WAL 持久化已收盘 K 线、情报历史、派生事件和执行记录
+- Python 策略研究：1 分钟历史数据、回测、参数调优、多次回测对比
+- 实盘执行：把已回测的策略绑到账户，每根 1 分钟收线自动决策，八道风控闸门前置
 
-```bash
-codex mcp add desic-okx -- desic-okx mcp
-```
+## 一条链，不是两个产品
 
-Or add it to `~/.codex/config.toml`:
+上面的能力不是并列的清单，而是同一条链上的几段。**手动做和让 AI 做，走的是同一条链**：
 
-```toml
-[mcp_servers.desic-okx]
-command = "desic-okx"
-args = ["mcp"]
+```text
+分析行情 ──→ 写成策略 ──→ 回测 ──→ 调参 ──→ 建 Profile ──→ 模拟盘验证 ──→ 实盘
+  行情/衍生品      Python        7:3 切分   验证段排名     不会开始交易    真实下单    真钱
+  News/资金流      策略文件                                              （需你同意）
 ```
 
-## Connect Claude Code
+两种用法的区别只在谁按键：
+
+| | 你自己做 | 交给 AI |
+| --- | --- | --- |
+| 找想法 | `market_*` / `news_*` 工具，或 TUI | `okx-market-analysis` 等 Skill |
+| 写策略 | `strategy new` 起模板，自己编辑 | agent 写文件，`strategy_validate_source` 校验 |
+| 回测调参 | `strategy backtest` / `optimize` / `compare` | 同名 MCP 工具，`okx-strategy-research` Skill |
+| 建 Profile | `live create` | `live_create_profile`（需开 `agent-access`） |
+| 启用实盘 | `live start` | `live_start`，且 Skill 要求**先问你并给出数字** |
 
-The recommended option is `desic-okx setup`, which also installs all Skills. To register only the MCP server manually:
+默认情况下 agent 只能读和停，创建与启用不在它的工具列表里。要让 AI 跑完整条链：
 
 ```bash
-claude mcp add --transport stdio --scope user desic-okx -- desic-okx mcp
+desic-okx live agent-access on    # 需重启 MCP 客户端
+desic-okx live agent-access       # 查看当前设置
 ```
 
-Verify the connection with:
+开启后 agent 仍被要求在启用实盘 Profile 前停下来问你 —— 这条约束写在 Skill 里，不是系统闸门。系统能验证的是"这个 Profile 能不能跑"，不能验证"该不该投真钱"。
+
+## 策略研究
+
+用 Python 写策略，在本地 1 分钟历史数据上回测、调参、对比：
 
 ```bash
-claude mcp get desic-okx
+desic-okx strategy env --setup
+desic-okx data download --inst BTC-USDT-SWAP --days 90
+desic-okx strategy new --out ema.py --template ema-trend
+desic-okx strategy backtest --file ema.py --inst BTC-USDT-SWAP --days 30 --follow
 ```
 
-A JSON example is available in `examples/claude-code/mcp.json`.
+调参会把窗口按 7:3 切分，用候选从未见过的那一段排名，因此过拟合是可见的而不是被埋掉的。对比会在两次运行数据、合约、区间或成本不同时给出警告。
 
-## Skills
-
-`desic-okx setup` automatically installs all seven Skills for Codex and Claude Code. The MCP server exposes the tools; Skills add reusable analysis and trading workflows.
+完整说明见 **[策略研究使用指南](docs/strategy-research.md)**。
 
-To install selected Skills manually, copy their directories from the installed package:
+## 实盘执行
 
-Codex personal skills:
+把已验证的策略接到真实账户，每根 1 分钟收线自动执行：
 
-```text
-${CODEX_HOME:-~/.codex}/skills/<skill-name>/SKILL.md
+```bash
+desic-okx live create --file ema.py --inst BTC-USDT-SWAP --account demo \
+  --environment demo --entry-budget 100 --side-budget 200 --daily-loss 500
+desic-okx live readiness --id lp_xxxx
+desic-okx live start --id lp_xxxx
+desic-okx live signals --id lp_xxxx
 ```
 
-Claude Code personal skills:
+启用需要该源码 + 该合约已完成回测（按源码 hash 匹配，不是文件名），并会把 Profile 的杠杆写到交易所 —— 预算按杠杆折算张数，两边不一致预算就不成立。八道风控闸门只拒绝、不修正，被拒绝的信号会完整保留 —— 它们是风控运行过的证据。崩溃后向交易所对账，绝不重发可能已存在的订单。
 
-```text
-~/.claude/skills/<skill-name>/SKILL.md
-```
+**这部分会用真钱下单。** 完整说明与限制见 **[实盘执行使用指南](docs/live-trading.md)**。
 
-Project-scoped alternatives are `.agents/skills/` for Codex and `.claude/skills/` for Claude Code.
+## Skills
 
-Included skills:
+`desic-okx setup` 会为 Codex 和 Claude Code 自动安装：
 
 - `okx-market-analysis`
 - `okx-derivatives-analysis`
@@ -170,11 +220,11 @@ Included skills:
 - `okx-smart-money-analysis`
 - `okx-account-analysis`
 - `okx-trading`
+- `okx-strategy-research`
+- `okx-live-trading`
 - `trading-philosophy`
 
-Restart the client if a newly installed skill does not appear.
-
-Setup synchronizes bundled Skills on every run. Identical Skills are left untouched. Changed copies are backed up before the bundled version is installed. They can also be inspected or synchronized explicitly:
+升级后 Skills 会自动同步。也可手动检查或同步；被修改的旧版本会先备份：
 
 ```bash
 desic-okx skills status
@@ -182,77 +232,41 @@ desic-okx skills sync
 desic-okx skills sync --targets codex --dry-run
 ```
 
-## Configure an OKX account
-
-Public tools work without credentials. Account and trading tools use a named account alias and never accept credentials as tool arguments.
-
-Add and verify an account interactively:
+## 账户管理
 
 ```bash
-desic-okx account add --name demo --environment demo
-desic-okx account verify --name demo
-desic-okx account verify --all
 desic-okx account list
-desic-okx account set-default demo
-desic-okx account rename demo demo-primary
-desic-okx account edit demo-primary
-```
-
-`account add` and `account edit` verify the credentials with OKX before writing the configuration file. Editing credentials remains interactive so secrets are not passed as command-line arguments.
-
-The credential prompts hide input. Credentials are stored in the system configuration directory in `config.json`; Unix permissions are set to `0600`. The active path is shown by:
-
-```bash
-desic-okx config-path
-```
-
-Environment variables can override a named account:
-
-```text
-OKX_ACCOUNT
-OKX_API_KEY
-OKX_API_SECRET
-OKX_API_PASSPHRASE
-OKX_ENVIRONMENT=demo|live
+desic-okx account verify --name main
+desic-okx account verify --all
+desic-okx account set-default main
+desic-okx account rename main primary
+desic-okx account edit primary
+desic-okx account remove primary
 ```
 
-The three credential values must be provided together. Whether an account can trade is determined by the permissions assigned to its API key in OKX.
+`account add` 和 `account edit` 均在写入配置前验证凭证。工具参数只接受账户别名，不接受 API Key、Secret 或 Passphrase。
 
-## Tool help
-
-The MCP schemas are available to AI clients. Humans can inspect the same schema, account requirement, and a runnable example from the CLI:
+## 工具帮助
 
 ```bash
+desic-okx tools
 desic-okx tool news_search
+desic-okx tool trade_place_order
 desic-okx tool trade_place_order --json
 ```
 
-Remote News and Smart Money tools require a configured **live OKX account**. Read-only API permission is sufficient. Local News event and history tools can use previously persisted data where available. This requirement is included in the MCP tool descriptions and relevant Skills.
-
-## Update
-
-Check or install the latest npm release:
-
-```bash
-desic-okx update --check
-desic-okx update
-desic-okx update --yes
-```
-
-The updater checks the official npm registry, stops the Runtime, waits for the native SQLite module to be released, and then performs the global npm update. It synchronizes Skills for detected installations and runs Doctor afterward. When a newer CLI or MCP adapter encounters an older running Runtime, it automatically replaces it before handling requests.
-
-## Proxy
+帮助会显示用途、账户要求、输入 Schema 和可直接运行的调用示例。远程 News 与 Smart Money 接口属于实验性能力，上游兼容性问题会返回 `CAPABILITY_UNAVAILABLE`，不会影响行情、账户和交易模块。
 
-REST and every public, business, and private WebSocket connection use the same proxy resolution order:
+## 代理
 
-1. `proxy.url` in `config.json`
-2. `HTTPS_PROXY`, `HTTP_PROXY`, or `ALL_PROXY` environment variables, with `NO_PROXY` support
-3. The enabled Windows or macOS HTTP/HTTPS system proxy
-4. Direct connection
+REST 以及公共、业务和私有 WebSocket 统一按以下顺序解析代理：
 
-Linux system-wide desktop proxy settings vary by distribution; use the standard environment variables or `config.json`. Only HTTP and HTTPS proxy URLs are supported. PAC-only and SOCKS-only system settings require an HTTP proxy endpoint.
+1. `config.json` 中的 `proxy.url`
+2. `HTTPS_PROXY`、`HTTP_PROXY` 或 `ALL_PROXY`，并支持 `NO_PROXY`
+3. Windows 或 macOS 已启用的系统 HTTP/HTTPS 代理
+4. 直接连接
 
-Example explicit configuration:
+只支持 HTTP/HTTPS 代理 URL。仅有 PAC 或 SOCKS 的环境需要提供 HTTP 代理入口。示例：
 
 ```json
 {
@@ -262,74 +276,64 @@ Example explicit configuration:
 }
 ```
 
-The guided `desic-okx setup` flow tests a manually entered proxy before saving it. See `examples/config.example.json` for a complete credential-free configuration template. Restart the Runtime after changing configuration.
-
-## Runtime behavior
-
-- Binds a random port on `127.0.0.1`
-- Stores PID, port, and a random access token in private local state files
-- Prewarms `BTC-USDT-SWAP` and `ETH-USDT-SWAP`
-- Subscribes to other instruments on demand and releases them after 15 minutes of inactivity
-- Serves fresh data from memory and uses REST for cold or stale data
-- Reconnects WebSockets automatically
-- Rebuilds the order book after sequence gaps or checksum failures
-- Restores persisted candle and intelligence history before live prewarming
+修改配置后重启 Runtime：
 
-`market_get_decision_snapshot` combines market components around one observation time. It reports every component's exchange timestamp, receive time, age, warnings, and maximum observed time skew. Trading prechecks reject inconsistent snapshots.
+```bash
+desic-okx stop
+```
 
-## Trading behavior
+## 更新
 
-Trading tools require a stable `executionKey`. Client order IDs are derived from that key, and execution state is recorded locally. When a write times out or returns an unclear result, the Runtime queries remote order state before deciding whether a retry is safe.
+```bash
+desic-okx update --check
+desic-okx update
+desic-okx update --yes
+```
 
-Supported order families include:
+更新器会检查 npm 官方 Registry、停止 Runtime、等待 Windows 释放 SQLite 原生模块、执行全局升级、同步已安装 Skills，最后运行 Doctor。新版 CLI 或 MCP 适配器遇到旧 Runtime 时也会自动切换版本。
 
-- `limit`
-- `market`
-- `post_only`
-- `ioc`
-- `fok`
-- `trigger`
-- `conditional`
-- `trailing`
+## 手动接入客户端
 
-Ordinary and strategy orders are checked against instrument increments, minimum size, current account permission, and market snapshot consistency before submission.
+推荐使用 `desic-okx setup`。只注册 MCP 时，可运行：
 
-Use an OKX Demo account first. Trading software can lose money, and the project provides no investment advice or guarantee of execution quality.
+```bash
+codex mcp add desic-okx -- desic-okx mcp
+claude mcp add --transport stdio --scope user desic-okx -- desic-okx mcp
+```
 
-## Experimental intelligence
+Codex 的手动配置：
 
-Remote News and Smart Money use upstream interfaces that may change without notice and require a configured live OKX account; read-only API permission is sufficient. Compatibility failures return `CAPABILITY_UNAVAILABLE`, or locally persisted history when available. A failure in these modules does not disable market, account, or trading tools.
+```toml
+[mcp_servers.desic-okx]
+command = "desic-okx"
+args = ["mcp"]
+```
 
-## Development
+## 从源码开发
 
 ```bash
+git clone https://github.com/xiazhi88/desic-okx-agent.git
+cd desic-okx-agent
 npm ci
 npm run check
+npm link
 ```
 
-The check pipeline runs:
-
-- TypeScript type checking
-- Unit tests
-- Skill validation
-- Sensitive-information scanning
-- Production build
-- MCP SDK smoke tests
-
-The optional end-to-end trading test is restricted to OKX Demo. Export the four environment variables listed in the account section, using `demo` as the environment, and then run:
-
-```bash
-npm run test:demo
-```
+检查流程包含 TypeScript 类型检查、单元测试、Skill 校验、敏感信息扫描、生产构建和 MCP 传输冒烟测试。普通测试不会提交订单；真实交易端到端测试仅允许 OKX Demo 环境。
 
-Normal tests never submit orders.
+## 运行机制
 
-## Status
+- Runtime 绑定 `127.0.0.1` 随机端口，并以私有状态文件保存 PID、端口和访问令牌。
+- 默认预热 `BTC-USDT-SWAP` 和 `ETH-USDT-SWAP`，其他合约按需订阅并在空闲 15 分钟后释放。
+- 热数据从内存返回，冷数据或过期数据由 REST 补齐。
+- WebSocket 自动重连；盘口序列、校验失败时重新建立快照。
+- `market_get_decision_snapshot` 对齐多个数据组件并报告最大时间偏差；交易预检拒绝不一致快照。
+- 交易写操作使用稳定 `executionKey`。超时或结果不明确时先查询远端状态，不直接重复提交。
 
-This repository is currently pre-release software at version `0.2.0`. Unit, packaging, Skill, and MCP transport checks are automated. Real OKX Demo trading should be validated in the target network environment before a `1.0.0` release.
+交易软件可能造成资金损失。本项目不提供投资建议，也不保证执行结果。
 
-## License
+## 状态与许可
 
-MIT. See `LICENSE`.
+当前为 `0.3.0` 预发布版本。正式发布 `1.0.0` 前，应在目标网络环境中完成 OKX Demo 交易验证。策略研究与实盘执行已在 OKX 模拟盘上端到端验证过，**实盘执行尚未经过长期真钱运行**。
 
-OKX and related marks belong to their respective owners.
+MIT License，详见 `LICENSE`。OKX 及相关商标归其各自权利人所有。

package/dist/account/private-websocket.js

@@ -2,6 +2,7 @@ import crypto from "node:crypto";
 import WebSocket from "ws";
 import { HttpsProxyAgent } from "https-proxy-agent";
 import { resolveProxy } from "../network/proxy.js";
+import { privateWsUrl } from "../network/connectivity.js";
 export class PrivateAccountWebSockets {
     store;
     connections;
@@ -43,10 +44,9 @@ export class PrivateAccountWebSockets {
     connect(connection) {
         if (connection.stopping)
             return;
-        const url = connection.account.environment === "demo"
-            ? "wss://wspap.okx.com:8443/ws/v5/private"
-            : "wss://ws.okx.com:8443/ws/v5/private";
-        const socket = new WebSocket(url, this.agent ? { agent: this.agent } : undefined);
+        // Per account, not per runtime: the private feed follows whichever environment
+        // the credentials belong to, while market data follows its own setting.
+        const socket = new WebSocket(privateWsUrl(connection.account.environment), this.agent ? { agent: this.agent } : undefined);
         connection.socket = socket;
         connection.authenticated = false;
         socket.on("open", () => socket.send(JSON.stringify({ op: "login", args: [loginArgs(connection.account)] })));

package/dist/account/private-websocket.js.map

@@ -1 +1 @@
-{"version":3,"file":"private-websocket.js","sourceRoot":"","sources":["../../src/account/private-websocket.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"private-websocket.js","sourceRoot":"","sources":["../../src/account/private-websocket.ts"],"names":[],"mappings":"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"}

package/dist/account/service.d.ts

@@ -1,6 +1,6 @@
 import type { RuntimeConfig } from "../config/schema.js";
 import { OkxClient } from "../core/okx-client.js";
-import { type AccountCredentials, type ToolResult } from "../core/types.js";
+import { type AccountCredentials, type OkxEnvironment, type ToolResult } from "../core/types.js";
 import type { AccountStore } from "./store.js";
 export declare class AccountService {
     private readonly config;
@@ -20,3 +20,14 @@ export declare class AccountService {
     getRisk(name?: string): Promise<ToolResult<Record<string, unknown>>>;
     private wrap;
 }
+export interface UnclassifiedAccountCredentials {
+    name: string;
+    apiKey: string;
+    secretKey: string;
+    passphrase: string;
+}
+export interface DetectedAccount {
+    account: AccountCredentials;
+    config: Record<string, unknown>;
+}
+export declare function detectAccountEnvironment(client: Pick<OkxClient, "privateGet">, credentials: UnclassifiedAccountCredentials, preferred?: OkxEnvironment): Promise<DetectedAccount>;

package/dist/account/service.js

@@ -1,4 +1,5 @@
 import { resolveAccount } from "../config/loader.js";
+import { RuntimeError } from "../core/errors.js";
 import { resultMeta } from "../core/types.js";
 export class AccountService {
     config;
@@ -108,6 +109,23 @@ export class AccountService {
         };
     }
 }
+export async function detectAccountEnvironment(client, credentials, preferred) {
+    const environments = preferred === "demo" ? ["demo", "live"] : ["live", "demo"];
+    let lastError;
+    for (const environment of environments) {
+        const account = { ...credentials, environment };
+        try {
+            const [config] = await client.privateGet("/api/v5/account/config", account);
+            return { account, config: config ?? {} };
+        }
+        catch (error) {
+            lastError = error;
+            if (error instanceof RuntimeError && !["AUTH", "PERMISSION", "OKX_REJECTED"].includes(error.code))
+                throw error;
+        }
+    }
+    throw lastError ?? new RuntimeError("AUTH", "OKX account environment could not be detected");
+}
 function recent(value) {
     return value && Date.now() - value.receivedAt <= 15_000 ? value : undefined;
 }