文档

Console 界面改版

采用 Higgsfield 页面结构与 OceanWay 品牌的本地实现及验收范围

归档内容,只读,不代表现行方案。现行文档见文档总览。

2026-09-22,用户要求重点设计 UI,直接沿用 Higgsfield API 的设计结构,替换为 OceanWay 配色和 Logo。当前改动已落在现有 Console 业务工程,状态为本地待视觉验收,未发布生产。

实现范围

页面或组件本轮实现
全站框架深色中性背景、圆角侧栏/内容框、分组导航、折叠侧栏、页面搜索、手机抽屉
品牌保留原始 SVG 图形与字标;采用 Design 的黑底白标版本,主要操作与焦点使用 OceanWay 蓝
快速开始双栏接入步骤与 Key 面板、开发者资源卡片;登录后加载原有账户示例
接入文档与控制台共用框架,匿名可读,沿用真实协议说明
总览接入入口卡片、四项真实指标、消费趋势和最近调用
模型与价格账户授权模型卡片,按名称、协议或提供方搜索;保留本人价、公开参考价和服务端报价
用量与钱包筛选面板、汇总指标、余额重点展示、原有流水与明细
Key 与账户统一表格、表单、弹窗、空态、错误和登录页主题;手机表格局部滚动

视觉参考来自已登录的 Higgsfield 页面。没有复制其品牌素材、宣传模型数据、折扣、赠金或未实现功能。详细采用说明位于 Console 仓库 docs/design/adoption.md;运行时样式位于 Console,不在 Docs 再维护一份 token。

验证与运行

  • Console 前端 66 项测试及生产构建通过。
  • 浏览器实测:匿名指南、Core 全局登录返回、账户总览、模型搜索/空态、侧栏折叠、页面搜索跳转、余额/流水、Key 列表与新建弹窗。
  • 390px 手机走查:公共快速开始、登录、Key 列表、导航抽屉与搜索;表格内部横向滚动,页面不横向溢出。长 Key 名称补换行。
  • 本机隔离环境运行于 http://localhost:63640/quick-start,复用测试 Core、SQLite 和 BFF;本轮只核对展示,不发起模型消费、充值或创建密钥。
  • 测试 fixture 补齐本人用量/订单读取 scope,原本地配置缺少的权限不通过放宽生产权限解决。

公开模型发布、完整 SDK 文档、商业计价配置与真实支付仍按 Console 开发者体验计划继续。模型卡片仍是登录后本人目录,不等于 CON-D02 全部完成。七平台生产 SSO、真实媒体与高并发也不在本次 UI 验收结论内。

本机证据:coordination/console-higgs-ui.json。生产版本保持 Console 发布记录所述状态。

第二轮:接入功能扩展

2026-09-22,继续对照已登录 Higgsfield 的 Dashboard、Explore 与模型详情,读取浏览器可见的两份公开前端构建产物,核对组件和交互;没有取得或声称取得其完整源码仓库。

  • 快速开始新增“自己接入 / 交给 AI Agent”,提供可复制的 OceanWay 接入指引与四项接入 FAQ。
  • 新增 cURL、JavaScript、Python 示例及协议切换;匿名显示通用模板,登录后按授权模型及协议生成。未配置地址时保留明确提示;不注入真实密钥。
  • 模型目录新增类型、提供方、协议与关键词组合筛选;详情分为价格与报价、API 接入、模型信息。
  • 文档分为开始接入、身份与密钥、请求协议、流式响应、用量与费用、错误与排查六章。
  • shadcn Tabs 完成现有 Base UI 版本适配;深色品牌、登录授权与服务端权威计价继续沿用。

前端测试增至 81 项通过,生产构建通过。新增四协议 × 三语言的 12 组实际本地请求执行,核对路径、认证头、请求体及特殊字符转义,不调用收费上游。浏览器检查通过:Agent 指引复制、代码语言切换、模型筛选/空态/清空、模型 API 分栏、文档章节切换;390px 的快速开始、文档和模型页面不横向溢出。已恢复桌面尺寸并保留预览。

公开模型营销素材、模型发布、完整 SDK 教程、在线生成、实时分析与商业支付仍按原计划继续。本轮本地数据不能作为商业模型全量上线证据。新增证据:coordination/console-higgs-ui-expansion.json;未部署生产。

第三轮:Explore 模型广场取代价格首页(历史阶段)

2026-09-22,用户明确要求模型发现体验:文本、图片、视频都要有丰富内容。/models 已改为公开可读的 Explore 模型广场,账户报价功能保留在受保护的 /models/pricing。

  • 大幅精选模型与手动切换、三类模型集合和分类切换、关键词/提供方/账户可用筛选。
  • 9 个精选模型介绍;视频镜头概念图、图片作品式封面、文本编程/写作/推理场景展示。
  • 详情包括能力标签、应用场景、创作提示词及复制、资料来源、已开放规格的账户价格入口。
  • 目录展示不等于授权;只用 Core 有效授权模型精确匹配可用规格,不推测价格,未开放模型明确说明。
  • 两张原创场景封面由内置 Image Gen 生成,三张已有 OceanWay 视觉素材复制入 Console 仓,保留来源。视频当前为概念封面,没有真实样片播放。

