Files
worldquant-alpha-system/docs/worldquant-knowledge-base/03-engineering/2026-operating-lessons.md
T

36 lines
4.3 KiB
Markdown
Raw Normal View History

# 2026 工程经验:可恢复、可对账、可核验
只引用今年帖子,不安装或执行其代码。这里整理职责与故障模式,不宣称项目已经实现。
## 1. 请求、业务结果与配额分层
今年动态并发帖建议成功后渐增、429 时降低并发并退避;它是示例策略,不是平台配额保证。来源:[【代码分享】遇到429时,我用代码写了个一套管理机制来动态控制并发数](https://support.worldquantbrain.com/hc/en-us/community/posts/39224259294999)(2026-03-23)。每日 simulations 使用量查询见 [获取 WorldQuant 每天剩余回测次数、已回测次数](https://support.worldquantbrain.com/hc/en-us/community/posts/43058251853847)(2026-08-28)。调度器应以实际响应、Retry-After 和可取得的当前配额为依据,而不是固定并发数字。
认证失败、限流、暂时网络错误、任务业务失败分别处理;提交类请求出现未知结果时先对账,不能盲目重发。认证复用和限流目标是减少冗余请求,不是用多账号/多会话规避额度。
## 2. 长任务保存状态
checkpoint CSV 与报告帮助批处理断点续跑,来源:[【代码工具分享】让 Alpha 回测告别手工时代:一条命令跑完整个研究闭环](https://support.worldquantbrain.com/hc/en-us/community/posts/41551045362071)(2026-06-28)。跨 API/网页的台账用 RESERVED 防止重复派发,来源:[一个很小但很有用的工具:Alpha Backtest Ledger,避免重复回测](https://support.worldquantbrain.com/hc/en-us/community/posts/40857367883159)(2026-05-31)。
CSV 本身不保证并发原子性。需要记录任务身份、租约或领取时间、simulation/alpha ID、最后成功阶段和 unknown 状态恢复。规范化公式和完整 settings 参与去重;不要盲目统一代码大小写,可能改变字段或字符串含义。
## 3. 缓存有完整性清单
只记录最后更新时间不够;缺页或遗漏 Alpha 会低估相关性。来源:[本地check ppc的完整方法及代码,助你GLB PPA开发一臂之力](https://support.worldquantbrain.com/hc/en-us/community/posts/43085454784535)(2026-08-29)。缓存应保存数据池类型、分页完成状态、去重数量、失败页面、日期区间和采集版本。
浏览器向 Python 传递缓存的社区方案强调字段校验。来源:[分享一个连接插件中prodmemo和python的一个小脚本,帮助大家可以将页面上缓存的pc拿到python里用](https://support.worldquantbrain.com/hc/en-us/community/posts/42585946296855)(2026-08-09)。应验证输入 schema 和对象范围,不能把未经核验的缓存直接用于提交判断。
## 4. 研究反馈与 OS
将 OS 的检查字段同步到本地,而不只看 IS。帖子提出检查 `COMPENSATED_ALPHA` 的 WARNING;是否可计费/配点要按当时平台对象核验。来源:[【QUANT101】什么是 Non-Compensated Alpha? 如何筛选 Compensated Alpha?](https://support.worldquantbrain.com/hc/en-us/community/posts/39354351739415)(2026-03-28)。
流水线可以贯通生成、模拟、去重、相关检查和 OS 回流;社区 MCP 架构的存在不证明其收益有效。来源:[Pipeline MCP 深度版:面向多样性、高质量、低相关性 Alpha 持续生产的编排架构实践](https://support.worldquantbrain.com/hc/en-us/community/posts/39868267753623)(2026-04-20)。研究任务完成与外部提交应分开授权。
## 5. 数据获取与审计
今年帖子介绍认证后通过 Zendesk API 读取论坛资料。来源:[Python纯代码获取论坛内容(不使用任何无头浏览器等操作)](https://support.worldquantbrain.com/hc/en-us/community/posts/40458012001815)(2026-05-14)、[通过 Zendesk API 直接获取 WQB 平台资源 — 告别浏览器依赖](https://support.worldquantbrain.com/hc/en-us/community/posts/40531705016855)(2026-05-17)。本次实际使用这一可访问接口完成目录与评论读取;只保存需要的来源目录和归纳,不把会话 Cookie 写入知识库。
## 建设次序
先补台账和完整结果保存,再做断点恢复与配额控制;之后建设相关性缓存完整性检查、结构化失败回流,最后扩大候选生成。架构建议见 [工程路线](architecture.md)。没有修改本项目运行代码、数据库或全局代理规则。