@alphafox/cli 0.3.20 → 0.3.22

package/dist/commands/run.js

@@ -101,8 +101,8 @@ async function runCli(argv, env = process.env) {
                 "alphafox schema [operationId]",
                 "alphafox catalog",
                 "alphafox api METHOD PATH [--body JSON|--config @file]",
-                "alphafox engine-backtest run --experiment <uuid> --definition <id> --config @file --exchange <id> --range FROM..TO --initial-equity N",
-                "alphafox engine-backtest sweep --experiment <uuid> --definition <id> --config @file --axes @file --exchange <id> --range FROM..TO --initial-equity N --no-persist",
+                "alphafox engine-backtest run --experiment <uuid> --definition <id> --config @file --exchange <id> --range FROM..TO --initial-equity N [--verbose]",
+                "alphafox engine-backtest sweep --experiment <uuid> --definition <id> --config @file --axes @file --exchange <id> --range FROM..TO --initial-equity N --no-persist [--verbose]",
                 "alphafox cache status|clean [--tape|--runtime|--all]",
                 "alphafox resolve-symbols <query...> [--exchange binance] [--asset-class equity_perp]",
                 "alphafox <domain> <resource> <action> [flags]",

package/dist/engine-backtest/parse-args.js

@@ -16,11 +16,11 @@ const TIERS = new Set(["free", "pro", "pro_max"]);
 const DATA_QUALITY = new Set(["strict", "basic"]);
 const PRICE_PATHS = new Set(["ohlc_path_4", "close_only"]);
 exports.ENGINE_BACKTEST_RUN_USAGE = [
-    "alphafox engine-backtest run --experiment <uuid> --definition <id> --config @file.json --exchange <id> --range YYYY-MM-DD..YYYY-MM-DD --initial-equity N [--replay-timeframe 1m]",
+    "alphafox engine-backtest run --experiment <uuid> --definition <id> --config @file.json --exchange <id> --range YYYY-MM-DD..YYYY-MM-DD --initial-equity N [--replay-timeframe 1m] [--verbose]",
     "alphafox engine-backtest run --create-experiment --name <name> --definition <id> --config @file.json --exchange <id> --from YYYY-MM-DD --to YYYY-MM-DD --initial-equity N",
 ];
 exports.ENGINE_BACKTEST_SWEEP_USAGE = [
-    "alphafox engine-backtest sweep --experiment <uuid> --definition <id> --config @file.json --axes @axes.json --exchange <id> --range YYYY-MM-DD..YYYY-MM-DD --initial-equity N [--no-persist] [--mode neighborhood|range] [--search-mode standard|fast] [--concurrency N]",
+    "alphafox engine-backtest sweep --experiment <uuid> --definition <id> --config @file.json --axes @axes.json --exchange <id> --range YYYY-MM-DD..YYYY-MM-DD --initial-equity N [--no-persist] [--mode neighborhood|range] [--search-mode standard|fast] [--concurrency N] [--verbose]",
 ];
 const SWEEP_MODES = new Set(["neighborhood", "range"]);
 const SEARCH_MODES = new Set(["standard", "fast"]);
@@ -112,6 +112,7 @@ function parseEngineBacktestRunArgs(args) {
     let configSchemaVersion;
     let executionModelOverride;
     let persist = true;
+    let verbose = false;
     let help = false;
     let replayTimeframe = replay_timeframe_1.ENGINE_BACKTEST_DEFAULT_REPLAY_TIMEFRAME;
     for (let i = 0; i < args.length; i += 1) {
@@ -128,6 +129,10 @@ function parseEngineBacktestRunArgs(args) {
             persist = false;
             continue;
         }
+        if (a === "--verbose") {
+            verbose = true;
+            continue;
+        }
         if (!a.startsWith("--")) {
             usage(`Unexpected argument: ${a}`, "unexpected_arg");
         }
@@ -227,6 +232,7 @@ function parseEngineBacktestRunArgs(args) {
             tier,
             dataQualityMode,
             persist,
+            verbose,
             replayTimeframe,
         };
     }
@@ -284,6 +290,7 @@ function parseEngineBacktestRunArgs(args) {
         configSchemaVersion,
         executionModelOverride,
         persist,
+        verbose,
         replayTimeframe,
     };
 }
@@ -346,6 +353,7 @@ function parseEngineBacktestSweepArgs(args) {
             createExperiment: false,
             dataQualityMode: types_1.DEFAULT_DATA_QUALITY_MODE,
             persist: true,
+            verbose: false,
             replayTimeframe: replay_timeframe_1.ENGINE_BACKTEST_DEFAULT_REPLAY_TIMEFRAME,
             axesRaw,
             mode,

package/dist/engine-backtest/run-command.js

@@ -222,7 +222,9 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
         wasm = wasmLoaded.module;
         runner = runnerLoaded.module;
     }
-    const client = wasm.createNodeBacktestClient();
+    const client = wasm.createNodeBacktestClient({
+        verbose: args.verbose,
+    });
     try {
         if (typeof client.init === "function") {
             await client.init();
@@ -449,6 +451,7 @@ function engineBacktestHelpData() {
             "runs.create is write (not high-risk-write); --yes is not required",
             "Do not pass --token; use alphafox auth login",
             "--replay-timeframe defaults to 1m (min 1m). Indicator series still download their native plan timeframes.",
+            "Raw Engine worker logs, including per-trade output, are hidden by default. Use --verbose to forward them.",
             "--data-quality defaults to basic: hard tape failures still stop, soft gaps finish the run and appear as coverageNotice (prefix_gap less severe, internal_gap more severe). Use --data-quality strict to fail on any gap.",
         ],
     };

package/dist/engine-backtest/sweep-command.js

@@ -85,7 +85,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
     const { wasm, runner } = await loadRuntime(deps, env);
     const clients = [];
     try {
-        const client = wasm.createNodeBacktestClient();
+        const client = wasm.createNodeBacktestClient({ verbose: args.verbose });
         clients.push(client);
         if (typeof client.init === "function") {
             await client.init();
@@ -221,7 +221,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
         }
         emitProgress("tape", 1);
         while (clients.length < concurrency) {
-            const extra = wasm.createNodeBacktestClient();
+            const extra = wasm.createNodeBacktestClient({ verbose: args.verbose });
             clients.push(extra);
             if (typeof extra.init === "function") {
                 await extra.init();

package/dist/engine-backtest/types.d.ts

@@ -50,6 +50,8 @@ export interface EngineBacktestRunArgs {
     readonly configSchemaVersion?: number;
     readonly executionModelOverride?: Partial<ExecutionModel>;
     readonly persist: boolean;
+    /** Forward raw Engine WASM worker stdout/stderr. Disabled by default. */
+    readonly verbose: boolean;
     /** Replay/download bar. Defaults to 1m; never finer. */
     readonly replayTimeframe: string;
 }
@@ -256,7 +258,9 @@ export interface BacktestClientLike {
     terminate(): void;
 }
 export interface BacktestWasmModule {
-    createNodeBacktestClient(options?: unknown): BacktestClientLike;
+    createNodeBacktestClient(options?: {
+        readonly verbose?: boolean;
+    }): BacktestClientLike;
 }
 export interface BacktestRunnerModule {
     loadTape(request: {

package/dist/skills-manifest.json

@@ -1,153 +1,153 @@
 {
   "schemaVersion": 1,
   "packageName": "@alphafox/cli",
-  "packageVersion": "0.3.20",
+  "packageVersion": "0.3.22",
   "contractVersion": "2026-08-31",
-  "bundleHash": "ca170c6f023704493568335720fd82f73cd7b7a34dab795e39f3920cfa4d47d5",
+  "bundleHash": "0ff8e818dd5a2f06d7d0df63d681bdf04163b9b09d8626da99c033a97aa8d438",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "87bfa86a0be66a6737282286b3def88cc15485dac3245ea26d462334a03cc686",
+          "sha256": "454ddd309258874eb35bf567cd9ac3f524ecd212cd0a76599b8ae96ca50b9658",
           "size": 7950
         }
       ],
-      "hash": "1717e3a193ebc73813d7029dc700d735bdded791a628a8d42a40245912b7effc"
+      "hash": "10dc9fcb503d2e09dda7284818fcebd1223d97fb3c8e95e7757ea6db86a239b2"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "cda48226d5c00160a5373a457f813f9fe9b44fe8e17a1ff9e267e507b586227a",
+          "sha256": "ab83a22f7960d1b94d1f3874cd464c705c9eafb77b3b132ad3d2c092b343227b",
           "size": 784
         }
       ],
-      "hash": "271fad09bfdabbea108182f32e03ee660e30f8f69b176c128b67491c3cb95bea"
+      "hash": "b0de2c06865dd85be5655358e2fe20bd54dd2db29af73c225e43e3e5c4464649"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "87c7141e1a4eb23f62ef5091a1d329d4d63926c7ffecd9f36fe2363c5ae77baa",
+          "sha256": "a30aa7f40d67e32068f909481906a548da713f05dfb8562eebb05bc09d90bca7",
           "size": 2078
         }
       ],
-      "hash": "af6a0f2e8438578ba047e5f95bb69e7ce0919f5d947634203bdd0a1aea963e39"
+      "hash": "e0aa20827c3299dc996c74ef27b7708bd32275e3a61362b07be367fc565e735a"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "285ff81745bb8336af4b0d68ae1d6fb212120d357b0b70f1a090815d4b3038b2",
+          "sha256": "eab220c69f31de56f7bdfde7722723c2bc9a667539f62bc8faae7234642412be",
           "size": 2371
         }
       ],
-      "hash": "f2dcab96b60491f9a3c18bcbd7e4a855ee645c144e2178351091b3c0d72d5830"
+      "hash": "02c24ece7d90d42afd81c249184925ec970602e0226deafd290ff1d7d2e2dfa9"
     },
     {
       "name": "alphafox-cache",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "1bfd3487e1d155f8c250d6f1f96b555f56ca267f99691845656e60026bf98db8",
+          "sha256": "ebdf0007dfb04f2e2285b2e4cf738e6b70c46b40f67b22f2ec024be79e1ff895",
           "size": 1530
         }
       ],
