EdgeDepth Research

EdgeDepth Research MCP Server

@edgedepth/research-mcp 是 EdgeDepth 官方的、仅用于研究的 Model Context Protocol 服务。EdgeDepth 是一款针对已记录的 Binance USDT-M 加密货币永续合约的市场微观结构搜索引擎。你可以在 ChatGPT、Claude、Cursor、Codex 或任何 MCP 客户端中使用它，查找每个经过验证的市场条件实例，检查完整匹配集中的后续结果，读取同范围的无条件参考数据，并打开带有回放链接的证据。

每个结果都包含带分母的计数和一个可复现性密钥。密钥相同，字节内容相同。

网站 · 搜索市场 · REST API 文档 · MCP 设置指南 · 学习中心

为什么使用 EdgeDepth Research？

• 搜索已记录的市场微观结构： 查询一个封闭且有版本管理的特征注册表，涵盖订单流、订单簿深度和交易成本、采集来源、价格走势、波动率、资金费率、未平仓量、持仓、K 线形态、清算和清算区间。
• 保留分母： 每个计数都会报告符合条件的总体及其排除项。缺失数据会保持缺失，绝不会被悄悄改为零。
• 衡量结果，不使用前视选择： 前向收益、MFE 和 MAE 均基于所有实例计算。结果字段不能用作筛选条件。
• 比较匹配总体与基线总体： 确定性分组结果会将匹配分布与其他所有符合条件、谓词为假的分组并列展示。
• 审计并回放证据： 结果附带可复现性密钥，代表性实例则包含经过身份验证的网页跳转，可直达精确的已记录市场时刻。
• 仅用于研究： 没有任何工具会进行交易、修改提醒或发布报告。私有 Radar 管理员试点版可使用单独的可选 research:hypotheses 权限，保存归账户所有的假设。新扫描、分组或分层计算可能会消耗研究额度单位；注释会明确说明这一副作用。

选择连接方式

该软件包通过两种传输方式提供同一套工具核心：

• 托管 MCP（推荐）： 通过 Streamable HTTP 连接到 https://mcp.edgedepth.com/mcp，并在浏览器中完成一次授权。无需复制 API 密钥。
• 本地 stdio： 使用 EdgeDepth API 密钥运行 npx -y @edgedepth/research-mcp。

连接

Claude Desktop

在 Settings > Connectors > Add custom connector 中输入：

https://mcp.edgedepth.com/mcp

按照提示完成 EdgeDepth 浏览器授权。

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "edgedepth-research": {
      "url": "https://mcp.edgedepth.com/mcp"
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.edgedepth]
url = "https://mcp.edgedepth.com/mcp"

然后运行：

codex mcp login edgedepth

使用浏览器 OAuth 前，请删除所有旧的 bearer_token_env_var 行。

使用 npx 运行本地 stdio

在 EdgeDepth Developer 页面创建密钥，然后添加：

{
  "mcpServers": {
    "edgedepth-research": {
      "command": "npx",
      "args": ["-y", "@edgedepth/research-mcp"],
      "env": {
        "EDGEDEPTH_API_KEY": "edk_live_YOUR_KEY"
      }
    }
  }
}

本地 stdio 需要 Node.js 20 或更高版本。对于已记录数据工具，请使用 research:read 密钥范围；仅当需要免费的 interpret_prose 提案步骤时，才添加 research:interpret。

结果投影（Agent 上下文节省）

扫描类结果很大：一次全域扫描的规范字节数可达数百 KB，其中大部分是包含所有已记录特征的页面行、counts_by_symbol 中的零值和长尾条目，以及空的阈值档位。这会在客户端回答任何问题之前就超出其工具结果预算。

因此，run_scan、next_page 和 run_cohort 默认返回明确说明的投影。显示衍生结果和移除内容时，会准确说明如何恢复详细信息。默认情况下，run_scan 会附加下文所述的精简文本视图；full_outcomes: true、next_page 和 run_cohort 则保留此详细投影：

• 出现记录会裁剪至 rows（默认值为 3），且每条保留的记录都会保留其自身 evidence 块中列出的设置字段——full_rows: true 可恢复完整向量；
• 每次出现对应的 outcomes 映射会保留剩余记录对应的条目；
• counts_by_symbol 会保留匹配数最高的条目，并说明省略了多少个标的和匹配项；
• 结果阶梯会替换为配对答案块：对于每项指标，原样保留 present、absent 和所选档位的整数计数，并在旁边列出 rate、针对相同标的和时间窗口计算的无条件 baseline_rate，以及两者的比值 lift。档位预先固定（gte 0.01、gte 0.02、lte -0.01、lte -0.02），会移除没有区分度的档位，并在出现次数至少为 30 的档位中，额外添加 lift 最高的单个档位，并以 kept_for 标记。full_outcomes: true 会返回所有档位及逐档直方图，分别针对匹配集和参照集计算。

