跨节点通信
选择自己的节点，再选择允许通信的认证节点。双方互相允许后策略才生效。
请选择节点。
我的合作伙伴资格
同一账号可叠加代理商 / 区域运营服务商 / OEM 白牌资格，由平台授予。
—
我的实例
还没有已开通的实例——认领授权码后，在你的服务器上运行安装命令即可开通。
节点运营数据
聊天房间、会员和业务数据来自节点最新心跳；今日消息是 Bot 当日进程计数，重启后从 0 重计；Token 数据来自 Nexus 账本。
详情只来自你自己的节点心跳和 Nexus 账本。
代理商
批发价统一 25 元/席、席位永久有效；等级按历史最高单笔进货席位认定。客户经你的邀请链接注册后，在其节点按你设定的首期价购买席位，款付平台，差价与激活奖自动计入你的收益钱包（T+7 可提现）。
分成计提
月续与充值分成次月 10 日可提，年付分成 T+7；养成奖随客户首次续费 / 升档发放。费率按计提时的策略版本与等级冻结。
官方远程维护
使用下方选择的节点。开启后，官方可通过独立维护账号管理整台服务器，用于开发、排障和升级。只有企业主账号可修改授权。
关闭后停止续发公钥授权，节点通常一分钟内撤销；离线授权最长十分钟到期。已建立的会话和已完成的操作不会自动撤销。普通版本更新不受影响。
请选择节点
OEM 节点更新
选择你的节点并确认平台已全量发布的版本。节点会使用本机 OEM KEY 主动领取和安装，普通更新时 Nexus 不会 SSH 连接你的服务器，官方远程维护需另外授权。
当前账号还没有已开通的节点。
邀请与层级
分享用户注册链接，注册成功后会直属挂靠在你的 OEM 名下；邀请合作伙伴注册 OEM，会成为你的直属下级。层级深度不设上限，仅记录关系与人数。
—
当前层级—
直属普通用户0
直属下级 OEM0
全部下级 / 网络用户0 / 0
邀请普通用户
每个已开通实例都有自己的注册链接和二维码。
邀请下级 OEM
对方从此链接注册后，自动成为你的直属下级。
我的下属清单
这里展示你的直属与间接下级 OEM，以及挂靠在你整个网络内的普通用户。只显示业务归属信息，不公开下级企业的联系方式。
0 家企业 · 0 个用户
下级 OEM
企业层级与人数均来自 Nexus 真实归属数据。
归属用户
只保存 Matrix 用户 ID 与归属边，不保存用户密码或聊天内容。
当前网络较大，页面只展示最新的 500 条明细；上方总数仍是完整数据。
购买与充值
款项统一支付到 GuDuu 平台；直属上级 OEM 按结算价获得价差。
Token 充值
为你的实例补充 AI 用量（余额耗尽 AI 服务会暂停）
在线支付渠道暂未开放；仍可在左栏「授权申请」中选择企业转账或合同/免费授权审批。
订单已创建：
![微信支付二维码]()
请使用微信扫描二维码完成支付；到账后订单会自动履约。
申请购买 Token
没有合适套餐时，可提交自定义量；财务确认实际到账后才会充入节点。
销售收益与提现
直属下级完成支付后，价差进入待结算收益。
累计销售收益¥0
待结算¥0
可提现¥0
累计申请提现¥0
⚠️ 合作伙伴资格已停用，收益处于冻结状态（合同 1 第 5.4/12.1 条）：流水照常记录，但暂不能提现。请联系平台处理。
OEM HELP从接入到推广，一步一步完成
选择一篇教程，查看操作入口、由谁处理和完成标准。教程不会替你申请、修改配置或安装节点。
← 返回教程列表
01 / 应用接入
OEM 申请，超管审批，节点同步
把自己的节点接入 MuuZi、MCN 或已登记的其他应用。账号、登录与聊天仍在用户选择的节点上。
- OEM 准备节点。确认节点已激活、域名与 HTTPS 正常、心跳在线。按业务需要配置公开或邀请注册，并确认验证码邮件服务可用。
- OEM 提交申请。进入「我的节点 → 应用接入」，找到目标应用和自己的节点，点击「同意并申请」。提交后等待平台审核，不要重复申请。
- 超管核对并批准。在超管后台「平台管理 → 应用接入 → 待审核接入任务」核对应用身份、所需权限、官方公钥和节点归属，再批准关联。
- 等待授权同步。回到 OEM「应用接入」查看状态。批准不等于节点已应用；显示「授权已同步」后继续核对分项检测。
- 按需安装并检测。应用开发者确认精确的应用来源，OEM 再发起「安装并检测」。这会安排节点配置任务；旧节点如提示需要升级，先完成兼容版本升级。
开发自己的新 App，需要独立应用身份与已交付的节点协议支持。不能复用 MuuZi、MCN 的应用身份，也不能仅凭批准就认为自己的 App 已完成开发。
应用私钥只留在应用自己的受控服务器。OEM 和 Nexus 核对公钥，不索取用户密码或 Matrix 会话凭据。
← 返回教程列表
02 / 上线验收
什么时候可以向用户推广？
「已批准」「授权已同步」「接口检测通过」是不同阶段。推广前要在用户实际使用的 App 或网页上走完一次完整流程。
- 先看四项检测。在「应用接入」核对注册、登录、平台会话与聊天。显示「尚无有效检测结果」时，说明尚缺检测记录。
- 验证新用户注册。使用测试邮箱收到验证码并完成注册；邀请制节点还需验证有效邀请及无邀请时的限制。
- 验证账号登录与平台会话。新账号及已有账号能登录，能进入应用自己的平台功能。节点登录成功不等于 MuuZi 等应用的平台换票成功。
- 验证消息收发。由两个受控测试账号实际发送、接收消息，确认退出、重新登录及账号切换不会沿用另一人的会话。
- 最后确认推广入口。用真实分享地址在目标设备打开，核对节点品牌、注册方式和可用功能；没有完成的登录方式或对话能力不要宣称可用。
「再次检测」不创建账号、不发送消息。它不能代替真实注册和消息投递验收。跨节点聊天还需要双方节点的通信授权，不会随应用审批自动开放。
失败后找谁处理
- 收不到验证码：OEM 核对注册规则和邮件服务。
- 批准后未同步：节点运维与超管核对心跳、授权版本和有效状态。
- 节点能登录，但平台会话失败：应用服务方与节点运维核对身份交换能力。
- 第三方登录按钮仍灰色或无响应：应用开发者检查是否已接入节点登录能力；保存凭据不会自动补齐客户端代码。
← 返回教程列表
03 / APPLE 登录
准备 Apple 凭据，再由 OEM 开启
当前分工：Apple 开发者账号负责人准备凭据；平台超管在「平台设置」按节点加密保存；OEM 在「节点系统配置」决定是否开放入口。OEM 开关页不能填写私钥。
- 先取准确的回调。请超管在「平台设置 → Apple / Google 登录凭据」选择目标节点，复制表单显示的回调地址。不要复制其他节点的地址，也不要自行猜测路径。
- 启用 App ID。进入 Apple Developer 的 Certificates, Identifiers & Profiles，给对应的主 App ID 开启 Sign in with Apple。
- 创建 Services ID。在 Identifiers 新建 Services ID，启用 Sign in with Apple，关联前一步的主 App ID；在网页配置中登记节点域名和准确的 Return URL。
- 准备签名材料。创建与该 App ID 关联的 Sign in with Apple 私钥，保存下载的 .p8 文件，并记录 Team ID、Key ID 和 Services ID。
- 由超管安全保存。在所选节点的 Apple 配置中填写 Client IDs（Services ID 放第一位）、Team ID、Key ID 和 .p8 私钥内容，点击「加密保存登录凭据」。密钥只填受控配置页，不发到教程评论、聊天或工单。
- OEM 开启并验收。确认凭据完整后，在「节点系统配置 → Apple / Google 登录」开启 Apple 并保存。等待节点同步，再验证授权、返回应用及账号绑定；应用端也须已经实现相应登录流程。
填写凭据不代表真实登录已通过。不要为了让按钮变亮而绕过节点能力状态；私钥撤销或轮换后需重新验证。关闭入口只停止新的第三方登录，不删除已绑定账号。
官方参考：Apple 网页登录配置 · 创建 Apple 登录私钥
← 返回教程列表
04 / GOOGLE 登录
创建 Google Web Client，登记节点回调
当前分工：Google 项目负责人准备 OAuth 应用；超管按节点保存凭据；OEM 控制本节点登录开关。浏览器和普通用户不会取得 Client Secret。
- 确认节点回调。请超管在「平台设置 → Apple / Google 登录凭据」选择节点，复制当前显示的完整回调地址。
- 配置 Google 登录项目。在 Google Cloud 的 Google Auth Platform 完成应用品牌、受众和同意屏幕；按实际使用域名填写主页与隐私说明。仅用于登录时使用 openid、email、profile 等必要范围。
- 创建 Web application 客户端。在 OAuth 客户端配置中选择 Web application，把第一步的地址逐字填入 Authorized redirect URIs。若使用网页 JavaScript 登录组件，另外配置对应的 Authorized JavaScript origins。
- 由超管保存凭据。将 Client ID 和 Client Secret 填入目标节点的 Google 配置；Web / Server Client ID 放第一位，再点击「加密保存登录凭据」。不要把 Secret 放进 App 或网页源码。
- OEM 开启并测试。凭据完整后，在「节点系统配置」开启 Google 登录并保存。测试状态先添加测试用户，等待节点同步后验证登录、回调和账号绑定。
- 确认正式开放条件。按 Google 控制台要求完成必要的应用发布或验证，再面向普通用户开放。原生 App 应使用受支持的系统授权方式，不在自有内嵌网页里加载 Google 授权登录。
出现 redirect_uri_mismatch 时，核对当前节点的协议、域名、路径和尾部斜杠是否与登记值完全一致。OAuth 登录配置与应用接入审批是两件事，都不能代替真实客户端验收。
官方参考：Google OpenID Connect · OAuth 使用要求
← 返回教程列表从购买节点到应用登录与聊天
节点由 OEM 管理，应用由开发者维护，超管审核应用身份及节点接入。按下面步骤完成一次设置，后续通过后台安装和检测。
1. 准备节点
在「我的节点」确认节点部署完成、域名与 HTTPS 正常、心跳在线。在节点后台选择公开注册或邀请注册，配置邮件服务。注册关闭不会自动阻止已有账号登录。
2. 申请与审核
- 在「应用接入」选择应用和自己的节点，点击「同意并申请」。
- 应用开发者向超管提交应用编号、HTTPS 服务地址、公钥地址和所需权限。私钥留在应用自己的服务器。
- 超管核对应用身份与公钥，批准该应用及节点关联。
- 填写应用的精确来源（例如 https://app.example），点击「安装并检测」。可提前安排，节点只会在审批通过后执行。
此操作由节点主动领取固定配置任务，备份后执行已审核的 Connect 数据迁移并启用适配器。它不会清空节点或修改跨节点授权。旧节点提示“需要升级”时，先通过节点更新安装兼容版本。
3. 使用登录注册组件
兼容节点提供 /cosmac/node/sdk/v1/node-access.mjs。从自己的已验证节点下载、审核并固定文件摘要，随应用一起构建。不要在每次登录时加载未经审核的浮动脚本。
import { createNodeAccess, mountNodeLogin } from './node-access.mjs';
const access = createNodeAccess({
origin: 'https://node.example', clientId: 'example-app'
});
mountNodeLogin(document.querySelector('#login'), access, {
onLogin: async () => {
const appCode = await access.appCode();
// 只把一次性 appCode 和节点地址交给自己的业务服务器。
}
});账号密码和 Matrix 会话只用于客户端与所选节点之间；Nexus、应用业务服务器不接收 Matrix token。节点开启人机验证时，由应用集成对应验证组件，并通过 challenge 回调提交验证结果。
4. 平台身份与聊天
通用应用编号为 3–32 个小写字母、数字、点、横线或下划线，首字符必须是字母或数字；guduu- 为官方保留前缀。每个应用有独立 audience。
- 客户端取码：POST /cosmac/connect/apps/{client_id}/app-code。
- 业务服务器服务检查：POST /cosmac/connect/apps/{client_id}/service/check，权限 guduu:connect:check。
- 业务服务器兑换：POST /cosmac/connect/apps/{client_id}/app-code/exchange，权限 guduu:connect:exchange。
业务服务器使用 private_key_jwt / RS256；断言绑定实际节点地址、节点编号、短时效及唯一请求编号，兑换时额外绑定 app_code_hash。一次性码有效期 60 秒。MuuZi、MCN 保持各自既有路径和权限。
聊天调用 Matrix Client-Server API。起步组件可连接固定版本 matrix-js-sdk 42.1.0，使用 connectChat、subscribe 和 sendText。生产客户端还需完善持久加密密钥、设备验证与历史恢复界面；组件内存会话不替代原生安全存储或系统后台推送。
5. 验收与重检
后台分别展示注册配置、登录接口、平台身份接口和聊天连接。接口检查通过后，用测试账号确认验证码送达、注册、登录、平台换票、收发消息、退出及切换账号。
「再次检测」只检查当前节点，不创建账号、不发送消息，也不把“接口可达”写成“真实登录成功”。失败时查看原因；配置失败可安排重新安装，执行结果不确定时先核查节点保留的恢复记录。
跨节点聊天需要双方节点管理员在各自「跨节点通信」页面互相选择，并等待策略已应用。频道本身也要允许跨节点。应用接入审批和商城开通不会自动开放联邦。
购买 GuDuu OS Aquarius 节点授权
一张申请、一笔付款、一把 KEY；一个产品承载所有使用和交付方式。
正在读取当前授权商品…
系统只认服务端支付回调或超管确认的真实到账；转账凭证和 AI 识别结果不会自动发 KEY。获批后请在 7 天内领取。
授权概览
授权状态、节点绑定和节点运行状态分别统计，避免把有效 KEY 误认为节点在线。
授权总数0
已绑定节点0
待部署兑换0
暂停 / 吊销0
我的授权
完整 KEY 只在签发或获批领取窗口展示；安装命令不包含 KEY，执行后在服务器终端安全输入。
新节点部署流程
1. 复制对应审批域名的安装命令
2. 在 Ubuntu / Debian 服务器 SSH 终端执行
3. 按提示输入管理员邮箱与 OEM 授权码
认领线下授权码
仅用于商务或线下渠道另行交付的授权码；门户申请批准的 KEY 已自动归属，无需重复认领。