-      "hash": "a3e23a1ec43760757473b54604aa8e6535cf4c9329884ff5e408365e77baf9e1"
+      "hash": "7ebf4b0457e8c61fdd28601dbd95ef3b36eb2d4935e1f38448273e329ae69013"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "074c54274b962267101b8b2e6d51c7054345c5d79c841299fa8ccd084e134a9d",
-          "size": 9360
+          "sha256": "2a30ee16622c6a4cf1f9f40519be544d0f089a62eba4ffdd48d726f153760de3",
+          "size": 9792
         }
       ],
-      "hash": "d43d2be349a3c4e97c45d3dd560bcaccbffcd6c3dafae9795b7bdd641352b291"
+      "hash": "1aecca4608c0253089e69c1d58746984c2621ab5eccbb45c4e962a7530936663"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "46ee8cd0b8a4cebce8f15dfa1faec604880ea3547f2c9647b4b820e6d40f2a0a",
+          "sha256": "a065c2af77150a140838580053d688defaafa2c1093c565f9759b2e4f211e3cd",
           "size": 744
         }
       ],
-      "hash": "03373a84634e21bcc1325f6d2caa000063e9a6e49794c6f8368b0a1aab28b064"
+      "hash": "0dd29f8547bdbcfe89789877b32e84f130e88c886cd07cab2785d515ff807a3c"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "41ded9162c51d32c1bd4b03eaa59fa3a32fb799a27828f1ccdf16d49e449b187",
+          "sha256": "ca9d73c21724cf2e9b2f4ab9128f5ca883c70530ee4dc7268ea05c3a9d226083",
           "size": 3079
         }
       ],
-      "hash": "5e54514b833faa00b906424c967dee34c302ea44377c8b6cde43457e358b4a4a"
+      "hash": "e5582689e8c8ca0e2ffcb334ba454b12400e9591070c9728b31e39db42c276a0"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "ec3682d888512bd5ce3937ca691ce66d1c6ab71bcb834bc26fa65b74baa8f7b1",
+          "sha256": "05485ee0d3bec411583f57ecb711555a5353d50fbf76ab92aaa45e2de4abdf20",
           "size": 699
         }
       ],
-      "hash": "f3fecdd9069200c456c3e809679d6d6bf01638aadf1be08861d4dff2fd13309b"
+      "hash": "a139b26ee840f4f6c3bf46e92809ef5db1af29b446e572b5254808a639f86f27"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "41284bfad66f187a3ee57a9134f9cbf341beb1ce20581dcdf5981f2a0af581af",
+          "sha256": "b7bbdf683b12975538c26e38a05dce89d0c0f1a19a5cc73569e2c709fbb5d04b",
           "size": 6920
         }
       ],
