文档

进度记录

按日期记录的完成事项与决策变化

新记录写在最上面。每条写明日期、做了什么、涉及的决定。

2026-10-02:文档站发布批次

用户授权将累计文档更新推送到站点。发布包含架构重建、归档与旧路径跳转、平台专项产品/开发/实施文档及本机阶段 1~2 进度;不发布平台业务服务。远端 main 的三篇旧管理文档已完整保存在归档,保留历史后合并,不恢复旧架构为现行页面。

发布前将 Next.js 从 16.3.3 升到 16.3.6,修复依赖审计报告的 GHSA-vcvr-r3jv-pc5j。核对发现 2026-09-29 的历史 GitHub Actions 因账户计费限制未启动;本次重新触发的流水线已正常运行,质量和安全检查通过,优先使用其构建、签名和自动部署链路。另完成本地质量检查并准备可回退的本地镜像备用方案,未将备用镜像切入生产。发布步骤及备用方式见仓库 deploy/README.md。实际提交/制品及部署结果由 Actions 和服务器 OCEANWAY_DOCS_COMMIT 记录,公网验证结果由本次发布任务反馈;仅备用模式使用 releases/<完整提交号>/deployment.txt。

2026-10-02:旧 Console 全量回顾与迁入差异登记

用户要求先详细回顾oceanway-console。主 agent 与原三个子 agent 只读审计固定旧提交 6716e80f65e017a37463de26c51747b2db939d63 的路由、页面、组件、设计七轮记录、公共模型素材/内容发布、私有接口和历史验证。旧仓四个公共开发者入口、34媒体/工作流+3文本卡片、5精选、多协议三语言示例、完整Key、UTC筛选/汇总/详情、流水和账号自助均有实际源码;任务/产品入口仍是占位,真实支付/订阅和原型另行区分。

当前平台仅四个Console主页面和简化外壳,未完整保留旧视觉、搜索/折叠/分组/帮助及客户查询体验;新增统一资金路径不代替页面迁入。发现刷新后未知订单关联和超JS安全整数quota展示保真差距,仅审计登记未修复。旧前端 pnpm test 19文件128测试、pnpm typecheck复跑通过;未启动旧BFF/Core、调用模型/支付或访问生产,旧已跟踪文件无修改。详见平台 docs/verification/T-07/console-source-review.md;T-07整体仍进行中,需求和设计唯一源不变,旧仓未归档。

2026-10-02:T-04~T-09 首批正式开发与页面联调

用户授权开始开发,主 agent 与 identity_frontends、accounting_recovery、protocol_tasks 协同完成正式首批实现。分支 t04-platform-authority,实现及首批脱敏证据提交 e463ee7dd63af0cc77a606142c27f1a7b8c19854,官方基线仍为 rc.41 / 2035a82aeb5414253a728bd937d4b8f97aa99b9b;只做本地提交,没有远端推送或发布。

正式身份支持可配置oceanway.tech/oceanway.ai、多主域一次性交接同SID及下一请求即时退出;独立产品凭据只证明产品身份。平台复用原生充值/支付/计费配置,同事务校验权限、版本及审计,保留不可变价格快照;ServerAddress原生Passkey特殊分支已补同事务授权,真实PG证明越权、过期版本、回滚及注销拒绝。人民币Epay订单、签名通知与管理员核对只入同钱包一次;基本OpenAI文本/SSE用量按原生倍率进入统一记账,未知恢复不重发。

Console/Admin首批页面迁入现有web,真实Chromium/独立PG/HTTPS验证共享SID、普通Admin403、动态支付选项/报价、旧revision409不重放、管理员本地测试补单后客户100积分/冻结0/credited、原生模型预览及保存、disabled订阅草案和移动导航。退出后另一子域401并清私有UI;两个最新浏览器SID已撤销。独立SQL证明operation、ledger、管理员receipt和正向audit各一。临时库/角色/cluster/账号秘密/身份配置/TLS私钥已清理,夹具端口关闭,原本机开发服务保持存活;没有真实收款。

全量Go/vet/relaykit、前端170文件2156用例、类型检查及构建通过;正式实际main启动/重启、真实PG/TLS资金闭环及分项PG/TCP回归通过,金额断言 20001000=20000992可用+8消费。分项证据在平台 docs/verification/T-04~T-09,聚合记录 T-04/integration.md;文档检查只作链接证据。本批不表示T-04~T-09整项完成:订阅资金/周期购买仍关闭,完整P0、六产品导航、三协议/Responses/媒体、企业协议价、真实上游和生产备份/发布未完成。文档站此前未提交改动保留,仅增量登记,无整体提交或发布。

2026-10-02:充值、订阅及计费配置原则确认

用户明确充值、订阅、全部支付相关内容和模型计费应后台配置,复用new-api已有能力。初始40元=100积分、模型倍率1可调整,优惠周/月订阅纳入首期;具体套餐数值和商户凭据不再作为编码前置阻断。退款由管理员控制,首期无客户线上退款。同步D-BILLING-CONFIG、PD-04~08、PL-017、首发范围及T-09依赖,保留唯一钱包、价格快照、幂等和未知不重做要求。

