# Quant Atlas 工作交接（2026-08-08）

> 用途：供新的 Codex 对话直接续作。不要从头重建项目，也不要依据历史聊天中的口头承诺覆盖本文件与仓库证据。

## 1. 项目位置与入口

- 项目目录：`/Users/zhuboyu/Documents/Codex/2026-07-31/100-pdf-100/portal`
- 成果档案源目录：`/Users/zhuboyu/Documents/Codex/2026-07-31/100-pdf-100/outputs`
- 已部署 Worker 源码提交：`f0241bd97c77e936df7fa8c7a779efbb70f67ec6`（Complete convertible bond pages within alarm budget）
- 公开主站：<https://seekingquant.netlify.app/>
- Sites 同步站：<https://www-quant-atlas.zhuboyujoseph.chatgpt.site/>（部分网络可能被 Cloudflare 阻断，不能作为唯一入口）
- Worker：<https://hunter.quant01.workers.dev>
- 实时状态：<https://seekingquant.netlify.app/api/simulation/live>
- 分钟仓库状态：<https://seekingquant.netlify.app/api/warehouse/status>

## 2. 不可突破的安全边界

1. 真实资金、真实券商连接和真实下单始终保持 `LOCKED`；真实订单必须为 `0`。
2. 不公开或复制任何 Token、API Key、账户密钥、MFA、Cookie、Sites 绕过令牌或 Cloudflare 凭据。
3. 所有收益均须明确标注为回测、研究或影子账户；不得称为真实收益，不得承诺低风险高收益或稳赚。
4. C 级收盘代理、缺失分钟、当前成分回填和非点时数据不得冒充完整 OHLCV 或严格样本外结果。
5. 盘中参数冻结；挑战者策略不能根据当日盈亏自动晋级。至少需要新的前向样本和人工批准。
6. 修改真实下单能力、公开写接口、预算上限或账户武装状态前必须再次取得用户明确授权。

## 3. 最新部署与代码状态

- Sites 项目 ID 已写在 `.openai/hosting.json`；最新已发布版本为 42，对应提交 `3c0543d...`，站点访问模式为公开。
- `.openai/hosting.json` 中 `r2` 为 `null`：Sites 本身不绑定 R2；生产分钟仓库由独立 Cloudflare Worker 的 `wrangler.always-on.jsonc` 绑定 `MINUTE_ARCHIVE`。
- Worker 已绑定：D1、R2、全量证券目录、分钟仓库 Durable Object；公开接口只读。
- 最近一次云端证据显示引擎心跳正常、真实订单 0；美国旧版 8765 模拟账户仍独立运行，但中国三账户才是当前实盘策略的影子映射。

## 4. 可转债补跑已完成

- 自动恢复、只读状态唤醒、12 秒请求上限、过期闹钟自愈和可转债阶段低并发均已提交、测试并部署。
- 最新 Worker 版本：`534070f1-0c1c-4bdd-ad10-8605fe38405e`。
- 2026-08-07 批次现已发现并处理 296/296 只可转债；全批次 6,062/6,062，失败 0。
- 可转债 296 个分区全部为腾讯收盘代理 C 级，每个 242 行；完整 OHLCV 与研究可用分区为 0。
- 可转债固定研究结论：`INSUFFICIENT_DATA`，交易 0；真实订单 0。
- 证据：`portal/research/results/cn-convertible-bond-future-minute-catchup-2026-08-08.json` 与 `outputs/cn-convertible-bond-future-minute-catchup-2026-08-08.md`。

## 5. R2 数据湖的事实

- 私有 bucket：`hunter-quant-minute-lake`
- 已核验对象：10,318 个
- 已核验字节：91,306,354,373
- 上传和校验：10,318/10,318；七类各抽样完整回读，大小、SHA-256、格式 7/7 通过。
- 当前约 91.3 GB。Cloudflare R2 免费含 10 GB，超额约 81.3 GB；按 $0.015/GB-month，单纯存储约 $1.22/月，仍需考虑操作费。代码中的自动归档安全线为 100 GiB；Cloudflare 没有真正的硬账单上限。
- 不应删除用户本地目录，除非对应静态快照已在清单中完整核对，且没有供应方程序继续向本地目录写入。系统从未替用户执行删除。

R2 当前数据集：

- 沪深 A 股 1 分钟：2000–2025
- 北交所 A 股 1 分钟：2020–2025
- 指数 1 分钟：2000–2025
- A 股 2026 分钟日包
- 指数与 ETF 完整包
- A 股连续日线
- TuShare 15000 历史接口包

关键证据：

- `portal/research/results/r2-minute-data-lake-manifest-latest.json`
- `portal/research/results/three-asset-minute-continuity-2026-08-08.json`
- `outputs/three-asset-minute-continuity-and-adaptive-exit-2026-08-08.md`

## 6. 三类资产分钟数据真相

### A 股个股

- 历史分钟：R2 已核验，沪深 2000–2025，北交所 2020–2025，另有 2026 日包。
- 不能声称每只证券、每个交易日、每一分钟完全无缺口；必须继续做点时上市/退市/停牌/异常值与缺分钟审计。
- 未来分钟：云端盘后按全市场目录归档已实现，但 2026-08-07 只有 51 个分区通过 A 级完整 OHLCV；5,155 个是 C 级收盘代理，333 个无可用分钟。仅 A 级可进严格分钟研究。

### ETF / 场内 T+0 基金

