@alphafox/cli 0.3.8 → 0.3.10

package/dist/commands/run.js

@@ -14,11 +14,12 @@ const client_1 = require("../http/client");
 const store_1 = require("../keychain/store");
 const confirmation_1 = require("../safety/confirmation");
 const version_1 = require("../version");
-const run_command_1 = require("../engine-backtest/run-command");
-const run_command_2 = require("../resolve-symbols/run-command");
-const run_command_3 = require("../skills/run-command");
+const run_command_1 = require("../cache/run-command");
+const run_command_2 = require("../engine-backtest/run-command");
+const run_command_3 = require("../resolve-symbols/run-command");
+const run_command_4 = require("../skills/run-command");
 const notify_1 = require("../update/notify");
-const run_command_4 = require("../update/run-command");
+const run_command_5 = require("../update/run-command");
 const validate_body_1 = require("../catalog/validate-body");
 const types_1 = require("../install/types");
 const wizard_1 = require("../install/wizard");
@@ -102,6 +103,7 @@ async function runCli(argv, env = process.env) {
                 "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 cache status|clean [--tape|--runtime|--all]",
                 "alphafox resolve-symbols <query...> [--exchange binance] [--asset-class equity_perp]",
                 "alphafox <domain> <resource> <action> [flags]",
             ],
