@zltquant/zlt-mcp 0.6.1-beta.7 → 0.6.1-beta.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -4
- package/config.json +1 -1
- package/package.json +1 -1
- package/zlt-mcp-proxy.bundle.cjs +944 -538
package/README.md
CHANGED
|
@@ -14,10 +14,12 @@ npx -y @zltquant/zlt-mcp list --json
|
|
|
14
14
|
npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
使用 `--help` 和 `call --help` 获取当前调用契约；`list --tool
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
17
|
+
使用 `--help` 和 `call --help` 获取当前调用契约；`list --tool <工具名> --json`
|
|
18
|
+
返回单个工具的完整 schema、CLI 用法、可由 schema 明确值构造的参数示例，以及必要的跨工具参数引用。
|
|
19
|
+
示例无法覆盖必填业务值时会明确标成不可执行模板，不会猜测市场、策略 ID 或路径。未知工具名返回非零退出码。
|
|
20
|
+
简单查询直接输出；复杂配置用 `--args-file`。保留独立 stderr 和 CLI 原始退出码，调用结束后再解析结果。
|
|
21
|
+
Skill 负责工作流，不维护第二份接口契约。
|
|
22
|
+
能力随包版本分发；使用前以当前安装版本的 `--help`、单工具查询和实际证据目录回读为准。
|
|
21
23
|
|
|
22
24
|
业务调用支持 `call --output-json <新文件路径>`：完整 JSON 写入文件，stdout 返回含
|
|
23
25
|
`ok`、`tool`、`resultFile`、`cliProvenance`、精简 `data` 的回执。
|
|
@@ -25,6 +27,16 @@ npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
|
|
|
25
27
|
stderr 保留诊断，失败返回非零退出码。工具执行后若写文件失败，完整结果会输出到 stdout；先核对结果，不要自动重复执行。
|
|
26
28
|
不传该参数时保持原有完整 stdout。
|
|
27
29
|
|
|
30
|
+
需要一次调用的可审计证据时使用 `call/list --evidence-dir <新目录>`。目录的父目录必须存在，
|
|
31
|
+
目标目录必须是新目录，且不能与 `--output-json` 同时使用。CLI 会实时保留 stderr，并在目录中写入
|
|
32
|
+
`diagnostics.log` 与 `execution.json`。`result.json` 保存完整响应；call 在执行前预留该文件，list 在取得目录后写入。只有完整响应成功写入后结果文件才可解析；
|
|
33
|
+
文件存在不证明已收到响应，断连或写盘失败可能留下空文件或部分内容。参数校验失败时结果文件可能不存在。
|
|
34
|
+
执行记录区分
|
|
35
|
+
`running/completed/failed`、`not_started/unknown/response_received`、业务
|
|
36
|
+
`success/error/not_reported` 和 CLI 自身退出码。强制结束进程可能只留下 `running + unknown`；
|
|
37
|
+
CLI 启动前的 npm 或父 shell 失败不在证据范围内。记录不包含原始 argv 或凭据。
|
|
38
|
+
证据模式以 `execution.json` 为状态依据，不靠追加 `echo`、管道解析器或父 shell 状态推断。
|
|
39
|
+
|
|
28
40
|
回测可按当前工具 schema 传基线路径与覆盖：新建用 `strategyPath`（策略根 localPath），
|
|
29
41
|
重跑用 `codePath`（所选 runId 的运行目录）。MCP 先读配置并校验身份，再合并覆盖、补默认值，
|
|
30
42
|
沿原有 IPC 链提交完整参数。策略根是工作区/调试配置，正式 RUN 不保证更新根目录；运行目录用于该次结果对账。
|
package/config.json
CHANGED
|
@@ -416,7 +416,7 @@
|
|
|
416
416
|
},
|
|
417
417
|
{
|
|
418
418
|
"name": "mcp-get-cache-diff",
|
|
419
|
-
"description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction、assessment、evidence 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed
|
|
419
|
+
"description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction、assessment、evidence 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed 的文件同样要整份重下，所以补齐已返回缺口的下载量是 missingBytes 与 changedBytes 两者之和**；向用户报体量时必须相加，只报 missingBytes 会少算。nextAction=plan-download 只表示返回的有效 series 中发现缺口；cachediff 是差异结果，不是云端目录，未返回的 series 状态未知。evidence.requestCoverage=unverified 表示上游没有证明响应覆盖调用方的完整请求范围。report-unknown 时停止作请求级结论；不要靠扩大日期、无界重试或承诺重新下载即可一致来补造覆盖证据。本工具需要云端枚举，开销相当于一次下载的列举阶段，不要在轮询循环里反复调用。",
|
|
420
420
|
"inputSchema": {
|
|
421
421
|
"type": "object",
|
|
422
422
|
"properties": {
|