-      "hash": "1595fdcb3095ad7ed55af5b2a79e043a389a06c48cb806e2e3e04dd0ab305830"
+      "hash": "7c7750ba8bf2d2dbf51c8fb134ac958076773f9572f9082497925bb8b255de13"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "6d889ac8c1dde1f2581133975cc23f25b8e2793ee4c90b7c3ccc85ffbe2e01d8",
-          "size": 4862
+          "sha256": "01540ff5e1076eab22515991199be407263d942bc7608628c377b81eb0157cd7",
+          "size": 7185
         }
       ],
-      "hash": "148851ac3cc355de419b1dafe08f684fa8d7ea98967f14c0b01d83ea0ef800b8"
+      "hash": "e2e0e0a6bae21e5f97ed6ba42d66e90cf51c76b6601cdad606630c3743441909"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.20",
+      "version": "0.3.22",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "bef37f59c7511127794ba8edbbdde3f56bde543d0051b6dbfe5f0360168a2698",
-          "size": 4493
+          "sha256": "4b862b2f01534e0fda2c6667bc39a972f2cd9692f8967a0496b941411b745967",
+          "size": 4921
         }
       ],
-      "hash": "538a934c5e807af73da35c7ae85cd3921ee92a00f34648484a1c7e3eeb0fbc52"
+      "hash": "d8c0388da25fd4964d6ca8d4668ec0a0778669e0fbc22e85952b7eca80869205"
     }
   ]
 }

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 export declare const CLI_NAME = "alphafox";
 export declare const CLI_PACKAGE = "@alphafox/cli";
-export declare const CLI_VERSION = "0.3.20";
+export declare const CLI_VERSION = "0.3.22";
 export { CATALOG_VERSION as CLI_CONTRACT_VERSION } from "./catalog/operations";

package/dist/version.js

@@ -3,6 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLI_CONTRACT_VERSION = exports.CLI_VERSION = exports.CLI_PACKAGE = exports.CLI_NAME = void 0;
 exports.CLI_NAME = "alphafox";
 exports.CLI_PACKAGE = "@alphafox/cli";