@@ -120,7 +122,8 @@ async function runCli(argv, env = process.env) {
         if (cmd !== "version" &&
             cmd !== "install" &&
             cmd !== "update" &&
-            cmd !== "skills") {
+            cmd !== "skills" &&
+            cmd !== "cache") {
             assertCatalogCompatible();
         }
         switch (cmd) {
@@ -129,9 +132,11 @@ async function runCli(argv, env = process.env) {
             case "install":
                 return await cmdInstall(args, flags, env);
             case "update":
-                return await (0, run_command_4.cmdUpdate)(args, flags, env);
+                return await (0, run_command_5.cmdUpdate)(args, flags, env);
             case "skills":
-                return await (0, run_command_3.cmdSkills)(args, flags, env);
+                return await (0, run_command_4.cmdSkills)(args, flags, env);
+            case "cache":
+                return await (0, run_command_1.cmdCache)(args, flags, env);
             case "doctor":
                 return cmdDoctor(flags, env);
             case "whoami":
@@ -154,7 +159,7 @@ async function runCli(argv, env = process.env) {
                     sub === "help" ||
                     sub === "--help" ||
                     sub === "-h") {
-                    return await (0, run_command_1.cmdEngineBacktest)(args, flags, env);
+                    return await (0, run_command_2.cmdEngineBacktest)(args, flags, env);
                 }
                 // Hyphen built-in owns `run` and `sweep`. Underscore/hyphen catalog CRUD
                 // (engine_backtest.experiments.*) still goes through the typed tree.
@@ -162,7 +167,7 @@ async function runCli(argv, env = process.env) {
             }
             case "resolve-symbols":
             case "resolve-symbol":
-                return await (0, run_command_2.cmdResolveSymbols)(args, flags, env);
+                return await (0, run_command_3.cmdResolveSymbols)(args, flags, env);
             default:
                 return await cmdTyped(cmd, args, flags, env);
         }

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

@@ -14,6 +14,7 @@ const load_config_1 = require("./load-config");
 const parse_args_1 = require("./parse-args");
 const sweep_command_1 = require("./sweep-command");
 const persist_1 = require("./persist");
+const paths_1 = require("../cache/paths");
 const replay_timeframe_1 = require("./replay-timeframe");
 const resolve_packages_1 = require("./resolve-packages");
 var load_config_2 = require("./load-config");
@@ -316,6 +317,7 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
                 fromMs: args.range.fromMs,
                 toMs: args.range.toMs,
                 dataQualityMode: args.dataQualityMode,
+                cacheDir: (0, paths_1.resolveTapeCacheDir)(env),
                 onProgress: (progress) => {
                     emitProgress(flags, writeLine, progress.stage || "tape", progress.fraction, progress.detail);
                 },

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

@@ -7,6 +7,7 @@ exports.executeEngineBacktestSweep = executeEngineBacktestSweep;
 const node_crypto_1 = require("node:crypto");
 const profiles_1 = require("../config/profiles");
 const client_1 = require("../http/client");
+const paths_1 = require("../cache/paths");
 const store_1 = require("../keychain/store");
 const errors_1 = require("./errors");
 const load_config_1 = require("./load-config");
@@ -189,6 +190,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                     fromMs: args.range.fromMs,
                     toMs: args.range.toMs,
                     dataQualityMode: args.dataQualityMode,
+                    cacheDir: (0, paths_1.resolveTapeCacheDir)(env),
                     onProgress: (progress) => {
                         emitProgress(flags, writeLine, progress.stage || "tape", progress.fraction, progress.detail);
                     },

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

@@ -238,6 +238,7 @@ export interface BacktestRunnerModule {
         readonly fromMs: number;
         readonly toMs: number;
         readonly dataQualityMode?: DataQualityMode;
+        readonly cacheDir?: string;
         readonly onProgress?: (progress: TapeLoadProgress) => void;
     }, options?: unknown): Promise<TapeLoadResult>;
     assembleScenario(input: {

package/dist/skills-manifest.json

@@ -1,141 +1,153 @@
 {
   "schemaVersion": 1,
   "packageName": "@alphafox/cli",
-  "packageVersion": "0.3.8",
+  "packageVersion": "0.3.10",
   "contractVersion": "2026-08-13",
-  "bundleHash": "cd05f4eb6f9e1a7c9188ac5770196698c6f2c9ff6aaebfbfbaba3581ef08d226",
+  "bundleHash": "e03966174d892d1205e0f4a5ec69c11d7cd78e9f5bd2f95fc3e145b7dfea14cd",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "e8eadf96f36f6aa124b36d15a912465e839389e5228dbf9dfd9ad2f1ec86f65a",
-          "size": 3553
+          "sha256": "58466ff1f9d42d6c64b1a4b2d52bafd40857dd7e0ca928f987fc926c358bd850",
+          "size": 4407
         }
       ],
-      "hash": "fb41a55fcd363231cb69e30e4c0fe7b1ad2e17b12e2bb90cfda7d6e9ccd2f02c"
+      "hash": "363bf0b3746b8cd8b291956b58dd9ac3e001bc1bfb80f0fa9c471aec4bf0021d"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "9925573bf644b998ea683df7a20276a835d33cb83b0548ee0d1c43429ad99582",
-          "size": 783
+          "sha256": "4fcc7608817c900055dd605e0e71cd5b05e0945516701d0a281ebefb0407fb7b",
+          "size": 784
         }
       ],
-      "hash": "934bcd76d1bea875324673ffcc3d1c52e3f4065f776c4958ffc230cf911bac21"
+      "hash": "273fdb4dd81103fc214b85ab7d59fb9dd65ebf2ec6d5d0d889837573bd8e3dae"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "e9ae0b433cead54e9c284f0ea8859dd9e96123f842788938319404b96bc085e7",
-          "size": 787
+          "sha256": "0639573e3d59f42d3d718bdf07d719b01d802cbbdc04806c14882ebf8cd7c081",
+          "size": 788
         }
       ],
-      "hash": "1346e798f18582c16cfbb887667272406f170e775d3027131d3d88e1f1a656e3"
+      "hash": "bcd9d41096e65472eebc0981cc9f614c755f28ae307dffdb15117ad8e22c954c"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "8ec9f081d9a1d40606ac7c18cba5dae9f1b6144ddc0079005b16af54be8f2f46",
-          "size": 2370
+          "sha256": "d4edec17dd89e9e2e5d1759657837456f60d0b062d0a332334d9e6df6bfe003e",
+          "size": 2371
         }
       ],
