@zltquant/zlt-mcp 0.1.0 → 0.3.0-beta.0

package/config.json

@@ -507,7 +507,7 @@
     },
     {
       "name": "mcp-create-and-run-backtest",
-      "description": "创建并启动回测。strategyId 必须来自 mcp-create-strategy 返回的策略ID；runType 固定为 2；普通日线回测只传 strategyId，其余参数 MCP 补齐。未指定周期时 end 取自然日 T-1、start 从 end 往前推半年；ZLTAF 按实际交易日执行，非交易日不产生行情或策略调用。run/create 失败直接报错，不要去复用策略里自动生成的 debug runId（建策略时已回显为 debugRunId，跑它等于跑创建那一刻的模板快照）。\n\n**返回 runId 后立即调用 mcp-wait（kind=backtest，id=runId）阻塞等待回测结束，不要用 mcp-get-backtest-state 轮询。**\n\n日线类频率只可见到 context.previous_date：要用交易日 T 的收盘，end 必须设成 T 的下一个交易日；end 落在未来不报错但结果为空。展开见返回的 dailyVisibilityNote / endWarning。\n\n返回 Data 回显 resolvedStart/resolvedEnd/resolvedCapital——向用户汇报区间和初始资金时一律以这些字段为准，不要自行推算或臆测。**基准不在此列**：回显的 requestedBenchmark 只是请求值，策略 initialize 里的 set_benchmark() 会覆盖它，收益产物里的「基准收益」按策略实际用的基准算。说基准是什么之前先读策略代码里的 set_benchmark，否则会把一只个股的涨跌报成指数的。\n\n**期货回测要同时改三处，少一处引擎就按股票跑**：runParams.marketIds 加上对应期货交易所（zj 中金所、zs 郑商所、ds 大商所、sq 上期所、gq 广期所），account_list 的 account_type 改成 2（实测用 6 直接废单），费率用 ratio_tpl_obj.future。合约代码形如 zjIM2605。基准保持默认 sz399300 即可，它对期货策略只是业绩比较基准。数据前置见 mcp-download-data：除行情外还必须有市场规则 mr。",
+      "description": "创建并启动回测。strategyId 必须来自 mcp-create-strategy 返回的策略ID；runType 固定为 2；普通日线回测只传 strategyId，其余参数 MCP 补齐。未指定周期时 end 取自然日 T-1、start 从 end 往前推半年；ZLTAF 按实际交易日执行，非交易日不产生行情或策略调用。run/create 失败直接报错，不要去复用策略里自动生成的 debug runId（建策略时已回显为 debugRunId，跑它等于跑创建那一刻的模板快照）。run/create 生成快照后，MCP 会在真正启动前拒绝 get_current_data().get(...) 这种当前对象不支持的访问。\n\n**返回 runId 后立即调用 mcp-wait（kind=backtest，id=runId）阻塞等待回测结束，不要用 mcp-get-backtest-state 轮询。**\n\n日线类频率只可见到 context.previous_date：要用交易日 T 的收盘，end 必须设成 T 的下一个交易日；end 落在未来不报错但结果为空。展开见返回的 dailyVisibilityNote / endWarning。\n\n返回 Data 回显 resolvedStart/resolvedEnd/resolvedCapital——向用户汇报区间和初始资金时一律以这些字段为准，不要自行推算或臆测。evidence 给出 backtestId、实际 runDir、完整 effectiveRunParams 和代码快照 sourceSha256，后续结果必须与它对账。**基准不在此列**：回显的 requestedBenchmark 只是请求值，策略 initialize 里的 set_benchmark() 会覆盖它，收益产物里的「基准收益」按策略实际用的基准算。说基准是什么之前先读策略代码里的 set_benchmark，否则会把一只个股的涨跌报成指数的。\n\n**期货回测要同时改三处，少一处引擎就按股票跑**：runParams.marketIds 加上对应期货交易所（zj 中金所、zs 郑商所、ds 大商所、sq 上期所、gq 广期所），account_list 的 account_type 改成 2（实测用 6 直接废单），费率用 ratio_tpl_obj.future。合约代码形如 zjIM2605。基准保持默认 sz399300 即可，它对期货策略只是业绩比较基准。数据前置见 mcp-download-data：除行情外还必须有市场规则 mr。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -913,7 +913,7 @@
     },
     {
       "name": "mcp-get-backtest-profit",
-      "description": "读取已完成回测的收益表现，只能在 mcp-get-backtest-state 返回 status=5 后调用。直接读回测副本目录下的 log/zlt_backtest_profit_detail.csv，不经过 ZLTAF。正常只传 mcp-create-and-run-backtest 返回的 runId；MCP 重启后上下文丢失时补传 codePath。\n\nperformance 是整轮汇总，取自产物最后一行。**名字带 Pct 的已经是百分数**：-15.62 就是 -15.62%，不要再乘 100。winRate 与 dailyWinRate 是 0-1 的比例，其余是无量纲比值。上游没有值时返回 null（原文是 nan 或空单元格），不要当成 0。\n\n另给 rows（逐日行数）、firstDate/lastDate、capital、maxDrawdownWindow（已按北京时间换算成日期）。逐日净值序列默认不返回，要画净值曲线才传 includeSeries=true。\n\n**notes 里的内容必须转述**：产物回测ID 与请求不一致，说明 codePath 指向了另一次运行，那批数字不属于本次回测；超额收益校验不通过，说明上游口径变了，此时三个收益数原样给出，不得自行重算，也不得据此宣称跑赢基准。",
+      "description": "读取已完成回测的收益表现，只能在 mcp-get-backtest-state 返回 status=5 后调用。直接读回测副本目录下的 log/zlt_backtest_profit_detail.csv，不经过 ZLTAF。正常只传 mcp-create-and-run-backtest 返回的 runId；MCP 重启后上下文丢失时补传 codePath。\n\nperformance 是整轮汇总，取自产物最后一行。**名字带 Pct 的已经是百分数**：-15.62 就是 -15.62%，不要再乘 100。winRate 与 dailyWinRate 是 0-1 的比例，其余是无量纲比值。上游没有值时返回 null（原文是 nan 或空单元格），不要当成 0。\n\n另给 rows（逐日行数）、firstDate/lastDate、capital、maxDrawdownWindow（已按北京时间换算成日期）。evidence 对账 requestedBacktestId、artifactBacktestId、runDir、effectiveRunParams 和 sourceSha256；contextAvailable=false 表示 MCP 已重启，只能证明显式 codePath 和产物内 ID。逐日净值序列默认不返回，要画净值曲线才传 includeSeries=true。\n\n**notes 里的内容必须转述**：产物回测ID 与请求不一致，说明 codePath 指向了另一次运行，那批数字不属于本次回测；超额收益校验不通过，说明上游口径变了，此时三个收益数原样给出，不得自行重算，也不得据此宣称跑赢基准。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -928,7 +928,7 @@
           "includeSeries": {
             "type": "boolean",
             "default": false,
-            "description": "返回逐日序列（date / totalAsset / benchmarkPrice / positionRatePct / turnoverRatePct）。超过 250 行只返回最后 250 行并标 seriesTruncated。"
+            "description": "返回逐日序列（date / totalAsset / benchmarkPrice / positionRatePct / turnoverRatePct）。超过 250 行会**等距抽样**到 250 点并标 seriesTruncated：首尾保留、跨度完整、逐点数值真实，只是变稀——多年回测画净值曲线够用，不会只拿到末段。要每一行时 notes 会给出该次产物 CSV 的列号，照它读。"
           }
         },
         "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zltquant/zlt-mcp",
