@zltquant/zlt-mcp 0.4.1 → 0.5.0-beta.0

package/README.md

@@ -7,7 +7,20 @@
 
 ## 接入
 
-把下面的配置加进你的 MCP 客户端（Trae / WorkBuddy / Claude Code / Cursor 等）：
+WorkBuddy 使用配套 Skill，并由 Skill 调用 npm CLI 完成任务，无需配置 MCP 连接器：
+
+```powershell
+npx -y @zltquant/zlt-mcp list --json
+npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
+```
+
+业务调用支持 `call --output-json <新文件路径>`：完整 JSON 写入文件，stdout 返回含
+`ok`、`tool`、`resultFile`、`cliProvenance`、精简 `data` 的回执。
+输出目录须已存在，已有文件会在执行工具前报错；每次使用新文件名。完整参数与大段数据从结果文件读取。
+stderr 保留诊断，失败返回非零退出码。工具执行后若写文件失败，完整结果会输出到 stdout；先核对结果，不要自动重复执行。
+不传该参数时保持原有完整 stdout。
+
+其他支持原生 MCP 的客户端（Trae / Claude Code / Cursor 等）可以使用下面的配置：
 
 ```json
 {
@@ -20,17 +33,10 @@
 }
 ```
 
-WorkBuddy 也可以不配置 MCP，直接由 Skill 调用 CLI：
-
-```powershell
-npx -y @zltquant/zlt-mcp list --json
-npx -y @zltquant/zlt-mcp call mcp-get-strategy-list --args-json '{"status":0,"treeId":0}'
-```
-
 首次使用前请从 https://api.zltquant.com/login 获取 Key，并由用户自己创建
 `%USERPROFILE%\.zltquant\credentials.json`（只填 `apiKey`）。
 
-也可以固定安装后用 node 直接启动（技能市场的 zlt-mcp-setup 技能走这条路）：
+其他客户端无法使用 npx 时，也可以固定安装后用 node 启动 MCP 服务：
 
 ```powershell
 npm i @zltquant/zlt-mcp --prefix "$env:USERPROFILE\.zlt-quant" --registry https://registry.npmmirror.com

package/package.json

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

package/zlt-mcp-proxy.bundle.cjs

@@ -18374,8 +18374,21 @@ function parsePackageList(value) {
 
 // ../zlt-runtime-core/dist/registry.js
 var import_child_process = require("child_process");
-var import_util2 = require("util");
-var execAsync = (0, import_util2.promisify)(import_child_process.exec);
+var POWERSHELL_EXE = "powershell.exe";
+var REGISTRY_SUBKEY_ENV = "ZLT_REGISTRY_SUBKEY_B64";
+var REGISTRY_VALUE_NAME_ENV = "ZLT_REGISTRY_VALUE_NAME_B64";
+var READ_REGISTRY_VALUE_SCRIPT = [
+  "$subKey = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($env:ZLT_REGISTRY_SUBKEY_B64))",
+  "$valueName = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($env:ZLT_REGISTRY_VALUE_NAME_B64))",
+  "$key = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey($subKey)",
+  "if ($null -eq $key) { exit 1 }",
+  "try {",
+  "  if ($key.GetValueKind($valueName) -ne [Microsoft.Win32.RegistryValueKind]::String) { exit 1 }",
+  "  $value = $key.GetValue($valueName, $null, [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)",
+  "  if ($null -eq $value) { exit 1 }",
+  "  [Console]::Out.Write([string]$value)",
+  "} finally { $key.Dispose() }"
+].join("\n");
 function buildAssistantRegistryKey(registryKeyName) {
   return `HKLM\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\${registryKeyName}`;
 }
@@ -18393,26 +18406,45 @@ function getRegistryKeyNames(config2) {
   }
   return names;
 }
-function parseRegistryStringValue(stdout, valueName) {
-  const escapedValueName = valueName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const match = stdout.match(new RegExp(`${escapedValueName}\\s+REG_SZ\\s+(.+)`, "i"));
-  return match?.[1]?.trim() || "";
+function buildPowerShellRegistryEnvironment(registryKey, valueName) {
+  const subKey = registryKey.replace(/^HKLM\\/i, "");
+  return {
+    ...process.env,
+    [REGISTRY_SUBKEY_ENV]: Buffer.from(subKey, "utf-8").toString("base64"),
+    [REGISTRY_VALUE_NAME_ENV]: Buffer.from(valueName, "utf-8").toString("base64")
+  };
 }
-async function readAssistantRegistryStringValue(config2, valueName, suppressStderr = true) {
+function buildPowerShellRegistryArgs() {
+  return ["-NoLogo", "-NoProfile", "-NonInteractive", "-Command", READ_REGISTRY_VALUE_SCRIPT];
+}
+function readRegistryValueWithPowerShell(registryKey, valueName) {
+  return new Promise((resolve8, reject) => {
+    (0, import_child_process.execFile)(POWERSHELL_EXE, buildPowerShellRegistryArgs(), {
+      encoding: "utf-8",
+      env: buildPowerShellRegistryEnvironment(registryKey, valueName),
+      windowsHide: true
+    }, (error2, stdout) => {
+      if (error2)
+        reject(error2);
+      else
+        resolve8(stdout.trim());
+    });
+  });
+}
+async function readAssistantRegistryStringValue(config2, valueName, _suppressStderr = true) {
   const registryKeyNames = getRegistryKeyNames(config2);
   const registryKey = buildAssistantRegistryKey(registryKeyNames[0]);
   if (process.platform !== "win32")
     return { registryKey, valueName };
-  const stderrRedirect = suppressStderr ? " 2>nul" : "";
   for (const registryKeyName of registryKeyNames) {
     const candidateRegistryKey = buildAssistantRegistryKey(registryKeyName);
     try {
-      const { stdout } = await execAsync(`reg query "${candidateRegistryKey}" /v ${valueName}${stderrRedirect}`);
+      const stdout = await readRegistryValueWithPowerShell(candidateRegistryKey, valueName);
       return {
         registryKey: candidateRegistryKey,
         valueName,
         stdout,
-        value: parseRegistryStringValue(stdout, valueName)
+        value: stdout
       };
     } catch {
     }
@@ -24904,6 +24936,12 @@ function echoResolvedBacktestConfig(tool, args, result, contexts) {
     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.runId = runId;
+    if (context?.codePath) {
+      echo.codePath = context.codePath;
+      echo.runDir = context.codePath;
+    }
+    if (context?.runParams) echo.runParams = { ...context.runParams };
     if (context?.attemptStartedAtMs) {
       echo.attemptFence = {
         attemptStartedAtMs: context.attemptStartedAtMs,
@@ -27468,7 +27506,8 @@ function runtimeRecoveryStopData(message, extra = {}, handler = "runtimeStart")
 
 // src/index.ts
 var CLI_NAME = "zlt-mcp";
-var CLI_FALLBACK_VERSION = "0.4.0";
+var CLI_FALLBACK_PACKAGE_NAME = "@zltquant/zlt-mcp";
+var CLI_FALLBACK_VERSION = "0.5.0-beta.0";
 if (process.argv.length <= 2) {
   startMcpServer();
 } else {
@@ -27478,28 +27517,51 @@ if (process.argv.length <= 2) {
     if (kind !== "backtest") throw new Error(`Unsupported keepalive kind: ${kind}`);
     await keepMcpBacktestAlive(id, codePath);
   });
-  program2.command("call <tool>").description("Call any MCP tool through the bundled MCP server").option("--args-json <json>", "JSON object containing tool arguments").option("--args-file <path>", "Read the JSON argument object from a file").option("--timeout-ms <ms>", "MCP request inactivity timeout in milliseconds").option("--max-total-timeout-ms <ms>", "Optional hard upper bound for the request").option("--no-progress", "Suppress progress diagnostics on stderr").action(async (tool, options) => {
+  program2.command("call <tool>").description("Call any MCP tool through the bundled MCP server").option("--args-json <json>", "JSON object containing tool arguments").option("--args-file <path>", "Read the JSON argument object from a file").option("--output-json <path>", "Save the complete result to a new JSON file and print a compact receipt").option("--timeout-ms <ms>", "MCP request inactivity timeout in milliseconds").option("--max-total-timeout-ms <ms>", "Optional hard upper bound for the request").option("--no-progress", "Suppress progress diagnostics on stderr").action(async (tool, options) => {
+    let outputFd;
     try {
       const args = parseMcpArgs(options.argsJson, options.argsFile);
+      const timeoutMs = parseTimeoutOption(options.timeoutMs, "--timeout-ms");
+      const maxTotalTimeoutMs = parseTimeoutOption(options.maxTotalTimeoutMs, "--max-total-timeout-ms");
+      const resultFile = options.outputJson === void 0 ? void 0 : path14.resolve(options.outputJson);
+      if (resultFile !== void 0) outputFd = fs13.openSync(resultFile, "wx");
       const result = await callMcpTool(tool, args, {
-        timeoutMs: parseTimeoutOption(options.timeoutMs, "--timeout-ms"),
-        maxTotalTimeoutMs: parseTimeoutOption(options.maxTotalTimeoutMs, "--max-total-timeout-ms"),
+        timeoutMs,
+        maxTotalTimeoutMs,
         showProgress: options.progress !== false
       });
-      process.stdout.write(JSON.stringify(result) + "\n");
+      const complete = withCliProvenance(result);
+      const serialized = JSON.stringify(complete) + "\n";
+      if (outputFd !== void 0 && resultFile !== void 0) {
+        try {
+          fs13.writeFileSync(outputFd, serialized, "utf-8");
+          fs13.closeSync(outputFd);
+          outputFd = void 0;
+        } catch (error2) {
+          process.stdout.write(serialized);
+          throw new Error(`Tool returned a result, but saving ${resultFile} failed; complete result is on stdout. Do not repeat the tool automatically. ${String(error2)}`);
+        }
+        const receipt = compactCliReceipt(tool, complete, resultFile);
+        process.stdout.write(JSON.stringify(receipt) + "\n");
+        if (!receipt.ok) process.exitCode = 1;
+      } else {
+        process.stdout.write(serialized);
+      }
       if (result.isError === true) process.exitCode = 1;
     } catch (error2) {
       const message = error2 instanceof Error ? error2.message : String(error2);
       process.stderr.write(`Error: ${message}
 `);
       process.exitCode = 1;
+    } finally {
+      if (outputFd !== void 0) fs13.closeSync(outputFd);
     }
   });
   program2.command("list").description("List MCP tools exposed by the bundled server").option("--json", "Emit the complete tools/list response as JSON").action(async (options) => {
     try {
       const result = await listMcpTools();
       if (options.json) {
-        process.stdout.write(JSON.stringify(result) + "\n");
+        process.stdout.write(JSON.stringify(withCliProvenance(result)) + "\n");
         return;
       }
       const tools = Array.isArray(result.tools) ? result.tools : [];
@@ -27564,13 +27626,16 @@ if (process.argv.length <= 2) {
   });
 }
 function resolveCliVersion() {
+  return resolveCliPackageProvenance().packageVersion;
+}
+function resolveCliPackageProvenance() {
   let current = path14.dirname(path14.resolve(process.argv[1] || process.cwd()));
   for (let depth = 0; depth < 6; depth += 1) {
     const manifestPath = path14.join(current, "package.json");
     try {
       const manifest = JSON.parse(fs13.readFileSync(manifestPath, "utf-8"));
       if ((manifest.name === "@zltquant/zlt-mcp" || manifest.name === "zlt-mcp-proxy") && typeof manifest.version === "string") {
-        return manifest.version;
+        return { packageName: manifest.name, packageVersion: manifest.version };
       }
     } catch {
     }
@@ -27578,7 +27643,50 @@ function resolveCliVersion() {
     if (parent === current) break;
     current = parent;
   }
-  return CLI_FALLBACK_VERSION;
+  return { packageName: CLI_FALLBACK_PACKAGE_NAME, packageVersion: CLI_FALLBACK_VERSION };
+}
+function withCliProvenance(result) {
+  return { ...result, cliProvenance: resolveCliPackageProvenance() };
+}
+function compactCliReceipt(tool, result, resultFile) {
+  const payload = parseMcpResult(result);
+  const code = payload?.ErrNo;
+  const ok = result.isError !== true && (code === void 0 || code === null || Number(code) === 0);
+  const source = payload?.Data;
+  const data = {};
+  if (source && typeof source === "object" && !Array.isArray(source)) {
+    const fields = source;
+    for (const key of [
+      "runId",
+      "backtestId",
+      "strategyId",
+      "localPath",
+      "codePath",
+      "runDir",
+      "attemptFence",
+      "status",
+      "progress",
+      "available",
+      "runtimeReady",
+      "backtestReady",
+      "nextAction",
+      "recommendedAction",
+      "error_code",
+      "error_msg"
+    ]) {
+      if (fields[key] !== void 0) {
+        data[key] = key === "error_msg" && typeof fields[key] === "string" ? fields[key].slice(0, 512) : fields[key];
+      }
+    }
+  }
+  return {
+    ok,
+    tool,
+    resultFile,
+    cliProvenance: result.cliProvenance,
+    data,
+    ...!ok ? { error: { code: code ?? null, message: String(payload?.ErrMsg ?? "Tool reported an error; see resultFile").slice(0, 512) } } : {}
+  };
 }
 function parseTimeoutOption(value, flag) {
   if (value === void 0) return void 0;