- 历史分钟：2010-01-04 至 2026-08-06，748,339,222 行，2,683 个历史代码；当前 227 只已核验 T+0 基金都曾在历史正文中出现。
- 不能因此声称每只 ETF 全上市期无缺口；仍需逐标的、逐日期、逐分钟质量矩阵。
- 未来分钟：同一云端盘后管线。2026-08-07 仅 1 个 ETF 分区为 A 级，226 个为 C 级代理，所以当日固定日内研究样本不足、无成交是正确的 fail-closed 结果。

### 可转债

- 官方现行目录：沪深共 296 只已发现并每 6 小时刷新。
- 历史分钟：仍缺可信、完整正文。
- 还缺点时强赎、到期、转股价、转股溢价率等事件序列。
- 未来分钟归档与目录晚到补跑已接入；2026-08-07 的 296/296 个分区已完成，但均为 C 级收盘代理。
- 策略必须保持 `RUNNING_DATA_GATED`，不生成影子委托，直到历史分钟和事件数据通过质量闸门。

### free-stockdb

- 审计仓库：`hello245m/free-stockdb`，v0.2.1，固定提交 `f4b54e65e0b05ba6f0f8a990f4c68dd930f763fd`。
- 代码包不含历史正文；HTTP/HTTPS `manifest.txt` 实测均为 204、0 字节。
- 当前不可用，且可转债覆盖与再分发许可未验证。不要声称已经接入。

## 7. 最新云端分钟仓库状态

- 日期：2026-08-07
- 状态：`degraded`，阶段：`COMPLETE`
- 发现：6,062 = A 股 5,539 + 已核验 T+0 基金 227 + 可转债 296
- 已处理：6,062；A 级完整：52；降级/拒绝：6,010；失败：0
- 分钟行：1,520,541
- 当日对象字节：38,363,908；未来仓累计：74,450,509
- R2、D1、目录和 Durable Object 绑定均正常
- 固定 ETF 日内研究：只有 1 个合格分区、0 笔交易，样本不足；不是真实收益
- 可转债固定研究：合格分区 0、交易 0，`INSUFFICIENT_DATA`；不是收益为 0，而是数据不足。

## 8. 三账户与策略

- A 股 T+1、ETF T+0、可转债 T+0 是三个完全独立的影子账户：不共享现金、持仓、委托、盈亏或熔断。
- 每个账户起始影子资金 1,000,000 元；当前三账户均空仓，真实订单 0。
- A 股规则：次一交易日起可卖；3–5 日只是偏好观察窗，不是强制退出；强趋势/涨停可延长，利润保护、趋势破坏、ST/退市、流动性和组合熔断优先退出。系统不能知道未来最高点。
- ETF：全量 227 只参与预筛选，最多 12 只研究短名单、最多 6 只激活；当前 `CASH_CONTROL`，数据和成本闸门不通过就不交易。
- 可转债：全量 296 只目录已接，分钟和事件数据未齐，保持数据闸门。
- 真实券商适配器、公开写接口、运行武装都为 `LOCKED`。

## 9. 页面已完成

- 总览页面在 30 秒内展示市场状态、自动交易状态、今日决策、三账户权益/收益/回撤、当前持仓、委托、最近成交、数据连续性和需要人工处理的异常。
- 当前持仓卡片可进入 `/positions`；点击标的可进入 `/positions/:symbol`。
- 详情包含：选择逻辑、预计持有规则、平均买入价、最新价、卖出参考、持仓收益率、未实现盈亏、交易规则、退出逻辑和影子成交记录。
- 三账户统一使用 `cn-independent-shadow-accounts-v4`；空仓时不得伪造持仓。

## 10. 关键开发约束

1. 项目存在 `.openai/hosting.json`，网页变更必须遵循 `sites:sites-building`，成功构建后遵循 `sites:sites-hosting` 发布。
2. 所有本地编辑使用 `apply_patch`；保留用户已有修改。
3. 先用 `rg` / `rg --files` 检索。
4. 不运行 `npm run refresh:snapshot`；它可能改写历史账本。历史交易账本必须保持 633 笔，不得重新膨胀为 1,514 笔。
5. 成果档案同步使用 `npm run sync:artifacts`，同步后检查生成文件差异和交易笔数，再测试、提交和发布。
6. 最近一次完整测试为 24/24 通过；任何新修改都要重新运行测试。
7. 不在公开成果档案中写入密钥、Token、Cookie、MFA 或 `.env`。

## 11. 建议续作顺序

1. 新建三类资产逐标的、逐交易日、逐分钟覆盖矩阵，不以总行数代替完整性。
2. 为 R2 增加私有按需读取/流式回测接口：只允许受控研究调用，禁止公开列桶或导出供应方数据。
3. 找到可信可转债历史分钟和点时强赎/转股事件源；用户需提供供应商试用权限、合法下载包或 QMT/XtQuant 数据权限，不要让用户把密钥贴到聊天。
4. A 股与 ETF 挑战者研究继续使用点时样本、嵌套滚动样本外、牛熊震荡高波分层和 1/2/3 倍成本压力；最终留出禁止反向选参。
5. 将新的审计报告和源文件同步到成果档案，构建并发布主站。

## 12. 用户当前仍需提供的内容

短期没有必须立即提供的内容。继续开发可以先完成可转债未来分区补跑与质量审计。

若要补齐可转债历史并使三类资产真正连续，需要用户通过安全本地 Secret 或本地文件提供以下任一项：

- 合法、完整的可转债历史 1 分钟数据包，包含退市/到期转债；
- 点时强赎、到期、转股价、转股溢价率事件数据；
- 或中国券商 QMT/XtQuant 的历史分钟下载与实时订阅权限。

密钥只能保存在本地或云端 Secret，不得粘贴到聊天或公开网页。