@zltquant/zlt-mcp 0.6.1-beta.8 → 0.6.1-beta.9

package/README.md

@@ -14,10 +14,12 @@ npx -y @zltquant/zlt-mcp list --json
 npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
 ```
 
-使用 `--help` 和 `call --help` 获取当前调用契约；`list --tool mcp-wait --json`
-只查询一个工具的完整 schema，未知名字返回非零退出码。简单查询直接输出，无参数可省略参数选项；
-复杂配置用 `--args-file`，大结果或下游证据才使用结果文件。保留独立 stderr 和 CLI 原始退出码，
-调用成功后再解析结果，不通过管道隐藏失败。Skill 负责工作流，不维护第二份接口契约。
+使用 `--help` 和 `call --help` 获取当前调用契约；`list --tool <工具名> --json`
+返回单个工具的完整 schema、CLI 用法、可由 schema 明确值构造的参数示例，以及必要的跨工具参数引用。
+示例无法覆盖必填业务值时会明确标成不可执行模板，不会猜测市场、策略 ID 或路径。未知工具名返回非零退出码。
+简单查询直接输出；复杂配置用 `--args-file`。保留独立 stderr 和 CLI 原始退出码，调用结束后再解析结果。
+Skill 负责工作流，不维护第二份接口契约。
+能力随包版本分发；使用前以当前安装版本的 `--help`、单工具查询和实际证据目录回读为准。
 
 业务调用支持 `call --output-json <新文件路径>`：完整 JSON 写入文件，stdout 返回含
 `ok`、`tool`、`resultFile`、`cliProvenance`、精简 `data` 的回执。
@@ -25,6 +27,16 @@ npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
 stderr 保留诊断，失败返回非零退出码。工具执行后若写文件失败，完整结果会输出到 stdout；先核对结果，不要自动重复执行。
 不传该参数时保持原有完整 stdout。
 
+需要一次调用的可审计证据时使用 `call/list --evidence-dir <新目录>`。目录的父目录必须存在，
+目标目录必须是新目录，且不能与 `--output-json` 同时使用。CLI 会实时保留 stderr，并在目录中写入
+`diagnostics.log` 与 `execution.json`。`result.json` 保存完整响应；call 在执行前预留该文件，list 在取得目录后写入。只有完整响应成功写入后结果文件才可解析；
+文件存在不证明已收到响应，断连或写盘失败可能留下空文件或部分内容。参数校验失败时结果文件可能不存在。
+执行记录区分
+`running/completed/failed`、`not_started/unknown/response_received`、业务
+`success/error/not_reported` 和 CLI 自身退出码。强制结束进程可能只留下 `running + unknown`；
+CLI 启动前的 npm 或父 shell 失败不在证据范围内。记录不包含原始 argv 或凭据。
+证据模式以 `execution.json` 为状态依据，不靠追加 `echo`、管道解析器或父 shell 状态推断。
+
 回测可按当前工具 schema 传基线路径与覆盖：新建用 `strategyPath`（策略根 localPath），
 重跑用 `codePath`（所选 runId 的运行目录）。MCP 先读配置并校验身份，再合并覆盖、补默认值，
 沿原有 IPC 链提交完整参数。策略根是工作区/调试配置，正式 RUN 不保证更新根目录；运行目录用于该次结果对账。

package/package.json

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