-      "hash": "854910a6792aa6d0a8b9cd796afb41753a34cef79df95c5b50de432f03a4e67a"
+      "hash": "01c80f4fa33736e85b845576e5d026e7ec32869a8c0f806119625d44e43fcbaa"
+    },
+    {
+      "name": "alphafox-cache",
+      "version": "0.3.10",
+      "files": [
+        {
+          "path": "SKILL.md",
+          "sha256": "c7f36174e5bb1ac97ca55e89b6720863d3d05a52a522ff5498a4c5ea4a31adaa",
+          "size": 1530
+        }
+      ],
+      "hash": "a5a68c82de33aa8e09b12a65de1c45c522490d1b807c34a9616792cc71a13350"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "e5f37b8541c510a27f84cbf9eea7524efe0b8f9c60c4faf17521b6cac298f92b",
-          "size": 7584
+          "sha256": "dbcb6dc047150bdf3988da112691868787be4a51bda95e60c63628269b06a8d7",
+          "size": 7803
         }
       ],
-      "hash": "efb614f145763f514c33d02e112657bd42868cc746f13dbcb3cceaa0ecb770e4"
+      "hash": "1e85862e3ea104968061a0d778b836a6475b1d676dfbbb80a074851cd4e386fb"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "118141754916741f4f8b449cf307a89cdfa11f234302726ba4d6b58e396327b5",
-          "size": 743
+          "sha256": "100f74f3240d86e73531a981585c9a236d3d5fd3ea31ecb54a74074d4e256403",
+          "size": 744
         }
       ],
-      "hash": "3933f12a2d8c55db465d4a11cf1f7d40f90fff81b3931f398e2fe3bcaf064d62"
+      "hash": "9230a196316900e2cf6bd15659d2bf47f5332d855663f4dd116744139cfcf968"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "0e77dcc697fe60f742e1075986685db5018d9d659a4d8f44f9cc343117c1c74b",
-          "size": 3078
+          "sha256": "e750c23aaad020221a6cfdf2b273886c8367de63ca68df6a95cb31492c447f0d",
+          "size": 3079
         }
       ],
-      "hash": "710c45c6124583d3fa9c9584f67bbc665bad35c9e6d1294c7416f493b8a6b184"
+      "hash": "34283bcd2403e671ba5dcd4da7d3ad65f73a46ca3a5d29d28c3464038dfb074c"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "712aa6a4de8090bb7ee57373d35dd95c62bad7a24e443747afa4f11fb6e79b68",
-          "size": 698
+          "sha256": "4d6e705ff6aff33af729bca184dcb716cd97d31b4fe188173b07423eba0d94d4",
+          "size": 699
         }
       ],
-      "hash": "5f2feef0e17912a593bafae0961f983e3f781d12800e4808c136004897321ab2"
+      "hash": "a36312725ffa86ed9e629b056375b68ae6955d56a304c5895e4ab24666a53763"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "c6bab01f9c8369f9c2a29eebf7b46462887f14d3bec7ad00e2a159d395346508",
-          "size": 5385
+          "sha256": "4019aba3820aa1cf16dcb49202f251e4074829a130a7608caf6c67c3118a799c",
+          "size": 5386
         }
       ],
-      "hash": "2b78fe080877af19b659964a8c965720e5ab731dd157ced10d2ee598b8c574a0"
+      "hash": "ae7dbd98f00f8f6162d5dc77bd35ca13303895f7d6c91d910af1f46f03d2869e"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "03f1d1c6d048d7b0a23d725c6585d1d019445579be9779dc93095ebafb3fcf5a",
-          "size": 1826
+          "sha256": "85c78855f0a312f5093642668606197cc68569e9203f5b85a6e9c4bd3b9c9c21",
+          "size": 1827
         }
       ],
-      "hash": "ebf375c6eeaf13c971a3090d05beda7037f253325ee2236c35b26ad540922827"
+      "hash": "cb79e63d42a2559d2ec69b684c7d13d3351b49e117ca3256f462f0f04ba7d657"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.8",
+      "version": "0.3.10",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4b597f23ff6c8ce384e8fd56fab73c6128d373741285bac6df0b061e7ee50242",
-          "size": 3122
+          "sha256": "b580088309ddaeb0b460b572c9861393fe8d9b1129fca2f9dd2e9caa4b568368",
+          "size": 3123
         }
       ],
