feat: 增加仅检查 MCP 工具并完善已提交 Alpha 指标展示

docs/mcp-research.md

@@ -52,7 +52,9 @@ python -m app.cli mcp-token-revoke TOKEN_ID
 | search_catalog | `{filters:{region,universe,delay,...},dataset_id?}`；省略 dataset_id 查数据集，提供则查字段 |
 | get_research_metadata | `{query:{kind,...}}`；kind 为 scopes/settings/operators/field_availability |
 | refresh_research_data | `{query:{kind,...}}`；kind 为 catalog/operators/settings/field_availability/pnl |
-| get_refresh_job | `{job_id,limit?,offset?}`；查询刷新或自相关任务，错误列表独立分页 |
+| get_submission_check | `{alpha_id}`；读取检查上下文、snapshot 和缓存结果，不发起检查 |
+| check_submission | `{alpha_id,snapshot,descriptions}`；写回已确认描述并异步检查，绝不正式提交；要求 research:refresh |
+| get_refresh_job | `{job_id,limit?,offset?}`；查询刷新、自相关或平台检查任务，错误列表独立分页 |
 | check_self_correlation | `{alpha_ids:[...]}`，1–100 个已导入 Alpha ID；异步返回 job_id |
 | get_self_correlation | `{alpha_id}`；只读最新本地结果，含缓存和 stale 状态 |
 | search_backtests | 来源、reference、status、带时区起止时间、scope、q、候选精确匹配及分页 |
@@ -82,6 +84,12 @@ metadata 的 operators 支持 q/category 和分页；settings 支持分页；fie
 
 `result.stale=true` 表示缓存已待重算；新任务执行期间读取仍可能返回上一次结果，应同时查看任务状态和 `calculated_at`。这是本地研究规则，不调用 WorldQuant 的提交检查，也不代表平台提交资格。`get_research_capabilities.self_correlation` 提供工具名及当前规则。已有包含 `research:refresh` 的 Key 可直接发起检查；只读 Key 只能查看结果。
 
+## 平台检查（不提交）
+
+先调用 `get_submission_check({alpha_id})` 读取缓存表达式、Description 和 snapshot。核对三段描述后，调用 `check_submission({alpha_id, snapshot, descriptions})`；descriptions 为 `regular` 或 `selection`/`combo` 到完整文本的映射。此操作要求 `research:refresh`，仅写回描述并调用平台 `GET /alphas/{id}/check`。复用网页的本地自相关门槛、快照冲突保护和任务去重。不会调用 `/submit`，检查通过也不会正式提交 Alpha。
+
+使用返回的 job_id 调用 `get_refresh_job` 查看执行状态，再通过 `get_submission_check` 读取缓存结果和 checked_at。任务 completed 表示检查执行完毕，不代表所有检查通过；以 checks 中的结果为准。读取工具不自动访问平台。
+
 ## 一轮研究示例
 
 先读取能力和设置快照，发现字段并检查历史。用户授权本批执行后，提交以下形态的固定输入；设置仅为结构示例，实际范围需依据平台选项选择：