总体计数、结果分母、缺席计数、predicate_coverage、代表项、页面游标和可复现性密钥均保持不变。请求文档绝不会被重写，因此规范查询哈希和扣除的额度与您请求的完全一致。full_counts: true 会返回引擎原样生成的规范字节，不进行任何投影。ETag 的作用范围限定于投影：某个投影对应的 ETag 绝不会验证为另一个投影。

list_features 也可按需采用相同处理：search、feature_ids 和 compact 只返回一个特征族，而非整个语法，同时保留封闭部分（运算符、时间窗口、序列规则、限制、错误代码）。

提示词和资源

服务器提供了示例提示词，兼容的客户端会将其显示为可选命令：test_a_claim、liquidation_cascade_bounce、investigate_symbol、what_preceded_moves_like_this、does_it_confirm 和 how_common_is_it（免费普遍性查询路径）。每个提示词都遵循相同的答案约定：以语法为依据，提出精确定义，等待确认，然后提供带有分母、参照、可复现性密钥和重放交接信息的报告。

语法注册表也作为资源提供，地址为 edgedepth://research/grammar，客户端可以附加一次，而不必每个会话都调用 list_features。

推荐的 Agent 工作流

1. 对于优先设置的问题，在宿主端解读文字，并调用 prepare_study，传入结构化范围、谓词和结果。它会复用 Web 验证器和度量契约，验证当前工具的成员资格，并返回尚未运行的规范定义和最新额度估算。不会使用外部 LLM。分别保留 user_stated、semantic_translation（前 10% 表示排名 >= 0.9）和 model_assumed；只有最后一项表示自行提出的假设。将 interpret_prose 原样用作原始文字的备用方案。对于不常见字段或修复验证问题，请使用精简的 list_features，而非每次提问都使用它。
2. 仅在需要检查由清单推导出的范围、覆盖情况和来源时调用 list_instruments。对于仍在记录的市场，其结果会以同样方式附带面向用户的市场页面 https://edgedepth.com/research/symbols/<symbol>；范围内已退市的市场没有页面，因此应提供该链接，而不是承诺能查到页面。
3. 提出一份简短方案：条件、准确的市场和日期/时区、结果定义和时间范围，以及计量方式。解读不收费；新的计算可能消耗额度。使用标签来源信息，将所有未提供的值标记为建议假设。解决不受支持的片段，只询问会实质改变研究的问题。准确的 JSON 和诊断信息应可在工具详情中查看，也可按需提供。
4. 等待用户明确批准，然后将同一份文档传给 run_scan。如有更改，必须重新提出方案并确认。精确文档 API 不会存储方案 ID 或人工批准回执；客户端必须获得同意，模型提供的标志不构成证明。在支持该功能的 Web 版本（b68c744 或更高版本）中，返回的 rq 工作台链接会加载可编辑方案并等待用户点击 Run；导航本身不会授权计算。
5. 首先回答问题，并保留零匹配和结论不确定的发现。提供匹配/符合条件的数量、覆盖范围排除项、结果出现与未出现情况、约定时间范围内的两个方向，以及重叠/选择方面的限制。从 outcomes_summary 读取发生率，该汇总涵盖所有出现情况。页面行只是示例，不能作为分母。每个层级都附有其匹配数量和发生率、无条件发生率，以及二者的比值 lift：应引用这些数值，并在引用发生率时同时给出数量。没有 lift 表示没有可用的参照值，或无条件发生率为零；这两种情况都不能据此估算 lift。
6. 如有附加的同范围无条件参照，请一并查看。它并非匹配结果、可比较数据或因果对照。
7. 在回答中提供完整的可复现性密钥，并给出一项相关的后续操作：返回的重放、更改后的假设，或现有报告。通用的已保存研究和提醒仍需通过 Web 操作；私有 Radar 假设使用下方可选工作流。每次交接都要说明其回溯时间范围；重放可触及的时间范围取决于每个账户的权限，因此即使某个历史时刻确实发生过，Web 界面也可能拒绝访问。仅将 API 返回的游标用于 next_page。

MCP 客户端的示例指令：

Did elevated VPIN and one-sided buying tend to precede a rise? Propose a precise
study before running anything. Label any suggested thresholds, markets, dates
and outcome definition so I can approve or change them.

用户无需了解工具名称、功能 ID 或 JSON。客户端会将 已确认的方案转换为现有的精确文档调用。

结果优先与明确移动幅度工作流

对于结果优先的问题，在商定目标和范围后，使用 outcome_first。保留期间内触及（reached）与收盘时接近（finished）的区别、方向、幅度和时间范围。不要将结果传递给设置解读器，也不要用已演示的示例替代。目标语法见 edgedepth://research/outcome-first。

