智量通量化研究

概述

智量通量化业务

为任意兼容 Agent 提供一个入口。简单业务直接调用工具；策略构建、迁移、正式回测、分析与研究判断才按需读取下方 guide。只读查询回答当前问题后停止，不自动下载、创建策略或回测。

已有报告的最终回复

用户只要求打开已有报告、简要说明结果或数据时，程序简报就是完整答复正文。取到 result.cliReport.text（或记录中对应的程序简报字段）并展示原 HTML 后，按以下形式结束：

报告已打开。

<程序简报全文，逐字保留原段落与顺序>

占位行替换为实际简报，不输出占位符。只有宿主确认预览打开才写“报告已打开”；预览失败时改为实际交付状态，仍保留已取得的简报。不要添加“原样交付”等来源说明、标题、加粗、列表重排或自己的补充段落。简报已有结果、日期边界、缓存与新增、未知项及研究限制，不再从状态字段补写解释或建议。

“简要说明”“说明限制”属于上述交付，不是另作策略评价的请求。用户明确要求分析某项指标、评价策略或给出改进建议，或本次证据矛盾时，才按该问题定向取证并作答；不得仅凭策略名称、短区间、成交数或检查状态补推策略周期、有效性或唯一受限原因。

智量通平台业务入口

用户明确指定智量通、ZLT 或 ZLTAF，或当前任务已确认属于智量通时，使用本入口。用户指定其他量化框架时按该框架处理；框架不明确且会影响工具选择时先确认，不因机器上安装了智量通就接管所有量化任务。纯概念问答不调用平台。

WorkBuddy 的智量通业务通过本任务已选的智量通 CLI 调用 AF 或对应平台能力；CLI 负责连接与协议，Agent 不直接连接 AF、拼接 IPC/HTTP 请求或读取内部数据库替代平台查询。其他宿主保留已有原生 MCP 适配；不因本流程更换提供方、安装连接器或升级渠道。

平台对象和状态先从 CLI 的实际业务查询取得：策略、回测、数据覆盖、工作区、安装身份和业务路径以返回结果为准。已有本任务核实的结果直接复用；缺 schema 才定点发现，未知工具名才查目录。优先发当前问题的业务查询，不把 runtime-list、doctor、登录或安装检查变成每项任务的前置步骤；行情面板和 FinORM 继续按各自远端查询路径执行，不要求启动本地 AF。

本地文件用于读取或修改已定位对象：用户明确给出的文件、平台返回的路径、当前任务已核实的路径可以直接使用；编辑器路径只用于用户指定的源码任务。需要补路径时先查平台，不从 cwd、父目录、盘符、备份、其他框架目录或私有缓存猜安装和业务对象。文件读取限定在已确认的相关目录，不全盘搜索；平台无所需能力、未找到对象或存在多个工作区候选时，说明具体缺口并请用户选择或提供原路径，不自动换安装、创建或重跑任务。

WorkBuddy 的所有 shell 操作均使用 Windows PowerShell，包括文件和目录检查；调用 npm CLI 用 npx.cmd，整项任务不调用 Bash/WSL。

