Console 实施计划

目标与范围

统一公开模型、API 文档、教程、快速开始与登录后的客户管理：账户、API Key、本人模型与价格、用量、钱包订单、任务查询及产品入口。全平台共享 Core 身份；Console 管理账户，但不是唯一登录入口。

新增开发者体验按 CON-D01–10 合并实施计划执行；原 CON-P01–08 与已验收成果保留。

需求输入与确认

以详细需求、19 项产品操作、价格规则为唯一需求依据。首期覆盖 CA-C01–12、15–16、18 的已确定行为；注册等具体开放方式由能力配置决定。

兑换码（C13）与增强认证（C17）按配置；周期订阅（C14）和 Playground（C19）待选择。所有未接通按钮在原型中标识，不能凭 new-api 存在接口视作可用。

Console 是客户自助后台，负责本人账户、Key、充值、订单、价格和用量，并提供公开文档与教程阅读；不建设员工管理空间，不纳入 ADM-P09.04。模型说明、教程和示例如需员工编辑，由公共内容运营维护，Console 消费发布内容；内容呈现与真实模型目录引用继续纳入 CON-D 对应任务。

设计与原型

采用 shadcn 与 OceanWay 设计规范，参考 new-api 的客户交互重新组织页面。先做登录/恢复、Key 表格与表单、公开模型价目表、消费详情、充值与订阅状态五组原型，再补总览与设置；状态场景沿用原型任务书。

Key 掩码旁复制按钮直接请求该 ID 的完整值并复制，不新增确认弹窗，不复制掩码或猜同名记录。充值展示人民币实付与积分到账；参考价、本人生效价和本次消费价格依据分开表达。

API 与文档交付

页面动作沿用 CA-C ID → API 需求 ID 的字段映射。优先接入 /api/user/login、/api/user/self、refresh/logout、sessions，以及 /api/token/、search、:id/key。

价格、钱包流水、操作详情等缺口按 OW 提案补齐后接入；Core 提供业务事实，Console 不自行计算权威余额或协议价。交付页面数据适配、状态样例和联调说明，精确 Schema 归 Contracts；未实现的批量 Key/自动组等不能在真实页面伪装成功。

实施步骤与交付物

保留原有八个阶段编号，细化为 32 项任务。每项明确产品操作、前置、页面/字段与状态、API 依赖、交付物和具体验收；按阶段独立分页。主计划负责整体组织，执行证据单列在两端开工基线。

操作覆盖与接入顺序逐项对应产品操作、参考 API、Core 任务及当前运行边界。条件启用项保留计划，但不虚构已确定的支付商、套餐金额或 Playground 选择。

依赖与接入顺序

P01/P02 可独立推进；P03 依赖 Core 对应运行接口，P04/P05 依赖目录、价格与账务，P06 的跨站部分依赖 AUTH-G01，P07 依赖任务与产品深链。前端页面就绪不表示完整业务上线。

联合验收见Console/Admin 联调；不要把 Admin 的运营功能或供应网关配置放进 Console。

验收标准

• 每个首期操作有真实请求、响应和异常状态；本人数据隔离，未授权价格组不可选。
• 复制只针对该行 Key，失败不显示“已复制”；完整值不长期保留。
• 单位、筛选和统计一致，未知数据不填零或免费；旧零售待遇与 FDE 方案按已确认规则展示。
• 全局登录可从任一平台发起并返回；其他产品登录后 Console 识别同一身份。
• 充值、消费及任务均能关联后端事实；桌面/移动关键路径可用。

待定项与后续范围

Playground 复用 uumi 或引导 Studio、周期订阅、支付方式、积分比例及套餐数值沿用产品待定项。此计划不新增企业多人协作，也不将模型对接客户强制迁入。

本文定义计划，不累积执行日志。实际版本、完成状态和验证证据见项目进度；任务状态登记到本机工作台，并关联具体 CON-P/ADM-P 子任务；接口字段冻结与运行验收分别记录。