报告每种展示读法的总体数量和两个占比。请对方选择一种读法，在未更改的请求上以 full_rows: true 检索其 setup_first_rerun，并在 run_scan 前确认该确切设置。将原始目标作为未更改文档之外的 run_scan.measure 传入：触及用 kind: "touch"，收盘用 kind: "close"，并附上商定的方向、分数形式的幅度和时间范围。返回的工作台链接会保留该展示选择，并保持为未运行的草稿。这不会改变扫描／缓存键。以下本地选定结果扩展会单独保留确切读法，与收盘回报探索区分开来。 从完整匹配集摘要中读取原始结果目标；如果投影中省略了其档位，则请求 full_outcomes。若某个档位不可用，应明确说明，不得用默认时间范围替代。两次读取的分母不同。 同一时期的重新运行仍属探索；在声称验证前，应冻结条件并使用单独的时期。

可使用 snapshot_at 检查指定时刻；commonality 用于比较多个提供的时刻。以下截图路径增加了有界的明确收盘区间调查以及现有的检测器几何信息。MCP 不提供自动移动幅度选择。历史标记浏览和通用成交量等级解析目前也不是 MCP 功能。以下本地 resolve_scope 扩展会在其 Web 版本发布后提供明确的行业解析。list_instruments 提供覆盖范围和标的来源信息，而非行业成员资格。有记录的行业成员资格可用时，请使用 resolve_scope；否则请使用准确提供的名单；切勿臆造群组成员或数值价格。回放交接会打开 Web 界面，仍受对方的覆盖范围和使用权限限制。

工具

工具	功能说明
list_features	返回封闭的语法注册表：特征 ID、类型、范围、运算符、窗口、序列规则、限制和错误代码。可通过 search、feature_ids 和 compact 缩小范围。
list_instruments	返回研究范围及覆盖情况。默认返回精简摘要；使用 symbols: [...] 获取所选标的的完整记录，或使用 full: true 获取逐字的规范化完整范围。
prepare_study	免费提供确定性的结构化准备、溯源信息和额度估算。需先发布 Web 版 /prepare。
interpret_prose	将自然语言转换为拟议的查询文档。不会执行查询。可选参数 time_zone 接受 IANA 时区，用于日历规划。
run_scan	执行 research_query.v2 文档，并返回结果字节、计数、分母、结果、无条件同范围参考值和可复现性密钥。默认返回投影结果（rows、full_rows、full_counts）。
next_page	使用不透明游标继续之前的扫描。切勿手动构造游标。
ground_screenshots	将主机提取的截图坐标与记录的 K 线收盘价及覆盖情况进行匹配，同时保留不确定性并对事件视图去重。免费。
investigate_move	读取已匹配事件的既有前序走势和可选的已记录检测器几何信息，并可选择准备精确的未运行设置文档。免费读取；适用历史数据权限。
snapshot_at	读取指定记录时刻的注册表特征值、窗口聚合值和触发的规则。
base_rate	统计一个子句在某个窗口内的匹配次数和符合条件的桶数。
commonality	查找多个时刻之间的确定性交集，并附带选择偏差注意事项。
get_report	根据 8 位字符的规范哈希值获取已发布的报告。
run_cohort	对比每次匹配后发生的情况，以及每个其他符合条件但谓词为假的桶后发生的情况。
run_stratified	在既有锚点处，将一个匹配群体划分为拆分为真、拆分为假和拆分缺失三组，并汇总结果。
outcome_first	从走势而非设置入手：指定一种结果（幅度、方向、时间跨度），并报告每次实现了类似走势之前五个固定偏移时点的记录表现。每行包含两个已计数的占比：这些走势之前的占比，以及同一范围内每个符合条件的分钟所占的比例；此外还包括设置优先的重新运行结果，用相反顺序再次检验。此工具仅用于描述性读取，绝不用于搜索规则：行不是规则、候选项或发现，行的顺序仅用于显示。若某个范围内已实现的走势数量不足，将拒绝执行并提供计数及四项调整建议；拒绝执行不消耗额度。默认返回投影结果（rows、full_rows）。

没有任何工具可以交易、改变市场状态或发布内容。只有私有假设工具会修改账户研究历史记录，且需要单独授权。run_scan、run_cohort、run_stratified 和 outcome_first 被标注为计量计算，因为新的调用可能不可逆地消耗一个额度单位。其他读取记录数据的工具仅在封闭世界内读取。interpret_prose 是免费读取工具，会使用已配置的外部语言解释器。

私有 Radar 假设工作流（本地新增）

需要配套的 Web 版本、可选的 API 密钥范围迁移，以及 Radar 管理员访问权限。Web 版本先于 MCP。现有授权和密钥不会获得任何新权限；请同时申请 research:hypotheses 和 research:read 并授权新的授权项，或在创建密钥时明确选择假设选项。普通账户仍会被拒绝访问。这不是公开发布，也不代表托管服务已获认可。