验证结果:85 项前端测试、新价格路径的 BFF allowlist 定向测试、构建和 diff 检查通过。浏览器实测匿名浏览、三类卡片、精选切换、详情提示词复制、搜索空态与重置、账户可用筛选、登录返回价格页、390px 布局及详情滚动;图片正常加载,页面不横向溢出。修复文本卡片内文案重叠。

当前是前端编辑目录首版,Admin 素材上传、发布审核/版本管理、真实视频样片与完整公开模型 API 仍需后续补齐。生产尚未部署;新增回跳路径需同步正式 Core handoff target 配置。证据:coordination/console-explore-models.json。

第四轮:Higgs 卡片展示复现(模型展示基线)

用户确认“展示全部复现,等后台准备好了价格后再开始调整价格部分”。本轮据此替换第三轮的媒体卡片示意方案;参考美元价格仅用于展示,不修改 Core、Edge 或 UUMI 的实际计费。

  • 直接核对参考站后收录 34 张卡片:11 张图片/图片工作流、23 张视频/视频工作流;同名模型与工作流保留独立入口。另外保留 3 张 OceanWay 文本模型介绍,授权目录的其他模型仍动态加入。
  • 复现对应封面、视频样片、15:8 媒体比例、分类/Exclusive 标记、提供方与名称、模式数量、价格单位、起价、划线原价及 15% 折扣。简介采用简短中文表述。保留 OceanWay Logo、侧栏和品牌蓝操作。
  • 五个精选切换项,视频卡片悬停或键盘聚焦播放;详情可手动播放。离开卡片停止预览,减少动态效果偏好下不自动播放。失败时回退封面,不触发收费生成。
  • 展示快照保存在 Console 的 src/features/catalog/higgs-reference.json,记录来源、观察日期和用途。价格保留原始小数字符串,from 与原价分开存储,不根据有无折扣猜测。
  • 卡片参考数据不授予模型权限;精确开放规格仍由 Core 决定。真实账户价格继续位于 /models/pricing。详情和页内提示保留参考展示说明。
  • 媒体使用核对过的公开 CDN 地址;BFF CSP 仅增加对应图片/视频域名,脚本和 API 连接仍限制同源。后续正式素材托管与 Admin 发布尚待接入。

验证:87 项前端测试与构建通过;浏览器确认 34 张封面加载成功、视频 readyState 4 且播放时间递增、11 张图片筛选及详情、390px 卡片与弹窗无横向溢出。展示版已更新到 http://localhost:63640/models,未部署生产。证据为 coordination/console-explore-models.json。

第五轮:其余 Console 页面统一(2026-09-23)

继续在已登录 Chrome 中核对 Higgsfield 的 Dashboard、API Keys、新建 Key 弹窗、Analytics、Billing、Pricing 与账户设置。改造已落在现有 Console,保留 OceanWay Logo、品牌蓝和 shadcn 组件;本轮为本地视觉验收,未发布生产。

页面参考结构与本轮实现业务差异
总览我的工作空间 / AI Agent 切换、可收起的四步接入、模型推荐、指标与最近调用使用本账户真实汇总;未完成的接入步骤不伪造完成
API Keys紧凑工具栏、表格、模型推荐;新建弹窗突出名称输入保留掩码旁复制、权限限制、编辑启停和未知提交恢复
用量居中消费金额、全部时间/本月/今天、轻量指标和可展开筛选快捷周期使用 UTC,保留模型等条件;近七天趋势单独标注统计范围,零消费不绘制虚假柱高
余额与流水居中余额、页内分区、横排指标、充值方式区域金额保持服务端 microcredit 单位;EasyPay、微信、支付宝仍显示待开通,未伪造自动充值与优惠
账户与安全头像和账户摘要、分栏设置、统一设置导航、会话列表继续使用现有资料、密码和会话接口,不新增组织或第三方绑定能力
账户价格授权规格表格与价格详情,侧栏增加独立入口展示 Core 本人授权与价格;推荐卡片仍是已确认的参考美元展示快照
登录、指南、文档简洁登录面板、缩短引导文案、统一账户价格链接继续使用全局 SSO 与原登录回跳

验证:生产构建、类型检查、**89 项前端测试(13 个文件)**与 diff 检查通过。新增测试覆盖 UTC 跨年/闰月日期边界、切换周期保留模型条件以及清空筛选。桌面浏览器核对登录返回、总览模式切换、Key 新建弹窗打开/取消、用量 Today 真实归零、钱包、账户和安全页面;390px 核对总览、账户价格、账户资料、钱包、Key 列表与导航抽屉,整页无横向溢出,宽表格在内部滚动。浏览器未见 warn/error,已恢复默认桌面视口。

