@zltquant/zlt-mcp 0.7.4 → 0.7.6

package/config.json

@@ -1077,7 +1077,7 @@
     },
     {
       "name": "mcp-get-strategy-list",
-      "description": "查询本地策略列表（只展示 templateVal=strategy 的数据），返回策略ID、名称、类型、本地路径等。treeId 是策略分类（folder）ID：默认 1（用户策略默认所在文件夹）；传其他值只查该分类；传 0 则跨所有分类聚合并按 strategyId 去重（ZLTAF 原生 treeId=0 查不到数据，聚合由 MCP 实现）。status 固定为 0，必须显式传入。",
+      "description": "查询本地策略列表（只展示 templateVal=strategy 的数据），默认只返回定位字段，其他字段用 fields 点名（见 disclosure.availableFields）。treeId 是策略分类（folder）ID：默认 1（用户策略默认所在文件夹）；传其他值只查该分类；传 0 则跨所有分类聚合并按 strategyId 去重（ZLTAF 原生 treeId=0 查不到数据，聚合由 MCP 实现）。status 固定为 0，必须显式传入。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1118,7 +1118,7 @@
               "type": "string",
               "maxLength": 128
             },
-            "description": "代理层按需保留的顶层字段名，不发送给上游；省略时保留原字段。"
+            "description": "代理层按需保留的顶层字段名，不发送给上游；省略时只返回默认五个字段，传入则完全按所列字段返回。"
           }
         },
         "required": [
@@ -1132,7 +1132,7 @@
     },
     {
       "name": "mcp-get-backtest-list",
-      "description": "查询指定策略ID数组对应的回测列表，返回回测ID、名称、回测周期、回测状态与回测时间——**不要展示收益相关的信息**。pageSize 与 runType 是固定值，必须显式传入，不要依赖 default 自动补值。",
+      "description": "查询指定策略ID数组对应的回测列表——**不要展示收益相关的信息**。默认只返回定位字段（code 即 codePath），其他字段用 fields 点名（见 disclosure.availableFields）。pageSize 与 runType 必须显式传入，不要依赖 default 自动补值。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -1152,11 +1152,10 @@
           },
           "pageSize": {
             "type": "integer",
-            "enum": [
-              100
-            ],
-            "default": 100,
-            "description": "每页数量，固定为 100，必须显式传入。不要依赖 default 自动补值。"
+            "minimum": 1,
+            "maximum": 50,
+            "default": 20,
+            "description": "每页数量，传 20；最大 50，超出按 50 处理。必须显式传入，不要依赖 default 自动补值。"
           },
           "runType": {
             "type": "integer",
@@ -1165,6 +1164,15 @@
             ],
             "default": 2,
             "description": "回测运行类型，固定为 2，必须显式传入。不要依赖 default 自动补值。"