• get_hypothesis：获取原始观察（event）、已保存记录（id），或获取你的列表（两者都不提供）。full: true 会恢复所有回执正文。读取操作不会运行任何任务。
• prepare_hypothesis：生成精确的可编辑草稿、四项请求、修订版本、计划哈希和额度估算。这不代表已保存、已计算或已获批准。
• save_hypothesis：在已知修订版本上明确保存为私有记录；现有来源和尝试记录保持不可变。保存测试、保留或拒绝结果时，不要丢弃失败记录。
• run_hypothesis：在人工批准确切提案后，冻结全部四项请求并运行第一项。使用返回的续接令牌，按顺序在同一批准下运行其余请求。令牌不存在时即停止。发生不确定的超时后，读取已保存的历史记录；运行中或状态未知的任务绝不重试。

Web 和 MCP 共用一份账户历史记录。计数来自原生的完整结果汇总。A+B 为主要结果；A/B 是针对同一输入合格总体（包括匹配项）的诊断结果。样本可能包含支持和矛盾案例，但绝不用于提供分母。一个 Binance USDT 永续合约，六个受支持的数值字段；后端发布后，总体还支持原生的每日价格/OI 交叉筛选。结果指标为四小时内的 +5% 最大有利波动（MFE），不计成本/成交。开发期最多 31 天，与预留评估期之间间隔七个完整日期；锚点结束日期不晚于 2026 年 9 月 11 日。绝不运行预留评估。

服务端会保留定义、失败记录、响应字节、HTTP/额度标头和可复现性密钥。默认输出仅展示示例并省略原始回执，同时说明如何恢复。导入的浏览器证据会继续标记为由调用方提供。存储和并发错误会阻止后续工作；重新打开记录绝不会触发计算。现有计量规则保持不变：每次 API 计算都可能消耗额度，缓存结果免费；会话 UI 沿用现有的总体扫描计量规则。

研究契约

• 验证失败会原样传递为 422 {"errors":[{"code":"...","message":"..."}]}。
• 传输失败使用 {"error","code"} 信封。
• 契约代码可供机器执行操作。对于 UNSUPPORTED_FEATURE 或 OUTCOME_IN_PREDICATE 等错误，请调用 list_features，修正文档后重试。
• 确定性工具要求提供精确文档，且仅支持 UTC。interpret_prose 可以使用时区来规划日期，但 run_scan、run_cohort 和 base_rate 绝不会重新解释日历用语。
• 重新运行和 ETag 304 Not Modified 重新验证均免费。list_instruments 的 ETag 作用域取决于请求的是摘要、符号投影还是完整表示。
• 解析免费，绝不会扣减扫描额度。扫描额度不可用时，会返回中性的 402 RESEARCH_ALLOWANCE_EXHAUSTED 元数据，不附带结账链接。

REST API 和文档

MCP 服务是 EdgeDepth Research 公共 API 的轻量、确定性接口：

• REST API 快速入门
• 身份验证和 API 密钥
• 额度、缓存和限制
• 版本化查询语法
• 可复现性约定
• API 示例详解
• MCP 连接指南
• EdgeDepth Research 的工作原理
• 你可以提出哪些问题

stdio 软件包使用的默认 REST 基础 URL 为 https://app.edgedepth.com/api/v1/research。

环境变量

本地 stdio

变量	默认值	用途
EDGEDEPTH_API_KEY	无	调用 stdio 工具时必需。
EDGEDEPTH_API_BASE	https://app.edgedepth.com/api/v1/research	可选的 REST API 基础 URL 覆盖值。

托管服务运营者

变量	默认值	用途
EDGEDEPTH_OAUTH_EXCHANGE_URL	http://127.0.0.1:3002/api/mcp/oauth/exchange	OAuth 访问令牌交换端点。
MCP_INTERNAL_SECRET	无	必需的内部断言密钥；必须与 Web 应用匹配。
PORT	3003	HTTP 监听端口。
HOST	127.0.0.1	HTTP 监听主机。

身份验证与安全

托管服务使用浏览器 OAuth。它会验证不透明访问令牌，将其交换为独立的短期内部断言，并且绝不会将 OAuth 访问令牌传递给 REST API。MCP 服务是无状态的，不会存储用户凭据。

兼容的客户端会在连接保持活动状态期间静默轮换刷新令牌。可在 EdgeDepth 已连接应用中查看或撤销访问权限。

脚本、本地 stdio 以及不支持浏览器 OAuth 的 MCP 客户端仍可使用 API 密钥。请将 edk_live_... 密钥视为机密，切勿将其提交到源代码管理中。

开发

npm install
npm run build
npm test
npm run typecheck

TypeScript 会构建到 dist/。nginx 配置示例、systemd 加固配置和运营者环境变量值位于 deploy/ 下。生产环境部署和 npm 发布仍由运营者负责。

相关项目

• edgedepth-terminal（AGPL）：开源的 C++/WASM 订单流终端。研究结果中与回放关联的证据会在其中打开对应的精确记录市场时刻，并且只需运行一条 docker compose 命令即可自托管。
• edgedepth-gateway（MIT）：一个 Go 桥接程序，可将 Binance 的公共数据流转换为终端的线缆格式，以便在无账户的情况下使用实时数据运行终端。

