云应用聚合平台 —— 在工坊中发现各式各样的云应用,安装到你的云居桌面。
本仓库使用 pnpm workspace。现有 Web 和 Android 客户端位于 apps/mobile/,继续提供 apps.yunle.fun 浏览器版本;原生 iOS 位于 apps/ios/,原生 macOS 位于 apps/macos/,Electron 桌面端位于 apps/desktop/。公共业务与宿主协议按实际复用需求放入 packages/,各端独立构建和发布。
旧 iOS 兼容工程已按未分发客户端退役;Capacitor 当前仅用于 Android 主壳。共享原生代码已迁入 apps/ios,原生 iOS、原生 macOS 和 Electron 不依赖 Capacitor。剩余调用与后续迁移见 Capacitor 使用边界与退役准备。
- 🏠 云居(Home) —— iOS 风格桌面网格,长按编辑、拖拽排序、毛玻璃 Dock
- 🔍 寻乐(Discovery) —— 每日编辑推荐 + 每周热门排行
- 🏗️ 工坊(Workshop) —— 分类浏览、搜索、安装云应用;开发者可发布作品
- 📱 跨平台 —— Web + Android(Capacitor)+ 原生 iOS / macOS + Electron
- 🔐 多种登录 —— 微信、手机号 OTP、邮箱、密码、GitHub(仅 Web)
- ☁️ 云端同步 —— 桌面配置实时同步多设备
| 环境 | 地址 | 触发 |
|---|---|---|
| Production | https://apps.yunle.fun | 合并到 main 后由 EdgeOne 发布 |
EdgeOne 使用 Nuxt 框架和 apps/mobile 构建目录,通过 apps/mobile/edgeone.json 执行 pnpm --dir ../.. install --frozen-lockfile 和 pnpm run build:edgeone,Node.js 为 24.18.0。平台官方适配器生成完整 .edgeone 产物:.edgeone/assets 提供浏览器资源,.edgeone/cloud-functions/ssr-node 提供 Nitro API 和页面 fallback。每次发布都应按 仓库迁移与部署 核验实际页面、API 和部署版本。
专用 EdgeOne 构建入口要求干净检出,不允许应用目录或函数产物包含私有 .env 文件;服务器变量在平台配置。日常 pnpm build 和 Capacitor 构建继续使用原有 .output 流程。
node --version # 使用 .node-version 指定的 Node.js 24
pnpm i # 安装依赖
cp -n apps/mobile/.env.example apps/mobile/.env # 按本机环境填写
pnpm dev # 启动开发服务器(http://localhost:8001)从仓库根执行原有命令即可;应用命令转发到 apps/mobile,文档命令仍在 docs 中运行。
| 命令 | 说明 |
|---|---|
pnpm dev |
启动开发服务器(端口 8001,--host 暴露) |
pnpm build |
构建 Web 生产版本,输出到 apps/mobile/.output/ |
pnpm build:edgeone |
平台官方 Nuxt 适配器预处理后构建并检查全栈产物 |
pnpm check:edgeone-output |
检查完成适配后的 EdgeOne 函数、路由和运行依赖 |
pnpm dev:mobile |
显式启动 Web/移动客户端 |
pnpm build:mobile |
显式构建 Web/移动客户端 |
pnpm lint |
ESLint 检查(@antfu + UnoCSS + formatters) |
pnpm typecheck |
TypeScript 类型检查 |
pnpm test:unit |
运行单元测试(Vitest,单次) |
pnpm test:watch |
单元测试 watch 模式 |
pnpm test:coverage |
测试覆盖率报告 |
pnpm test:e2e |
Playwright E2E 测试 |
pnpm sync |
同步 web → Android |
pnpm build:android:release |
构建并验签 Android 发布包 |
pnpm release |
更新移动版本;发布前核对独立移动 Tag,见迁移文档 |
apps/macos/ 使用 SwiftUI + WKWebView,直接复用 iOS 的目录、认证、Keychain、网页数据仓库与 SSO 授权流程。支持公开免费应用、原生登录、会话恢复和已接入云应用的自动登录;Windows / Linux 继续使用下面的 Electron 入口。
pnpm dev:macos # 构建并启动原生 Mac 应用
pnpm build:macos # 只编译
pnpm test:macos # 共享认证测试与 Mac Keychain / WebKit 测试开发环境、复用边界和验证说明见 macOS 原生客户端。
pnpm dev:desktop # 本地 Nuxt + Electron,独立于移动开发服务
pnpm build:desktop # 生成静态 renderer 和主进程/preload
pnpm test:desktop # 桌面单元测试
pnpm make:desktop # 使用 Electron Forge 打包当前平台
pnpm verify:desktop # 检查原生包的 ASAR、生产依赖与 fuses
pnpm verify:desktop-artifacts # 检查安装包、构建记录与 SHA256
pnpm verify:desktop-launch # 实际启动当前平台原生包还可执行 pnpm typecheck:desktop、pnpm test:desktop:e2e 和 pnpm package:desktop。package:desktop 只生成原生应用目录;make:desktop 同时生成安装器,并把本次 Forge 产物、build-manifest.json 与 SHA256SUMS 整理到 apps/desktop/out/artifacts/,用于私有内测分发。
桌面端复用升级后的 vitesse-nuxt-electron:独立、安全的 shell/guest preload,BaseWindow + WebContentsView 容器和官方 Forge 打包流程。复用 packages/app-core 的目录类型、转换和快照,由主进程获取匿名公开目录,打开符合公开、免费和无登录要求的云应用。ICNS/ICO/PNG 使用移动端既有云乐坊标志;修改图标后在 macOS 执行 pnpm icons:desktop 重新导出。
产品仓库现阶段保持私有,桌面自动更新关闭,默认产物未配置分发签名。pnpm check:desktop-release 只校验稳定 Tag、桌面版本、目标仓库及更新策略,不上传产物。完整构建、三项校验与单平台手动 CI 见 桌面构建与私有内测;账号、云居、宿主 SSO 与正式签名/发布按 桌面架构 分阶段接入。
| 层级 | 选型 |
|---|---|
| 框架 | Nuxt 4(CSR 模式,ssr: false) + Vue 3 |
| UI | Ionic Vue(ios 模式) + Konsta UI |
| 样式 | Tailwind CSS 4 + UnoCSS(仅图标) + SCSS |
| 状态 | Pinia |
| 移动端 | Capacitor 8(仅 Android) |
| 原生 macOS | SwiftUI + AppKit + WKWebView(复用 iOS Swift 业务层) |
| Electron 桌面端 | Electron 44.7.0 + Electron Forge 8.0.1 |
| 后端 | Nitro Server + 腾讯 CloudBase |
| 认证 | CloudBase Auth + 微信 SDK + GitHub OAuth |
| 部署 | EdgeOne Pages(Git 集成) |
apps/
├── ios/ # 独立 SwiftUI 原生客户端(改造进行中)
├── macos/ # SwiftUI + WKWebView,共享 iOS 目录与认证源码
├── mobile/ # Web + Ionic + Capacitor
│ ├── app/ # Nuxt 4 页面、组件、composables、stores、plugins
│ ├── server/ # 云端 Nitro API
│ ├── android/ # Capacitor Android 工程
│ ├── scripts/ # 移动构建、版本同步与发布脚本
│ ├── test/ # Vitest + Playwright
│ └── package.json # Web/移动端依赖和版本
└── desktop/ # 独立 Nuxt 界面 + Electron + Forge
packages/ # 私有 workspace 包与原生插件
docs/ # VitePress 文档站
scripts/ # CloudBase 规则、索引与跨应用工具
package.json # 私有根包、统一命令和代码质量工具
pnpm-workspace.yaml # 工作区与依赖安全策略
pnpm-lock.yaml # 所有工作区共用锁文件
移动端环境文件在 apps/mobile/.env;iOS / Android 版本从 apps/mobile/package.json 读取。各应用的 .nuxt、.output、测试结果和原生构建产物均留在各自目录。
完整文档(产品设计、UI 规范、数据库、开发笔记、上架路线图)见:
- 本地预览:
pnpm docs:dev - 线上:https://apps.yunle.fun/docs
主要章节:
pnpm test:unit # 单元测试
pnpm test:e2e # E2E(Chromium/Firefox/WebKit 三浏览器矩阵)
pnpm test:coverage # 覆盖率Web/移动 CI 按源码和构建配置的路径过滤验证 lint、移动类型检查、生产构建、服务端运行依赖、单元及 Nuxt 测试,并单独运行 Chromium smoke。Desktop CI 在 macOS arm64、Windows x64、Ubuntu 24.04 x64 验证类型、单元、Electron 集成测试、安装包/构建记录、ASAR/fuses 与打包后启动;仅修改文档不触发桌面构建。workflow 进入默认分支后可手动选择 all、macos、windows 或 linux,安装包保留 3 天,失败 trace 保留 7 天。当前组织 Actions 预算阻止 runner 启动,远端三平台仍待实际运行。移动原生构建使用本机对应 SDK 验证,商店签名和正式发布独立执行。
- Fork 本仓库
- 创建特性分支:
git checkout -b feat/awesome - 提交前确保通过:
pnpm lint && pnpm typecheck && pnpm test:unit - 提交格式参考 Conventional Commits
- 发起 PR 到
main分支
发布前请先阅读 docs/roadmap.md 了解当前阻塞项。