GornerOS 技术文档

生态概览

GornerOS 生态由四个独立部署的 Cloudflare Worker 组成，共享一套统一身份（SSO）与数据规范：

产品	职责	技术栈
🛰️ 星际超联中心	统一身份中心（IdP）、钱包、抽奖商城、后台	Workers + D1 + PBKDF2/JWT
🪐 GornerOS	Web 桌面融合壳，承载各系统级应用	Workers + Assets + postMessage
💬 GornerChat	私聊 / 群聊，实时消息推送	Workers + D1 + SSE
🤖 GornerAI	开源大模型对话助手（流式推理）	Workers + D1 + Workers AI

系统架构

• 身份层：星际超联中心签发 JWT，作为全生态唯一身份源；其他产品通过 SSO 换取本地会话。
• 数据层：每个产品独立 D1 数据库；用户按 StarLink uid 强关联，避免改名裂号。
• 实时层：聊天使用基于 D1 轮询的无状态 SSE（1s 拉新消息 / 15s 心跳 / 29s 主动关闭 + 浏览器自动重连），无需进程内存事件总线，可水平扩展。
• 接入层：全局 AI 内核 + 可扩展 SDK 注册机制（gornerx.js）。

接入统一身份

任何新产品接入生态，只需引入统一身份 SDK 并调用两个方法：

<script src="https://hub.gorner.kdns.fr/sso/gorner-sso.js"></script>
<script>
  GornerSSO.init({ starlinkUrl: "https://hub.gorner.kdns.fr" });

  // 确保已登录；已登录返回身份，未登录自动跳转中央登录页
  GornerSSO.ensureLogin().then(user => {
    console.log("当前用户：", user.username, user.id);
  });
</script>

SDK 会自动完成：父窗口 postMessage 握手 → URL #token 回传 → localStorage / cookie 持久化，跨域由 StarLink API 的 CORS 打通。

部署指南

每个产品均为纯 Worker 项目，标准部署三步：

# 1. 创建云端数据库
npx wrangler d1 create <db-name>
# 把返回的 database_id 填入 wrangler.toml

# 2. 应用迁移
npx wrangler d1 migrations apply <db-name> --remote

# 3. 部署
npx wrangler deploy

完整源码包与逐产品部署脚本可在 下载中心 获取。

API 参考（本官网）

方法	路径	说明
GET	/api/health	健康检查（含 D1 连通性）
GET	/api/products	产品矩阵（含最新版本）
GET	/api/releases?product=<key>	版本清单
GET	/api/archives?product=<key>	技术档案清单
GET	/api/stats	下载统计
POST	/api/download	记录下载事件并返回地址

版本与档案

每个产品提供三类 DOCX 档案：完整技术档案、Bug 记录、开发者开发档案。前往 下载中心 选择产品与版本后即可下载。