许可证

MIT

行内扫描证据

支持 MCP Apps 的宿主可以显示来自 run_scan 的比较卡片和记录分布卡片。卡片仅接收工具结果 _meta 中的完整结果前向回报摘要、覆盖范围、精确查询/键和计量数据。在 ChatGPT 中，这些数据对模型不可见；现有文本投影保持不变。生成分布时不会使用原始页面观测，不会虚构拟合曲线，切换图表视图也不会产生额外请求或消耗额度。仅当参考分布的分箱边界对齐时才进行比较。空箱、开放尾部、缺失结果以及零条/一条观测的状态都会保留并显示。时间范围和变动幅度控件只是对已计算结果的显示选项，不会改变已批准的查询。卡片默认显示所述结果；如果没有指定结果，则优先选择 24h，并在可用时选择至少有 30 次出现记录且带有标注的探索性变动幅度。精确的研究/证据详情可在卡片内展开；纯文本宿主会收到精简的扫描响应。HTML 资源没有网络依赖，也不会修改数据。这是一次开发者连接器更新，并非自动执行的官方 V1 重新扫描。

基于截图的调查（本地实现；需要发布）

将图表附加到支持视觉能力的宿主，并使用 investigate_screenshots。宿主读取图像；服务通过 ground_screenshots 接收 screenshot_observation.v1 事实。契约为 edgedepth://research/screenshots。不会使用第二个图像模型，也不会自动访问附件。

所有已认证层级均可免费进行定位。它会根据已记录的 Binance 期货 K 线和清单边界，检查明确的分钟收盘边界，保留可见/推断/用户提供/缺失等来源信息，并对完全相同的事件视图去重。日期或时区不明确、边界为推断值、坐标冲突以及示例重叠时，都需要进行一次澄清。不会设定默认日期、替换交易场所或搜索附近的变动。不会匹配影线的逐笔时序和不受支持的绘图。

investigate_move 会重新检查事件，并复用 Web 端的五个前置偏移量、已记录的检测器证据和设置组合构建器。它不会消耗额度；历史快照仍受现有权益限制。可选的精确研究范围和目标回报会生成未运行的 setup_first_rerun 文档、额度估算和可编辑工作台链接。默认响应会省略重复的源快照和检测器 K 线柱；设置 full_sources: true 可恢复完整字节数据。所有读取值、精确设置文档、来源元数据、缺口和一致性均可检查；免费重新读取可能会看到更新的版本。总体数量和前向回报率仍需使用现有的 outcome_first 或 run_scan，且须先提出具体方案并获得明确的人类批准。精确目标与设置谓词保持分离。选出的获胜示例和同一时期的重新运行仍属于探索性质；验证前请使用单独的时期。回放覆盖范围和权益与研究历史相互独立。

发布这些 MCP 工具前，请先部署 Web 端的 /api/v1/research/investigate/ground、/investigate 和 /evidence 路由。Web 工作台 b68c744 会将 rq 加载为可编辑方案，并等待用户点击 Run。请勿将新的方案链接用于较旧的版本，因为这些版本会在收到链接时立即执行。历史标记和命名集合的 MCP 一致性仍是独立工作。返回的估算针对每个准备好的设置，并非通用报价端点。

本地确定性测试使用固定数据测试提取出的观测和已认证处理器。这些测试不代表图像模型或视觉宿主的验收测试。声称上传到调查的端到端流程可用前，请在实际的视觉宿主中执行 test/screenshot-host-acceptance.md 中的测试用例。

Release 0.8.0

新增了明确的截图定位和移动调查功能，默认使用精简来源投影；需要完整证据时可设置 full_sources: true。 主机读取图像；MCP 验证结构化观察结果和精确记录的坐标。遇到歧义时会请求澄清，而不是臆造移动。

额度耗尽后，已保存的扫描、队列、比较和结果优先研究仍可读取。Web 使用专用的引擎缓存读取路由；缺少结果时无法启动新的计算。缓存与版本绑定，并可能被清除，因此这并不保证结果会永久保存。常规回放访问权限取决于记录日期、市场和套餐；研究链接不会授予事件访问权限。

主机准备和精简报告（本地；需要发布）

prepare_study 接受范围（标的、带偏移的 from/to、来源信息）、设置（字段/运算符/值/来源信息）和结果（触及/完成、方向、分数幅度、时限、来源信息）。来源元数据与哈希查询分开保存。截图锚点必须清晰可见，或由用户提供；不确定的时间需要澄清。先通过 snapshot_at 检索 EdgeDepth 读数。定性规则在用户批准提案前仍标记为 model_assumed。服务端会验证主机声明，但无法核实主机实际看到了什么。