-  "version": "0.1.0",
+  "version": "0.3.0-beta.0",
   "description": "智量通 ZLT Quant MCP server（Windows x64；量化策略创建与本地回测）",
   "bin": {
     "zlt-mcp": "./zlt-mcp-proxy.bundle.cjs"

package/zlt-mcp-proxy.bundle.cjs

@@ -10496,7 +10496,95 @@ var DEFAULT_BACKTEST_MODULE_INDICES = [TY_MODULE_INDEX];
 var DEBUG_ASSISTANT_INSTALLER_URL = "https://beta.zltquant.com/download/setup-ZLTStudio-Dbg-mini-20260714.4.exe";
 var PUBLIC_PYTHON_SDK_INDEX_URL = "https://pypip.zltquant.com/";
 var ZLTAF_CONFIG_FILE_DEFAULT = "application-local.properties";
-var ZLTAF_CONFIG_FILE_DAY = "application-local-day.properties";
+var OFFICIAL_MIRROR_ROOTS = {
+  public: "https://zlt-data-house.oss-cn-wuhan-lr.aliyuncs.com/zltkj.site/down/v1/up/Zlt.Std.Official",
+  internal: "http://192.168.1.243:9000/zlt-data-house/zltkj.site/down/v1/up/Zlt.Std.Official"
+};
+var OFFICIAL_INSTALLERS = {
+  public: {
+    // 2026-08-31 抬到 2026.08.31.3，接替 2026.06.18.11 —— 运维已把件传上公网 OSS。
+    // 摘要不必重下：公网与内网是同一份字节，HEAD 实测 Content-Length 168,548,568
+    // 与 ETag（OSS 侧即 MD5）C404C12F…33DA 两边完全一致，所以沿用内网那份已核过的
+    // SHA256=5BE939F0…5B19。
+    // 卡在 2026.06.18.11 的代价是实打实的：它低于我们自己发布的
+    // zlt_quant_version_index.json 里的 Client.min = 2026.08.12.3，于是一台 full
+    // 装机撞上闸门只会得到 blockedByPlugin，被告知「请先升级 ZLT Quant 插件」——
+    // 而插件已经是最新的那一版，闸门永远消不掉。
+    // 本条与 internal.full 这次同版本，那是因为公网刚补齐，不是两张表从此必然同步。
+    // **本版没有装机验证**，与 internal.full 同一句话。
+    full: {
+      artifact: "zlt_client",
+      version: "2026.08.31.3",
+      sha256: "5BE939F069E69C05F37017FBB06FF76DE4DBCBD4CBCAF1322479255A5CE55B19"
+    },
+    // 2026-08-15 抬到 2026.08.14.5：公网 OSS 与内网镜像是同一份字节（ETag 113b3cff…、
+    // 75,075,160 字节两边一致），本机下载实测 SHA256=9D40AE9A…D551，与 2026-08-14 覆盖
+    // 安装时校验过的摘要一致，两条独立路径互证。这一版是投研模块下限（≥2026.08.11.2）
+    // 之上的第一个已发布 mini：低于它，投研模块 upgrade/check 直接以「客户端版本过低」
+    // 拒绝，且该下限只在模块服务端。version 取安装包自身 FileVersion 的点分四段（不是
+    // 构建目录名的紧凑形 20260814.5）：升级判定拿它和 InstallInfo.xml 的
+    // InstallAppReleaseVer 比，写成紧凑形会让「有可用更新」永远消不掉。
+    // 2026-08-31 抬到 2026.08.31.4，接替 2026.08.14.5。判据与 full 同一条：HEAD 实测
+    // Content-Length 79,605,832 与 ETag 7A53D1EE…1375 公网内网一致，摘要沿用内网已核过的
+    // SHA256=115A3EED…83CE。
+    // 这一槽位是市场版的首装路径 —— VSCode 只装 mini（runtime-profile.mjs 的
+    // VSCODE_INSTALL_TYPE），full 槽位只在已装 full 的机器上参与升级判定。
+    // **本版没有装机验证**：本机停在 2026.08.28.7，08-30 对 .7 做的那轮活体复核
+    // （三进程起得来、ZLTHQHost 管道在、两轮 check:npm-live 全绿）不适用于本版。
+    mini: {
+      artifact: "zlt_plugin",
+      version: "2026.08.31.4",
+      sha256: "115A3EEDC07211F6FBE56696573F668AE8315E351B017FECB0F6136AAAD983CE"
+    }
+  },
+  internal: {
+    // 2026-08-31 抬到 2026.08.31.3（1.0.2 RC 用件），接替 2026.08.28.8。内网镜像下载
+    // 核验：168,548,568 字节，SHA256=5BE939F0…5B19，安装包 FileVersion 自报
+    // 2026.08.31.3（版本取它，不取文件名）。它仍高于 Client.min = 2026.08.12.3，
+    // 所以内测通道上一台 full 装机不会以 blockedByPlugin 收场。
+    // 公网 OSS 上这一版 404（2026-08-31 实测 HEAD），public.full 不动。
+    full: {
+      artifact: "zlt_client",
+      version: "2026.08.31.3",
+      sha256: "5BE939F069E69C05F37017FBB06FF76DE4DBCBD4CBCAF1322479255A5CE55B19"
+    },
+    // 2026-08-31 抬到 2026.08.31.4（1.0.2 RC 用件），接替 2026.08.28.7。下载核验：
+    // 79,605,832 字节，SHA256=115A3EED…83CE，FileVersion 自报 2026.08.31.4。
+    //
+    // **本条两件都只核到字节与版本，没有装机验证。** 本机停在 2026.08.28.7
+    // （InstallInfo.xml 的 InstallAppReleaseVer 实读如此），所以 08-30 对 .7 做的那轮
+    // 活体复核（三进程起得来、ZLTHQHost 管道在、两轮 check:npm-live 全绿）**不适用于
+    // 这两版**，别把它顺移过来当证据。RC 装机后要重新确认两件事：ZLTHome 起得来、
+    // 且 InstallAppReleaseVer 回读等于本条点分四段（对不上会让「有可用更新」永远消不掉）。
+    //
+    // 这条 08-28 起的历史仍然有效，记着是因为它解释了为什么这批件在密集换版：
+    // 2026.08.28.3 现场装过并 ZLTHome 启动即崩（TTaskFunc 持栈上 lambda 的悬垂引用，
+    // 100% 复现，ZLTHQHost 管道从未存活）；同版起把 zltaf 从投研模块的子模块集里去掉，
+    // 修的是首装必炸的另一条权限死路 —— 安装器与模块各发一份 zltaf，模块解压要覆盖
+    // 安装器以管理员身份写下的文件，而 ZLTBackService 跑在登录账户的 UAC 过滤令牌上，
+    // 卷根 ACL 缺 Authenticated Users:(M) 时覆盖必被拒，2 毫秒失败在第一个文件上。
+    // 见 docs/reports/2026-08-28-zltaf-submodule-extract-access-denied.md。
+    // 这些版本都没进过本表，不要读成本槽位的版本序列（上一个 pin 是 2026.08.28.7）。
+    //
+    // 公网 OSS 上这一版同样 404，所以 public.mini 仍停在 2026.08.14.5 —— 两张表不同版本，
+    // 这正是按镜像分表的理由。
+    mini: {
+      artifact: "zlt_plugin",
+      version: "2026.08.31.4",
+      sha256: "115A3EEDC07211F6FBE56696573F668AE8315E351B017FECB0F6136AAAD983CE"
+    }
+  }
+};
+function resolveInstallerMirror() {
+  return false ? "internal" : "public";
+}
+function officialInstallerUrl(slot, mirror = "public") {
+  const spec = OFFICIAL_INSTALLERS[mirror][slot];
+  return `${OFFICIAL_MIRROR_ROOTS[mirror]}/pkg/${spec.artifact}_${spec.version}.exe`;
+}
+function officialVersionIndexUrl(mirror = "public") {
+  return `${OFFICIAL_MIRROR_ROOTS[mirror]}/VscodeMarketPlugin/zlt_quant_version_index.json`;
+}
 var INTERNAL_PYTHON_SDK_INDEX_URL = "https://192.168.1.32:9100/pypi/simple/";
 var INTERNAL_PYTHON_SDK_TRUSTED_HOST = "192.168.1.32";
 var PYTHON_SDK_PACKAGES = ["zltquant", "zltsdk-plugin"];
@@ -10517,8 +10605,8 @@ var defaultAssistantRuntimeConfig = {
   envMode: "OFFICIAL",
   backserviceDownload: {
     OFFICIAL: {
-      full: "https://zlt-data-house.oss-cn-wuhan-lr.aliyuncs.com/zltkj.site/down/v1/up/Zlt.Std.Official/pkg/zlt_client_2026.06.18.11.exe",
-      mini: "https://zlt-data-house.oss-cn-wuhan-lr.aliyuncs.com/zltkj.site/down/v1/up/Zlt.Std.Official/pkg/zlt_plugin_2026.08.14.5.exe"
+      full: officialInstallerUrl("full"),
+      mini: officialInstallerUrl("mini")
     },
     REL: {
       full: "",
@@ -10531,10 +10619,13 @@ var defaultAssistantRuntimeConfig = {
   },
   // Exact artifact digests. A URL update requires a matching digest update in the
   // same reviewed change; downloadRuntimeInstaller fails closed when it is absent.
+  // OFFICIAL 的取值来自 OFFICIAL_INSTALLERS.public —— URL/版本/摘要三者同源，只有那一处可改。
+  // 这里恒取公网表：模块级默认必须公网可达（runtime.test.ts 的 LAN 守卫钉的就是它），
+  // 内网镜像那档由 applyEnvOverrides 按镜像轴整行换掉。
   backserviceDownloadSha256: {
     OFFICIAL: {
-      full: "376D9C60A4BA7FF4745DF67A789BA252025EA72BB74DB6A963513FE1EFC10AE2",
-      mini: "9D40AE9ABCA459CF60CD5377A24013FA4B14BF96DE2D82E04CDD268AE1FDD551"
+      full: OFFICIAL_INSTALLERS.public.full.sha256,
+      mini: OFFICIAL_INSTALLERS.public.mini.sha256
     },
     REL: { full: "", mini: "" },
     DEBUG: {
@@ -10542,15 +10633,12 @@ var defaultAssistantRuntimeConfig = {
       mini: "05C57A5D212684A801665774E9F0813EFC1AA4762D1540EC353BB41173712B07"
     }
   },
-  // 与上面的 URL/摘要同属一次评审：本体升级判定拿它当「我们能立刻交付的版本下限」。
-  // 只改 URL 不改这里，判定就会用别的版本号去比对已装本体。
+  // 本体升级判定拿它当「我们能立刻交付的版本下限」。OFFICIAL 与 URL 同源自
+  // OFFICIAL_INSTALLERS，结构上不可能只改 URL 不改这里。
   backserviceDownloadVersion: {
     OFFICIAL: {
-      full: "2026.06.18.11",
-      // 取安装包自身的 FileVersion，不是构建目录名里的紧凑形（20260814.5）：判定拿它和
-      // InstallInfo.xml 的 InstallAppReleaseVer 比，那边是点分四段。写成紧凑形会让
-      // 20260814 > 2026 恒成立，「有可用更新」永远消不掉。
-      mini: "2026.08.14.5"
+      full: OFFICIAL_INSTALLERS.public.full.version,
+      mini: OFFICIAL_INSTALLERS.public.mini.version
     },
     REL: { full: "", mini: "" },
     DEBUG: {
@@ -10567,8 +10655,10 @@ var defaultAssistantRuntimeConfig = {
   //
   // REL/DEBUG 没有对应发布面，留空即跳过远程判定。地址不可达或文件不存在同样 fail-open，
   // 所以这条链路默认是关的，直到有人把文件传上去 —— 见 deploy/README.md。
+  // 与安装包同源自 OFFICIAL_MIRROR_ROOTS：内测构建把安装包指到内网时，这条也必须跟着走，
+  // 否则一个 -internal 产物会拿公网索引判闸门 —— 而索引取不到时闸门是 fail-open。
   baseRequirementUrl: {
-    OFFICIAL: "https://zlt-data-house.oss-cn-wuhan-lr.aliyuncs.com/zltkj.site/down/v1/up/Zlt.Std.Official/VscodeMarketPlugin/zlt_quant_version_index.json",
+    OFFICIAL: officialVersionIndexUrl("public"),
     REL: "",
     DEBUG: ""
   },
@@ -10771,13 +10861,16 @@ function applyEnvOverrides(config2) {
   const sdkTrustedHostOverride = process.env.ZLT_PYTHON_SDK_TRUSTED_HOST;
   const baseRequirementUrlOverride = process.env.ZLT_BASE_REQUIREMENT_URL?.trim();
   const installer = parseInstallerOverride(process.env.ZLT_ASSISTANT_INSTALLER_OVERRIDE);
+  const mirror = resolveInstallerMirror();
+  const mirrored = applyInstallerMirror(config2, mirror);
+  const mirroredIndex = mirror === "public" ? config2.baseRequirementUrl : { ...config2.baseRequirementUrl, OFFICIAL: officialVersionIndexUrl(mirror) };
   return {
     ...config2,
     envMode,
-    baseRequirementUrl: baseRequirementUrlOverride ? { ...config2.baseRequirementUrl, [envMode]: baseRequirementUrlOverride } : config2.baseRequirementUrl,
-    backserviceDownload: applyInstallerOverride(config2.backserviceDownload, envMode, installer, "url"),
-    backserviceDownloadSha256: applyInstallerOverride(config2.backserviceDownloadSha256, envMode, installer, "sha256"),
-    backserviceDownloadVersion: applyInstallerOverride(config2.backserviceDownloadVersion, envMode, installer, "version"),
+    baseRequirementUrl: baseRequirementUrlOverride ? { ...mirroredIndex, [envMode]: baseRequirementUrlOverride } : mirroredIndex,
+    backserviceDownload: applyInstallerOverride(mirrored.backserviceDownload, envMode, installer, "url"),
+    backserviceDownloadSha256: applyInstallerOverride(mirrored.backserviceDownloadSha256, envMode, installer, "sha256"),
+    backserviceDownloadVersion: applyInstallerOverride(mirrored.backserviceDownloadVersion, envMode, installer, "version"),
     pythonRuntimePackages: runtimePackages.length > 0 ? runtimePackages : config2.pythonRuntimePackages,
     pythonRuntimeIndexUrl: process.env.ZLT_PYTHON_RUNTIME_INDEX_URL?.trim() || config2.pythonRuntimeIndexUrl,
     pythonSdkPackages: packages.length > 0 ? packages : envModeChanged ? config2.pythonSdkPackagesByMode[envMode] : config2.pythonSdkPackages,
@@ -10787,6 +10880,25 @@ function applyEnvOverrides(config2) {
     pythonPipWheelSha256: process.env.ZLT_PYTHON_PIP_WHEEL_SHA256?.trim() || config2.pythonPipWheelSha256
   };
 }
+function applyInstallerMirror(config2, mirror) {
+  if (mirror === "public")
+    return config2;
+  const pins = OFFICIAL_INSTALLERS[mirror];
+  return {
+    backserviceDownload: {
+      ...config2.backserviceDownload,
+      OFFICIAL: { full: officialInstallerUrl("full", mirror), mini: officialInstallerUrl("mini", mirror) }
+    },
+    backserviceDownloadSha256: {
+      ...config2.backserviceDownloadSha256,
+      OFFICIAL: { full: pins.full.sha256, mini: pins.mini.sha256 }
+    },
+    backserviceDownloadVersion: {
+      ...config2.backserviceDownloadVersion,
+      OFFICIAL: { full: pins.full.version, mini: pins.mini.version }
+    }
+  };
+}
 function parseInstallerOverride(raw) {
   const text = raw?.trim();
   if (!text)
@@ -11038,7 +11150,34 @@ var AssistantMasterIpcClient = class {
       }
     }
   }
-  async startDefaultServices(config2) {
+  /**
+   * 安装/启动通道动手前，先把 VSCode PID 注册进智能管家的监控表。
+   *
+   * 智能管家侧（xzs）每 ~10 秒查一次 monitor/check_reg_empty，注册表持续为空约 30 秒
+   * 就把整族进程自退回收 —— 2026-08-25 全新装机实测：TY 模块 202MB 下载到 88% 时
+   * ZLTBackService 被回收，ZLTHome 随后退出，下载轮询以管道断开告终
+   * （FAILURE-PATTERNS #77）。常规注册挂在 ZLTAF connected 边沿（vscode-ext 的
+   * assistant-monitor），而首次安装期间 ZLTAF 尚不存在，那条边沿永远等不到；
+   * claw-host 的安装通道在每次 IPC 连接后都上报 PID
+   * （assistant-installer.ts:1132/:1442），此处对齐。重复注册幂等。
+   * 仅检测通道（checkBacktestModuleUpdates）刻意不注册 —— 后台检查若注册会阻止
+   * 空闲自退，把「已装但未运行」这个合法状态挡掉。
+   *
+   * 注册失败绝不拦安装：旧本体可能没有 monitor API，失败只降级为一行进度日志。
+   *
+   * @param config 运行时配置，取其 ipcConnectTimeout 作为请求超时
+   * @param onProgress 可选进度回调，仅在注册失败时收到一行说明
+   */
+  async reportInstallLanePid(config2, onProgress) {
+    try {
+      await this.reportVSCodePid(process.pid, config2);
+    } catch (error2) {
+      const message = error2 instanceof Error ? error2.message : String(error2);
+      onProgress?.(`VSCode \u8FDB\u7A0B\u6CE8\u518C\u5931\u8D25\uFF08\u4E0D\u5F71\u54CD\u5B89\u88C5\u7EE7\u7EED\uFF09: ${message}`);
+    }
+  }
+  async startDefaultServices(config2, onProgress) {
+    await this.reportInstallLanePid(config2, onProgress);
     for (const serviceIndex of config2.manualServiceIndices) {
       await this.sendRequest("zltMClient", "CallInnerRpc", {
         modeType: 0,
@@ -11092,6 +11231,7 @@ var AssistantMasterIpcClient = class {
     }
   }
   async installBacktestModules(workRoot, config2, onProgress, hooks = {}) {
+    await this.reportInstallLanePid(config2, onProgress);
     const moduleIndices = [
       CLIENT_PLUGIN_MODULE_INDEX,
       ...config2.backtestModuleIndices.filter((moduleIndex) => moduleIndex !== CLIENT_PLUGIN_MODULE_INDEX)
@@ -11514,17 +11654,26 @@ var AssistantMasterIpcClient = class {
     throw new Error(formatModuleInstallError("\u6295\u7814\u6A21\u5757\u5305\u8986\u76D6\u5B89\u88C5\u72B6\u6001\u8F6E\u8BE2\u8D85\u65F6", moduleIndex, lastProgress ?? { status: 0, process: 0, phase: 0, response: null }));
   }
 };
-async function startManualServices(workRoot, zltContent, config2) {
+async function startManualServices(workRoot, zltContent, config2, onProgress) {
   const client = new AssistantMasterIpcClient();
   try {
     await client.connect(zltContent, config2);
-    await client.startDefaultServices(config2);
+    await client.startDefaultServices(config2, onProgress);
     await client.pollStartupServices(config2);
     await waitForPipe(workRoot, "ZLTAF", config2.zltafPipeWait);
   } finally {
     await client.disconnect();
   }
 }
+async function unregisterRuntimeConsumerPid(zltContent, config2) {
+  const client = new AssistantMasterIpcClient();
+  try {
+    await client.connect(zltContent, config2);
+    await client.logoutVSCodePid(process.pid, config2);
+  } finally {
+    await client.disconnect();
+  }
+}
 async function installBacktestModules(workRoot, zltContent, config2, onProgress, hooks = {}) {
   const client = new AssistantMasterIpcClient();
   try {
@@ -12224,25 +12373,11 @@ async function acquireMcpRuntime(config2, explicitWorkRoot) {
   const workRoot = explicitWorkRoot ?? await locateInstalledRuntime(config2);
   return acquireRuntimeLease(workRoot, "starter", {
     ensureRuntime: async () => {
-      const launchedPid = await startRuntimeAndServices(workRoot, config2);
-      if (!launchedPid)
-        return null;
-      const identity = await waitForProcessIdentity(launchedPid, config2.serviceStartupWait);
-      if (!identity)
-        throw new Error(`\u65E0\u6CD5\u786E\u8BA4 MCP \u542F\u52A8\u7684 ZLTAF \u8FDB\u7A0B\u8EAB\u4EFD: pid=${launchedPid}`);
-      return identity;
+      await startAssistantManagedRuntime(workRoot, config2);
+      return null;
     }
   });
 }
-async function startRuntimeAndServices(workRoot, config2) {
-  ensureUsersProjectsDirectory(workRoot);
-  const launchReady = validateRuntimeLaunchReady(workRoot, config2);
-  if (!launchReady.complete) {
-    throw new Error(launchReady.reason || "ZLTAF runtime \u542F\u52A8\u4F9D\u8D56\u4E0D\u5B8C\u6574");
-  }
-  await startAssistantBackServices(workRoot, config2);
-  return waitForZltafPipe(workRoot, config2, { startIfMissing: true });
-}
 var AssistantNotRunningError = class extends Error {
   code = "ASSISTANT_NOT_RUNNING";
   constructor(message = "\u667A\u80FD\u7BA1\u5BB6\u5F53\u524D\u672A\u8FD0\u884C\uFF1B\u5F53\u524D\u64CD\u4F5C\u4EC5\u68C0\u6D4B runtime\uFF0C\u4E0D\u4F1A\u542F\u52A8\u667A\u80FD\u7BA1\u5BB6") {
@@ -12267,7 +12402,7 @@ async function startAssistantBackServices(workRoot, config2, onProgress, options
     return;
   const zltContent = await ensureAssistantHostRunning(workRoot, config2, onProgress, options);
   onProgress?.("\u542F\u52A8\u667A\u80FD\u7BA1\u5BB6\u540E\u53F0\u670D\u52A1");
-  await startManualServices(workRoot, zltContent, config2);
+  await startManualServices(workRoot, zltContent, config2, onProgress);
 }
 async function ensureAssistantHostRunning(workRoot, config2, onProgress, options = {}) {
   const masterPipeExists = (suffix) => pipeExists(workRoot, `${config2.masterPipePrefix}_${suffix}`);
@@ -12291,11 +12426,13 @@ var ASSISTANT_UPGRADE_FINISH_LOCK = path6.join("Temporary", "upgradeFinsh.lock")
 function launchAssistantHost(workRoot, config2, onProgress) {
   const hostPath = path6.join(workRoot, config2.hostPath);
   onProgress?.("\u542F\u52A8\u667A\u80FD\u7BA1\u5BB6");
+  const { ELECTRON_RUN_AS_NODE: _dropped, ...env } = process.env;
   const child = (0, import_child_process3.spawn)(hostPath, ["startwithplugin", "selfstart"], {
     cwd: path6.dirname(hostPath),
     detached: true,
     stdio: "ignore",
-    windowsHide: true
+    windowsHide: true,
+    env
   });
   if (!child.pid)
     throw new Error(`\u667A\u80FD\u7BA1\u5BB6\u542F\u52A8\u540E\u672A\u8FD4\u56DE PID: ${hostPath}`);
@@ -12379,15 +12516,18 @@ async function installRuntime(options) {
   const installDir = options.installDir || getDefaultInstallPath();
   const installerPath = options.installerPath || await downloadRuntimeInstaller(options.config, options.onProgress, options.installType || "full");
   fs6.mkdirSync(installDir, { recursive: true });
+  const installerLogPath = path6.join(installDir, "Temporary", "logs", "install.log");
+  fs6.mkdirSync(path6.dirname(installerLogPath), { recursive: true });
   options.onProgress?.(`\u6267\u884C\u5B89\u88C5\u7A0B\u5E8F: ${installerPath}`);
-  const exitCode = await executeInstallerProcess(installerPath, installDir);
+  const exitCode = await executeInstallerProcess(installerPath, installDir, installerLogPath);
   options.onProgress?.(`\u5B89\u88C5\u8FDB\u7A0B\u9000\u51FA\u7801: ${exitCode}`);
   if (exitCode !== 0) {
     const validateInstalled = options.installModules === false ? validateAssistantBaseComplete : validateWorkRootComplete;
     const directValidation = validateInstalled(installDir, options.config);
     const registryWorkRoot = options.installModules === false ? await readRegistryInstallLocationRaw(options.config) : await readRegistryInstallLocation(options.config);
     if (!directValidation.complete && !registryWorkRoot) {
-      throw new Error(`\u5B89\u88C5\u7A0B\u5E8F\u6267\u884C\u5931\u8D25\uFF0C\u9000\u51FA\u7801: ${exitCode}; ${directValidation.reason || "\u672A\u53D1\u73B0\u5B8C\u6574 ZLTAF runtime"}`);
+      const cause = describeInstallerExitCode(exitCode);
+      throw new Error(`\u5B89\u88C5\u7A0B\u5E8F\u6267\u884C\u5931\u8D25\uFF08\u9000\u51FA\u7801 ${exitCode}\uFF09` + (cause ? `\uFF1A${cause}` : "") + (directValidation.reason ? `\uFF08${directValidation.reason}\uFF09` : "") + `\u3002\u5B89\u88C5\u65E5\u5FD7: ${installerLogPath}`);
     }
     options.onProgress?.(`\u5B89\u88C5\u7A0B\u5E8F\u9000\u51FA\u7801\u975E 0\uFF0C\u4F46\u57FA\u7840 runtime \u6587\u4EF6\u5DF2\u5B58\u5728\uFF0C\u7EE7\u7EED\u521D\u59CB\u5316: ${exitCode}`);
   }
@@ -12956,7 +13096,28 @@ async function downloadRuntimeInstaller(config2, onProgress, installType = "full
   onProgress?.(`\u5B89\u88C5\u5305 SHA256 \u6821\u9A8C\u901A\u8FC7: ${sha256}`);
   return destination;
 }
-function executeInstallerProcess(installerPath, installDir) {
+function describeInstallerExitCode(exitCode) {
+  switch (exitCode) {
+    case 1:
+      return "\u5B89\u88C5\u7A0B\u5E8F\u672A\u80FD\u5F00\u59CB\u5B89\u88C5\uFF0C\u6700\u5E38\u89C1\u539F\u56E0\u662F\u53E6\u4E00\u4E2A\u667A\u80FD\u7BA1\u5BB6\u5B89\u88C5\u6216\u5378\u8F7D\u7A0B\u5E8F\u6B63\u5728\u8FD0\u884C\uFF08\u7A97\u53E3\u53EF\u80FD\u88AB\u906E\u6321\uFF0C\u6216\u505C\u5728\u63D0\u6743\u786E\u8BA4\u4E0A\uFF09\u3002\u8BF7\u5173\u95ED\u6240\u6709\u5B89\u88C5/\u5378\u8F7D\u7A97\u53E3\u540E\u91CD\u8BD5";
+    case 2:
+      return "\u5B89\u88C5\u5728\u5F00\u59CB\u524D\u88AB\u7528\u6237\u53D6\u6D88";
+    case 3:
+    case 4:
+      return "\u5B89\u88C5\u8FC7\u7A0B\u4E2D\u53D1\u751F\u81F4\u547D\u9519\u8BEF\uFF08\u5E38\u89C1\u539F\u56E0\uFF1A\u78C1\u76D8\u7A7A\u95F4\u4E0D\u8DB3\u3001\u76EE\u6807\u6587\u4EF6\u88AB\u5176\u4ED6\u7A0B\u5E8F\u5360\u7528\u3001\u6216\u88AB\u5B89\u5168\u8F6F\u4EF6\u62E6\u622A\uFF09";
+    case 5:
+      return "\u5B89\u88C5\u8FC7\u7A0B\u4E2D\u88AB\u7528\u6237\u53D6\u6D88";
+    case 7:
+      return "\u5B89\u88C5\u524D\u68C0\u67E5\u5224\u5B9A\u5F53\u524D\u73AF\u5883\u65E0\u6CD5\u7EE7\u7EED\u5B89\u88C5";
+    case 8:
+      return "\u4E0A\u4E00\u6B21\u5B89\u88C5\u5C1A\u672A\u5B8C\u6210\uFF0C\u9700\u8981\u91CD\u542F\u7CFB\u7EDF\u540E\u624D\u80FD\u7EE7\u7EED\u5B89\u88C5";
+    case 1223:
+      return "\u5B89\u88C5\u7A0B\u5E8F\u8BF7\u6C42\u7BA1\u7406\u5458\u6743\u9650\u65F6\u88AB\u62D2\u7EDD\uFF08UAC\uFF09";
+    default:
+      return void 0;
+  }
+}
+function executeInstallerProcess(installerPath, installDir, logPath) {
   return new Promise((resolve5, reject) => {
     const child = (0, import_child_process3.spawn)(installerPath, [
       "/VERYSILENT",
@@ -12966,7 +13127,7 @@ function executeInstallerProcess(installerPath, installDir) {
       "/NO_ICONS",
       "/MERGETASKS=!desktopicon",
       `/DIR=${installDir}`,
-      `/LOG=${path6.join(installDir, "install.log")}`,
+      `/LOG=${logPath}`,
       "/m"
     ], {
       shell: false,
@@ -12975,7 +13136,7 @@ function executeInstallerProcess(installerPath, installDir) {
     });
     child.on("close", (code) => {
       if (code === 2) {
-        reject(new Error("\u5B89\u88C5\u88AB\u7528\u6237\u53D6\u6D88\u6216 UAC \u6743\u9650\u88AB\u62D2\u7EDD\uFF0C\u9000\u51FA\u7801: 2"));
+        reject(new Error(`\u5B89\u88C5\u7A0B\u5E8F\u6267\u884C\u5931\u8D25\uFF08\u9000\u51FA\u7801 2\uFF09\uFF1A${describeInstallerExitCode(2)}`));
       } else if (code === null) {
         reject(new Error("\u5B89\u88C5\u7A0B\u5E8F\u6267\u884C\u5931\u8D25\uFF0C\u672A\u8FD4\u56DE\u9000\u51FA\u7801"));
       } else {
@@ -13257,16 +13418,6 @@ async function waitForZltafPipe(workRoot, config2, options) {
   }
   throw new Error(`\u7B49\u5F85 ZLTAF \u7BA1\u9053\u8D85\u65F6: ${discoverPipePath(workRoot, "ZLTAF")}`);
 }
-async function waitForProcessIdentity(pid, timeoutMs) {
-  const deadline = Date.now() + Math.max(1e3, timeoutMs);
-  while (Date.now() <= deadline) {
-    const identity = inspectRuntimeProcess(pid);
-    if (identity)
-      return identity;
-    await delay(100);
-  }
-  return null;
-}
 
 // ../zlt-runtime-core/dist/auth.js
 var fs7 = __toESM(require("fs"), 1);
@@ -20885,6 +21036,16 @@ var NPM_PACKAGE_CONFIG_TOOL_NAMES = Object.freeze([
 // src/tool-pipeline.ts
 var fs11 = __toESM(require("node:fs"), 1);
 var path11 = __toESM(require("node:path"), 1);
+var import_node_crypto2 = require("node:crypto");
+
+// src/feature-set.ts
+function resolveFeatureSet() {
+  return false ? "core" : "full";
+}
+var MASKED_FACTOR_MESSAGE = "\u56E0\u5B50\u7814\u7A76\u529F\u80FD\u5728\u5F53\u524D\u7248\u672C\u672A\u5F00\u653E\u3002";
+var MASKED_FUTURES_MESSAGE = "\u671F\u8D27\u56DE\u6D4B\u5728\u5F53\u524D\u7248\u672C\u672A\u5F00\u653E\uFF1ArunParams.marketIds \u542B\u671F\u8D27\u4EA4\u6613\u6240\uFF08zj/zs/ds/sq/gq\uFF09\u6216 account_list \u7684 account_type \u4E3A\u671F\u8D27\u3002\u8BF7\u4F7F\u7528\u80A1\u7968\u5E02\u573A\uFF08sh/sz\uFF09\u4E0E account_type=1\u3002";
+
+// src/tool-pipeline.ts
 var FUTURES_MARKET_IDS = /* @__PURE__ */ new Set(["zj", "zs", "ds", "sq", "gq"]);
 function isFuturesRun(marketIds) {
   if (!marketIds) return false;
@@ -20895,7 +21056,26 @@ function prepareToolArgs(tool, args, contexts) {
   const inherited = inheritReBacktestRunParams(tool, args, contexts);
   const dated = applyBacktestDateDefaults(tool, inherited);
   const named = normalizeBacktestRunName(tool, dated);
-  return stripEmptyLegacyUserId(tool, named);
+  const prepared = stripEmptyLegacyUserId(tool, named);
+  return refuseMaskedFuturesBacktest(tool, prepared) ?? prepared;
+}
+var FUTURES_GATED_TOOLS = /* @__PURE__ */ new Set(["mcp-create-and-run-backtest", "mcp-re-backtest"]);
+var FUTURES_ACCOUNT_TYPES = /* @__PURE__ */ new Set([2, 6]);
+function refuseMaskedFuturesBacktest(tool, args) {
+  if (!FUTURES_GATED_TOOLS.has(tool.name) || resolveFeatureSet() !== "core") return null;
+  const runParams = args.runParams ?? {};
+  const marketIds = Array.isArray(runParams.marketIds) ? runParams.marketIds : [];
+  const accounts = Array.isArray(runParams.account_list) ? runParams.account_list : [];
+  const futuresAccount = accounts.some(
+    (account) => !!account && typeof account === "object" && FUTURES_ACCOUNT_TYPES.has(Number(account.account_type))
+  );
+  if (!isFuturesRun(marketIds) && !futuresAccount) return null;
+  return jsonToolResult(10057, MASKED_FUTURES_MESSAGE, {
+    retryableByAgent: false,
+    tool: tool.name,
+    marketIds,
+    userAction: "\u5F53\u524D\u7248\u672C\u4EC5\u652F\u6301\u80A1\u7968\u56DE\u6D4B\uFF08sh/sz\uFF09\uFF1B\u671F\u8D27\u56DE\u6D4B\u8BF7\u7B49\u5F85\u540E\u7EED\u7248\u672C\u5F00\u653E\u3002"
+  }, true);
 }
 async function dispatchSpecialTool(tool, args, client, timeout, session, waitControl) {
   if (tool.name === "mcp-factor-task-status") {
@@ -20938,7 +21118,7 @@ function shapeToolResult(tool, args, result, session) {
   if (tool.name === "mcp-stop-backtest" && !result.isError && typeof args.runId === "string") {
     session.activeBacktestRunIds.delete(args.runId);
   }
-  const echoed = echoResolvedBacktestConfig(tool, args, result);
+  const echoed = echoResolvedBacktestConfig(tool, args, result, session.backtestRunContexts);
   const guarded = applyBacktestResultGuards(
     tool,
     args,
@@ -22098,6 +22278,12 @@ async function runWait(_tool, args, client, timeout, session, control) {
       { action: 'Pass kind="factor" with the executionId from a factor start tool, kind="backtest" with the runId from mcp-create-and-run-backtest, or kind="download" with the uuid from mcp-download-data.' }
     );
   }
+  if (kind === "factor" && resolveFeatureSet() === "core") {
+    return waitError(10057, MASKED_FACTOR_MESSAGE, {
+      action: "Factor research is not available in this build; do not retry with other factor tools.",
+      userAction: MASKED_FACTOR_MESSAGE
+    });
+  }
   if (!id) {
     if (kind === "factor") {
       return waitError(
@@ -22244,13 +22430,22 @@ function captureBacktestRunContext(tool, args, result, contexts, activeRunIds) {
     const codePath = typeof parsed.Data.codePath === "string" && parsed.Data.codePath.trim() ? parsed.Data.codePath.trim() : prior?.codePath;
     if (runId) {
       const marketIds = Array.isArray(runParams.marketIds) ? runParams.marketIds.filter((id) => typeof id === "string") : prior?.marketIds;
-      contexts.set(runId, { strategyId, start, end, codePath, marketIds, runParams: { ...runParams } });
+      const sourceSha256 = hashBacktestSource(codePath) ?? prior?.sourceSha256;
+      contexts.set(runId, {
+        strategyId,
+        start,
+        end,
+        codePath,
+        marketIds,
+        runParams: { ...runParams },
+        sourceSha256
+      });
       activeRunIds.add(runId);
     }
   } catch {
   }
 }
-function echoResolvedBacktestConfig(tool, args, result) {
+function echoResolvedBacktestConfig(tool, args, result, contexts) {
   if (tool.name !== "mcp-create-and-run-backtest" && tool.name !== "mcp-re-backtest" || result.isError || result.content.length === 0) return result;
   const runParams = isRecord2(args.runParams) ? args.runParams : {};
   const resolvedStart = typeof runParams.start === "string" ? runParams.start : "";
@@ -22268,10 +22463,23 @@ function echoResolvedBacktestConfig(tool, args, result) {
   if (isDailyBacktestFrequency(runParams.freq)) echo.dailyVisibilityNote = DAILY_VISIBILITY_NOTE;
   const endWarning = describeFutureBacktestEnd(resolvedEnd);
   if (endWarning) echo.endWarning = endWarning;
-  if (Object.keys(echo).length === 0) return result;
   try {
     const parsed = JSON.parse(result.content[0].text);
     if (!isRecord2(parsed) || !isRecord2(parsed.Data)) return result;
+    const echoedRunId = typeof parsed.Data.runId === "string" ? parsed.Data.runId.trim() : "";
+    const runId = echoedRunId || (tool.name === "mcp-re-backtest" && typeof args.runId === "string" ? args.runId.trim() : "");
+    const context = runId ? contexts.get(runId) : void 0;
+    if (runId) {
+      echo.evidence = {
+        contextAvailable: Boolean(context),
+        backtestId: runId,
+        ...context?.codePath ? { runDir: context.codePath } : {},
+        ...context?.strategyId ? { strategyId: context.strategyId } : {},
+        ...context?.runParams ? { effectiveRunParams: { ...context.runParams } } : {},
+        ...context?.sourceSha256 ? { sourceSha256: context.sourceSha256 } : {}
+      };
+    }
+    if (Object.keys(echo).length === 0) return result;
     return {
       ...result,
       content: [{
@@ -22286,6 +22494,16 @@ function echoResolvedBacktestConfig(tool, args, result) {
     return result;
   }
 }
+function hashBacktestSource(codePath) {
+  if (!codePath) return void 0;
+  try {
+    const sourcePath = path11.join(codePath, "main.py");
+    if (!fs11.statSync(sourcePath).isFile()) return void 0;
+    return (0, import_node_crypto2.createHash)("sha256").update(fs11.readFileSync(sourcePath)).digest("hex");
+  } catch {
+    return void 0;
+  }
+}
 var BENCHMARK_OVERRIDE_NOTE = "\u8FD9\u662F\u8BF7\u6C42\u7684\u57FA\u51C6\uFF0C\u4E0D\u4E00\u5B9A\u662F\u5B9E\u9645\u751F\u6548\u7684\uFF1A\u7B56\u7565 initialize \u91CC\u7684 set_benchmark() \u4F1A\u8986\u76D6\u5B83\uFF0C\u6536\u76CA\u4EA7\u7269\u4E2D\u7684\u300C\u57FA\u51C6\u6536\u76CA\u300D\u6309\u7B56\u7565\u5B9E\u9645\u7528\u7684\u57FA\u51C6\u8BA1\u7B97\u3002\u62A5\u544A\u57FA\u51C6\u662F\u4EC0\u4E48\u4E4B\u524D\uFF0C\u5148\u8BFB\u7B56\u7565\u4EE3\u7801\u91CC\u7684 set_benchmark\u3002";
 var DAILY_VISIBILITY_NOTE = "\u65E5\u7EBF\u7C7B\u9891\u7387\u7684\u7B80\u5355\u56DE\u6D4B\u53EA\u80FD\u770B\u5230 context.previous_date \u53CA\u4EE5\u524D\u7684\u5B8C\u6574\u65E5 K\uFF1B\u5F53\u65E5\u6536\u76D8\u5728\u56DE\u6D4B\u4E2D\u4E0D\u53EF\u89C1\uFF0Cafter_trading_end \u540C\u6837\u770B\u4E0D\u5230\u3002\u6240\u4EE5\u8981\u7528\u67D0\u4E2A\u4EA4\u6613\u65E5 T \u7684\u6536\u76D8\u505A\u7B5B\u9009\u6216\u8BA1\u7B97\uFF0CrunParams.end \u5FC5\u987B\u8BBE\u6210 T \u7684\u4E0B\u4E00\u4E2A\u4EA4\u6613\u65E5\uFF1B\u53EA\u8DD1 [T, T] \u5355\u65E5\uFF0C\u53D6\u5230\u7684\u662F T-1 \u7684\u6536\u76D8\u3002\u5206\u949F\u3001Tick\u3001\u7814\u7A76\u3001\u4EFF\u771F\u3001\u5B9E\u76D8\u4E0D\u53D7\u6B64\u9650\u3002";
 function isDailyBacktestFrequency(value) {
@@ -22709,7 +22927,7 @@ function extractStrategyTreeIds(result) {
   }
   return ids;
 }
-async function executeSteps(steps, client, initialBody, timeout, repairHint = identityRepairHint) {
+async function executeSteps(steps, client, initialBody, timeout, repairHint = identityRepairHint, toolName) {
   let body = { ...initialBody };
   for (let i = 0; i < steps.length; i++) {
     const step = steps[i];
@@ -22746,6 +22964,10 @@ async function executeSteps(steps, client, initialBody, timeout, repairHint = id
         }
       }
     }
+    if (i < steps.length - 1) {
+      const blocked = preflightCreatedBacktestSource(toolName, body);
+      if (blocked) return blocked;
+    }
     if (i === steps.length - 1) {
       const finalData = repairHint(mergeStepFieldsToFinalData(parsed.data, body, step.mergeToFinalData));
       return {
@@ -22756,6 +22978,126 @@ async function executeSteps(steps, client, initialBody, timeout, repairHint = id
   }
   return { content: [{ type: "text", text: "{}" }] };
 }
+function pythonCodeLines(source) {
+  let state = null;
+  return source.split(/\r?\n/).map((line) => {
+    let code = "";
+    for (let i = 0; i < line.length; ) {
+      if (state === "'''" || state === '"""') {
+        if (line.startsWith(state, i)) {
+          i += 3;
+          state = null;
+        } else {
+          code += " ";
+          i += 1;
+        }
+        continue;
+      }
+      if (state === "'" || state === '"') {
+        if (line[i] === "\\") {
+          code += "  ";
+          i += 2;
+        } else if (line[i] === state) {
+          code += " ";
+          i += 1;
+          state = null;
+        } else {
+          code += " ";
+          i += 1;
+        }
+        continue;
+      }
+      if (line[i] === "#") break;
+      if (line.startsWith("'''", i) || line.startsWith('"""', i)) {
+        state = line.slice(i, i + 3);
+        code += "   ";
+        i += 3;
+        continue;
+      }
+      if (line[i] === "'" || line[i] === '"') {
+        state = line[i];
+        code += " ";
+        i += 1;
+        continue;
+      }
+      code += line[i];
+      i += 1;
+    }
+    if (state === "'" || state === '"') state = null;
+    return code;
+  });
+}
+function findUnsupportedCurrentDataGet(source) {
+  const lines = pythonCodeLines(source);
+  const aliases = /* @__PURE__ */ new Set();
+  const assignment = /\b([A-Za-z_]\w*)\s*(?::[^=]+)?=\s*get_current_data\s*\(\s*\)/g;
+  for (const line of lines) {
+    assignment.lastIndex = 0;
+    let match;
+    while ((match = assignment.exec(line)) !== null) aliases.add(match[1]);
+  }
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const line of lines) {
+      for (const alias of aliases) {
+        const escaped = alias.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const copied = new RegExp(`\\b([A-Za-z_]\\w*)\\s*(?::[^=]+)?=\\s*${escaped}\\b`).exec(line);
+        if (copied && !aliases.has(copied[1])) {
+          aliases.add(copied[1]);
+          changed = true;
+        }
+      }
+    }
+  }
+  const violations = [];
+  lines.forEach((line, index) => {
+    if (/get_current_data\s*\(\s*\)\s*\.\s*get\s*\(/.test(line)) {
+      violations.push({ line: index + 1, expression: "get_current_data().get(...)" });
+    }
+    for (const alias of aliases) {
+      const escaped = alias.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      if (new RegExp(`\\b${escaped}\\s*\\.\\s*get\\s*\\(`).test(line)) {
+        violations.push({ line: index + 1, expression: `${alias}.get(...)` });
+      }
+    }
+  });
+  return violations.filter((item, index, all) => all.findIndex((candidate) => candidate.line === item.line && candidate.expression === item.expression) === index);
+}
+function preflightCreatedBacktestSource(toolName, body) {
+  if (toolName !== "mcp-create-and-run-backtest") return null;
+  const runId = typeof body.runId === "string" ? body.runId.trim() : "";
+  const codePath = typeof body.codePath === "string" ? body.codePath.trim() : "";
+  if (!codePath || !fs11.existsSync(codePath)) return null;
+  const sourcePath = path11.join(codePath, "main.py");
+  if (!fs11.existsSync(sourcePath)) return null;
+  let source;
+  try {
+    source = fs11.readFileSync(sourcePath, "utf8");
+  } catch (error2) {
+    const message = error2 instanceof Error ? error2.message : String(error2);
+    return jsonToolResult(10061, "\u56DE\u6D4B\u4EE3\u7801\u5FEB\u7167\u65E0\u6CD5\u8BFB\u53D6\uFF0C\u672A\u542F\u52A8\u7B56\u7565\u5F15\u64CE\u3002", {
+      retryableByAgent: false,
+      runId,
+      codePath,
+      sourcePath,
+      sourcePreflight: "blocked",
+      reason: message
+    }, true);
+  }
+  const violations = findUnsupportedCurrentDataGet(source);
+  if (violations.length === 0) return null;
+  return jsonToolResult(10061, "\u56DE\u6D4B\u4EE3\u7801\u4F7F\u7528\u4E86 get_current_data().get(...)\uFF0C\u5F53\u524D\u5BF9\u8C61\u4E0D\u652F\u6301 .get()\uFF1B\u5DF2\u521B\u5EFA\u5FEB\u7167\u4F46\u672A\u542F\u52A8\u7B56\u7565\u5F15\u64CE\u3002", {
+    retryableByAgent: false,
+    runId,
+    codePath,
+    sourcePath,
+    sourcePreflight: "blocked",
+    sourceSha256: (0, import_node_crypto2.createHash)("sha256").update(source).digest("hex"),
+    violations,
+    userAction: "\u628A current_data.get(security) \u6539\u4E3A current_data[security]\uFF0C\u5E76\u7528 KeyError \u5904\u7406\u7F3A\u5931\u8BC1\u5238\uFF1B\u7136\u540E\u91CD\u65B0\u521B\u5EFA\u5E76\u8FD0\u884C\u56DE\u6D4B\u3002"
+  }, true);
+}
 function buildStepBody(step, body) {
   if (!step.bodyMapping) return body;
   const mappedBody = {};
@@ -23793,7 +24135,7 @@ function summarizeBacktestProfit(runDir, options = {}) {
 function handleBacktestProfitTool(args, contexts) {
   const backtestId = typeof args.backtestId === "string" ? args.backtestId.trim() : "";
   if (!backtestId) {
-    return toolText({ ErrNo: 10057, ErrMsg: "\u7F3A\u5C11 backtestId\uFF0C\u65E0\u6CD5\u5B9A\u4F4D\u56DE\u6D4B\u4EA7\u7269\u76EE\u5F55\u3002", Data: null }, true);
+    return toolText({ ErrNo: 10060, ErrMsg: "\u7F3A\u5C11 backtestId\uFF0C\u65E0\u6CD5\u5B9A\u4F4D\u56DE\u6D4B\u4EA7\u7269\u76EE\u5F55\u3002", Data: { retryableByAgent: true } }, true);
   }
   const explicit = typeof args.codePath === "string" ? args.codePath.trim() : "";
   const runDir = explicit || contexts.get(backtestId)?.codePath || "";
@@ -23804,13 +24146,24 @@ function handleBacktestProfitTool(args, contexts) {
       Data: null
     }, true);
   }
+  const context = contexts.get(backtestId);
+  const summary = summarizeBacktestProfit(runDir, {
+    expectedBacktestId: backtestId,
+    includeSeries: args.includeSeries === true
+  });
+  summary.evidence = {
+    contextAvailable: Boolean(context),
+    requestedBacktestId: backtestId,
+    ...summary.backtestId ? { artifactBacktestId: summary.backtestId } : {},
+    runDir,
+    ...context?.strategyId ? { strategyId: context.strategyId } : {},
+    ...context?.runParams ? { effectiveRunParams: { ...context.runParams } } : {},
+    ...context?.sourceSha256 ? { sourceSha256: context.sourceSha256 } : {}
+  };
   return toolText({
     ErrNo: 0,
     ErrMsg: "",
-    Data: summarizeBacktestProfit(runDir, {
-      expectedBacktestId: backtestId,
-      includeSeries: args.includeSeries === true
-    })
+    Data: summary
   });
 }
 
@@ -23848,7 +24201,7 @@ var RUNTIME_TOOLS = [
   },
   {
     name: "zlt-runtime-start",
-    description: "\u4EE5 ZLTAF direct mode \u542F\u52A8\u5DF2\u5B89\u88C5\u7684\u667A\u91CF\u901A\u672C\u5730\u56DE\u6D4B runtime\uFF1A\u76F4\u63A5\u542F\u52A8 zltaf/zltaf.exe \u5E76\u7B49\u5F85 ZLTAF \u7BA1\u9053\u53EF\u7528\u3002\u672C\u5DE5\u5177\u4E0D\u4F1A\u542F\u52A8 ZLTHome\u3001ZLTBackService\u3001Code.exe \u6216 jsservice\uFF0C\u4E5F\u4E0D\u8BFB\u53D6 backServiceRun.json\u3002\u5B89\u88C5\u5B8C\u6210\u540E\u5982\u679C backtestReady=false\uFF0C\u5E94\u8C03\u7528 zlt-runtime-install \u4FEE\u590D zltaf\u3001Python/Git \u6216 SDK\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\u3002",
+    description: "\u542F\u52A8\u5DF2\u5B89\u88C5\u7684\u667A\u91CF\u901A\u672C\u5730\u56DE\u6D4B runtime\uFF1A\u7ECF\u667A\u80FD\u7BA1\u5BB6\uFF08ZLTHome selfstart\uFF09\u6258\u7BA1\u62C9\u8D77\u5E76\u7B49\u5F85\u5176\u521B\u5EFA\u7684 ZLTAF \u7BA1\u9053\uFF0C\u7EDD\u4E0D\u76F4\u63A5\u542F\u52A8 zltaf.exe\u3002\u672C\u5DE5\u5177\u4E0D\u4F1A\u542F\u52A8 Code.exe \u6216 jsservice\uFF0C\u4E5F\u4E0D\u8BFB\u53D6 backServiceRun.json\u3002\u5B89\u88C5\u5B8C\u6210\u540E\u5982\u679C backtestReady=false\uFF0C\u5E94\u8C03\u7528 zlt-runtime-install \u4FEE\u590D zltaf\u3001Python/Git \u6216 SDK\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\u3002",
     inputSchema: {
       type: "object",
       properties: {},
@@ -23858,7 +24211,7 @@ var RUNTIME_TOOLS = [
   },
   {
     name: "zlt-runtime-install",
-    description: "\u4E0B\u8F7D\u5E76\u5B89\u88C5\u667A\u91CF\u901A\u672C\u5730 ZLTAF runtime\uFF0C\u6821\u9A8C\u6295\u7814\u6A21\u5757\u4E0B\u53D1\u7684 Python/MinGit \u5DE5\u5177\u94FE\u4E0E zltquant/zltsdk\uFF0C\u5E76\u4EE5 ZLTAF direct mode \u542F\u52A8\u56DE\u6D4B\u670D\u52A1\u3002Python \u4E0E MinGit \u5F52\u6295\u7814\u6A21\u5757\u4E0B\u53D1\uFF0C\u672C\u5DE5\u5177\u53EA\u6821\u9A8C\u3001\u4E0D\u518D\u81EA\u884C\u4E0B\u8F7D\u6216\u4FEE\u590D\u5B83\u4EEC\uFF1A\u7F3A\u5931\u65F6\u4F1A\u660E\u786E\u62A5\u51FA\u300C\u8BF7\u5728\u667A\u80FD\u7BA1\u5BB6\u4E2D\u5B89\u88C5\u6216\u4FEE\u590D\u6295\u7814\u6A21\u5757\u300D\u3002\u8BE5\u64CD\u4F5C\u4F1A\u5199\u5165\u672C\u673A\u78C1\u76D8\u5E76\u53EF\u80FD\u89E6\u53D1 Windows \u5B89\u88C5/UAC\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u53D6\u5F97\u7528\u6237\u786E\u8BA4\uFF0C\u5E76\u4F20\u5165 confirm=true\u3002\u5B89\u88C5\u5305\u5FC5\u987B\u81EA\u5E26 zltaf\uFF1B\u672C\u5DE5\u5177\u4E0D\u4F1A\u901A\u8FC7 Assistant IPC\u3001ZLTHome \u6216 ZLTBackService \u8865\u88C5\u6A21\u5757\uFF0C\u4E5F\u4E0D\u4F1A\u542F\u52A8 Code.exe/jsservice\u3002",
+    description: "\u4E0B\u8F7D\u5E76\u5B89\u88C5\u667A\u91CF\u901A\u672C\u5730 ZLTAF runtime\uFF0C\u6821\u9A8C\u6295\u7814\u6A21\u5757\u4E0B\u53D1\u7684 Python/MinGit \u5DE5\u5177\u94FE\u4E0E zltquant/zltsdk\uFF0C\u5E76\u7ECF\u667A\u80FD\u7BA1\u5BB6\u6258\u7BA1\u542F\u52A8\u56DE\u6D4B\u670D\u52A1\u3002Python \u4E0E MinGit \u5F52\u6295\u7814\u6A21\u5757\u4E0B\u53D1\uFF0C\u672C\u5DE5\u5177\u53EA\u6821\u9A8C\u3001\u4E0D\u518D\u81EA\u884C\u4E0B\u8F7D\u6216\u4FEE\u590D\u5B83\u4EEC\uFF1A\u7F3A\u5931\u65F6\u4F1A\u660E\u786E\u62A5\u51FA\u300C\u8BF7\u5728\u667A\u80FD\u7BA1\u5BB6\u4E2D\u5B89\u88C5\u6216\u4FEE\u590D\u6295\u7814\u6A21\u5757\u300D\u3002\u8BE5\u64CD\u4F5C\u4F1A\u5199\u5165\u672C\u673A\u78C1\u76D8\u5E76\u53EF\u80FD\u89E6\u53D1 Windows \u5B89\u88C5/UAC\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u53D6\u5F97\u7528\u6237\u786E\u8BA4\uFF0C\u5E76\u4F20\u5165 confirm=true\u3002\u5B89\u88C5\u5305\u5FC5\u987B\u81EA\u5E26 zltaf\uFF1B\u672C\u5DE5\u5177\u4E0D\u4F1A\u901A\u8FC7 Assistant IPC\u3001ZLTHome \u6216 ZLTBackService \u8865\u88C5\u6A21\u5757\uFF0C\u4E5F\u4E0D\u4F1A\u542F\u52A8 Code.exe/jsservice\u3002",
     inputSchema: {
       type: "object",
       properties: {
@@ -23892,14 +24245,7 @@ async function startMcpServer() {
     ...resolveListedRuntimeTools(RUNTIME_TOOLS, toolProfile),
     ...resolveListedIpcTools(config2.tools, toolProfile)
   ];
-  const runtimeConfig = {
-    ...loadAssistantRuntimeConfig(resolveDefaultRuntimeConfigPath()),
-    zltafConfigFile: ZLTAF_CONFIG_FILE_DAY,
-    // Trae/WorkBuddy owns a standalone direct-ZLTAF lane. 智能管家 and its
-    // Assistant-managed services belong to the zlt-quant VSCode runtime.
-    manualServiceIndices: [],
-    startupCheckIndices: []
-  };
+  const runtimeConfig = loadAssistantRuntimeConfig(resolveDefaultRuntimeConfigPath());
   let runtimeStartAttempted = false;
   let runtimeLease;
   let leaseStateUpdate = Promise.resolve();
@@ -24074,7 +24420,7 @@ async function startMcpServer() {
     );
     if (special) return special;
     if (tool.steps && tool.steps.length > 0) {
-      const result = await executeSteps(tool.steps, ipcClient, stripControlParams(toolArgs), timeout, withRuntimeRepairHint);
+      const result = await executeSteps(tool.steps, ipcClient, stripControlParams(toolArgs), timeout, withRuntimeRepairHint, tool.name);
       return shapeToolResult(tool, toolArgs, result, session);
     }
     try {
@@ -24118,6 +24464,14 @@ async function startMcpServer() {
       if (runtimeLease) {
         const lease = runtimeLease;
         runtimeLease = void 0;
+        try {
+          const zltContent = await readZltContent(lease.workRoot, runtimeConfig.temporaryZltFile);
+          if (zltContent) await unregisterRuntimeConsumerPid(zltContent, runtimeConfig);
+          process.stderr.write("[zlt-mcp-proxy] runtime PID \u5DF2\u6CE8\u9500\n");
+        } catch (error2) {
+          process.stderr.write(`[zlt-mcp-proxy] runtime PID \u6CE8\u9500\u5931\u8D25\uFF08\u5FFD\u7565\uFF09: ${error2 instanceof Error ? error2.message : String(error2)}
+`);
+        }
         try {
           const released = await releaseRuntimeLease(lease);
           process.stderr.write(`[zlt-mcp-proxy] runtime lease released: ${released.reason}
@@ -24473,7 +24827,7 @@ function getRuntimeRecommendedAction(runtimeReady, backtestReady) {
     return "call zlt-runtime-install with confirm=true to install the local backtest runtime";
   }
   if (!backtestReady) {
-    return "if zltaf is missing, call zlt-runtime-install with confirm=true. Python/Git toolchain and SDK packages come from the \u6295\u7814 module: ask the user to install or repair it in \u667A\u80FD\u7BA1\u5BB6. Then start ZLTAF direct mode.";
+    return "if zltaf is missing, call zlt-runtime-install with confirm=true. Python/Git toolchain and SDK packages come from the \u6295\u7814 module: ask the user to install or repair it in \u667A\u80FD\u7BA1\u5BB6. Then start the managed runtime.";
   }
   return "call zlt-runtime-start before backtest if the ZLTAF pipe is not running";
 }
@@ -24485,10 +24839,10 @@ function getRuntimeStartUserAction(message) {
     return "\u667A\u91CF\u901A\u672C\u5730 ZLTAF runtime \u4E0D\u5B8C\u6574\uFF0C\u672A\u627E\u5230 C:\\ZLTClient\\zltaf\\zltaf.exe\u3002\u8BF7\u53D6\u5F97\u7528\u6237\u786E\u8BA4\u540E\u8C03\u7528 zlt-runtime-install\uFF0C\u4F7F\u7528\u5305\u542B zltaf \u7684\u5B89\u88C5\u5305\u4FEE\u590D\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\u3002";
   }
   if (/handshake/i.test(message)) {
-    return "\u667A\u91CF\u901A ZLTAF direct mode \u542F\u52A8\u63E1\u624B\u5931\u8D25\u3002\u8BF7\u628A ErrMsg \u548C doctor \u7ED3\u679C\u53CD\u9988\u7ED9\u5F00\u53D1\u8005\u6392\u67E5 ZLTAF \u7BA1\u9053\u534F\u8BAE\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\uFF0C\u4E5F\u4E0D\u8981\u542F\u52A8 ZLTHome\u3001ZLTBackService\u3001Code.exe \u6216 jsservice\u3002";
+    return "\u667A\u91CF\u901A\u6258\u7BA1\u542F\u52A8\uFF08ZLTHome selfstart\uFF09\u63E1\u624B\u5931\u8D25\u3002\u8BF7\u628A ErrMsg \u548C doctor \u7ED3\u679C\u53CD\u9988\u7ED9\u5F00\u53D1\u8005\u6392\u67E5 ZLTAF \u7BA1\u9053\u534F\u8BAE\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\uFF0C\u4E5F\u4E0D\u8981\u542F\u52A8 ZLTHome\u3001ZLTBackService\u3001Code.exe \u6216 jsservice\u3002";
   }
   if (/pipe|管道|ZLTAF/i.test(message)) {
-    return "\u667A\u91CF\u901A ZLTAF \u7BA1\u9053\u4ECD\u4E0D\u53EF\u7528\u3002\u8BF7\u628A ErrMsg\u3001doctor \u7ED3\u679C\u548C zltaf \u65E5\u5FD7\u53CD\u9988\u7ED9\u5F00\u53D1\u8005\u6392\u67E5 ZLTAF direct mode\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\uFF0C\u4E5F\u4E0D\u8981\u542F\u52A8 ZLTHome\u3001ZLTBackService\u3001Code.exe \u6216 jsservice\u3002";
+    return "\u667A\u91CF\u901A ZLTAF \u7BA1\u9053\u4ECD\u4E0D\u53EF\u7528\u3002\u8BF7\u628A ErrMsg\u3001doctor \u7ED3\u679C\u548C zltaf \u65E5\u5FD7\u53CD\u9988\u7ED9\u5F00\u53D1\u8005\u6392\u67E5\u6258\u7BA1\u542F\u52A8\u94FE\u8DEF\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\uFF0C\u4E5F\u4E0D\u8981\u542F\u52A8 ZLTHome\u3001ZLTBackService\u3001Code.exe \u6216 jsservice\u3002";
   }
   return "\u667A\u91CF\u901A ZLTAF runtime \u542F\u52A8\u5931\u8D25\u3002\u8BF7\u628A ErrMsg \u548C doctor \u7ED3\u679C\u53CD\u9988\u7ED9\u7528\u6237\u6216\u5F00\u53D1\u8005\u6392\u67E5\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\u3001\u6740\u8FDB\u7A0B\u3001\u542F\u52A8 ZLTHome/ZLTBackService/Code.exe/jsservice \u6216\u91CD\u590D\u5B89\u88C5 runtime\u3002";
 }
@@ -24502,7 +24856,7 @@ function getRuntimeInstallUserAction(message) {
   if (/handshake|pipe|管道|ZLTAF/i.test(message)) {
     return getRuntimeStartUserAction(message);
   }
-  return "\u667A\u91CF\u901A ZLTAF runtime \u5B89\u88C5/\u4FEE\u590D\u5931\u8D25\u3002\u8BF7\u628A ErrMsg \u548C doctor \u7ED3\u679C\u53CD\u9988\u7ED9\u5F00\u53D1\u8005\u6392\u67E5\u5B89\u88C5\u5668\u6216 ZLTAF direct mode\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\u3001\u6740\u8FDB\u7A0B\u3001\u542F\u52A8 ZLTHome/ZLTBackService/Code.exe/jsservice \u6216\u91CD\u590D\u5B89\u88C5 runtime\u3002";
+  return "\u667A\u91CF\u901A ZLTAF runtime \u5B89\u88C5/\u4FEE\u590D\u5931\u8D25\u3002\u8BF7\u628A ErrMsg \u548C doctor \u7ED3\u679C\u53CD\u9988\u7ED9\u5F00\u53D1\u8005\u6392\u67E5\u5B89\u88C5\u5668\u6216\u6258\u7BA1\u542F\u52A8\u94FE\u8DEF\uFF1B\u4E0D\u8981\u624B\u52A8\u521B\u5EFA zltaf \u76EE\u5F55\u3001\u6740\u8FDB\u7A0B\u3001\u542F\u52A8 ZLTHome/ZLTBackService/Code.exe/jsservice \u6216\u91CD\u590D\u5B89\u88C5 runtime\u3002";
 }
 function runtimeRecoveryStopData(message, extra = {}, handler = "runtimeStart") {
   return {