# 工程化路线：复用现有系统，逐步接入研究执行

本节是后续建设建议，不是本次实施记录。当前系统范围以 [项目方案](../../project-plan.md) 和 [验收记录](../../verification.md) 为准：平台只读同步、Alpha/PnL、本地记录已列为首期；回测、检查、平台回写与提交尚属后续。

## 值得补的工程模块

| 层 | 职责 | 对你的系统建议 |
| --- | --- | --- |
| 只读资料层 | 字段/算子元数据、论坛/官方文章、源版本 | 沿用统一认证与客户端；缓存按账户权限、地区、日期区分 |
| 研究台账 | 假设、输入 hash、父子实验、失败状态、预算 | 增量扩展 PostgreSQL，避免 CSV 充当并发锁 |
| 执行队列 | 配额、持久任务、轮询、退避、恢复 | 后续引入时把提交回测和等待结果分开；长 HTTP 请求不等于可靠任务 |
| 证据与决策 | 原始业务响应、简明摘要、状态、差异 | 前端/AI 默认读摘要，按 ID 下钻原文 |
| 分析层 | PnL、SC、同族识别、组合增量 | 先离线分析，再决定是否值得消耗平台 PC 检查 |
| Agent 入口 | CLI/MCP、schema、可观察步骤 | 共用业务接口，避免 Agent 直接写数据库或绕过状态机 |

## 社区工具怎样取舍

**wqb_cli 0.3.2** 强调可观察原语，保留请求、响应、状态码、等待过程和 artifacts；原帖仓库是 [untuitivist/wqb_cli](https://github.com/untuitivist/wqb_cli)。适合借鉴输入/输出契约和错误分类。本次未验证仓库版本、未安装，不将帖子版本称为当前最新版本。[[all alpha can do] wqb_cli 0.3.2 震撼发布：从零打造 Agent-Native 的 WorldQuant BRAIN 真实操作层](https://support.worldquantbrain.com/hc/en-us/community/posts/41706827651991)（发帖 2026-07-04，社区经验）。

**MCP bridge** 让多 IDE 共用服务，并用线程池隔离阻塞。其长请求超时、熔断和退避是设计样例；“零依赖”与实际使用 Starlette/Uvicorn 的描述冲突。更适合借鉴统一入口，不能直接视为已验证高可用。[从「 IDE的MCP挨个手动重启」到「一次配置，全部打通」：我的 BRAIN MCP 桥接架构分享](https://support.worldquantbrain.com/hc/en-us/community/posts/41856507417623)（发帖 2026-07-10，社区经验）。

**simulation wrapper** 与 **raw/decision** 把完整结果、进度、错误与对话摘要分开。评论还指出单批快照会覆盖历史、固定 JSON 路径可能静默产出 null。建议追加事件日志、版本化摘要 schema、保留明确的 unknown/pending；按 ID 关联完整表达式。[想让 Claude 通宵挖 alpha、早上只看结果？我加了一层 simulation wrapper](https://support.worldquantbrain.com/hc/en-us/community/posts/41363885291031)（发帖 2026-06-20，社区经验）；[【工程优化】Agent 挖 Alpha 时 Token 黑洞：raw 留磁盘，对话只读 decision](https://support.worldquantbrain.com/hc/en-us/community/posts/42406158561943)（发帖 2026-08-02，社区经验）。

**本地因子库②** 展示本地 upsert、缓存和请求封装，但当时不少分页/指标/回测能力仍待完善。你的首期系统已有类似底座，无须为学习另维护一套数据库；作者 [Gist](https://gist.github.com/AshSwing/67219501b9b80b90a6c3b414eb3ad93f) 只作参考，未运行。[【Consultant 101】手把手教你搭建本地因子库 ②](https://support.worldquantbrain.com/hc/en-us/community/posts/39466506480663)（发帖 2026-04-02，社区经验）。

## 本次真实验证过的资料获取路线

本次通过 BRAIN authentication 得到 201，使用账户授权的 support SSO 后，论坛 HTML 返回 403，而支持站 Community API 返回 200；按 topic 分页取得今年帖子，并读取重点评论。它证明这条只读资料路线在本次账户和时点可行，不代表所有账户永久可用。

官方接口依据：[Zendesk Posts API](https://developer.zendesk.com/api-reference/help_center/help-center-api/posts)、[Post Comments API](https://developer.zendesk.com/api-reference/help_center/help-center-api/post_comments)。SSO、过期、分页、限流仍应统一处理；认证响应不得进入研究 artifacts。本次没有执行论坛帖子里的发帖/评论/点赞示例。