文档

01 NEXT-01 本地交付基线(2026-09-20)

历史记录(已归档):本基线固化的是 2026-09 的旧多仓架构(Core/Edge/Contracts 等仓库现已归档,见 ADR-0002)。仅供追溯,不代表现行状态。同目录 JSON 与脚本为原始数据,不在站点渲染。

2026-09-20 固化六个业务仓库,具体 Commit、分支、检查和 15 仓观察结果见 baseline.json。 committed-source-manifests.json 保存逐文件 SHA-256:六个已提交源码树与隔离测试副本一致。

本次提交不等于推送、远端备份或上线。网关、Studio、Design 等已有提交仅只读登记,未擅自合并或切换分支。Docs 的版本以包含本文件的 Git commit 为准,不在文件里写入循环自引用的 SHA。

可复现检查

要求 Python 3.12+、Go 工具链下载能力、Node 24.10.0、pnpm/npm,以及六仓提交对象在本机存在。 Console/Admin 使用 packageManager 固定的 pnpm 10.15.0;依赖按锁文件安装,不能用清空锁文件解决安装问题。

python3 docs/baselines/NEXT-01/verify-baseline.py --list
python3 docs/baselines/NEXT-01/verify-baseline.py --repo oceanway-core --node-bin /path/to/node-v24.10.0/bin
python3 docs/baselines/NEXT-01/verify-baseline.py --repo all --node-bin /path/to/node-v24.10.0/bin

脚本默认从当前 OceanWay 目录布局定位仓库,异地 checkout 使用 --workspace /path/to/OceanWay。 它只从固定 Commit 导出到临时目录验证,结束后清理自己创建的临时目录;不改变仓库分支、私有配置、共享 fixture 或数据库。依赖安装可以访问包仓库,但不调用模型供应商或支付。

Go 使用 -count=1 -race、vet、build;前端使用锁文件安装、已有格式/测试/构建;Contracts 验证规范、Node/Go 消费样例及打包。数据库默认临时 SQLite;本次没有重跑 PostgreSQL 专项、共享浏览器环境、真实供应或生产验收,原阶段证据保留。二进制字节可能因路径/工具环境变化不同,不以新构建哈希替换旧冻结二进制证据。

运行入口与依赖

仓库运行入口当前实际边界
Corego run ./cmd/server;配置与迁移见 docs/identity-runtime.md、phase-two-runtime.md、billing-runtime.md默认仅探针;显式启用身份/价格/本地账务;迁移 0001–0005;无公共 Worker
Edgego run ./cmd/server;独立 cmd/protocol-replay、cmd/billing-edge、cmd/billing-reconcile正式 server 仅探针,本地回放与 capture-chat-v1 计费分别启用;不可直指真实 uumi
Contractsnode scripts/check.mjs、node scripts/build.mjs规范和内部参考制品,不是可运行服务或已发布 SDK
Consolepnpm dev、pnpm dev:bff;见 docs/catalog-ledger/README.md本人身份/Key/价格/账务;真实模式需显式 Core/BFF 配置;共享 fixture 归 Console
Adminpnpm dev、pnpm bff;见 docs/OW-ADMIN-03/RUNBOOK.mdBFF 消费 Core;财务等部分仍演示;.env.bff.local 自行配置并保密
Sitenpm run dev、npm run preview静态首页,不消费客户账务

新服务从空白隔离环境初始化,先按 Core 说明迁移、创建测试账户/凭据,再配置 BFF/Edge;不能把旧私有 fixture 文件直接复制到生产。

固定接口来源

  • new-api 参考:385d2dfd10d821b25c8a6766bd16eea248cb1652,只读参考目录 references/new-api。
  • Billing OpenAPI SHA-256:513052efd2b4cfdd9fff417498c66bfa47ec609f5630cccd069951efdb987dee。
  • Catalog OpenAPI SHA-256:c39f81fcb7512db40ac1be873d24314f7045dc2481f9fc2e5cefa2eda88f6323。
  • Consumer/customer OpenAPI SHA-256:112d9742eff276c2e822f95b3f3bd6bb614e46ade5e20622c7832428431dcff5。

Contracts 当前提交是规范源,Console/Admin 已带有按摘要固定的消费切片。仍未发布新 SDK;不能直接安装历史包替换这些切片。源和消费者字段变更需配套验证,不直接 import 其他仓内部业务代码。

已审阅的差异

  • 五模块第三阶段清单核对:Core 80、Edge 22、Contracts 26、Console 160、Admin 136 项均与修改前现状匹配。
  • Core、Edge、Contracts、Admin README 修正过时说明;业务实现不改。
  • Admin 原测试重复返回同一个 Response,自动身份复查与显式复查重复消费 body;只修测试夹具,每次生成新 Response。初次失败和修复后 46 测试通过分开记录。
  • Admin 一份构建日志、Site 两份源码文件仅整理行尾空白;原/新摘要在 normalization 文件中,不修改历史交付清单。
  • Gitleaks 对六个候选源码副本扫描;39 项命中逐项核对为 SHA-256 或明确的 loopback 测试凭据,无未处置项。私有 .env、数据库、运行目录和二进制不入 Git。

备份和发布差异

六仓新提交均仅在本机,远端没有收到本次成果。Docs 历史线上版本为 9 月 16 日的 7d4152b,本次文档未上线。历史托管 Actions 曾受账户付款/额度影响,本次未重新查询,不声称限制已解除。

根 coordination/ 本身没有 Git;公开复盘可使用本目录的脱敏摘要,原始本地检查日志与历史 fixture 留本机且不算异地备份。需要异地备份时推送审阅后的源码/证据,私有配置与客户库通过单独授权的加密备份处理。

On this page