-      "hash": "d7e818482ec3ba9aeab50af72e72f990288f0e2e6714e1227cba441db05fa75a"
+      "hash": "c215ba2c61b5d4487046bb7f56145eabdc942c70c6c36f2d79cc2d7da887463f"
     }
   ]
 }

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.8";
+export declare const CLI_VERSION = "0.3.10";
 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.8";
+exports.CLI_VERSION = "0.3.10";
 var operations_1 = require("./catalog/operations");
 Object.defineProperty(exports, "CLI_CONTRACT_VERSION", { enumerable: true, get: function () { return operations_1.CATALOG_VERSION; } });

package/docs/e2e-staging.md

@@ -10,13 +10,15 @@ Staging CLI issuer: `https://staging.alphafox.app`. Test login (staging-only, ga
 2. Device Flow split (`--no-wait` + `--device-code`)
 3. `whoami` / `auth status --verify`
 4. Readonly: strategy definitions, connectors, traders
-5. Write: create chat with idempotency
-6. Backtest create → watch stream → cancel
+5. ~~Write: create chat with idempotency~~ **historical** — chat is not a CLI surface; do not use `chats.create` as the trader-create path
+6. ~~Backtest create → watch stream → cancel~~ **historical** — web `/api/v1/backtests` is not a CLI surface; use `engine-backtest`
 7. High-risk without `--yes` → exit 10
 8. Logout / revoke
 9. Cross-env token rejection (prod token on staging)
 
-## Evidence (2026-08-13) — vertical slice pass
+## Evidence (2026-08-13) — vertical slice pass (historical chat / web-backtest slice)
+
+The chat and `POST /api/v1/backtests` steps below are a **historical** facade record. They are not the CLI trader-create path. Current create is Engine `trading.traders.create` (`strategyDefinitionId` + `config`). Do not treat this section as a playbook.
 
 Anonymous `GET https://staging.alphafox.app/api/v1/meta` → **HTTP 200**, `environment=staging`, `contractVersion=2026-08-13`, `commitSha=65d1f816007adc7acc09db5e86671931737e0379`, `x-request-id=66511bcf-dda9-4974-9378-3aacd8d938ff`. No 302 to `vercel.com/sso-api`. Vercel Authentication is disabled for the whole `alphafox-web` project (Preview `*.vercel.app` is also public; accepted).
 
@@ -66,7 +68,7 @@ Reused staging Device Flow session `userId=019f3073-307f-76e9-adf1-0203af9ab22b`
 - **Backtest vertical slice:** cannot `create → stream → cancel` until a chat has an integer `strategyId`, and until the facade body matches contracts (`backtestSettings`) or the catalog is updated to `{chatId, strategyId}`.
 - Parent Feishu task and t101364 (production publish / npm `latest` / production OAuth) stay **todo**. Do not merge web PR 448 to production `main` from this evidence.
 
-## Evidence (2026-08-13) — gapfix retest (idempotency + backtests.create)
+## Evidence (2026-08-13) — gapfix retest (historical; idempotency + backtests.create)
 
 Anonymous `GET https://staging.alphafox.app/api/v1/meta` → **HTTP 200**, `environment=staging`, `contractVersion=2026-08-13`, `commitSha=fba21ef4b2c3909c51a5a19e2d2a45b30d1d598c`, `x-request-id=8702a21b-a749-4007-82eb-76ca1dd0caaf`. No SSO redirect. Device Flow `test@local.com`: approve `requestId=77293035-ebfd-4b03-b0e1-0779dce81fdd`, token `requestId=9dcc28c1-c1cc-49fc-9435-687dfdb591c2`, `whoami` `userId=019f3073-307f-76e9-adf1-0203af9ab22b` `requestId=1473f107-d742-42eb-99e7-b60c6b583928`. CLI local `92c8610250b30e7881f79a2fde60b00fe50b4628`, catalog `contractsSha=d1f184e3d72581f155497978880d9ab3029ff858`. Staging llm-gateway image `0a10d8e3a1304b04eff2f21c503922a5b7c11491` (workflow `31683345740` failed after the container was healthy: `/opt/alphafox/images/alphafox-llm-gateway.env` permission denied). Do not merge web PR 448 to production `main`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "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.8
+version: 0.3.10
 ---
 
 # 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.8
+version: 0.3.10
 ---
 
 # 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. If a CLI command prints `[alphafox] update available`, ask the user「检测到新的版本，是否需要我帮你升级？」and only then run `alphafox update --format json --no-input`. 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.8
+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. 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.10
 ---
 
 # AlphaFox
@@ -22,6 +22,7 @@ A **trader** is a running strategy instance (paper or live), not a person. Creat
 | Login, logout, whoami, profile, staging vs production | `alphafox-auth` |
 | Ticker / 标的 / 美股 / crypto / resolve a misspelled symbol | `alphafox-market` |
 | Engine WASM backtest, experiment, `engine-backtest run`, persist a local run | `alphafox-engine-backtest` |
+| 清理回测缓存 / 历史 K 线占磁盘 / `alphafox cache` | `alphafox-cache` |
 | Strategy types / definitions / validate config (grid, dca, copy, …) | `alphafox-strategy` |
 | Create, list, start, or stop a running strategy (trader), including copy | `alphafox-trading` |
 | Exchange connectors | `alphafox-exchange` |
@@ -36,7 +37,7 @@ If several rows apply, load **all** of them (typical: `alphafox-shared` + `alpha
 The CLI may print this on **stderr** at most once every 24 hours:
 
 ```text
-[alphafox] update available: 0.3.7 -> 0.3.8. After the user confirms, run: alphafox update --format json --no-input,
+[alphafox] update available: 0.3.9 -> 0.3.10. After the user confirms, run: alphafox update --format json --no-input,
 ```
 
 If you see that notice (or `updateAvailable: true` from `alphafox update --check`):
@@ -60,3 +61,13 @@ Do not install Skills from GitHub. Details and dry-run / check commands live in
 - Web `/api/v1/backtests` (`backtests.*`) is **not** a CLI surface. Do not call it via typed commands, `schema`, or `alphafox api`.
 
 Ambiguous “帮我回测” → `alphafox-engine-backtest`, after resolving symbols.
+
+## Large historical tape
+
+`engine-backtest run|sweep` downloads closed OHLCV into the local tape cache. After a long-range or 1m backtest (or whenever the operator mentions disk / 缓存), read `alphafox-cache` and run `alphafox cache status --format json --no-input`.
+
+If `data.tape.large` is true (tape ≥ `data.remindAfterBytes`):
+
+1. Ask the user: **回测下载的历史数据比较大，要不要我帮你清理本地缓存？**
+2. Wait for an explicit yes. Do not clean on your own.
+3. Follow `alphafox-cache` (`alphafox cache clean --dry-run`, then `--yes`).

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, and public operationIds only.
-version: 0.3.8
+version: 0.3.10
 ---
 
 # 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.8
+version: 0.3.10
 ---
 
 # Auth Skill

package/skills/cache/SKILL.md

@@ -0,0 +1,38 @@
+---
+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.10
+---
+
+# Cache
+
+Always `--format json --no-input`. Never `--token`. This is local disk only.
+
+`engine-backtest run|sweep` writes closed OHLCV into the **tape** cache (`~/.alphafox/cache/engine-backtest`, or `ALPHAFOX_TAPE_CACHE_DIR`). The wasm / Node host lives under the **runtime** cache (`~/.cache/alphafox/engine-backtest/<hash>/`). Tape is the large historical download.
+
+## Status first
+
+```bash
+alphafox cache status --format json --no-input
+```
+
+Read `data.tape.bytes`, `data.tape.files`, `data.tape.large`, `data.remindAfterBytes`. `large` is true when tape bytes ≥ `remindAfterBytes` (512 MiB).
+
+If `data.tape.large` is true, ask the user:
+
+**回测下载的历史数据比较大，要不要我帮你清理本地缓存？**
+
+Wait for an explicit yes. Do not clean on your own.
+
+## Clean
+
+Default clean is **tape only** (historical bars). Runtime re-downloads on the next run; only add `--runtime` or `--all` when the operator asks.
+
+```bash
+alphafox cache clean --dry-run --format json --no-input
+alphafox cache clean --yes --format json --no-input
+```
+
+`--yes` is required to delete. `--dry-run` reports what would be removed. After clean, `data.bytesFreed` is the space recovered.
+
+Do not `rm` cache paths by hand. Do not delete `~/.config/alphafox` (config / skills state / keychain).

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.
-version: 0.3.8
+version: 0.3.10
 ---
 
 # Engine Backtest
@@ -94,6 +94,7 @@ Owner isolation and 7-day expiry are enforced by the server. Applying a coordina
 2. `engine-backtest run` (reuse `--experiment` after the first create).
 3. Read `data.metrics` / `data.engineVersion` / `data.runId` / `data.experimentUrl`.
 4. Adjust parameters and run again. Do not invent a token flag if persist returns 401 — `alphafox auth login`.
+5. After a long-range or 1m run, follow `alphafox-cache`: `alphafox cache status`. If `data.tape.large` is true, ask **回测下载的历史数据比较大，要不要我帮你清理本地缓存？** and wait for yes.
 
 ## Safety
 

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.8
+version: 0.3.10
 ---
 
 # 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.8
+version: 0.3.10
 ---
 
 # Market

package/skills/notification/SKILL.md

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

package/skills/strategy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-strategy
 description: Strategy definitions — list types (grid, dca, copy, …) and validate config. Creating a running strategy is creating a trader; use alphafox-trading for that.
-version: 0.3.8
+version: 0.3.10
 ---
 
 # Strategy definitions

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.
-version: 0.3.8
+version: 0.3.10
 ---
 
 # Running strategies (traders)

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

@@ -288,6 +288,8 @@ export interface TapeLoadRequest {
   readonly signal?: AbortSignal;
   readonly onProgress?: (progress: TapeLoadProgress) => void;
   readonly nowMs?: number;
+  readonly cacheDir?: string;
+  readonly seriesConcurrency?: number;
   readonly ohlcvFetcher?: TapeOhlcvFetcher;
   readonly fundingFetcher?: TapeFundingFetcher;
   readonly marketsLoader?: () => Promise<TapeMarketsSnapshot>;
@@ -302,6 +304,8 @@ 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. */
+  readonly seriesConcurrency?: number;
   readonly nowMs?: number;
   readonly onProgress?: (progress: TapeLoadProgress) => void;
   readonly createExchange?: (
@@ -336,6 +340,17 @@ export interface TapeLoadResult {
   };
 }
 
+export const DEFAULT_TAPE_SERIES_CONCURRENCY: 4;
+export const MAX_TAPE_SERIES_CONCURRENCY: 8;
+
+export function resolveTapeSeriesConcurrency(value?: number): number;
+
+export function mapWithConcurrency<T, R>(
+  items: readonly T[],
+  concurrency: number,
+  worker: (item: T, index: number) => Promise<R>
+): Promise<R[]>;
+
 export function loadTape(
   request: TapeLoadRequest,
   options?: TapeLoadOptions

package/vendor/backtest-runner/index.mjs

@@ -50,8 +50,12 @@ export {
   loadSeriesWithCache,
 } from "./lib/series.mjs";
 export {
+  DEFAULT_TAPE_SERIES_CONCURRENCY,
+  MAX_TAPE_SERIES_CONCURRENCY,
   loadTape,
+  mapWithConcurrency,
   resolveTapeCache,
+  resolveTapeSeriesConcurrency,
   effectiveTapeEndMs,
   inferFundingIntervals,
   classifyTapeSymbolsForPreflight,