-exports.CLI_VERSION = "0.3.20";
+exports.CLI_VERSION = "0.3.22";
 var operations_1 = require("./catalog/operations");
 Object.defineProperty(exports, "CLI_CONTRACT_VERSION", { enumerable: true, get: function () { return operations_1.CATALOG_VERSION; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "AlphaFox CLI — Agent/Human entry for the public Application API.",
   "type": "commonjs",
   "bin": {

package/skills/account/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-account
 description: Account, wallet, and subscription read paths.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Account / wallet

package/skills/admin/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-admin
 description: Admin-only operations reusing Web role authorization.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Admin

package/skills/alphafox/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox
 description: AlphaFox CLI entry router. Use for any AlphaFox request — install, update, login, whoami, 回测, engine backtest, 清理回测缓存 / 历史数据, strategy definitions, create/list/start/stop a running strategy (trader), ticker/标的 resolve (美股 or crypto), market data, exchange connectors, wallet, subscriptions, notifications, or admin. After 回测 or 运行策略, include the dashboard URL from the domain skill. When the user asks 排行榜, include https://www.alphafox.app/zh/dashboard/leaderboard. After a successful install and login, present the 新人引导 in this file (Lite square 带单员 + classic strategies). If a CLI command prints `[alphafox] update available`, ask the user「检测到新的版本，是否需要我帮你升级？」and only then run `alphafox update --format json --no-input`. After a large backtest, if tape cache is large, ask「回测下载的历史数据比较大，要不要我帮你清理本地缓存？」then open `alphafox-cache`. Start here, then open the routed domain skill. Do not guess alphafox-engine-backtest vs alphafox-strategy vs alphafox-trading from memory.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # AlphaFox

package/skills/alphafox-shared/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-shared
 description: Shared AlphaFox CLI rules for Agents — auth, profiles, envelopes, risk gates, public operationIds, and dashboard links after 回测 / 运行策略 / 排行榜.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # AlphaFox shared Agent contract

package/skills/auth/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-auth
 description: Login, status, logout, whoami, and environment isolation for AlphaFox CLI.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Auth Skill

package/skills/cache/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-cache
 description: Inspect and clean local Engine backtest caches (downloaded OHLCV tape and wasm runtime). Use when the user asks to 清理缓存, free disk, or after a large historical backtest.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Cache

package/skills/engine-backtest/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-engine-backtest
 description: Local Engine WASM backtest (alphafox engine-backtest run|sweep) vs catalog experiment CRUD. After a persisted run, include https://www.alphafox.app/zh/dashboard/traders/backtest/{experimentId}.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Engine Backtest
@@ -33,6 +33,8 @@ alphafox schema engine_backtest.experiments.byId.sweeps.create --format json --n
 
 The tape runner ships inside the CLI (plus `ccxt` for public-market pulls). The wasm / Node host is downloaded from the public Vercel Blob manifest (`engine-backtest/latest.json`) into `~/.cache/alphafox/engine-backtest/<hash>/` on first run.
 
+Before planning or running, follow the complete parameter review in `alphafox-strategy`, including when the operator already supplied `--config` or pasted a full command. Do not run the backtest until every applicable parameter, default status, short explanation, proposed value, and value source has been shown and the operator explicitly confirms the final proposal. User overrides win; unresolved required values stop the flow.
+
 Local overrides, in order:
 
 1. `ALPHAFOX_BACKTEST_WASM_DIR` / `ALPHAFOX_BACKTEST_RUNNER_DIR`

package/skills/exchange/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-exchange
 description: Exchange connectors list and connection management via Public API.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Exchange connectors

package/skills/market/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-market
 description: Market data and ticker resolution for US equity perps, RWAs, and crypto on the same perp catalog. Use when the user names 美股, NVDA, AAPL, BTC, or any 标的. Keep the operator's asset class via symbolMetadata — do not rewrite NVDA into a crypto coin.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Market

package/skills/notification/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-notification
 description: Notification channels and subscriptions.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Notification

package/skills/strategy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-strategy
 description: Strategy definitions — list types, read a definition's contract, and validate config. Creating a running strategy is creating a trader; use alphafox-trading for that. Local Engine backtest is alphafox-engine-backtest.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Strategy definitions
@@ -31,18 +31,38 @@ Match the name the operator used against list `id` / `name` / `display`. If they
 1. `id`, `category` (`COPY` / `DCA` / `GRID` / `TREND` / `OTHERS`), `status`
 2. English `description` (mechanism). Prefer it over marketing `display.description`
 3. `capabilities` and `commonModules` (event-driven vs polling, signal sources, manual sync)
-4. `strategyConfigSchema` required fields and each field's `display` — including decision-logic enums inside this definition
+4. The effective `configSchema`, including composed common modules, strategy parameters, defaults, constraints, conditional branches, and each field's `display`
 5. `capabilities.actionDefinitions` (what a manual action changes)
 
 Explain the type from those fields. Missing a layer → say unknown; do not fill from memory. Decision logic (`simple-long`, grid `mode` `neutral`/`long`/`short`) is an internal parameter, not a new definition id.
 
 ## Configure with the human
 
-The human answers knobs. You write JSON.
+The human confirms the complete parameter set. You write JSON only after that review.
 
 1. Confirm the definition from `byId.get` in the operator's language (what it is, what drives it, how positions change).
-2. From `strategyConfigSchema` plus common required fields, ask **only** values the human must choose: symbols (resolve first), direction / mode, size, signal source, leverage. Do not walk every optional key. If the operator does not pick leverage, write `common.execution.leverage: 10` (website form default). Omitting the field is not the same — Engine treats a missing leverage as **1x**.
-3. Write `strategy-config.json` as the trader object:
+2. Use the effective `configSchema` returned by `byId.get` as the sole parameter contract. It already composes the definition's `commonModules` with `strategyConfigSchema` and may contain definition-specific customization. Walk every applicable parameter, not only required fields or familiar knobs.
+3. Resolve conditional schemas in dependency order. Ask for a discriminator or enable/disable choice first, then enumerate every parameter in the selected branch. Do not present inactive branch fields as active settings. For arrays or maps, explain the collection and confirm every field of each configured item.
+4. Build a grouped or numbered review table in the operator's language. Every applicable parameter must have:
+
+   - full JSON path;
+   - short explanation from localized `display.description`, falling back to the schema's description; if neither exists, say the definition provides no explanation — do not guess;
+   - type plus enum, range, or other relevant constraints;
+   - default status and source;
+   - proposed value and value source.
+
+5. Determine the proposed value in this precedence order:
+
+   1. **user override** — any value the operator explicitly supplied, including values already present in a provided config;
+   2. **schema default** — the field's JSON Schema `default`;
+   3. **product default** — only a default explicitly documented by this skill or the live product contract. Currently `common.execution.leverage` is `10`, matching the website form; raw Engine omission means 1x;
+   4. **no default** — required fields remain unresolved and must be answered; optional fields are proposed as “不设置 / omit”. Do not guess a value or describe omission as a default.
+
+   A user override always wins, even when it equals neither default. Preserve explicit `false`, `0`, empty arrays, and empty strings when the schema allows them; they are not missing values.
+
+6. When there are many parameters, present them in logical groups or numbered chunks so the review remains readable. After all groups are visible, ask the operator to reply **confirm all** / “全部确认”, or override paths/numbers. One overall confirmation is sufficient, but it must cover every displayed parameter. Apply overrides, show the affected rows again, and repeat until no required value is unresolved and the operator explicitly confirms the final proposal.
+7. An earlier request such as “创建策略”, “运行回测”, or a pasted command/config is input to the proposal, not confirmation of the review. Do not validate, create, or backtest until the complete parameter review is explicitly confirmed.
+8. Write `strategy-config.json` as the trader object:
 
 ```json
 {
@@ -53,7 +73,7 @@ The human answers knobs. You write JSON.
 
 `common` is shared risk / SLTP / execution / market. `strategy` is this type's parameters and decision logic. Do not use top-level `settings`, `policyId`, or `policyParams`. `configSchemaVersion` comes from the definition (`byId.get` / list); keep it off this file.
 
-4. Keys and enums come from the definition schema, not from this skill. Do not ship a default `grid.json` / `dca.json`. Reuse this source file for `engine-backtest --config` and as `trading.traders.create` `config`.
+9. Keys and enums come from the definition schema, not from this skill. Do not ship a default `grid.json` / `dca.json`. Reuse this source file for `engine-backtest --config` and as `trading.traders.create` `config`.
 
 ## Validate config
 

package/skills/trading/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-trading
 description: Running strategies (traders) — create, list, start, and stop. A trader is a live or paper strategy instance (grid, dca, copy, …), not a person. Default Engine create uses autoStart true (创建即开始). Use autoStart false only when the user asks to create without starting. After create or start, include https://www.alphafox.app/zh/dashboard/traders/{traderId}.
-version: 0.3.20
+version: 0.3.22
 ---
 
 # Running strategies (traders)
@@ -32,6 +32,8 @@ alphafox api GET /api/v1/trading/traders --format json --no-input
 
 Read `alphafox schema <operationId>` first. Body may only include documented `request.body` fields. Large / nested bodies use `--config @file`.
 
+Before composing or dry-running any create request, follow the complete parameter review in `alphafox-strategy`, including when the operator already supplied a config. Do not create a trader until every applicable parameter, default status, short explanation, proposed value, and value source has been shown and the operator explicitly confirms the final proposal. User overrides win; unresolved required values stop the flow.
+
 ```bash
 alphafox schema trading.traders.create --format json --no-input
 alphafox trading traders create --config @./create-trader.json --dry-run --format json --no-input

package/vendor/backtest-runner/README.md

@@ -80,6 +80,8 @@ const scenario = assembleScenario({
 
 与 web `tape-loader.series.ts` 对齐：Binance 1500、OKX 100、Bybit / Bitget 1000、Hyperliquid 5000。Bitget 另受约 89 天请求跨度限制；Hyperliquid 分页带 `until` 窗口。
 
+长区间会拆成最多 8 个可独立下载的时间窗口；不同 `symbol × timeframe` 与同一序列的时间窗口共用一个全局 8 请求池，避免嵌套并发放大。相邻窗口保留一根重叠 K 线，合并时按时间去重；同时间戳内容不一致会抛出 `invalid_ohlcv`，不会静默选取其中一份。
+
 ## 数据质量
 
 - `basic`（默认）：硬失败（缺市场、空序列、非法 K 线、拉数失败）仍抛错；软缺口进入 `coverageIssues` 与 `coverageWarnings`。起始缺口（`prefix_gap`）较轻，中间缺口（`internal_gap`）较重。

package/vendor/backtest-runner/index.d.ts

@@ -316,7 +316,7 @@ export interface TapeProxyOptions {
 export interface TapeLoadOptions extends TapeProxyOptions {
   readonly cache?: FileTapeCache | false | "disable";
   readonly cacheDir?: string;
-  /** Independent series fetches; default 4, hard cap 8. Pagination stays serial. */
+  /** Shared series and time-window request budget; default and hard cap are 8. */
   readonly seriesConcurrency?: number;
   readonly nowMs?: number;
   readonly onProgress?: (progress: TapeLoadProgress) => void;
@@ -353,7 +353,7 @@ export interface TapeLoadResult {
   };
 }
 
-export const DEFAULT_TAPE_SERIES_CONCURRENCY: 4;
+export const DEFAULT_TAPE_SERIES_CONCURRENCY: 8;
 export const MAX_TAPE_SERIES_CONCURRENCY: 8;
 
 export function resolveTapeSeriesConcurrency(value?: number): number;
@@ -364,6 +364,12 @@ export function mapWithConcurrency<T, R>(
   worker: (item: T, index: number) => Promise<R>
 ): Promise<R[]>;
 
+export function limitTapeOhlcvConcurrency(
+  exchange: Pick<TapeRuntimeExchange, "fetchOHLCV">,
+  concurrency: number,
+  signal?: AbortSignal
+): Pick<TapeRuntimeExchange, "fetchOHLCV">;
+
 export function loadTape(
   request: TapeLoadRequest,
   options?: TapeLoadOptions

package/vendor/backtest-runner/index.mjs

@@ -55,10 +55,13 @@ export {
 export {
   DEFAULT_TAPE_SERIES_CONCURRENCY,
   MAX_TAPE_SERIES_CONCURRENCY,
-  loadTape,
+  limitTapeOhlcvConcurrency,
   mapWithConcurrency,
-  resolveTapeCache,
   resolveTapeSeriesConcurrency,
+} from "./lib/tape-loader-concurrency.mjs";
+export {
+  loadTape,
+  resolveTapeCache,
   effectiveTapeEndMs,
   inferFundingIntervals,
   classifyTapeSymbolsForPreflight,

package/vendor/backtest-runner/lib/series.mjs

@@ -12,19 +12,14 @@ import {
   ENGINE_BACKTEST_WARMUP_CANDLES,
   TIMEFRAME_MS,
 } from "./timeframes.mjs";
+import {
+  fetchClosedOhlcvRange,
+  isClosedCandle,
+} from "./tape-loader-range.mjs";
 
 const WARMUP_CANDLES = ENGINE_BACKTEST_WARMUP_CANDLES;
-const BITGET_OHLCV_MAX_REQUEST_SPAN_MS = 89 * 86_400_000;
-
-export { TIMEFRAME_MS };
 
-export function isClosedCandle(timestampMs, timeframe, toMs) {
-  const stepMs = TIMEFRAME_MS[timeframe];
-  if (!stepMs) {
-    throw new Error(`不支持的 timeframe：${timeframe}`);
-  }
-  return timestampMs + stepMs <= toMs;
-}
+export { fetchClosedOhlcvRange, isClosedCandle, TIMEFRAME_MS };
 
 export function ohlcvSeriesStartMs(fromMs, timeframe, market) {
   const stepMs = TIMEFRAME_MS[timeframe];
@@ -207,164 +202,3 @@ function concatMonotonicRows(head, tail) {
   const lastHeadTimestamp = head[head.length - 1][0];
   return [...head, ...tail.filter((row) => row[0] > lastHeadTimestamp)];
 }
-
-export async function fetchClosedOhlcvRange(request) {
-  const stepMs = TIMEFRAME_MS[request.timeframe];
-  if (!stepMs) {
-    throw new Error(`不支持的 timeframe：${request.timeframe}`);
-  }
-  const pageLimit = ohlcvPageLimitForTimeframe(
-    request.exchangeDefinition,
-    request.runtimeConfig,
-    request.timeframe
-  );
-  const rows = [];
-  const totalSpan = Math.max(1, request.toMs - request.sinceMs);
-  let cursor = request.sinceMs;
-  let emptyPrefixLowerMs = null;
-  let nonEmptyPrefixUpperMs = null;
-  let prefixResolved = false;
-
-  while (cursor < request.toMs) {
-    request.signal?.throwIfAborted();
-    const fetchSinceMs =
-      request.exchangeDefinition.ccxtId === "bitget"
-        ? Math.max(0, cursor - 1)
-        : cursor;
-    const requestParams = {
-      ...request.runtimeConfig.requestParams,
-    };
-    if (request.exchangeDefinition.ccxtId === "hyperliquid") {
-      requestParams.until = Math.min(
-        request.toMs,
-        fetchSinceMs + (pageLimit - 1) * stepMs
-      );
-    }
-    const page = await abortable(
-      request.exchange.fetchOHLCV(
-        request.symbol,
-        request.timeframe,
-        fetchSinceMs,
-        pageLimit,
-        requestParams
-      ),
-      request.signal
-    );
-    request.signal?.throwIfAborted();
-
-    if (!prefixResolved && rows.length === 0 && emptyPrefixLowerMs !== null) {
-      if (page.length === 0) {
-        emptyPrefixLowerMs = cursor;
-        if (cursor >= request.fromMs) break;
-      } else {
-        nonEmptyPrefixUpperMs = cursor;
-      }
-      const upperMs = nonEmptyPrefixUpperMs ?? request.fromMs;
-      if (
-        nonEmptyPrefixUpperMs !== null &&
-        upperMs - emptyPrefixLowerMs <= stepMs
-      ) {
-        cursor = upperMs;
-        prefixResolved = true;
-        continue;
-      }
-      cursor = midpointCursorMs(emptyPrefixLowerMs, upperMs, stepMs);
-      continue;
-    }
-
-    if (page.length === 0) {
-      if (!prefixResolved && rows.length === 0 && cursor < request.fromMs) {
-        emptyPrefixLowerMs = cursor;
-        cursor = midpointCursorMs(cursor, request.fromMs, stepMs);
-        continue;
-      }
-      break;
-    }
-    prefixResolved = true;
-
-    for (const raw of page) {
-      if (raw.length < 6) {
-        throw new TapeDataUnavailableError([
-          {
-            code: "invalid_ohlcv",
-            symbol: request.symbol,
-            timeframe: request.timeframe,
-          },
-        ]);
-      }
-      const timestamp = Number(raw[0]);
-      if (!Number.isFinite(timestamp)) {
-        throw new TapeDataUnavailableError([
-          {
-            code: "invalid_ohlcv",
-            symbol: request.symbol,
-            timeframe: request.timeframe,
-          },
-        ]);
-      }
-      if (!isClosedCandle(timestamp, request.timeframe, request.toMs)) {
-        continue;
-      }
-      if (rows.length > 0 && timestamp <= rows[rows.length - 1][0]) {
-        throw new TapeDataUnavailableError([
-          {
-            code: "non_monotonic",
-            symbol: request.symbol,
-            timeframe: request.timeframe,
-            expected: rows[rows.length - 1][0] + stepMs,
-            actual: timestamp,
-            timestamp,
-          },
-        ]);
-      }
-      rows.push([
-        timestamp,
-        Number(raw[1]),
-        Number(raw[2]),
-        Number(raw[3]),
-        Number(raw[4]),
-        Number(raw[5]),
-      ]);
-    }
-    const lastTimestamp = Number(page[page.length - 1][0]);
-    const nextCursor = lastTimestamp + stepMs;
-    if (nextCursor <= cursor) {
-      break;
-    }
-    cursor = nextCursor;
-    request.onFraction?.(Math.min(1, (cursor - request.sinceMs) / totalSpan));
-  }
-  if (rows.length === 0 && !request.allowEmpty) {
-    throw new TapeDataUnavailableError([
-      {
-        code: "ohlcv_missing",
-        symbol: request.symbol,
-        timeframe: request.timeframe,
-      },
-    ]);
-  }
-  return rows;
-}
-
-function ohlcvPageLimitForTimeframe(exchange, runtimeConfig, timeframe) {
-  if (exchange.ccxtId !== "bitget") {
-    return runtimeConfig.ohlcvPageLimit;
-  }
-  const stepMs = TIMEFRAME_MS[timeframe];
-  return Math.max(
-    1,
-    Math.min(
-      runtimeConfig.ohlcvPageLimit,
-      Math.floor(BITGET_OHLCV_MAX_REQUEST_SPAN_MS / stepMs)
-    )
-  );
-}
-
-function midpointCursorMs(lowerMs, upperMs, stepMs) {
-  if (upperMs - lowerMs <= stepMs) {
-    return upperMs;
-  }
-  const midpointMs = lowerMs + Math.floor((upperMs - lowerMs) / 2);
-  const alignedMs = Math.floor(midpointMs / stepMs) * stepMs;
-  return Math.min(upperMs, Math.max(lowerMs + 1, alignedMs));
-}

package/vendor/backtest-runner/lib/tape-loader-concurrency.mjs

@@ -0,0 +1,72 @@
+export const DEFAULT_TAPE_SERIES_CONCURRENCY = 8;
+export const MAX_TAPE_SERIES_CONCURRENCY = 8;
+
+export function resolveTapeSeriesConcurrency(value) {
+  if (typeof value === "number" && Number.isFinite(value) && value >= 1) {
+    return Math.min(
+      MAX_TAPE_SERIES_CONCURRENCY,
+      Math.max(1, Math.floor(value))
+    );
+  }
+  return DEFAULT_TAPE_SERIES_CONCURRENCY;
+}
+
+export async function mapWithConcurrency(items, concurrency, worker) {
+  const list = [...items];
+  if (list.length === 0) return [];
+
+  const limit = Math.min(
+    list.length,
+    Math.max(1, Math.floor(Number(concurrency)) || 1)
+  );
+  const results = new Array(list.length);
+  let nextIndex = 0;
+  async function runWorker() {
+    while (true) {
+      const index = nextIndex;
+      nextIndex += 1;
+      if (index >= list.length) return;
+      results[index] = await worker(list[index], index);
+    }
+  }
+  await Promise.all(Array.from({ length: limit }, () => runWorker()));
+  return results;
+}
+
+/** Shares one request budget across series workers and their time windows. */
+export function limitTapeOhlcvConcurrency(exchange, concurrency, signal) {
+  const limit = resolveTapeSeriesConcurrency(concurrency);
+  const queue = [];
+  let active = 0;
+
+  const drain = () => {
+    while (active < limit) {
+      const task = queue.shift();
+      if (!task) return;
+      active += 1;
+      void task().finally(() => {
+        active -= 1;
+        drain();
+      });
+    }
+  };
+  const schedule = (operation) =>
+    new Promise((resolve, reject) => {
+      queue.push(async () => {
+        try {
+          signal?.throwIfAborted();
+          resolve(await operation());
+        } catch (error) {
+          reject(error);
+        }
+      });
+      drain();
+    });
+
+  return {
+    fetchOHLCV: (symbol, timeframe, since, pageLimit, params) =>
+      schedule(() =>
+        exchange.fetchOHLCV(symbol, timeframe, since, pageLimit, params)
+      ),
+  };
+}

package/vendor/backtest-runner/lib/tape-loader-range-plan.mjs

@@ -0,0 +1,77 @@
+import { TapeDataUnavailableError } from "./coverage.mjs";
+import { MAX_TAPE_SERIES_CONCURRENCY } from "./tape-loader-concurrency.mjs";
+
+export function planOhlcvTimeSegments(request, stepMs, pageLimit) {
+  const candleCount = Math.max(
+    0,
+    Math.ceil((request.toMs - request.sinceMs) / stepMs)
+  );
+  const segmentCount = Math.min(
+    MAX_TAPE_SERIES_CONCURRENCY,
+    Math.max(1, Math.ceil(candleCount / pageLimit))
+  );
+  if (segmentCount === 1) {
+    return [{ sinceMs: request.sinceMs, untilMs: request.toMs }];
+  }
+
+  const candlesPerSegment = Math.ceil(candleCount / segmentCount);
+  return Array.from({ length: segmentCount }, (_, index) => {
+    const logicalStartMs = request.sinceMs + index * candlesPerSegment * stepMs;
+    return {
+      // Overlap preserves bars whose exchange open time is not split-aligned.
+      sinceMs:
+        index === 0
+          ? request.sinceMs
+          : Math.max(request.sinceMs, logicalStartMs - stepMs),
+      untilMs: Math.min(
+        request.toMs,
+        request.sinceMs + (index + 1) * candlesPerSegment * stepMs
+      ),
+    };
+  }).filter((segment) => segment.untilMs > segment.sinceMs);
+}
+
+export function createSegmentRequest(request, segment, onFraction) {
+  return {
+    ...request,
+    sinceMs: segment.sinceMs,
+    toMs: segment.untilMs,
+    fromMs: Math.min(
+      segment.untilMs,
+      Math.max(segment.sinceMs, request.fromMs)
+    ),
+    allowEmpty: true,
+    onFraction,
+  };
+}
+
+export function mergeOhlcvTimeSegments(request, segments) {
+  const rowsByTimestamp = new Map();
+  for (const rows of segments) {
+    for (const row of rows) {
+      if (row[0] < request.sinceMs) continue;
+      const existing = rowsByTimestamp.get(row[0]);
+      if (existing && !sameOhlcvRow(existing, row)) {
+        throw new TapeDataUnavailableError([
+          {
+            code: "invalid_ohlcv",
+            symbol: request.symbol,
+            timeframe: request.timeframe,
+            timestamp: row[0],
+            message: "concurrent OHLCV windows returned conflicting candles",
+          },
+        ]);
+      }
+      rowsByTimestamp.set(row[0], row);
+    }
+  }
+  return [...rowsByTimestamp.values()].sort((left, right) => left[0] - right[0]);
+}
+
+export function averageProgress(values) {
+  return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+
+function sameOhlcvRow(left, right) {
+  return left.every((value, index) => value === right[index]);
+}

package/vendor/backtest-runner/lib/tape-loader-range.mjs

@@ -0,0 +1,222 @@
+import { abortable } from "./abortable.mjs";
+import { TapeDataUnavailableError } from "./coverage.mjs";
+import {
+  averageProgress,
+  createSegmentRequest,
+  mergeOhlcvTimeSegments,
+  planOhlcvTimeSegments,
+} from "./tape-loader-range-plan.mjs";
+import { TIMEFRAME_MS } from "./timeframes.mjs";
+
+const BITGET_OHLCV_MAX_REQUEST_SPAN_MS = 89 * 86_400_000;
+
+export function isClosedCandle(timestampMs, timeframe, toMs) {
+  return timestampMs + timeframeStepMs(timeframe) <= toMs;
+}
+
+export async function fetchClosedOhlcvRange(request) {
+  const stepMs = timeframeStepMs(request.timeframe);
+  const pageLimit = ohlcvPageLimitForTimeframe(
+    request.exchangeDefinition,
+    request.runtimeConfig,
+    request.timeframe
+  );
+  const segments = planOhlcvTimeSegments(request, stepMs, pageLimit);
+  if (segments.length === 1) {
+    return fetchClosedOhlcvTimeSegment(request, pageLimit);
+  }
+
+  const progress = new Array(segments.length).fill(0);
+  const segmentRows = await Promise.all(
+    segments.map((segment, index) =>
+      fetchClosedOhlcvTimeSegment(
+        createSegmentRequest(request, segment, (fraction) => {
+          progress[index] = fraction;
+          request.onFraction?.(averageProgress(progress));
+        }),
+        pageLimit
+      )
+    )
+  );
+  const rows = mergeOhlcvTimeSegments(request, segmentRows);
+  if (rows.length === 0 && !request.allowEmpty) {
+    throw missingOhlcvError(request);
+  }
+  request.onFraction?.(1);
+  return rows;
+}
+
+async function fetchClosedOhlcvTimeSegment(request, pageLimit) {
+  const stepMs = timeframeStepMs(request.timeframe);
+  const rows = [];
+  const totalSpan = Math.max(1, request.toMs - request.sinceMs);
+  let cursor = request.sinceMs;
+  let emptyPrefixLowerMs = null;
+  let nonEmptyPrefixUpperMs = null;
+  let prefixResolved = false;
+
+  while (cursor < request.toMs) {
+    request.signal?.throwIfAborted();
+    const fetchSinceMs = resolveFetchSinceMs(request, cursor);
+    const page = await fetchOhlcvPage(request, fetchSinceMs, pageLimit, stepMs);
+    request.signal?.throwIfAborted();
+
+    const prefix = resolveEmptyPrefix({
+      request,
+      page,
+      rows,
+      cursor,
+      stepMs,
+      emptyPrefixLowerMs,
+      nonEmptyPrefixUpperMs,
+      prefixResolved,
+    });
+    if (prefix) {
+      ({ cursor, emptyPrefixLowerMs, nonEmptyPrefixUpperMs, prefixResolved } =
+        prefix);
+      if (prefix.done) break;
+      continue;
+    }
+    if (page.length === 0) break;
+    prefixResolved = true;
+    appendPageRows(request, rows, page, stepMs);
+    const nextCursor = Number(page[page.length - 1][0]) + stepMs;
+    if (nextCursor <= cursor) break;
+    cursor = nextCursor;
+    request.onFraction?.(Math.min(1, (cursor - request.sinceMs) / totalSpan));
+  }
+  if (rows.length === 0 && !request.allowEmpty) {
+    throw missingOhlcvError(request);
+  }
+  return rows;
+}
+
+function resolveEmptyPrefix(input) {
+  if (input.prefixResolved || input.rows.length > 0) return null;
+  if (input.page.length === 0 && input.cursor >= input.request.fromMs) {
+    return { ...input, done: true };
+  }
+  if (input.page.length > 0 && input.emptyPrefixLowerMs === null) return null;
+
+  const emptyPrefixLowerMs =
+    input.page.length === 0 ? input.cursor : input.emptyPrefixLowerMs;
+  const nonEmptyPrefixUpperMs =
+    input.page.length > 0 ? input.cursor : input.nonEmptyPrefixUpperMs;
+  const upperMs = nonEmptyPrefixUpperMs ?? input.request.fromMs;
+  const prefixResolved =
+    nonEmptyPrefixUpperMs !== null &&
+    upperMs - (emptyPrefixLowerMs ?? upperMs) <= input.stepMs;
+  return {
+    cursor: prefixResolved
+      ? upperMs
+      : midpointCursorMs(
+          emptyPrefixLowerMs ?? input.cursor,
+          upperMs,
+          input.stepMs
+        ),
+    emptyPrefixLowerMs,
+    nonEmptyPrefixUpperMs,
+    prefixResolved,
+    done: false,
+  };
+}
+
+async function fetchOhlcvPage(request, fetchSinceMs, pageLimit, stepMs) {
+  const params = { ...request.runtimeConfig.requestParams };
+  if (request.exchangeDefinition.ccxtId === "hyperliquid") {
+    params.until = Math.min(
+      request.toMs,
+      fetchSinceMs + (pageLimit - 1) * stepMs
+    );
+  }
+  return abortable(
+    request.exchange.fetchOHLCV(
+      request.symbol,
+      request.timeframe,
+      fetchSinceMs,
+      pageLimit,
+      params
+    ),
+    request.signal
+  );
+}
+
+function appendPageRows(request, rows, page, stepMs) {
+  for (const raw of page) {
+    const timestamp = Number(raw[0]);
+    if (raw.length < 6 || !Number.isFinite(timestamp)) {
+      throw invalidOhlcvError(request);
+    }
+    if (!isClosedCandle(timestamp, request.timeframe, request.toMs)) continue;
+    if (rows.length > 0 && timestamp <= rows[rows.length - 1][0]) {
+      throw new TapeDataUnavailableError([
+        {
+          code: "non_monotonic",
+          symbol: request.symbol,
+          timeframe: request.timeframe,
+          expected: rows[rows.length - 1][0] + stepMs,
+          actual: timestamp,
+          timestamp,
+        },
+      ]);
+    }
+    rows.push([
+      timestamp,
+      Number(raw[1]),
+      Number(raw[2]),
+      Number(raw[3]),
+      Number(raw[4]),
+      Number(raw[5]),
+    ]);
+  }
+}
+
+function resolveFetchSinceMs(request, cursor) {
+  return request.exchangeDefinition.ccxtId === "bitget"
+    ? Math.max(0, cursor - 1)
+    : cursor;
+}
+
+function ohlcvPageLimitForTimeframe(exchange, runtimeConfig, timeframe) {
+  if (exchange.ccxtId !== "bitget") return runtimeConfig.ohlcvPageLimit;
+  return Math.max(
+    1,
+    Math.min(
+      runtimeConfig.ohlcvPageLimit,
+      Math.floor(BITGET_OHLCV_MAX_REQUEST_SPAN_MS / timeframeStepMs(timeframe))
+    )
+  );
+}
+
+function timeframeStepMs(timeframe) {
+  const stepMs = TIMEFRAME_MS[timeframe];
+  if (!stepMs) throw new Error(`不支持的 timeframe：${timeframe}`);
+  return stepMs;
+}
+
+function midpointCursorMs(lowerMs, upperMs, stepMs) {
+  if (upperMs - lowerMs <= stepMs) return upperMs;
+  const midpointMs = lowerMs + Math.floor((upperMs - lowerMs) / 2);
+  const alignedMs = Math.floor(midpointMs / stepMs) * stepMs;
+  return Math.min(upperMs, Math.max(lowerMs + 1, alignedMs));
+}
+
+function invalidOhlcvError(request) {
+  return new TapeDataUnavailableError([
+    {
+      code: "invalid_ohlcv",
+      symbol: request.symbol,
+      timeframe: request.timeframe,
+    },
+  ]);
+}
+
+function missingOhlcvError(request) {
+  return new TapeDataUnavailableError([
+    {
+      code: "ohlcv_missing",
+      symbol: request.symbol,
+      timeframe: request.timeframe,
+    },
+  ]);
+}

package/vendor/backtest-runner/lib/tape-loader.mjs

@@ -19,9 +19,15 @@ import {
   buildCcxtConstructorOptions,
   ccxtExchangeClientCacheKey,
 } from "./proxy.mjs";
-import { loadSeriesWithCache, TIMEFRAME_MS } from "./series.mjs";
+import { loadSeriesWithCache } from "./series.mjs";
+import {
+  limitTapeOhlcvConcurrency,
+  mapWithConcurrency,
+  resolveTapeSeriesConcurrency,
+} from "./tape-loader-concurrency.mjs";
 import {
   ENGINE_BACKTEST_BASE_TIMEFRAME,
+  TIMEFRAME_MS,
   baseTimeframeStepMs,
   resolvePlanBaseTimeframe,
 } from "./timeframes.mjs";
@@ -40,47 +46,8 @@ const FUNDING_INTERVALS = [
   { interval: "8h", spacingMs: 28_800_000 },
 ];
 
-/** Independent symbol×timeframe (and funding) fetches. Pagination stays serial. */
-export const DEFAULT_TAPE_SERIES_CONCURRENCY = 4;
-export const MAX_TAPE_SERIES_CONCURRENCY = 8;
-
 const exchangePromises = new Map();
 
-export function resolveTapeSeriesConcurrency(value) {
-  if (typeof value === "number" && Number.isFinite(value) && value >= 1) {
-    return Math.min(
-      MAX_TAPE_SERIES_CONCURRENCY,
-      Math.max(1, Math.floor(value))
-    );
-  }
-  return DEFAULT_TAPE_SERIES_CONCURRENCY;
-}
-
-export async function mapWithConcurrency(items, concurrency, worker) {
-  const list = [...items];
-  if (list.length === 0) {
-    return [];
-  }
-  const limit = Math.min(
-    list.length,
-    Math.max(1, Math.floor(Number(concurrency)) || 1)
-  );
-  const results = new Array(list.length);
-  let nextIndex = 0;
-  async function runWorker() {
-    while (true) {
-      const index = nextIndex;
-      nextIndex += 1;
-      if (index >= list.length) {
-        return;
-      }
-      results[index] = await worker(list[index], index);
-    }
-  }
-  await Promise.all(Array.from({ length: limit }, () => runWorker()));
-  return results;
-}
-
 export function effectiveTapeEndMs(
   requestedToMs,
   nowMs = Date.now(),
@@ -287,6 +254,11 @@ export async function loadTape(request, options = {}) {
   const dataIssues = [];
   const coverageWarnings = [];
   const coverageIssues = [];
+  const ohlcvExchange = limitTapeOhlcvConcurrency(
+    exchange,
+    seriesConcurrency,
+    request.signal
+  );
   const seriesFractions = new Array(totalSeries).fill(0);
   let lastOhlcvDetail = "";
   const reportOhlcv = (index, fraction, detail) => {
@@ -311,7 +283,7 @@ export async function loadTape(request, options = {}) {
       const detail = `${symbol} ${timeframe}`;
       try {
         const loaded = await loadSeriesWithCache(
-          exchange,
+          ohlcvExchange,
           exchangeDefinition,
           runtimeConfig,
           symbol,