Repository navigation
Releases: NuoXianTech/openapi-platform
Release list
OpenAPI Platform v0.1.5-rc.2
Changes
- chore(release): prepare v0.1.5-rc.2 (#50) (
8c5be906) - fix(ui): simplify homepage request example panel (
f320f87a) - fix(ui): refine header controls and compact homepage actions (
dfc4b893)
Full Changelog: v0.1.5-rc.1...v0.1.5-rc.2
Release highlights
- Discovery, configuration synchronization, and availability probes now use the same observed Service Token; the redundant control-token cache has been removed.
- Upstream lists remain readable when an availability observation fails, with a shared process-wide limit of 16 concurrent probes.
- The last ready Target remains protected while a Route disable is still an unapplied draft.
- Homepage request examples and header controls are simpler and more compact.
- Test coverage is consolidated around HTTP and configuration workflows, retaining real database persistence and locking checks while reducing redundant setup and waits.
Upgrade and rollback
- Relative to
v0.1.5-rc.1, this release introduces no database schema, migration, dependency, environment-variable, or runtime-configuration changes. - The
openapi-service/v1protocol is unchanged. Platform and Service remain independently versioned. - Upgrades from
v0.1.3or earlier require a new PostgreSQL database or a new PGlite data directory, following the migration procedure introduced inv0.1.4. Make a recoverable backup and export/import the required application data; do not reuse the old migration history. - For rollback from this candidate, retain the
v0.1.5-rc.1artifact or image and a recoverable database backup. No new schema migration is introduced by this candidate.
Validation and distribution
- The release commit passed CI checks for lint, types, unit tests, real Service acceptance tests, production build, and built-artifact integration tests.
- The Node server archive and container images reuse the same verified CI distribution. Both Linux architectures are validated on native runners for startup, automatic migrations, health/readiness, and restart with a retained data volume before publication.
- Container image:
ghcr.io/nuoxiantech/openapi-platform:0.1.5-rc.2(linux/amd64,linux/arm64). - This is a release candidate and is marked as a GitHub prerelease.
OpenAPI Platform v0.1.5-rc.1
v0.1.5-rc.1 release candidate
This prerelease includes dashboard and authentication UI refinements and architecture fixes for Service control, routing, gateway request lifecycles, rate limiting, credit recovery, OAuth/account completion, API Key handling, redemption-code generation, and log cleanup.
Upgrade notes
- From v0.1.4: database schema, generated migrations, and
.env.exampleare unchanged. Back up the database, then deploy the version-pinned artifact/image using the normal migration/start workflow. - From v0.1.3 or earlier: the database baseline introduced in v0.1.4 is incompatible with older migration histories. Use a new PostgreSQL database or PGlite data directory. Export required application data from the old installation and import it into the new baseline; do not reuse the old migration journal.
- The control protocol remains openapi-service/v1. Platform and Service versions are independent.
- Rollback: retain the previous v0.1.4 artifact/image and a recoverable database backup. This candidate adds no schema migration; restoring older pre-v0.1.4 installations requires their matching database backup.
Validation
Published assets are produced by the release commit's Linux CI, including lint, typecheck, unit tests, Platform-Service acceptance, production build, and built-artifact integration/migration tests. Both amd64 and arm64 images pass native startup/readiness and persistent-volume restart verification before publication.
Changes
- chore(release): prepare v0.1.5-rc.1 (#49) (
b843b876) - fix(test): load theme templates from Nuxt build directory (
c0cb0427) - fix(ui): align typography, spacing and responsive controls with design (
32c8a89a) - fix(ui): address design audit accessibility and layout issues (
aef3fc5d) - fix(platform): harden account, gateway and async workflows (
452922b3) - refactor(platform): consolidate target health, details and themes (
b6a8074b) - fix(ui): improve responsive controls and semantic contrast (
9d5a9716) - fix(ui): resolve design audit styling gaps (
1ff40c64) - fix(ui): refine auth layouts and public header (
bfa84761) - feat(ui): align dashboards with design system (
eea76ce9) - feat(ui): unify public pages with design system (
dcfafbdd) - refactor(platform): coordinate runtime state and token rotation (
f327ff6f) - feat(design): add Vercel design language analysis document (
adb1b879) - refactor(platform): consolidate gateway and routing workflows (
256bdc77) - refactor(ci): reuse verified build artifacts for platform releases (
882f603d)
Full Changelog: v0.1.4...v0.1.5-rc.1
OpenAPI Platform v0.1.4
OpenAPI Platform 0.1.4
本版本整合接口发布、管理台交互和运行时可靠性改进。Platform 与 Service 独立发布;Service 控制协议仍为 openapi-service/v1,无需使用相同软件版本号。
升级前必读:数据库基线不兼容
从 0.1.3 或更早正式版本升级,必须使用新数据库或新 PGlite 数据目录。不能直接覆盖产物后原地迁移。
本版本移除手工自定义 Endpoint / Route 管理,Route 必须引用 Service 连接;已在开发线生成的 0000 基线删除 api_routes.managed_by,并更新外键约束和迁移标识。旧数据库的迁移历史与 0.1.4 不匹配,启动检查会拒绝继续。本版本不提供跨基线自动数据转换工具。
升级步骤:
- 停止所有 Platform 实例,保存旧版本产物、环境配置、独立密钥,以及可恢复的 PostgreSQL 完整备份或完整 PGlite 数据目录。
- 如需保留用户、余额、积分流水、API Key 和运营设置,先在隔离环境制定并验证与新 Schema 对应的导出/导入流程。保留关联 ID 和完整财务记录,不复制旧
drizzle.__drizzle_migrations;涉及加密数据时必须保留原密钥。未经验证不要导入生产库。 - 创建空 PostgreSQL 数据库或新的 PGlite 目录,使用 0.1.4 产物执行
npm run migrate,再启动 Platform。不要删除旧数据和备份。 - 导入经验证的数据,重新发现 Service 并审核公开接口、API Key、计费和限流配置,点击“应用全部变更”后验证流量。旧手工 Route 需要由 Service 契约重新提供,不能直接恢复为自定义接口。
- 检查
/api/health、/api/ready、登录、管理台、活动 Routing Revision、调用日志及积分余额。
0.1.4 发布后,该 0000 基线冻结;后续 Schema 变化必须追加 Drizzle 迁移。详细流程见数据库迁移与版本升级。
主要变化
- 接口发布、停用和治理修改先保存为草稿,再统一应用。Upstream、Target、分组、版本或默认域名的自动刷新不再夹带 Endpoint 草稿。
- Routing Revision 记录已应用 Route 配置,保留 Target 验证后自动恢复、支撑接口联动和回滚能力;相同配置复用快照。
- 管理台集中处理 Endpoint、Target、Service 配置、分组和运行快照操作,修复异步响应覆盖新状态、重复确认和读取失败反馈问题。
- 私有详情与分页读取共用请求生命周期;页面销毁后不再发起请求,过期响应不能覆盖当前数据,读取结果区分成功、失败、过期和已关闭。
- 系统设置和 OAuth 保存保留请求期间继续编辑的草稿;Upstream 元数据与待验证 Token 原子保存,共享缓存失效阻止旧加载回填。
- 改善后台分页、小时趋势、计费异常管理,以及首页调用量展示、加载状态和无障碍动效。
- 统一启动、诊断和迁移入口,强化数据库访问、迁移历史、运行时密钥校验,以及 Gateway 计费持久化和缓存隔离。
配置与部署
- Node.js 要求仍为
>=24 <25;使用 Release 预构建产物或ghcr.io/nuoxiantech/openapi-platform:0.1.4,生产服务器不执行构建。 NUXT_AUTH_SECRET与NUXT_API_KEY_SECRET必须分别配置为符合校验要求的独立密钥,启动过程不会代为生成或替换。- 可选
PLATFORM_DATA_DIR统一应用与迁移执行器的数据位置;相对路径以.env所在目录为基准。未配置 PostgreSQL 时使用该数据根目录下的pglite。 - Release 包在版本根目录提供
package.json、server/和public/,可直接运行npm run doctor、npm run migrate、npm start。
回滚
路由配置可通过重新激活历史 Routing Revision 回滚。跨版本应用回滚必须停止所有写入,并同时恢复旧版本产物、匹配的环境配置和升级前数据库备份;仅回滚镜像不能让旧版本使用 0.1.4 数据库。回滚前应单独保存升级后的数据,避免丢失需要对账的新增记录。
Changes
- chore(release): prepare v0.1.4 (
ea7fa65a) - style(auth): remove branding above login and registration forms (
b45082ff) - fix(runtime): protect database access and validate deployments (
df774171) - feat(runtime): simplify platform startup and deployment (
3aa502c3) - fix(admin): allow independent publication during target discovery (
6eac512d) - fix(gateway): persist billing before delivery and prevent cache bypass (
d9f46366) - chore(deps): update compatible platform dependencies (
12ec40fb) - feat(settings): add public security filing lookup code (
4220b9bb) - feat(admin): merge billing exceptions into credit transactions (
6cb383f9) - refactor(admin): redesign upstream service configuration page (
02972f6b) - style(admin): refine upstream form and refresh global fonts (
e8775898) - refactor(admin): remove manual product and version creation (
cecf8e90) - fix(admin): align 24-hour chart to hour boundaries (
2eb6dbda) - refactor(platform): remove custom endpoints and rebuild database baseline (
fefe2e1c) - feat(admin): streamline endpoint list and add bulk enable controls (
12122d2e) - fix(admin): align hourly chart with rolling 24-hour window (
8575777f) - chore(lint): enforce typed async checks and relax formatting (#44) (
7e439e56)
Full Changelog: v0.1.3...v0.1.4
OpenAPI Platform v0.1.3
Changes
- chore(release): prepare v0.1.3 (
b31e5494) - fix(platform): harden endpoint management and runtime safety (
42dd5004) - fix(ci): move compatibility checks out of daily quality (
21a73c9b) - fix(platform): harden gateway and routing configuration (
760b51af) - fix(platform): harden gateway security and availability (
11596764) - fix(gateway): eject persistently failing targets and repair timeout failover (
bba89a60) - fix(platform): stop the routing revision from overwriting the config revision (
cdb8f486) - feat(audit): centralize the audit write path and close trail gaps (
e4ea4d9d) - refactor(platform): collapse Workspace and Environment into one runtime row (
982ed46c) - fix(admin): reject invalid platform list query params (
86b60125) - refactor(admin): drop the call ranking card from the overview (
5432f708) - refactor(platform): infer $fetch response types from InternalApi (
59c7bcf4) - refactor(credits)!: make redemption toggle/delete return a uniform shape (
4224c9f3) - refactor(credits)!: fix redemption codes at 32 lowercase characters (
17420a8c) - fix(platform): surface stale Service target runtime state (
f60f4591) - refactor: unify upstream target management (
f9699057)
Full Changelog: v0.1.2...v0.1.3
OpenAPI Platform v0.1.2
Changes
- chore(release): prepare v0.1.2 (
88410c51) - feat(platform): make node artifacts directly deployable (
16a1a0b5) - refactor(platform): version service control protocol (
11a696ee) - chore(platform): decouple service release validation (
67f8d8d8) - fix(platform): show toast after copying OAuth callback (
314a41aa) - refactor(platform): simplify site footer (
e4395e92) - fix(platform): reserve Nuxt i18n message routes (
8c6e2f3d) - refactor(database)!: rebuild migration baseline (
545cf70e)
Full Changelog: v0.1.1...v0.1.2
OpenAPI Platform v0.1.1
Changes
- chore(release): prepare v0.1.1 (
2eb34635) - refactor(platform): consolidate application workflows (
465119df) - refactor(platform): simplify admin management workflows (
af14cf7e) - fix(platform): unify public API CORS handling (
4181bffb) - refactor: simplify platform workflows and runtime config (
2b021685) - fix(platform): harden state and publication workflows (
5ed90836) - refactor(platform): simplify application boundaries (
6f0959ec)
Full Changelog: v0.1.0...v0.1.1
OpenAPI Platform v0.1.0
Changes
- fix(platform): repair production release validation (
6aa3cdcd) - ci(platform): complete 0.1.0 release workflows (
37c44771) - refactor(platform): simplify service connection mapping (
5c1346cc) - refactor(platform): simplify service orchestration and reset database baseline (
37e82633) - feat(platform): complete external service migration (
0709871a) - fix(platform): harden gateway and service synchronization (
fcb16b7d) - feat(platform): complete 0.1.0 management platform refactor (
d8adebb7) - feat(platform): harden service routing integration (
e16dd076) - fix(platform): report service availability (
8fc4d0c6) - feat(platform): deduplicate runtime snapshots (
510202ab) - fix(platform): render service upstream details (
45167ef8) - fix(platform): align public catalog with active revisions (
091f7aca) - fix(platform): harden gateway response and accounting flow (
52fcdd97) - docs(platform): define split Platform and Service architecture (
8c56e2b8) - refactor(platform): separate control plane from API execution (
3e30361f) - fix(music): refresh Qianqian and Kuwo parsing (
25a5f741) - fix(billing): make credit settlement crash-safe (
793c5542) - docs: remove built-in public APIs section from README (
c8661a13) - feat(api): add daily luck endpoint (
fa4a0f09) - feat(api): expand v50 yiyan dataset (
a725efea) - feat(api): add QQ avatar endpoint (
ad8d3464) - feat(api): add Minecraft player endpoint (
3e3ad76a) - feat(api): add Lanzou file parser (
de243cfa) - feat(api): add daily 60-second news endpoint (
9ed4d6b2) - fix(settings): harden secret configuration flow (
0cff0647) - perf(ui): defer credits chart and trim auth stats payload (
17640081) - perf(ui): defer heavy charts and standardize refresh icons (
938ba658) - refactor(ui): refine dashboard layouts and table defaults (
b8f0b437) - fix(logs): align time range with toolbar actions (
afcb32c2) - feat(logs): add filtered cleanup controls (
95345f26) - refactor(server): simplify services and harden data flows (
db49e0fc) - refactor(app): consolidate shared dashboard patterns (
c51db4a2) - refactor(server): isolate h3 at HTTP boundaries (
3f257230) - chore: clean up unused code and improve readability (
8908e39d) - chore: remove undici version override from pnpm-workspace.yaml (
0126de70) - chore: remove redundant code blocks from changes section (
4114d570) - ``` feat(datetime-picker): enhance DateTimePicker component with improved draft handling and UI updates (
071252dd) - style(auth): update auth form options styling for improved layout (
738b8135) - feat(stats): add skeleton component and refresh functionality for public stats dashboard (
44c70dfe) - feat(search): enhance search bar with new props and improved styling (
1de92cc0) - feat(api): implement live public API call statistics summary (
631cd402) - feat(calendar): enhance user credits check-in calendar with improved date handling and UI updates (
578510ba) - feat(about): enhance project details and capabilities in the admin section (
858bcf37) - feat(logs): add keyword search functionality to admin logs (
097e116b) - feat(dashboard): standardize hourly label formatting for user dashboard (
0f19bc27) - feat(network): update inline notice styles and alert variants for improved UI consistency (
b42fc1ff) - feat(system-settings): add uptimeDays calculation and update startTime handling (
78ed5bf2) - feat(footer): refactor footer component to use SiteBrand and improve layout (
6e6878d6) - feat(api): enhance FriendLinksHero component and improve localization strings (
a2e65a8f) - fix(i18n): update terminology and improve clarity in localization files (
9c9e4b8a) - feat(docs): add short_videos link to API references (
ab165ece) - feat(bing): add 4K cover URL to response object (
632d3b64) - feat(api): add multiple new public APIs for various services (
e0b4175c) - refactor(api): unify response handling and context management in OpenAPI handlers (
d51cfb83) - feat(admin): improve UI components with consistent styling and enhanced tooltips (
d85c6e51) - feat(admin): enhance call log detail modal with query parameters and improved localization (
9fe2c540) - feat: add tooltips to enhance user experience across multiple components (
8adf147b) - feat(db): add new tables for credit transactions and rede...