@zltquant/zlt-mcp 0.7.1-beta.1 → 0.7.2-beta.0

package/README.md

@@ -11,7 +11,7 @@ WorkBuddy 用户可从 SkillHub 安装 [zlt-quant Skill](https://skillhub.cn/ski
 
 ```powershell
 npx -y @zltquant/zlt-mcp list --json
-npx -y @zltquant/zlt-mcp call zlt-runtime-doctor --args-json '{}'
+npx -y @zltquant/zlt-mcp auth login --widget --json
 ```
 
 使用 `--help` 和 `call --help` 获取当前调用契约；`list --tool <工具名> --json`
@@ -67,6 +67,9 @@ ZLTQUANT_HOME 和 ZLTQUANT_CREDENTIALS 仍可指定凭据路径。原生 MCP 宿
 首次使用的网关尚未支持设备登录时，请从 https://api.zltquant.com/login 获取 Key，并由用户自己创建
 `%USERPROFILE%\.zltquant\credentials.json`（只填 `apiKey`）。
 
+每次独立业务调用都会重新读取本地凭据配置。未配置或配置损坏时，调用会在业务文件读取、
+runtime 启动和 IPC 前停止并给出登录或修复提示；该检查不联网，也不表示 Key 已远端验证。
+
 其他客户端无法使用 npx 时，也可以固定安装后用 node 启动 MCP 服务：
 
 ```powershell

package/config.json

@@ -895,7 +895,7 @@
     },
     {
       "name": "mcp-get-backtest-state",
-      "description": "查询回测运行状态与进度，是手动/兜底查询入口：适用于用户主动询问进度，或 mcp-wait 异常中断后复查。**等回测结束请用 mcp-wait（kind=backtest，id=runId），不要用本工具循环轮询。** 立即返回：只做一次查询，不会阻塞等待状态变化。status：0 准备中/1 运行中/2 失败/3 取消/4 终止/5 完成；status=5 前不要调用收益查询。显式 CLI call 或 MCP 重启后复查时，必须同时传启动/重跑响应返回的 codePath 和 attemptFence；它们只用于本地 result.json 对账，不会发给 IPC。\n\n兜底查询时未进终态的返回一定带 nextPollAfterMs，那是 wait 不可用时的节奏参考；终态不带该字段。数据准备阶段的进度取自磁盘 result.json，只要 download_update_time 仍在推进就视为有进展；durationSeconds 变化不算进展。若实际工作状态连续无变化但数据准备刚更新，返回 dataPrepInProgress=true；若数据准备也已停滞，返回 pollingStopped=true、stopAutoPolling=true 和 manualRecheckAfterMs，此时停止查询、约 1 分钟后手动再查一次。若磁盘 result.json 已确认属于当前 attemptFence 且数据准备或策略引擎启动失败，即使 IPC 仍报 status=1 或 status=4，也会返回 ErrNo 10043 和 resultJson 真实错误让你停止。",
+      "description": "查询回测运行状态与进度，是手动/兜底查询入口：适用于用户主动询问进度，或 mcp-wait 异常中断后复查。**等回测结束请用 mcp-wait（kind=backtest，id=runId），不要用本工具循环轮询。** 立即返回：只做一次查询，不会阻塞等待状态变化。status：0 准备中/1 运行中/2 失败/3 取消/4 终止/5 完成；status=5 前不要调用收益查询。显式 CLI call 或 MCP 重启后复查时，必须同时传启动/重跑响应返回的 codePath 和 attemptFence；它们只用于本地 result.json 对账，不会发给 IPC。\n\n非终态返回 nextPollAfterMs；请按该节奏查询，不循环快速调用。状态查询与 mcp-wait 都按约 3 分钟没有实质进展判断是否暂停：百分比、数据准备实际进度或模拟时间向前推进都算进展，普通日志增长、重复事件或单独时间戳刷新不算。executionProgress 在可验证时返回 simulationTime（北京模拟时间）、lastEventAt（带时区的真实事件时间）和 source=strategy-log，取自 codePath 下当前 runId、本次 attempt 的引擎事件；缺失表示没有足够证据，不能断言引擎停滞。数据准备完成后进入策略执行阶段，不要自行解释成预热，也不要把一次性能测量当成固定耗时。暂停查询仍可能是 status=1/isTerminal=false，不表示回测失败；真实失败和终态优先。若当前 attempt 的 result.json 证明数据准备或引擎启动失败，即使 IPC 仍报运行中，也返回 ErrNo 10043 和原始错误。",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -985,7 +985,7 @@
     },
     {
       "name": "mcp-get-backtest-entrust",
-      "description": "读取已完成回测的委托与拒单摘要，用于回测后验收；只能在 mcp-get-backtest-state 返回 status=5 后调用。直接读回测副本目录下的产物，不经过 ZLTAF。正常只传 runId，MCP 重启后上下文丢失时补传 codePath（取 mcp-create-and-run-backtest 返回的 codePath）。\n\n返回委托总数、买卖笔数、状态分布（9 全部成交/6 部分成交/3 废单）、有委托的交易日数、首末委托日期，以及从 strategy_user.log 分类统计的拒单原因——**拒单不会出现在 zlt_entrust.csv 里，只存在于日志中**（实测一次回测 CSV 的废单原因全为空，日志里有 2302 条）。anomalies 标出「零委托」「单边成交」「结构性下单失败」等必须解释的异常：`当前时间不允许申报市价单` 属结构性失败（全部委托被拒但回测仍以 status=5 正常结束）；`最大可购买数量低于最小申报数`、`账户资金不足`、`停牌中，停止交易` 属常见正常拒单。\n\n`engine` 是**策略引擎自己报告加载了什么**（取自本次回测 log/strategy.log 的 Mdf Setting）：dataRoot、markets、dataTypes。它是「其中一个消费者」的实况，不是全局唯一答案——`Temporary/logs/strategylog/<runId>/` 下还有另一条形状不同的 Mdf Setting，实测两者可以指向不同的根，排查数据类问题两处都要看。这是 mcp-get-data-range 的另一半：那边答「配置上应该有什么、磁盘上有没有文件」，这边答「引擎实际打开了什么」；回测报「本地数据不足」而覆盖检查却说 available 时先看这里，两者不一致就是环境问题不是策略问题。engine.available=false 只表示这次运行没留下 strategy.log，不代表引擎有问题。",
+      "description": "读取已完成回测的委托与拒单摘要，用于回测后验收；只能在 mcp-get-backtest-state 返回 status=5 后调用。直接读回测副本目录下的产物，不经过 ZLTAF。正常只传 runId，MCP 重启后上下文丢失时补传 codePath（取 mcp-create-and-run-backtest 返回的 codePath）。\n\n返回委托总数、买卖笔数、状态分布（9 全部成交/6 部分成交/3 废单）、有委托的交易日数、首末委托日期，以及从 strategy_user.log 分类统计的交易错误原因——**拒单不会出现在 zlt_entrust.csv 里，只存在于日志中**（实测一次回测 CSV 的废单原因全为空，日志里有 2302 条）。anomalies 标出「零委托」「单边成交」「结构性下单失败」等必须解释的异常：`当前时间不允许申报市价单` 属结构性失败（全部委托被拒但回测仍以 status=5 正常结束）；`最大可购买数量低于最小申报数`、`账户资金不足`、`停牌中，停止交易` 属常见正常拒单。\n\n`engine` 是**策略引擎自己报告加载了什么**（取自本次回测 log/strategy.log 的 Mdf Setting）：dataRoot、markets、dataTypes。它是「其中一个消费者」的实况，不是全局唯一答案——`Temporary/logs/strategylog/<runId>/` 下还有另一条形状不同的 Mdf Setting，实测两者可以指向不同的根，排查数据类问题两处都要看。这是 mcp-get-data-range 的另一半：那边答「配置上应该有什么、磁盘上有没有文件」，这边答「引擎实际打开了什么」；回测报「本地数据不足」而覆盖检查却说 available 时先看这里，两者不一致就是环境问题不是策略问题。engine.available=false 只表示这次运行没留下 strategy.log，不代表引擎有问题。\n\nrejections.total 和 byReason 统计错误日志条数，不是拒单笔数；一次平仓可能同时产生合约查询失败与平仓失败两条日志。期货合约资料查询失败、平仓委托失败会在 anomalies 中标明交易异常，必须解释，不能因为 status=5 就称策略交易有效。查询失败不自动等于合约到期，原因以日志证据为准。",
       "inputSchema": {
         "type": "object",
         "properties": {

package/package.json

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