开发者平台

发布你的 App 到应用商店

所有第三方 App 通过邮件审核后，会出现在 NyouOS 应用商店里。请按以下步骤提交：

如何使用开源版 NyouOS 来制作您的 Web 系统

NyouOS 以 GPLv3 协议开源。你可以自由使用、修改、分发，但衍生作品必须同样以 GPLv3 开源。下面是从零定制的完整流程。

1. 拿到源码并本地运行

下载或克隆 27.0/ 整个目录。项目没有 npm 依赖、不需要打包，直接用任意静态服务器跑：

# 在 27.0 目录里任选一种
python -m http.server 8000
npx http-server . -p 8000

然后打开 http://localhost:8000/。首次进入会走 OOBE，默认 PIN 是 1234。

2. 看懂目录结构

NyouOS On Web 27.0/
├─ index.html              # 页面骨架，按顺序加载 css/js
├─ css/                    # 系统样式（main.css 是主题变量）
├─ js/
│  ├─ core/                # 存储、状态、i18n、Daola、窗口组件
│  ├─ ui/                  # 桌面、任务栏、OOBE、锁屏
│  ├─ apps/                # 14 个内置应用
│  └─ main.js              # 入口，公开 API 在 window.FluentOS
├─ Theme/
│  ├─ Icon/nyouos_logo.png # 你的系统 logo（浅色/深色两张）
│  ├─ Picture/             # 壁纸
│  └─ ...
└─ scripts/                # manifest 生成与校验脚本

3. 换成你的品牌

把品牌名和 logo 换成你自己的：

• Logo：替换 Theme/Icon/nyouos_logo.png 和 nyouos_logo_dark.png。
• 系统名称：用户可见文字集中在 index.html、js/core/i18n.js、js/ui/oobe.js，全局搜索 NyouOS 改成你的名字即可。
• 配色：主题色变量在 css/main.css 开头的 :root 里。

4. 添加你自己的应用

每个应用是一个 JS 文件，放在 js/apps/。最简单的方式是打开系统里的开发者中心（设置 → 实验室 → 关闭"隐藏开发者中心"），用可视化界面创建应用。

在控制台里可以直接调用系统 API：

FluentOS.openApp('files');      # 打开文件
FluentOS.setTheme('dark');      # 切深色
FluentOS.notify('你好', '通知内容');
FluentOS.debug.getState();      # 调试

5. 改完必须重新生成清单

只要动了 index.html、js/、css/、Theme/ 里的任何文件，就要重跑这两个脚本，否则开机校验会失败：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\generate-resource-manifest.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\generate-storage-manifest.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\validate-project.ps1

6. 部署上线

把整个 27.0/ 目录拖到任意静态托管即可。官方站 nyouos.pages.dev 部署在 Cloudflare Pages：

1. 注册 Cloudflare Pages，连接你的 Git 仓库或直接上传文件夹。
2. 构建命令留空，输出目录设为 27.0（或你部署的子目录）。
3. 绑定你的自定义域名。

7. GPLv3 的义务

因为 NyouOS 用 GPLv3，如果你分发修改后的版本（包括部署成公开网站），你必须：

• 公开你修改后的完整源代码；
• 同样以 GPLv3 协议发布，不能改成闭源；
• 保留原作者版权声明和 LICENSE 文件。

联系方式