@zltquant/zlt-mcp 0.6.1-beta.6 → 0.6.1-beta.7

package/config.json

@@ -416,7 +416,7 @@
     },
     {
       "name": "mcp-get-cache-diff",
-      "description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed 的文件同样要整份重下，所以补齐全部缺口的下载量是 missingBytes 与 changedBytes 两者之和**；向用户报体量时必须相加，只报 missingBytes 会少算。nextAction=up-to-date 表示本地已经齐了。本工具需要云端枚举，开销相当于一次下载的列举阶段，不要在轮询循环里反复调用。",
+      "description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction、assessment、evidence 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed 的文件同样要整份重下，所以补齐全部缺口的下载量是 missingBytes 与 changedBytes 两者之和**；向用户报体量时必须相加，只报 missingBytes 会少算。nextAction=plan-download 只表示返回的有效 series 中发现缺口；report-unknown 表示上游响应没有提供足够的全请求覆盖证据，不能据此声称本地已经齐了，须同时说明 assessment 和 evidence。本工具需要云端枚举，开销相当于一次下载的列举阶段，不要在轮询循环里反复调用。",
       "inputSchema": {
         "type": "object",
         "properties": {

package/package.json

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

package/zlt-mcp-proxy.bundle.cjs

@@ -26171,17 +26171,30 @@ function toCacheDiffWindows(value) {
   }
   return unionDataRangeIntervals(intervals).map(([startDate, endDate]) => ({ startDate, endDate }));
 }
+function hasInvalidCacheDiffWindow(value) {
+  return value.some((item) => !isRecord2(item) || !compactDataRangeDate(item.begin ?? item.start) || !compactDataRangeDate(item.end));
+}
 function formatCacheDiffResult(rawResult) {
   if (!isRecord2(rawResult)) return rawResult;
-  if (isRecord2(rawResult.Data) && rawResult.Data.resultKind === CACHE_DIFF_RESULT_KIND) return rawResult;
+  if (isRecord2(rawResult.Data) && rawResult.Data.resultKind === CACHE_DIFF_RESULT_KIND && typeof rawResult.Data.assessment === "string" && isRecord2(rawResult.Data.evidence)) return rawResult;
   const { Data: upstream, ...envelope } = rawResult;
   const payload = isRecord2(upstream) ? upstream : {};
+  const hasResultsField = Object.prototype.hasOwnProperty.call(payload, "results");
   const results = Array.isArray(payload.results) ? payload.results : [];
+  const resultsShape = !hasResultsField ? "missing" : !Array.isArray(payload.results) ? "invalid" : results.length === 0 ? "empty" : "array";
   const series = [];
+  let uncertainSeries = 0;
   for (const item of results) {
-    if (!isRecord2(item)) continue;
-    const token = splitDataTypeToken(typeof item.data_type === "string" ? item.data_type : "");
+    if (!isRecord2(item) || typeof item.data_type !== "string" || item.data_type.length === 0) continue;
+    const differenceFields = ["missing", "changed", "files"];
+    const presentFields = differenceFields.filter((field) => Object.prototype.hasOwnProperty.call(item, field));
+    if (presentFields.length === 0 || presentFields.some((field) => !Array.isArray(item[field]))) continue;
+    const token = splitDataTypeToken(item.data_type);
+    const missing = Array.isArray(item.missing) ? item.missing : [];
+    const changed = Array.isArray(item.changed) ? item.changed : [];
     const files = Array.isArray(item.files) ? item.files : [];
+    const hasUnusableMember = hasInvalidCacheDiffWindow(missing) || hasInvalidCacheDiffWindow(changed) || files.some((file) => !isRecord2(file) || file.state !== "missing" && file.state !== "changed");
+    if (hasUnusableMember) uncertainSeries += 1;
     let missingFiles = 0;
     let changedFiles = 0;
     let missingBytes = 0;
@@ -26200,8 +26213,8 @@ function formatCacheDiffResult(rawResult) {
       market: describeDataRangeMarket(item.exchange_id, MARKET_ID_TO_NAME, MARKET_CODE_TO_NAME),
       datatype: DATATYPE_TO_NAME[token.family] || token.family || "\u672A\u77E5\u9891\u7387",
       sectype: describeDataRangeSecurityClass(void 0, token.securityClass, SECTYPE_TO_NAME),
-      missing: toCacheDiffWindows(item.missing),
-      changed: toCacheDiffWindows(item.changed),
+      missing: toCacheDiffWindows(missing),
+      changed: toCacheDiffWindows(changed),
       missingFiles,
       changedFiles,
       missingBytes,
@@ -26210,12 +26223,24 @@ function formatCacheDiffResult(rawResult) {
   }
   const errNo = Number(rawResult.ErrNo);
   const upstreamFailed = Number.isFinite(errNo) && errNo !== 0;
-  const hasWork = series.some((s) => s.missing.length > 0 || s.changed.length > 0);
+  const hasWork = series.some((s) => s.missing.length > 0 || s.changed.length > 0 || s.missingFiles > 0 || s.changedFiles > 0);
+  const rejectedSeries = results.length - series.length;
+  const partialResult = resultsShape === "array" && (rejectedSeries > 0 || uncertainSeries > 0);
+  const assessment = upstreamFailed ? "upstream-error" : partialResult ? "partial-result" : resultsShape !== "array" ? "indeterminate-result" : hasWork ? "differences-found" : "no-differences-in-returned-series";
+  const nextAction = upstreamFailed ? "report-error" : partialResult || resultsShape !== "array" || !hasWork ? "report-unknown" : "plan-download";
   return {
     ...envelope,
     Data: {
       series: upstreamFailed ? [] : series,
-      nextAction: upstreamFailed ? "report-error" : hasWork ? "plan-download" : "up-to-date",
+      nextAction,
+      assessment,
+      evidence: {
+        resultsShape,
+        resultCount: results.length,
+        interpretedSeries: series.length,
+        rejectedSeries,
+        uncertainSeries
+      },
       resultKind: CACHE_DIFF_RESULT_KIND
     }
   };