本轮未创建密钥、修改密码、充值或调用付费模型。参考站的赠金、自动充值、支付资料与未实现的第三方绑定不属于交付功能。原正式支付与 Admin 模型发布仍待接入;本地 fixture 会话较短,到期后可经现有统一登录继续。预览:http://localhost:63640/。证据:coordination/console-higgs-account-pages.json。

第六轮:账户价格改为充值与订阅(2026-09-27,历史阶段)

用户取消个人定价工具,确认参考 Higgsfield 的订阅套餐页与 API 价目表。现公开 /pricing 提供账户充值、订阅套餐和模型价格三个分区;旧 /models/pricing 跳转到新入口,侧栏、模型详情、快速开始、文档和钱包跳转已同步。

参考内容当前实现有意差异
个人/企业与月付/年付Starter/Plus/Ultra 三列卡片、企业方案、周期切换正式金额、积分和权益待公布,不复制参考站促销与无限生成承诺
账户补充余额人民币金额选择、自定义金额、支付方式选择;登录后真实余额易支付/微信/支付宝未开通,提交禁用,不创建订单
API 模型价目表全部/视频/图片/文本、搜索、模式数量、展示价、分页与详情跳转复用已确认的 34 张媒体卡片参考快照与 3 个文本模型;无规格资料的字段不猜测,文本价格待公布
购买说明充值/订阅/模型价/企业协议 FAQ商业条件未确定时如实说明;后台差异计费与历史账务继续沿用

验证:93 项前端测试(14 文件)、构建与类型检查、BFF 精确回跳路径测试和 diff 检查通过。浏览器验证匿名阅读、金额选择、月付/年付、企业切换、搜索空态/重置/分页、模型详情跳转、旧路径迁移与 SSO 返回新页面显示 99,955 microcredit 本地余额;桌面与 390px 充值/套餐/价格表无整页横向溢出,宽表格局部滚动。已恢复桌面视口;浏览器健康检查未见应用错误。本轮没有支付、订阅、密钥创建或付费生成,未部署生产。

新 /pricing 路径已同步本地 BFF、登录恢复与 Core fixture handoff 白名单;正式部署需同步正式 Core handoff 配置。预览 http://localhost:63640/pricing,证据 coordination/console-pricing-subscription.json。第五轮中的个人账户价格实现已被本轮替代,历史验收仅供追溯。

第七轮:统一页面结构与业务动作(2026-09-27,当前)

重新核对已登录 Higgsfield Dashboard、API Keys、Analytics 与 Billing,以中性背景、紧凑标题、轻边框卡片和克制的主操作统一 Console。沿用 OceanWay Logo、品牌蓝与 shadcn,不复制未实现的自动充值、赠金和支付资料功能。第六轮充值选择器等中间展示由本轮替代。

  • 总览先展示余额、消费、调用与待核对;首次接入步骤折叠,真实无消费时显示空态。近七天消费/调用链接携带相同 UTC 范围,待核对链接带对应状态。
  • Key 页只保留列表和管理动作,移除模型推荐;完整 Key 的复制、编辑、启停与受控删除保留。
  • 用量改为四项汇总、可展开筛选与调用列表;模型和 Key 选择展示名称,周期切换保留其他条件。移除与筛选范围不同的固定七天趋势。详情从记录打开弹窗,关闭保留范围、模型、Key、状态和请求 ID;同页导航重置为目标 URL 的范围。突出实际扣款,原预留注明已处理,避免误认为仍冻结余额。
  • 钱包统一指标与金额单位层级;流水关联到对应调用详情。账户/安全页统一摘要、导航和设置面板,区分退出 Console 与退出当前统一登录。
  • 充值与订阅仍展示真实本账户余额和套餐方向。正式支付未接入时只显示待开通状态,不展示无效的金额选择、自定义充值与可点击支付方式;未开放订阅不用购买按钮。
  • 快速开始和文档采用共享页头;总览推荐卡片直达对应模型详情。模型参考展示价保持既有快照,不修改实际 Core 计价。

验证:96 项前端测试(14 文件)、类型检查和生产构建通过。桌面验证总览区间跳转、模型/时间筛选、清除筛选、真实流水到调用明细、推荐到对应模型详情、账户/安全/充值/指南/文档;390px 验证充值/订阅、Key 列表与新建取消、导航抽屉和调用弹窗,长 ID/协议换行且弹窗无横向溢出,宽表格局部滚动。应用浏览器 warn/error 为零,已恢复默认桌面视口。测试只使用本地既有 Core 数据,没有创建 Key、改密码、支付或发起模型生成。

本轮是本地 UI 与现有业务交互验收,未部署生产,不代表正式支付、订阅、商业模型目录或全平台生产登录已经完成。证据:coordination/console-ui-unification.json;预览 http://localhost:63640/。

On this page