feat: 增加 MCP 研究模板保存工具

2026-09-11 23:05:01 +08:00
parent 03a66546f3
commit f29063c9a2
13 changed files with 430 additions and 13 deletions
@@ -0,0 +1,16 @@
+# 新增 MCP 研究模板工具
+
+Status: ready-for-agent
+Type: task
+Resolution: implemented
+
+实现 create_research_template、research:write 权限、MCP Key 选项、能力声明与接入文档，复用现有模板资产和幂等机制。验收见 ../spec.md。
+
+## Comments
+
+- 已确认当前工作区存在研究删除及知识库相关改动；本任务不修改这些文件。
+- 已实现 create_research_template、独立 research:write 权限和网页 Key 选项，保存模板及固定来源证据，返回模板工坊入口；无迁移，无内部模型调用或回测启动。
+- 验证：新增模板专项测试 11 项通过；后端全量 376 项通过、1 项失败。失败为 tests/test_api.py:204 的 PnL 空缓存旧断言（缺少 series=[]），在干净 HEAD 03a6654 快照单独复跑同样失败，未改动该既有问题。
+- uv run ruff check app tests、pnpm build、MCP Key 浏览器测试通过；构建保留第三方 lottie eval 和包体积警告。
+- 独立只读审查 template_review 已完成，未发现可确认的权限、幂等原子性、队列唤醒、来源快照或展开兼容缺陷。
+- 未部署、未签发实际 Key、未执行真实平台回测。
@@ -0,0 +1,9 @@
+# MCP 研究模板沉淀
+
+外部大模型读取研究结果后自行总结参数化模板，通过 `create_research_template` 保存到现有模板工坊。服务端不再次调用模型，不展开实验、不启动回测。
+
+输入复用 TemplateSpec，另需研究假设、1–20 个已完成采集并持久化的来源回测候选 ID、幂等键，可附外部研究引用。服务端读取来源表达式、设置、指标和全部非通过检查摘要作为固定证据；不把完成或保存当作策略成功、检查通过或全部参数组合已验证。返回模板 ID、固定版本、理论组合数和模板工坊链接。后续批量回测继续使用现有固定输入、展开及确认流程。
+
+新建专用 `research:write` 权限，仅允许新增模板；旧 Key 的权限不扩张。重用账户锁、ResearchRequest、ResearchAsset/ResearchRevision 和 MCPAudit，无数据库迁移。相同键与内容重放原响应，不同内容拒绝；同名模板拒绝，不覆盖现有版本。失败事务不占用幂等键，不保留资产。
+
+验证覆盖 SDK HTTP 工具发现和调用、权限过滤与拒绝、参数/来源错误、同名冲突、幂等/并发/重新实例化重放、固定来源证据、网页资产读取和候选展开兼容、无模型调用和新回测。运行项目后端检查及前端类型检查。