accounting_recovery子agent只读审计固定官方基线,证据在平台docs/verification/T-04/native-config-mapping.md:已有充值/折扣、模型计费配置、订阅管理与支付渠道配置入口;订阅创建/更新强制USD,周期重置刷新权益而非向钱包发积分,需要人民币及统一记账适配。该记录仅为配置能力审计,没有修改业务源码或运行配置,没有实际充值、支付或生产操作,不表示T-04~T-09已完成。套餐/渠道未配置完整时不上架,字段映射和账务兼容性由开发完成验证。

2026-10-02:T-02 原版审计与 T-03 最小产品闭环

按用户“每部分安排对应子 agent、协同开发”授权,主 agent 整合,protocol_tasks/accounting_recovery/identity_frontends 分别负责协议与任务、统一资金恢复、身份及两旧前端矩阵。平台工作分支 t02-platform-validation,实现提交 cd46dabd4d674c85d47728775510bac89fdefd97,脱敏证据提交 8baa2650a87c2ff94e3e854b9c6ac79f48eecb85;官方基线保持 rc.41 / 2035a82aeb5414253a728bd937d4b8f97aa99b9b,没有远端推送或生产操作。

T-02取得19个TCP协议/价格/异常案例、视频成功/失败/重启核对、6项原版资金PG实验、身份PG与20类Console/Admin矩阵。原版缺用量估算、响应丢失重发、Key分步失配和退款内存幂等被复现,不将这些测试通过写成目标能力通过。

T-03落地共享Cookie/原持久会话、产品动作/Origin作用域、唯一users.quota资金路径、冻结/operation/ledger/不可变快照与持久单发attempt。真实隔离PG验证9项账务和8组模型场景,真实TLS/router闭环核对1000=958可用+20未知冻结+22消费;注销后创建/开始/扩大预算拒绝,已发出原操作后台结算/保存恢复。包括真正提交前后及上游已收到后的kill、Key故障回滚、跨秒首次同键竞态、原模型恢复不重发。实际main启动/重启与版本化迁移通过,旧收费接口及原上游后台调度在验证模式关闭。契约和完整证据在平台 docs/openapi/platform-validation.json、docs/verification/T-02/、docs/verification/T-03/index.md。

全量Go/relaykit/vet、前端169文件2143测试和类型检查通过;后续受影响包复跑发现官方SQLite并发账户删除偶发SQLITE_BUSY,未改官方SHA的200次对照也复现。原控制器安全场景切到隔离PostgreSQL全套通过;SQLite风险如实保留,未删测试遮掩。文档检查不作业务证据。T-04~T-10尚未完成,正式域/凭据、人民币精度/套餐、超额/长期核对等PD未决;真实上游/网关、音频、完整媒体授权、页面迁入、支付、生产容量/发布未验收。本轮未调用收费模型/真实支付/生产库,文档站此前未提交改动保留,增量状态未整体提交或发布。

2026-10-02

完成 T-01 官方基线与本机开发环境(PL-016)。 按用户“详细阅读开发文档,准备开发环境”授权,读产品/开发/实施及身份/钱包/现行决策规则源,重新查询官方发布及 tag ref,导入 new-api v1.0.0-rc.41 / 2035a82aeb5414253a728bd937d4b8f97aa99b9b。本地验证分支 t01-baseline-environment,环境代码提交 d83e7a50cf6517e838d57536cae7184f49a54e34,证据提交 60dc5d3;保留原有入口和上游 LICENSE/NOTICE/第三方版权材料。没有 OceanWay 远端或推送。

工具链为 Go 1.26.3、Node 24.6.0、项目专用 Bun 1.4.0;锁文件未修改。用已安装 PostgreSQL 16.14/Redis 8.6.3 建立独立 cluster/instance,端口 15432/16379;原版 UI/API 18080、本地 TCP 上游和支付占位夹具 18081,均仅监听 127.0.0.1。应用数据库角色不能建库/建角色且不是超级用户;私密配置只留在忽略目录。唯一业务源码差异是可选 LISTEN_HOST,资金/身份/支付逻辑未改。

完整前端、主 Go 服务与 relaykit 独立构建通过;双模块 vet/测试、前端类型检查和 169 文件/2143 测试通过。真实 PostgreSQL model/controller 测试通过;首次 controller 因测试 helper 需要建库而失败,改用临时测试角色后复验,应用角色权限保持不变,临时库/角色清理完毕。启动器停止竞态和端口检查问题已修复并重复重启核对:初始测试 quota=100000000、used_quota=0,渠道/Key/订单/任务为 0,quota 列为 bigint。基线与脱敏证据在平台 docs/baseline.md 和 docs/verification/T-01/environment.md。