get_report 默认提供注明固定 1h 概览，其中包含来源计数和已存储的完整性状态。它不会声称重新验证固定值。full:true 会恢复完整的已存储字节，包括所有结果和定义。此选择不是已保存的请求测量。公开报告仍可免费读取。

先部署 Web，再部署 MCP。确定性本地测试不代表生产环境延迟或视觉主机兼容性。

研究流程连续性（本地；需要发布）

在此 MCP 版本之前部署 Web /api/v1/research/scope。resolve_scope 使用已记录的行业标签，并采用与 Web「先看走势」入口相同的解析器，同时筛选为已确认的 Binance 加密货币线性永续合约。它会返回精确的标的名单和各市场历史数据；总体缺失、有歧义、过于稀疏或规模过大时，都会保持阻止状态。不会自动扩大范围。成员资格依据当前记录的分类，而非特定时点的成员资格；历史数据也不能证明特征完整。

run_scan.measure 现在会在规范字节旁新增 selected_outcome.v1，其中包含精确选定的总体计数、相反方向和无条件参考值。零计数仍会显示，分母为零时不提供比率，绝不会替换不可用的指标或梯级。内嵌视图会优先展示相同读数，并在精确的测量结果上展开时限和走势幅度控件。其直方图始终标注收盘回报；路径阶梯则单独标注 MFE/MAE 触及情况。现有报告保留其固定且注明的概览。

相似度表示在注明的维度上进行探索性接近度分析。监控要求精确满足有版本记录且受支持的谓词，而非历史数值完全相同。发现的阈值必须标记为 proposed，并在单独时段评估前冻结，同时披露任何调参情况。不新增从相似度转换为警报的功能、交易规则评估器或自动化前向测试就绪度判定。保存和监控通过私密 Web 交接和明确确认进行。警报报告的是条件是否满足，而不是重复预测。

可选交易规则测试（0.9.0，托管版待发布）

仅在单独提出明确方案并获得人工批准后，才能使用 run_trade_test。 它会将确切的记录总体与 trade_query.v1 中的所有 trade_rules.v1 参数以及字符串值的 source_measurement 来源信息封装在一起。默认方案： 1% 止损、无固定目标、按收盘价追踪的 2% 移动止损、240 分钟 K 线、6 个基点 手续费和每侧 10 个基点滑点，并在退出前跳过同一市场的信号。明确选择做多或做空。 这些是可编辑的假设，并非最优参数。限制为 31 天、100 个明确指定的市场和 5,000 个信号。

入场价为下一分钟开盘价。跳空止损按更差的开盘价成交；若止损和目标价在同一根 K 线内触发，则以止损为准。移动止损根据已完成的收盘价更新，并从下一根 K 线开始生效。缺失的开盘价或价格 K 线视为不可用；不以先前收盘价替代。时间桶结束时间是区间标签，并非精确的成交时间戳。

从完整交易摘要中读取获胜次数、亏损次数、平均盈利/亏损和期望值，切勿从 MFE 或分页行中读取。收益包含手续费和滑点，但不含资金费用和其他执行成本；因此并非完全净收益或投资组合收益。在 source_measurement 中保留原始问题、selected_measure JSON、测量版本、查询哈希、数据集修订版本和来源调查。网页保存和下载会保留结果。警报仍是独立的设置重复项。

后端和网页版本必须先于 MCP 发布。没有开盘价列的旧时段会返回 TRADE_OPENS_UNAVAILABLE，不执行计算或扣费。新架构的行仍可能缺失，并会逐条计数。不允许通过托管版发布进行 npm/registry 发布。

交易结果默认显示完整摘要和按时间顺序排列的前十条日志示例。full_trades:true 会恢复所有规范字节。不同显示模式使用特定于投影的 ETag，因此不能跨模式重新验证；两种模式都不会改变规则、完整结果计数、可复现性键或计算费用。

两种模式都会先显示盈亏摘要：扣除手续费和滑点后的期望值、获胜和亏损次数、平均盈利和平均亏损及其计数、获胜和亏损合计、最大单笔盈利占盈利总额的比例、按原因分类的退出次数、不可用和跳过的计数，以及排除项（资金费用；持仓时间不超过 1440 分钟）。最大单笔盈利占比和退出次数取自裁剪行数前的完整日志；若该日志无法复现引擎的获胜和亏损计数，则省略这些数据，绝不估算。无需网络的盈亏视图（ui://edgedepth/trade-payoff-v1.html）会显示相同信息：结论、成对的盈亏条、规则和排除项。

已存储的调查证据（本地，待发布）

get_investigation_bundle 通过与网页相同的 API 读取现有的 SHA256 bundle ID。精简输出保留确切的事件/截至时间范围、来源凭证、指标、确定性观察、矛盾证据和缺失的分析；full: true 会恢复固定的输入观察。不会调用模型、执行扫描、扣减额度或发布内容。缺失的可比总体仍视为不可用；如有需要，使用现有的精确研究审批流程。必须先配置后端和网页读取器，并明确审核相关产物，之后此工具才能读取 bundle；此更改不会启用发布任务。

