Skip to content

About

Main Application for YunLeFun.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

320 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

云乐坊 · yunle.fun

云应用聚合平台 —— 在工坊中发现各式各样的云应用,安装到你的云居桌面。

CI Desktop CI License

本仓库使用 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,见迁移文档

macOS 原生开发

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 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 验证,商店签名和正式发布独立执行。

🤝 贡献

  1. Fork 本仓库
  2. 创建特性分支:git checkout -b feat/awesome
  3. 提交前确保通过:pnpm lint && pnpm typecheck && pnpm test:unit
  4. 提交格式参考 Conventional Commits
  5. 发起 PR 到 main 分支

发布前请先阅读 docs/roadmap.md 了解当前阻塞项。

📄 License

MIT © YunYouJun

About

Main Application for YunLeFun.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages