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

package/config.json

@@ -21,7 +21,7 @@
     },
     {
       "name": "mcp-strategy-get-template-list",
-      "description": "获取策略参数模板列表。创建策略前应先调用本工具，根据返回的模板列表选择 templateItemVal，再调用策略创建工具。",
+      "description": "获取平台策略参数模板列表。创建策略前应先调用本工具，只能从实时返回的条目取 val 作为 templateItemVal，不要编造或硬编码模板标识。用户明确指定的模板优先；用户只说「推荐策略并回测」等委托选择请求时，agent 可根据返回的名称、说明和可用标签选择合适模板，无需再要求用户选择。没有其他偏好时，优先选择实时返回的带平台推荐标签且适合的日线模板；没有返回推荐标记时，若列表中存在且适合用户需求，可选择「均线择时」作为后备；否则从当前列表选择其他合适模板并简要说明理由。随后调用 mcp-create-strategy-with-template 创建。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -47,13 +47,13 @@
     },
     {
       "name": "mcp-create-strategy-with-template",
-      "description": "基于用户选择的策略模板创建本地策略。先用 mcp-strategy-get-template-list 取模板列表让用户选，把所选模板的 val 填入 templateItemVal；templateVal 固定为 strategy。名称默认用「模板名称+日期时间（YYMMDD-HHMM）」，调用前允许用户修改或确认——ZLTAF 对重名策略会静默不创建并返回空结果，本工具已将其转为明确的 ErrNo 10051，遇到就改用唯一名称重试，**切勿改为复用既有同名策略**。\n\n返回含 strategyId 与 localPath，请直接使用，不要再自行查询策略列表按名称猜测。",
+      "description": "基于平台策略模板创建本地策略。先用 mcp-strategy-get-template-list 取实时列表，把所选条目的 val 填入 templateItemVal；templateVal 固定为 strategy。用户明确指定的模板优先；用户委托推荐时允许 agent 代选，无需再要求用户选择。名称默认用「模板名称+日期时间（YYMMDD-HHMM）」，允许用户修改；用户未指定名称时直接生成唯一名称——ZLTAF 对重名策略会静默不创建并返回空结果，本工具已将其转为明确的 ErrNo 10051，遇到就改用唯一名称重试，**切勿改为复用既有同名策略**。\n\n返回含 strategyId 与 localPath，请直接使用，不要再自行查询策略列表按名称猜测。",
       "inputSchema": {
         "type": "object",
         "properties": {
           "name": {
             "type": "string",
-            "description": "策略名称。默认使用“模板名称+日期（YYMMDD）”生成，允许用户修改；调用本工具时必须传入最终确认后的名称。"
+            "description": "策略名称。默认使用“模板名称+日期时间（YYMMDD-HHMM）”生成唯一名称，允许用户修改；用户未指定名称时由 agent 直接生成，调用时传入该名称。"
           },
           "templateVal": {
             "type": "string",
@@ -65,7 +65,7 @@
           },
           "templateItemVal": {
             "type": "string",
-            "description": "用户选择的模板 val，来自 mcp-strategy-get-template-list 返回的模板条目。调用前必须让用户选择模板。"
+            "description": "用户选择或委托 agent 代选的模板 val，必须来自 mcp-strategy-get-template-list 实时返回的模板条目；不要编造或硬编码。用户明确指定的模板优先。"
           },
           "userId": {
             "type": "string",

package/package.json

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

package/zlt-mcp-proxy.bundle.cjs

@@ -23302,14 +23302,14 @@ function shapeToolResult(tool, args, result, session) {
     session.activeBacktestRunIds.delete(args.runId);
   }
   const echoed = echoResolvedBacktestConfig(tool, args, result, session.backtestRunContexts);
-  const guarded = applyBacktestResultGuards(
+  const guarded = annotateBacktestOutcome(tool, applyBacktestResultGuards(
     tool,
     args,
     echoed,
     session.backtestPollStates,
     session.backtestRunContexts,
     session.activeBacktestRunIds
-  );
+  ));
   const activeChange = classifyActiveBacktestChange(tool, args, guarded);
   if (activeChange) {
     if (activeChange.active) session.activeBacktestRunIds.add(activeChange.runId);
@@ -23323,6 +23323,38 @@ function shapeToolResult(tool, args, result, session) {
   const distilled = distillFactorDetectReport(tool, args, diagnosed);
   return injectDebugRunId(tool, injectStrategyDocsHint(tool, distilled, session.docsPath));
 }
+function backtestStatusNumber(status) {
+  return typeof status === "number" || typeof status === "string" && status.trim() !== "" ? Number(status) : NaN;
+}
+function annotateBacktestOutcome(tool, result) {
+  if (tool.name !== "mcp-get-backtest-state") return result;
+  try {
+    const parsed = JSON.parse(result.content[0]?.text ?? "");
+    if (!isRecord2(parsed) || !isRecord2(parsed.Data)) return result;
+    const data = parsed.Data;
+    const status = backtestStatusNumber(data.status);
+    const reconciled = parsed.ErrNo === 10043 && data.reconciledFrom === "result.json";
+    const backtestOutcome = reconciled ? "failed" : status === 0 || status === 1 ? "running" : status === 2 ? "failed" : status === 3 ? "cancelled" : status === 4 ? "terminated" : status === 5 ? "completed" : "unknown";
+    const isTerminal2 = backtestOutcome !== "running" && backtestOutcome !== "unknown";
+    const message = typeof data.error_msg === "string" ? data.error_msg.trim() : "";
+    return {
+      ...result,
+      content: [{ type: "text", text: JSON.stringify({
+        ...parsed,
+        Data: {
+          ...data,
+          backtestOutcome,
+          isTerminal: isTerminal2,
+          evidenceSource: reconciled ? "current-attempt-result.json" : "ipc-state",
+          nextAction: isTerminal2 ? "finalize-backtest" : backtestOutcome === "unknown" || data.waitStopped || data.pollingStopped ? "inspect-backtest-state" : "keep-waiting",
+          ...backtestOutcome === "failed" && !reconciled && (!message || /异常(?:退出|终止)|unexpected.*exit|exited unexpectedly/i.test(message)) ? { failureCause: "unknown" } : {}
+        }
+      }) }]
+    };
+  } catch {
+    return result;
+  }
+}
 var ZLTAF_CONFIG_SEGMENTS = ["zltaf", "application-local.properties"];
 var FALLBACK_FACTOR_PROJECT_PATH = ["Users", "factors"];
 var factorProjectRootCache = /* @__PURE__ */ new Map();
@@ -24404,11 +24436,11 @@ function unreadableDownloadProgressError(uuid2) {
   );
 }
 function unreadableBacktestStateError(runId) {
-  return waitError(
+  return annotateBacktestOutcome(BACKTEST_WAIT_POLL_IDENTITY, waitError(
     10054,
     "\u56DE\u6D4B\u72B6\u6001\u5E94\u7B54\u65E0\u6CD5\u89E3\u6790\uFF0C\u5DF2\u505C\u6B62\u7B49\u5F85\uFF1B\u8BF7\u7528 mcp-get-backtest-state \u590D\u67E5\u3002",
     { runId }
-  );
+  ));
 }
 function factorWaitLane(executionId, session) {
   let staleCount = 0;
@@ -24557,7 +24589,7 @@ function backtestWaitLane(runId, session, codePath, resultBaseline, attemptStart
           return { verdict: "return", result: unreadableBacktestStateError(runId) };
         }
         const data = parsed.Data;
-        const status = Number(data.status);
+        const status = backtestStatusNumber(data.status);
         if (!Number.isFinite(status)) {
           return { verdict: "return", result: unreadableBacktestStateError(runId) };
         }
@@ -24598,7 +24630,10 @@ function backtestWaitLane(runId, session, codePath, resultBaseline, attemptStart
         frozenCount = signature === lastSignature ? frozenCount + 1 : 0;
         lastSignature = signature;
         if (frozenCount >= WAIT_FROZEN_THRESHOLD) {
-          return { verdict: "return", result: frozenBacktestResult(parsed, data) };
+          return { verdict: "return", result: annotateBacktestOutcome(
+            BACKTEST_WAIT_POLL_IDENTITY,
+            frozenBacktestResult(parsed, data)
+          ) };
         }
         const progress = typeof data.progress === "number" && Number.isFinite(data.progress) ? data.progress : 0;
         return { verdict: "wait", progress };
@@ -27669,6 +27704,10 @@ function compactCliReceipt(tool, result, resultFile) {
       "available",
       "runtimeReady",
       "backtestReady",
+      "backtestOutcome",
+      "isTerminal",
+      "evidenceSource",
+      "failureCause",
       "nextAction",
       "recommendedAction",
       "error_code",