# Funny OS Open Rom

**Repository Path**: littlelu-linux/funny-os-project

## Basic Information

- **Project Name**: Funny OS Open Rom
- **Description**: 嗨！这里是开方团队出品的Funny OS
这是开源免费的Rom
提供VMOS Pro和VPhone GaGa两个版本
- **Primary Language**: 其他
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/littlelu-linux/funny-os-project/
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2025-09-27
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: android-modules

**Tags**: None

## README

<div align="center">

### 🌿 开方OS · Kernelized Agile Framework Operating System
<i>原 Funny OS -- Fully Unified Native New Yield Operating System Project</i>

<p>
  <img src="https://img.shields.io/badge/Status-Stable-brightgreen" alt="Status">
  <img src="https://img.shields.io/badge/Kernel-Android_9_&_10-blue" alt="Kernel">
</p>

</div>

---

### 🚀 版本快讯与更新日志

#### 🔥 光速虚拟机版重大突破
**成功支持第三方图标包美化 QuickStep！**
经过技术攻关，光速虚拟机版本（Android 10）现已完美支持第三方图标包对原生桌面（QuickStep）进行深度美化，个性化定制不再受限。

#### 🐞 已知问题与交互优化
在进入部分软件的瞬间立即返回桌面，可能会触发空指针异常导致卡崩。

- **暂行缓解方法**：
  > 在应用启动卡顿的那一刻，请**缓慢地**从全面屏手势小白条向上滑动，**拖拽至超过屏幕高度的四分之三**后再松手；或者等待界面初步响应（卡顿过去）后再进行返回操作。
  >
  > *原理：通过延长手势交互时间，确保应用进程完全建立后再触发返回动作，避开空指针陷阱。*

---

### 🧩 技术架构与组件变更

开方OS Project 基于 AOSP + LineageOS 深度定制，采用中高度魔改策略。

#### 核心组件
- **系统设置 (Settings)**：深度定制 UI，集成专属版本信息页与铭文志（“红橙黄绿青蓝紫...”）。
- **文件管理 (Files)**：采用 LineageOS 原生组件。
- **桌面环境**：
    - **光速版**：保留 QuickStep 并增强图标包支持。
    - **VMOS 版**：替换为 Trebuchet Launcher。

#### 权限与模块化框架
- **Root 方案**：集成 Magisk，实现系统无侵入式修改。
- **Hook 框架重大变更**：
    - **光速虚拟机版本**：**采用 LSPosed 衍生版**。鉴于 LSPosed 官方原版已归档，本项目已切换至维护更活跃、兼容性更优的衍生版本，确保长期稳定性。
    - **VMOS Pro 版本**：采用 LSPatch 方案，配合 Shizuku 服务自动启动。

---

### 📱 风味构建与独立更新策略

本项目采用 **独立构建、独立更新** 的双轨策略，两个版本互不兼容，请按需下载。

| 构建版本 | 基础环境 | 适配平台 | 核心特性 | 更新模式 |
| :--- | :--- | :--- | :--- | :--- |
| **光速定制版** | Android 10 | 光速虚拟机 | 支持第三方图标包美化<br>集成 LSPosed 衍生版<br>System 分区直接修改 + Platform 签名 | **独立更新**<br>侧重图形渲染与兼容性 |
| **VMOS 适配版** | Android 9 | VMOS Pro | 集成 Trebuchet 桌面/联系人/信息<br>采用 LSPatch + Shizuku | **独立更新**<br>侧重功能完整性 |

---

### ⚠️ 光速虚拟机专属风险提示

- **禁止操作**：直接修改 `/system` 分区内的 APK 文件（删除/替换）。
- **后果**：系统重启将卡在 **79%**，导致软砖。
- **推荐方案**：
    1.  **重打包签名**：APKTool 修改 -> Platform 签名覆盖。
    2.  **Magisk 挂载**：利用 Magisk 模块在 `post-fs-data` 阶段注入（推荐）。

---

### 🛠️ 虚拟机适配矩阵

| 虚拟机环境 | Android 版本 | Root 方案 | 模块框架 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| **光速虚拟机** | 10 | Magisk v26 | **LSPosed (衍生版)** | ✅ 稳定 |
| **VMOS Pro** | 9 |  Magisk修改版 | Lsposed | ✅ 适配 |

---

### 📄 开源协议

本项目遵循 **OSRL** 开源协议。
许可证详见[OSRL许可证声明](https://gitee.com/littlelu-linux/funny-os-project/blob/master/LICENSE2)
- **项目主页**：[Gitee 项目地址]
- **交流反馈**：QQ群 `922141409`

> **致谢**：感谢 哔哩哔哩@小山ZQR、@SYSTEM-L-WIN QQ@Leo的技术支持