单交易场所 Hyperliquid 研究（2026-09-15，本地）

首个跨交易场所复刻切片在 API v1 全市场读取中加入 exchange=hl，并在 MCP list_instruments 中加入 exchange: "hl"。省略时仍使用 Binance。精确记录文档通过 ["identity.exchange", "eq", "hl"] 选择 HL，并使用 btc 等小写记录 ID。每份文档只允许一个交易场所；请对经过验证、特征覆盖范围重叠的内容分别运行配对定义。Binance 的规范哈希、默认范围和结果字节保持不变。

日线/合并读取、查询/基线/群组/普遍性/分层/交易封装器、页面设置水合和修订检查均遵循所选交易场所。缺失的特征仍保持缺失。清单未确认的 HL 元数据仍属未知。此切片不支持 HL 实时监控和回放/工作台交接。结果优先、快照、文本准备、命名范围和 UI 交易场所选择仍是独立关卡；不要根据记录验证推断这些环节也支持 HL。

交付顺序为后端、Web API/验证器，然后是 MCP。未进行源数据提取、数据集提升、采集变更或生产发布。本地 BTC 9 月 12 日证明和后续工作负责人信息，位于任务中心的规范文件 tasks/research-cross-venue-replication.md 和 outputs/cross-venue-20260915/。

研究小组件（本地可用，托管版本待发布）

run_scan、run_cohort 和 run_stratified 共用一个无需网络的小组件。将 prepare_study.summary 原样传入可选的 study_summary，放在精确查询文档之外。较旧的调用方会收到忠实呈现子句和范围的标题。标题保留所述结果、发生次数和扫描的符号。

可选的 measure 用于设置类型、方向、幅度和时间范围。若未设置，小组件会在有数据时从 24h 开始，并选择至少有 30 次发生、且任一方向的收盘回报幅度最大且超过 1% 的档位。若没有符合条件的档位，则显示分布并请读者选择一次变动。此显示选择并非显著性证据。所有控件均读取已完成结果的字节。

「结果一览」部分首先用通俗语言说明精确选定结果的次数、观测分母和比率。若有可用数据，则报告缺失结果以及与精确参考值之间的百分点差异；否则说明无法比较的原因。触及类结果会保留警告：两个方向都可能发生，且先后顺序未知；这是描述性证据，并非成功或置信度评分。若未指定结果，摘要会显示两个收盘方向，并标注此视图为探索性分析。

更改时间范围或变动幅度后，摘要会标注为探索性分析。恢复到所述结果会还原这两个控件，且不会发起请求。分层摘要会注明当前查看的组。措辞根据已完成的计数确定，不会调用新模型或执行引擎计算。

默认视图是结论、「是否存在优势？」框和一张图：针对所选变动幅度，将形态出现后各方向的发生情况与通常比率（参考值）并列，以同一刻度显示为成对的条形，并标出精确计数。界面避免使用 MFE、提升幅度和参考值等术语。文字形式的计数、两个方向及其提升幅度、直方图和路径阶梯均收纳在同一个折叠的「详情」披露区中。

直方图保留所有已记录的区间。悬停、聚焦或轻触时，会以薄荷色高亮一个区间，并在图表下方的读数区域显示其精确计数和比率。图表只有一个 Tab 停靠点；按左/右键可逐个切换区间，按 Home/End 可跳至两端。也可以选择空区间，且不会发起请求。所有计数仍可在可展开的表格中查看。对齐的参考值会叠加显示；紧凑的 MFE/MAE 阶梯使用相同的时间范围。若缺少参考值，会显示原因；仅当两项精确比率均可用且参考比率不为零时，才显示提升幅度。队列会准确标注谓词为 false 的对照项；分层视图会保留全部三个组，包括缺失分组读数的情况，且不会虚构参考值。

被拒绝的文档会单独显示其 HTTP 状态、代码和消息，不会与未提供图表证据的宿主混为一谈。引擎、research_query.v2、规范字节、投影、身份验证或计费行为均不变。版本发布以及 Claude 宿主的实际验收仍待 James 批准。

精简扫描文本（本地，需发布）

默认的 run_scan 文本首先呈现约定的结果、两个方向、计数总体和局限性。它会显示确切的约定结果和相反方向（未指定时，探索性档位为 24h），并保留所有时间范围的存在／缺失计数。前三个匹配市场和一条示例行仍会显示（rows 可请求更多）；两者都不是分母。

较长的参考范围名单也会附带带标签的回执。较长的字符串 in 列表会转换为明确不可执行的 query_preview 回执，包含计数、按排序列表计算的 UTF-8 JSON 的 SHA256（保留重复项），以及排序后的前五个值。重复的行证据会引用同一个列表哈希。示例结果会保留显示的时间范围，包括其分桶存在计数。UTC 每日匹配计数会汇总为月度总和，并附上首个／最后一个匹配日和峰值日（并列时取最早日期）。匹配日期并非有效的特征可用时间窗口；此响应不包含谓词的首个数据日期。