+          },
+          "fields": {
+            "type": "array",
+            "maxItems": 50,
+            "items": {
+              "type": "string",
+              "maxLength": 128
+            },
+            "description": "代理层按需保留的顶层字段名，不发送给上游；省略时只返回默认八个字段，传入则完全按所列字段返回。"
           }
         },
         "required": [

package/package.json

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

package/zlt-mcp-proxy.bundle.cjs

@@ -10687,6 +10687,7 @@ var CliEvidence = class {
   teeWrite;
   constructor(directory, provenance, command) {
     const root2 = path.resolve(directory);
+    fs.mkdirSync(path.dirname(root2), { recursive: true });
     fs.mkdirSync(root2);
     this.resultFile = path.join(root2, "result.json");
     this.readableFile = path.join(root2, "result.readable.txt");
@@ -24642,6 +24643,49 @@ var MAX_FIELDS = 50;
 var MAX_FIELD_NAME_BYTES = 128;
 var MAX_UNKNOWN_FIELDS = 50;
 var MAX_OMITTED_FIELDS = 100;
+var DEFAULT_FIELDS = {
+  "mcp-get-strategy-list": ["strategyId", "strategyName", "localPath", "tags", "updateTime"],
+  "mcp-get-backtest-list": ["runId", "runName", "strategyId", "status", "startTime", "endTime", "errorMsg", "code"]
+};
+var FIELD_PROJECTION_TOOLS = /* @__PURE__ */ new Set(["mcp-get-backtest-list"]);
+function selectFields(toolName, args, source) {
+  const requestedFields = Array.isArray(args.fields) ? [...new Set(args.fields.filter((field) => typeof field === "string"))].slice(0, MAX_FIELDS).map((field) => field.slice(0, MAX_FIELD_NAME_BYTES)) : [];
+  const allAvailableFields = [...new Set(source.flatMap((row) => isRecord4(row) ? Object.keys(row) : []))];
+  const defaultFields = requestedFields.length ? [] : (DEFAULT_FIELDS[toolName] ?? []).filter((field) => allAvailableFields.includes(field));
+  const fields = requestedFields.length ? requestedFields : defaultFields;
+  const unknownFields = requestedFields.filter((field) => !allAvailableFields.includes(field));
+  return { requestedFields, allAvailableFields, defaultFields, fields, unknownFields };
+}
+function project(row, fields) {
+  return isRecord4(row) && fields.length ? Object.fromEntries(Object.entries(row).filter(([key]) => fields.includes(key))) : row;
+}
+function shapeFieldProjection(tool, args, result) {
+  if (!FIELD_PROJECTION_TOOLS.has(tool.name) || result.isError) return result;
+  try {
+    const envelope = JSON.parse(result.content[0]?.text ?? "");
+    if (!isRecord4(envelope) || envelope.disclosure || Number(envelope.ErrNo ?? 0) !== 0) return result;
+    if (!Array.isArray(envelope.Data)) return result;
+    const { requestedFields, allAvailableFields, defaultFields, fields, unknownFields } = selectFields(tool.name, args, envelope.Data);
+    const pageNum = integer2(args.pageNum, 1, 1, Number.MAX_SAFE_INTEGER);
+    const pageSize = integer2(args.pageSize, 0, 0, Number.MAX_SAFE_INTEGER);
+    const pagingIgnored = pageSize > 0 && envelope.Data.length > pageSize;
+    const fullPage = pageSize > 0 && envelope.Data.length === pageSize;
+    const disclosure = {
+      pageNum,
+      pageSize,
+      returned: envelope.Data.length,
+      possiblyMore: fullPage,
+      nextPageNum: fullPage ? pageNum + 1 : null,
+      ...pagingIgnored ? { pagingIgnored: true } : {},
+      availableFields: allAvailableFields.slice(0, MAX_FIELDS),
+      ...defaultFields.length ? { defaultFields } : {},
+      ...requestedFields.length && unknownFields.length ? { unknownFields: unknownFields.slice(0, MAX_UNKNOWN_FIELDS) } : {}
+    };
+    return replace(envelope, envelope.Data.map((row) => project(row, fields)), disclosure, result);
+  } catch {
+    return result;
+  }
+}
 function shapeListResultDisclosure(tool, args, result) {
   if (!LIST_DISCLOSURE_TOOLS.has(tool.name) || result.isError) return result;
   try {
@@ -24651,8 +24695,7 @@ function shapeListResultDisclosure(tool, args, result) {
     const source = envelope.Data;
     const offset = integer2(args.offset, 0, 0, Number.MAX_SAFE_INTEGER);
     const limit = integer2(args.limit, 20, 1, 50);
-    const fields = Array.isArray(args.fields) ? [...new Set(args.fields.filter((field) => typeof field === "string"))].slice(0, MAX_FIELDS).map((field) => field.slice(0, MAX_FIELD_NAME_BYTES)) : [];
-    const allAvailableFields = [...new Set(source.flatMap((row) => isRecord4(row) ? Object.keys(row) : []))];
+    const { requestedFields, allAvailableFields, defaultFields, fields, unknownFields } = selectFields(tool.name, args, source);
     const availableFields = allAvailableFields.slice(0, MAX_FIELDS).map((field) => field.slice(0, MAX_FIELD_NAME_BYTES));
     const rows = [];
     let nextCursor = offset;
@@ -24665,13 +24708,11 @@ function shapeListResultDisclosure(tool, args, result) {
         hasMore: nextCursor < source.length,
         nextOffset: nextCursor < source.length ? nextCursor : null,
         availableFields,
-        ...fields.length ? (() => {
-          const unknownFields = fields.filter((field) => !allAvailableFields.includes(field));
-          return {
-            unknownFields: unknownFields.slice(0, MAX_UNKNOWN_FIELDS).map((field) => field.slice(0, MAX_FIELD_NAME_BYTES)),
-            ...unknownFields.length > MAX_UNKNOWN_FIELDS ? { unknownFieldsTruncated: true } : {}
-          };
-        })() : {},
+        ...defaultFields.length ? { defaultFields } : {},
+        ...requestedFields.length ? {
+          unknownFields: unknownFields.slice(0, MAX_UNKNOWN_FIELDS).map((field) => field.slice(0, MAX_FIELD_NAME_BYTES)),
+          ...unknownFields.length > MAX_UNKNOWN_FIELDS ? { unknownFieldsTruncated: true } : {}
+        } : {},
         ...allAvailableFields.length > availableFields.length ? { availableFieldsTruncated: true } : {},
         ...omittedFields.length ? {
           omittedFields: omittedFields.slice(0, MAX_OMITTED_FIELDS).map((entry) => ({ ...entry, field: entry.field.slice(0, MAX_FIELD_NAME_BYTES) })),
@@ -25366,6 +25407,9 @@ function stripControlParams(args, toolName) {
     delete filtered.limit;
     delete filtered.fields;
   }
+  if (toolName && FIELD_PROJECTION_TOOLS.has(toolName)) {
+    delete filtered.fields;
+  }
   if (toolName && DATA_DISCLOSURE_TOOLS.has(toolName)) {
     delete filtered.offset;
     delete filtered.limit;
@@ -27387,7 +27431,7 @@ function prepareToolArgs(tool, args, contexts) {
   const oversizedWindow = refuseOversizedBacktestPreloadWindow(tool, dated);
   if (oversizedWindow) return oversizedWindow;
   const named = normalizeBacktestRunName(tool, dated);
-  const prepared = stripEmptyLegacyUserId(tool, named);
+  const prepared = clampBacktestListPageSize(tool, stripEmptyLegacyUserId(tool, named));
   const refused = refuseMaskedFuturesBacktest(tool, prepared);
   if (refused) return refused;
   capturePendingBacktestAttempt(tool, prepared, contexts);
@@ -27477,7 +27521,11 @@ function shapeToolResult(tool, args, result, session) {
   const diagnosed = tool.name === "mcp-factor-calculate-detail" ? diagnoseFactorFailure(withWorkspace) : withWorkspace;
   const distilled = distillFactorDetectReport(tool, args, diagnosed);
   const enriched = injectDebugRunId(tool, injectStrategyDocsHint(tool, distilled, session.docsPath));
-  return shapeDataResultDisclosure(tool, args, shapeListResultDisclosure(tool, args, enriched));
+  return shapeFieldProjection(
+    tool,
+    args,
+    shapeDataResultDisclosure(tool, args, shapeListResultDisclosure(tool, args, enriched))
+  );
 }
 function backtestStatusNumber(status) {
   return typeof status === "number" || typeof status === "string" && status.trim() !== "" ? Number(status) : NaN;
@@ -27717,6 +27765,13 @@ function subtractMonthsClamped(value, months) {
   target.setDate(Math.min(day, lastDay));
   return target;
 }
+var MAX_BACKTEST_LIST_PAGE_SIZE = 50;
+function clampBacktestListPageSize(tool, args) {
+  if (tool.name !== "mcp-get-backtest-list") return args;
+  const pageSize = args.pageSize;
+  if (typeof pageSize !== "number" || !Number.isFinite(pageSize) || pageSize <= MAX_BACKTEST_LIST_PAGE_SIZE) return args;
+  return { ...args, pageSize: MAX_BACKTEST_LIST_PAGE_SIZE };
+}
 function stripEmptyLegacyUserId(tool, args) {
   if (!toolHasUserIdField(tool)) return args;
   if (!Object.prototype.hasOwnProperty.call(args, "userId")) return args;