先处理当前阶段：新增独立环境只读 [新增 ClientLite 环境](references/host-adapters/guide.md#新增独立-clientlite-环境)，安装完成并选中新工作区后，再读取回测 runner；普通平台模板任务从模板列表和创建工具开始。创建结果的 localPath、docsPath 是源码与 SDK 文档路径来源。按下方任务路由逐份读取，不预读后续阶段的指南。

脚本阶段才按 [宿主适配](references/host-adapters/guide.md) 补尚缺的所选安装 pythonPath。已有路径和工具契约直接复用；CLI 返回本次运行终态后直接进入统一收尾。

执行边界

先按当前请求确定完成条件和允许产物：列表查询保留必要入参与 CLI 结果；已有报告交付使用已给出的可靠路径或已选 CLI 的报告结果；新回测才新增本次运行和权威收尾产物。完成后直接回复，不追加工作区记忆、日记、目录检查或审计摘要。

普通业务中，用户或本任务已核实 CLI 入口、输出能力、安装根和 Python 时直接复用；不运行输出探针、顶层 help、重复 call help、runtime-list 或路径存在性预检。确需定位本地对象且缺少工作区或安装身份时，按宿主适配做一次所需的只读查询；业务实际报错后才诊断。用户给出某份已完成 finalization 时，其中 delivery.text 已经是交付文本，不再读取同目录 delivery.txt 核对。

用户要求在回测运行中取消时，提交前按宿主实际工具 schema 确认原生后台执行及结果读取能力；单纯加长 timeout 会占住当前调用，不能替代后台。能力缺失时在提交前说明具体缺口，不先启动再等待超时。

宿主与路径契约

工具名以当前列表的裸名后缀匹配，参数与成功条件以实际 schema 和业务返回为准。宿主能力不是固定全集，因子工具仅在当前列表实际可见时使用；core 没有因子工具时说明缺口。

平台对象按根入口的“智量通平台业务入口”取得身份和路径；编辑器上下文只用于用户指定的源码任务。用户明确路径或 activeStrategy 提示优先，并验证本层 .vscode/tradesetting.json。存在 IDE 工具时，再按 active file、selection、多根 workspace 的顺序定位；只在任务相关范围查找，区分历史 backtest 运行副本和策略根。无 IDE 时只检查用户明确路径或已核实的相关目录；cwd 不自动等于策略，不从父目录、盘符或备份猜安装。多个或零个可靠候选时请用户选择或提供路径。具体工具及宿主流程见 [host-adapters](references/host-adapters/guide.md)。

插件的安装和鉴权由宿主处理。通用 setup 仅在当前工具实际存在且已有对应授权时执行；查询授权不包含安装或登录。

CLI 最短路径

WorkBuddy 沿用已选智量通 CLI，其他宿主沿用已选原生 MCP 或 CLI；同一任务保持同一个提供方和实际 CLI 版本。尊重用户指定的版本、渠道、registry 或已准备好的本地候选命令；未指定时复用现有 CLI，首次调用才使用默认稳定渠道。旧版不自动升级或猜传新参数；当前实际版本缺少所需能力时说明具体缺口。registry 是 npx 选项，放在包名前；cliProvenance 证明实际包版本，不证明下载源或本地候选字节身份。

调用语法是 call <工具裸名>；--tool 只用于定点 list --tool <工具裸名>。复用同版本已有的帮助或 cliUsage；首次输出能力未知时只读当前命令的帮助，call 与 list 的选项不能互推。下面两种命令只运行本次需要的一项，并替换为本任务已选入口：

npx.cmd -y @zltquant/zlt-mcp call --help
npx.cmd -y @zltquant/zlt-mcp list --help

确认当前 list 支持单文件后，定点 schema 示例：

npx.cmd -y @zltquant/zlt-mcp list --tool mcp-get-strategy-list --json --agent-output '<新的schema绝对文件路径>'

每次调用使用新文件或目录。已知结果路径直接 Read，不做存在性探针。单文件先 Read 前 60 行的 execution 和 decision（若提供），再按任务需要继续 Read 原 result：schema 在 result.tools[0].inputSchema，调用说明在 result.cliUsage，业务正文通常在 result.content[].text.parsedJson。旧版没有 decision 时直接定位同一 result 中的业务状态。较长内容用 Grep 定位后按范围 Read，不以转换程序或固定字符切片代替读取。

单文件模式自行保存完整结果、stderr 和真实退出码，直接执行 CLI，随后 exit $LASTEXITCODE，再 Read 文件；不重定向或合并 stdout/stderr，不另建日志。文件存在、宿主 exit 0 或 execution.completed 不是业务终态：按本次业务状态和 nextAction 决定等待、恢复或交付；已返回归属于本次运行的终态就直接收尾。saved=false、中断或状态未知时保留原结果并查原任务，不重发业务。npm/宿主启动失败可能没有 execution。

大结果按 schema 分页或选字段，乱码或截断的 schema 用已支持的文件输出补齐。没有可用输出方式或工具时，核对一次实际版本并报告能力缺口，由用户决定是否升级；不自动切 candidate/dev，不搜索源码、npm 缓存或凭据推断接口。stdout 可靠的宿主可沿用其方式。只保留后续消费的参数、结果和报告，不为单策略任务额外生成字段摘要、哈希、工作区记忆或审计清单。

策略清单用 mcp-get-strategy-list；某策略的回测历史用 mcp-get-backtest-list，两者不能混称。用户问代码版本历史时先核对当前工具是否支持，不把回测记录冒充代码历史。云端数据、本地覆盖与缓存差异分别按当前工具目录找到 mcp-get-cloud-data-list、mcp-get-data-range、mcp-get-cache-diff；只说明真实请求范围和结果中的未知部分。单项创建、下载、取消等动作按当前工具契约和用户授权执行，异步任务必须等到相应终态，不把提交回执当作成功。

数据范围从本次策略的实际标的、基准、频率和预热需求推导；市场、数据类型和日期的合法值仍按 schema。只在这个范围内查缺口、确认授权并下载，不照抄工具的多市场示例或默认组合。请求的日期和云端文件实际覆盖分别报告。当前 CLI 明确支持下载的等待与验证组合流程时优先复用它，检查其终态和覆盖证据；结果已给出充分证据就不再单独等待、查空间或查覆盖，证据缺失、未知或矛盾时再按 nextAction 补查。

列表回答只报告真实返回字段及其直接支持的数量、分组等汇总，备注与标签须逐项对应原记录。名称相似只能称“名称相似”，不能据此认定代码相同或重复草稿；名称简短、备注为空不证明策略废弃、无效或应删除。备注描述的策略逻辑注明来自备注，不当作已核对源码。用户未要求比较实现时不扩展为代码审阅、清理或合并建议；已要求比较但列表证据不足时，按该任务读取所需源码或历史证据，再下结论。

行情面板

纯 Skill＋CLI 可以展示行情面板，不要求用户安装或启用 MCP 连接器。个股、大盘、龙头分别使用已知工具 show_stock_panel、show_market_panel、show_leader_panel；只调用当前问题需要的一项，不为找它们搜索宿主连接器。参数缺失时定点读取所选 CLI 的 schema，复用 cliUsage；保持用户指定的本地候选或渠道，不切回旧 npm 包。

当前 CLI 的帮助或 cliUsage.output.panelOutput 明确支持时，调用所选工具并同时传新的 --agent-output 结果路径与 --panel-output HTML 路径。有参数时沿用 args-file；执行后先 Read 结果开头的 execution 和 result.cliPanel，确认 execution.exitCode=0 且 result.cliPanel.state=completed，再将 result.cliPanel.path 的原文件交给宿主预览（WorkBuddy 用 present_files），不要让 Agent 另写 HTML、图表或临时渲染脚本。仅要求展示面板时，最终只给预览、各面板数据时间和必要限制，不复述排行、指标、CLI 校验或产物清单；需要解释市场原因时才读取相关数据，并区分事实与推测。未知字段和覆盖限制保留；每个工具要求原样保留的免责声明逐条保留，相同文本只写一次，不因合并交付删掉“延迟”等限定。cliPanel.state=failed 时报告其错误，不交付成功路径，也不为渲染失败重复业务查询。

独立页面是本次查询的本地快照，标签和图表可交互，但不会重新取数；用户要求更新时，用新结果路径和新 HTML 路径再次查询。不要把旧快照刷新页面说成行情已更新，也不要承诺 MCP App 的实时刷新、下钻或宿主回调。CLI 不支持面板输出时说明具体版本缺口，保留已经取得的结果，不擅自安装连接器或切换提供方。仅查询行情不查本地 runtime、不启动回测、不要求 ClientLite 安装。

FinORM 只读数据查询

用户查询财务数据、金融数据库、数据分类、表或字段时，使用当前提供方的 FinORM 工具；例如“有哪些财务数据表”“某张表有哪些字段”“查询某公司最近一期财务数据”。这条远端查询路径复用智量通登录，不要求安装 ClientLite、查找本地 Python、启动 ZLTHome/ZLTAF 或读取 SDK 文档；不索取或读取 FinORM sharedKey、FINORM_KEY、凭据文件或 .env，不直连 REST 旁路。只有实际认证失败时才按真实 nextAction 进入已授权的智量通登录恢复；现有登录仍有效时直接业务查询。

已知六个工具裸名为 finorm_list_categories、finorm_list_tables、finorm_describe_table、finorm_get_query_spec、finorm_validate_query、finorm_run_query。保持本任务选定的 npm 版本或渠道和 CLI 输出方式；只补缺失工具的 schema，不列完整目录或改用本地 Node、wrapper、bundle。当前版本没有所需工具时报告该能力缺口，遵守用户的版本选择，不自动换渠道。

按问题选择最短路径：分类查询用 finorm_list_categories；找表用 finorm_list_tables；字段问题用 finorm_describe_table。实际取数先确定返回的表标识，读取 finorm_describe_table 和 finorm_get_query_spec，按当前返回的字段、查询 DSL 和约束构造最小请求，再用 finorm_run_query 执行；该工具会先验证再查询，需要单独检查或修正 DSL 时用 finorm_validate_query。只查分类、表或字段时到该步结束，不额外取数。已经取得且仍适用的 schema 和表定义直接复用，不凭示例猜表名、列名、过滤条件、SQL 或 REST 请求结构。

回答保留原始返回的单位、时间口径、未知值、截断提示与 data_version；元数据未提供就明确缺失，不猜单位、不把空值改成零、不把截断样本当作全量，也不将无记录等同于数值为零。查询范围按用户问题确定；需要缩小、分页或扩大范围时按实际 query-spec 和返回限制处理。验证失败先按实际错误修正；网络、权限或服务失败按原错误报告，不解释成没有数据，不进入本地 runtime 安装恢复。

按需工作流

平台模板到报告的正常路径：按需发现并调用 mcp-strategy-get-template-list → mcp-create-strategy-with-template → 读取新策略源码和配置 → 仅核对实际所需的数据 → mcp-create-and-run-backtest → 统一收尾 → 读取 finalization 并展示 HTML。这些工具名已知，不为寻找它们列完整目录；参数缺失时分别定点发现。创建前需要核对同名策略才调用策略列表；其余阶段不重复查询环境或身份。

以下路径指向普通文档，直接读取 guide.md，无需调用子 Skill 工具。SDK/API 问题先读取 [zlt-api-reference](references/zlt-api-reference/guide.md)，再按它定位当前 wheel 文档，不从环境变量或用户目录开始搜索。每份 guide 的 guide.md 所在的能力目录 是其 scripts/、assets/、references/ 的路径锚点。

已有结果或报告缺少路径时，先走[已有回测与报告定位](references/host-adapters/guide.md#已有回测与报告定位)：已选 CLI 实际支持 report 时，一次调用 report <RN-id> --include-data --agent-output <new absolute file> 完成查找和中文简报；用户未问数据时省略 --include-data，已有工作区或安装绑定时携带相应身份参数。不先读回测 runner，不根据回测 ID 猜目录，也不先列策略或回测。能力以实际帮助或已测试的授权本地候选为准；公开 npm 0.8.2 没有该命令，不自动升级或切换渠道。

成功后用 result.cliReport.path 展示原 HTML，按“已有报告的最终回复”交付 result.cliReport.text 并结束；不通过 Python、Node 或 Skill 脚本重建简报，不追加列表查询。cliReport.state: completed 表示报告查找完成；回测、交易检查和研究结论分别保留其 executionStatus、tradingStatus、researchStatus，不能由报告可用推断。命令存在但查询失败时保留真实错误；只有实际缺少 report 时才走宿主适配中的旧版有限查询和旧记录简报兼容路径。

用户仅要求交付已有报告，且已给出该次 finalization.json 时，直接 Read 它并展示 outputs 中的 HTML。“简要说明结果、数据范围、缓存与限制”仍是报告交付，不转入完整分析或源码审阅。结果使用 delivery.brief_text；用户问数据时，使用包含日期、缓存和新增说明的 delivery.brief_with_data_text。旧记录没有所需简报字段时，已选 CLI 支持 report 则使用上述一次调用；只有命令确实不存在时，才按宿主适配的只读 Python 简报命令生成。不重跑回测、不更新旧记录或重新生成 HTML。中文简报是程序核对已有证据后生成的完整交付文本，按“已有报告的最终回复”保留全文。信息足够就停止，不为扩写再读 compact、delivery.txt、日志、源码或行情，不重复收尾。

启动正式回测前读取 runner guide 的准备与提交部分；取得运行响应后按其终态分支继续，报告选项与交付到收尾阶段再读。沿用 runner 的适用源码检查、终态后置门禁与 finalize_backtest.py，其中管理 backtest_summary.py --compact 和 report_html.py；失败或取消同样保留收尾结果。等待中断时复用原 runId，不重新发起。

新回测与已有报告都展示原 HTML 并交付程序生成的中文简报；已有报告的 report 调用成功后直接使用 CLI 结果，不额外读取结果记录。实际读取 delivery、outputs、trading、research 和 execution.status；状态原值留在记录中，不把完成运行说成研究已通过。用户问下载范围、体量时，选择带数据说明的简报；程序只使用本次保存的数据证据，不替 Agent 自动下载或补查询。请求日期不冒充实际读取日期，缓存与新增压缩数据分别报告；未计量的网络总流量明确写“未计量”。

面向中文用户的交付

默认回答当前问题：报告入口、必要结果、用户问到的数据情况及影响使用的限制。精确任务 ID、原始字段、文件路径和审计细节保留在报告或结果记录；用户排障或索取时再展示。技术标识可在工具输入和证据中保留，普通答复不用英文状态、JSON 字段或流程术语解释业务。

用户明确要求解释状态时，以下用语只说明对应检查的结论，不作为已有报告回复的附加段落：

• research.blocked 表达为“研究结论暂受限”，说明记录中的具体原因；确属缺证据时写“研究证据尚不完整”。

不用该状态改写回测是否完成，也不把数据冲突或异常淡化为缺少说明。

• trading.passed 仅表示“交易记录检查通过”，不扩大为交易记录完全无误、策略有效或研究通过。
• finalization 通常无需提及；需要说明来源时称“回测结果记录”。
• 缺失值按实际原因写“未计量”“尚未确认”或“未提供”，不直接展示 null，也不把未知改为零。

程序简报保留日期边界、缓存／新增区别、单位及未计量项；不由 Agent 再自由整理或扩写。默认不把各任务载荷相加，避免用户将算术和误读为去重总下载量；大表和逐字节证据放在报告中。只陈述证据支持的结论：请求配置不等于历史生效值，当前源码不等于运行快照，缓存计数相同不证明文件身份相同。没有实现证据时，不补充引擎是否消费某配置的判断。

失败恢复

正常业务不先运行 doctor、auth status 或 setup 放行。CLI 不可用、网络、权限或运行时错误要保留真实退出码与 stderr；只有业务调用返回认证或 runtime 问题，才按其 nextAction 读取接入或 runtime guide 恢复，并保留原任务。不得从数据库、内部缓存、客户端工程或其他身份路径伪造平台查询。安装与登录属于单独的用户授权边界；已有回测或下载可能生效时不盲目重发。宿主安全拒绝时报告未执行的步骤，不换入口绕过。