超过 2,000 个字符的精确工作台 URL 会在精简文本中明确省略。不承诺提供仅含哈希的 URL 或持久化定义查询。原始的已批准工具输入保持精确不变；full_counts: true 会恢复规范结果、完整定义、每日计数和完整交接内容。full_outcomes: true 会恢复详细结果视图。小组件保留完整证据。引擎请求、规范哈希、计量或基线预算均不会改变。文本格式和时间范围的变更具有不同的投影 ETag。在此范围受限的后续更新中，群组、分层和续接文本保留现有投影。

对一次变动的已保存解读（2026-10-03，本地）

get_investigation_assessment({id, edition?}) 会读取现有的已发布评估，该评估用于调查页面和频道草稿。发布 ID 来自 /research/investigate/publication/<id> 链接。它不同于 get_investigation_bundle 接受的 SHA256 包 ID。结果会保留精确的市场、时间窗口／截至时间、模式、证据引用、缺口、比较可用性和版本。固定版本发生变化时会返回 409；证据已更正时会返回 410。请停止并重新打开该发布内容；切勿将其他版本静默应用于原问题。不会公开私有草稿。此读取使用 research:read，不消耗研究额度，也不会生成评估或调用模型。宿主可以解读其证据，同时保留不确定性；引用的测量结果并不能证明因果关系。请先部署 Web /api/v1/research/investigation-assessment 读取器，再使用此工具。

私有策略研究（本地扩展，待发布）

研究订阅用户可以使用与 Web 端 /research/strategies 工作区相同的版本化长基线、持久化和执行研究。这份首个 v2 合约支持基于符合条件的五分钟 OHLC、报价量和实际结算资金费率的首小时做多基准突破。它并不意味着同一日期范围内具备丰富特征或逐笔回放覆盖。旧版 run_trade_test 仍可使用。

• get_strategy({catalog:true}) 可发现确切的源修订版本、符合条件的市场和限制。不带参数时会列出私有定义/试验；id 可读取作业进度，id,result:true 可读取已完成且不可变的结果。
• prepare_strategy({document}) 可验证并估算明确的 trade_query.v2，不会保存或运行。请使用 Web 端的精确定义视图或工具架构说明来构建所有必需字段。数值示例不代表验证规则。
• save_strategy({document,name,revisit_of?}) 可保存归账户所有的定义。后续证据修订会关联其前序版本，但不会覆盖结果。
• run_strategy({document,confirmation,attempt,units,name,revisit_of?}) 需要人工明确批准返回的确切定义、范围、成本、资金费率约定和估算值。提交所有返回值时须保持原样。模型断言或哈希不代表同意。使用 get_strategy 轮询进度；不得将排队中的响应称为已完成结果。
• cancel_strategy({id}) 会请求所有者取消。请等待状态变为终止的已取消状态；其试验仍会保留在历史记录中。不会删除数据或更改监控。

除 Research 权限外，变更操作还需要可选的 research:strategies OAuth/密钥权限。现有默认行为仍为读取/解读。读取/估算使用 research:read；过期后仍可读取已完成的私有证据。新任务每次试验只会预留一次额度；重复/缓存读取不收费，已知失败/取消的试验会退还额度。结果不明确时会保留同一笔预留：重试前先读取原始哈希。终止状态的重试需要新的估算和明确批准。没有任何工具会启动实时监控或交易。

每项策略都使用相同的机会样本、决策和绝对期限。2.5% 的回撤是相对于下单时冻结的近期已完成高点计算的；重新收复要求收盘价已完成，并在下一根 K 线成交。未成交/跳过的记录计为已知的零 P&L，而未知价格/资金费率的记录则明确排除在外。资金费率采用带标签的 LB1 固定名义金额结算近似值。风险单位和敞口并非投资组合回报。负面结果仍是有效证据。

默认情况下，get_strategy(result:true) 会保留所有完整结果摘要、配对比较、覆盖范围、精确查询和可复现性字段，仅提供 10 条示例机会/交易。这些示例不是分母。full:true 会恢复完整的规范响应和 ETag；精简投影会移除该 ETag。

发布顺序和验收：先后为后端 docs/RESEARCH_STRATEGIES_V2.md、Web 端 docs/RESEARCH_STRATEGIES.md，再到 MCP。此实现复现了全部 14,563 个 LB1 机会，在 320,262 次日志比较中零不匹配，并通过公开处理程序单独测试了条件入场。自举过程明确标记了版本，不声称与 NumPy 的区间字节完全一致。本地 Web 浏览器检查使用带标签的测试数据；部署账户验收和付费意愿仍需验证。这些检查并不意味着已正式发布。