同步 PD-01、任务、环境、仓库清单与证据状态;T-02~T-10 未开始。共享 Cookie/HTTPS、受限委托、统一账务/冻结/恢复、三协议/SSE、多媒体、支付和两前端迁移尚未业务验收;未调用收费模型、真实支付或生产,未客户迁移。文档站此前已有未提交变更,本轮只增量更新 T-01 事实,未一并提交或发布。

文档检查 pnpm docs:redirects、pnpm docs:check、pnpm types:check、pnpm build 通过(56 篇现行、303 篇归档、398 条跳转);不计为平台业务通过。阶段 0 的文档发布和远端旧服务核对仍待执行,本轮没有修改既定业务决策。

2026-10-01

启动 oceanway-platform 专项文档。 新增 19 篇现行页面:产品文档 5 篇(范围、流程、需求和验收),开发文档 10 篇(架构、目录、环境、数据、接口、前端、测试、运行和迁移),实施文档 4 篇(计划、任务、决策和证据)。需求 PL-001~017、验收 AC-01~12、任务 T-01~10 建立关联;商业规则和技术未决项单列,不假定已实现。

在 platform/oceanway-platform 建立 README、AGENTS 与 docs 索引,正文仍以文档站为唯一来源。同步平台导航、工作区、仓库清单、路线图与当前进度;修正候选版本/Console 接口被写成已核实能力的表述,并修复集成验证表格的异常字符。平台源码、Git/远端、接口、数据库、收费调用、发布和客户迁移均未执行,T-01~T-10 均未开始。

本地 pnpm docs:redirects、pnpm docs:check、pnpm types:check 和 pnpm build 通过:56 篇现行页面、303 篇归档页面、398 条跳转;本地项目入口链接与文档仓库 git diff --check 通过。本轮结果尚未提交或发布,不作为平台业务验收。

补齐架构实施约定(本地文档变更)。 根据用户要求补充唯一记账、价格快照、预留到期与持久恢复、受限产品委托、图片/音频能力候选及文件授权归属。新增平台集成验证与共用任务与媒体,第 1 阶段扩为七项并提前验证跨产品闭环。更新 Drama 标准中的职责映射,并同步产品、Site、Design、Infrastructure、媒体网关的开发指令及贡献规范。图片/音频经 uumi 仍是建议,凭据格式、存储复制和保留期限仍待定;本次没有实现业务接口、调用真实模型或部署。

本地检查:pnpm docs:redirects、pnpm docs:check、pnpm types:check、pnpm build 通过,37 篇现行页面、303 篇归档页面、398 条跳转;相关八个仓库 git diff --check 通过。独立 AI 文档复核发现的贡献模板和同步委托遗漏已修正,复核未发现阻断问题。上述是工作区文档检查,未提交、合并或发布,也不是正式 PR 或生产验收。

架构重建。 评估后认为原 Core / API Edge / Contracts 多仓方案对一人开发过重,且平台核心能力在 new-api、Studio、自研 Core 三处重复实现。确定改为以最新 new-api 为基础建设统一平台。新增决定见现行决策中“2026-10-01 架构重建确定”一节。

当天的决策调整:

  • 视频请求不经过 uumi,直连媒体网关(D-MEDIA-DIRECT)。
  • 全局登录使用主域名共享 Cookie(D-SSO-SHARED-COOKIE)。
  • 管理端:平台级管理在 Admin,产品级管理留在产品(D-ADMIN-SPLIT)。
  • 官网内容在 Admin 中调整,后置(D-SITE-CONTENT-ADMIN)。
  • 创作产品先定为各自独立仓库,同日改为合并到 oceanway-studio、一个 Next.js 应用三个子站(D-CREATIVE-ONE-APP),技术栈统一为 Next.js 全栈(D-PRODUCT-STACK)。
  • Drama 此前完成的是交互原型验证,前端迁入、后端重写(D-DRAMA-REBUILD);产品规则以《标准 1.7.0》为准,“是否做成片合成”的待定项关闭。

执行:

  • 9 个仓库的未提交改动提交到 archive/2026-10-01-snapshot 分支并推送远端(Core、API Edge、Contracts、Console、Admin、Site、Studio、Docs、Infrastructure)。
  • 原 coordination/ 含生产密钥文件,完整目录只保存在本机 archive/coordination-2026-09/;其中 1610 个文本记录经密钥扫描后存入文档仓库。
  • Core、API Edge、Contracts 移入 archive/repos/;停止 9 月 28 日启动的本地预览服务。
  • 旧文档 301 篇移入归档,内部链接改写到归档路径,旧路径自动跳转;新增 pnpm docs:redirects 用于同步跳转。
  • Drama 仓库 codex/manju-workbench-handoff 快进合并进 main(45524ef)并推送;文档站导入《漫剧工作台标准 1.7.0》及其架构、对接说明。
  • 按“先总后分”重写文档:总览、平台、产品、网关、工程规范、运维、进度。

On this page