修改

Author: Dong-Jing-Yu

_posts/2025-07-29-GuangZou.md

@@ -1,99 +1,78 @@
 ---
-title: "光奏 (GuangZou) - Android APK 开发文档"
+title: "光奏 (GuangZou) - 功能与特性文档"
 date: 2025-07-27 08:00:00 +0800
 categories: [开发,Android]
-tags: [APK,Kotlin]
+tags: [APK,Kotlin,光遇]
 ---
 
-#### **简介**
+一款基于 **Kotlin** 开发的《光·遇》自动弹奏应用。无需 Root 权限,通过**无障碍服务**或 **Shizuku** 两种模式实现高精度模拟触控。UI 遵循 Material Design,风格简洁并支持动态取色。
 
-`光奏 (GuangZou)` 是一款专为《光·遇》玩家设计的安卓端自动弹奏辅助工具。项目采用 **Kotlin** 语言进行原生开发,旨在提供一个功能强大、高度可定制且无需 Root 权限的弹奏体验。
+详情请访问项目的 GitHub 主页:[Dong-Jing-Yu/GuangZou](https://github.com/Dong-Jing-Yu/GuangZou)
 
-应用内置两种模拟触控方案(**无障碍服务**与 **Shizuku**),以满足不同用户对精度和稳定性的需求。UI 设计遵循 Material Design 规范,在不同安卓版本上可自适应主题与配色,确保界面简洁、美观、易用。
+## ✨ 主要特性
 
-**项目地址**: [https://github.com/Dong-Jing-Yu/GuangZou](https://github.com/Dong-Jing-Yu/GuangZou)
+  * **双触摸引擎**:支持标准的**无障碍服务**模式和更高效的 **Shizuku (ADB)** 高级模式,可随时切换。
+  * **高度自定义界面**:
+      * **智能主题**:在 Android 12+ 上支持 **Material You** 动态取色,低版本系统亦有优化的暗色模式。
+      * **悬浮窗定制**:可自由调整主悬浮窗和最小化悬浮球的**不透明度**,并支持**自定义悬浮球图标**。
+  * **精准适配**:
+      * **分辨率管理**:内置多种分辨率布局方案,应用会为你自动匹配,也支持手动选择,确保在不同设备上的按键定位准确。
+      * **键位预览**:在开始弹奏前,可开启按键位置预览,方便对齐游戏内乐器界面。
+  * **现代化的体验**:完全使用 Kotlin 和最新的 Android Jetpack 组件开发,性能与体验俱佳。
 
------
+## 📱 应用信息
 
-### **核心功能**
+| 属性         | 值                                      |
+|--------------|-----------------------------------------|
+| **应用名称** | 光奏                                    |
+| **英文名** | GuangZou                                |
+| **包名** | `com.GuangZou.sky`                      |
+| **平台** | Android                                 |
+| **开发语言** | Kotlin                                  |
+| **最低 SDK** | API 28 (Android 9.0)                    |
+| **构建工具** | Kotlin DSL (`build.gradle.kts`)         |
+| **Root** | ❌ (完全不需要)                         |
 
-  * **🎹 双模式触控引擎**:
+## 🎨 主题与配色
 
-      * **无障碍服务**: 标准模式,稳定性与兼容性俱佳,满足绝大部分日常使用场景。
-      * **Shizuku (ADB)**: 高级模式,提供更低延迟、更精准的底层模拟触控,适合对演奏精度有极致要求的用户。
+  * **Android 12+**: 使用 **Material You** 动态壁纸取色。
+  * **Android 10-11**: 启用系统的 **Force Dark** 模式。
+  * **Android 9**: 使用内置的 **Dark Theme** 暗色主题。
 
-  * **✨ 强大的悬浮窗系统**:
+## 🔐 权限说明
 
-      * **主控制面板**: 集成乐谱信息展示与播放/暂停/停止等核心控制功能。
-      * **琴谱选择器**: 在独立的悬浮窗口中选择乐谱,操作互不干扰。
-      * **最小化悬浮球**: 可将主窗口最小化为可自定义图标的悬浮球,减少屏幕遮挡。
+应用需要以下权限以正常工作:
 
-  * **🎨 高度自定义选项**:
+  * **无障碍服务 (核心)**:用于执行模拟点击操作,是实现自动弹奏的基础。这是最主要的权限。
+  * **存储访问**:用于读取存放于指定目录下的琴谱文件。
+  * **悬浮窗**:用于显示控制播放/暂停/停止的浮动操作面板。
+  * **Shizuku (可选)**:若想使用更高效的 `ADB` 触摸模式,则需要授予此权限。不授予也不影响无障碍模式的正常使用。
 
-      * **主题外观**: 自适应系统,支持 Material You、夜间模式等。
-      * **分辨率校准**: 内置多种屏幕分辨率布局,用户可根据设备情况自由选择,确保按键位置精确。
-      * **个性化设置**: 自由调整主悬浮窗与悬浮球的透明度、自定义悬浮球图标等。
+## 🎼 琴谱格式
 
-  * **📂 智能琴谱管理**:
+  * **路径**:请将琴谱文件放置在 **`/storage/emulated/0/光奏/谱/`** 目录下。
 
-      * 自动扫描并解析指定目录下的 `json` 琴谱文件。
-      * 在主界面以可收缩列表形式清晰展示琴谱的标题、作者和BPM信息。
+  * **格式**:适配来自 **Sky Studio** 等工具导出的**未加密 `JSON` 格式**琴谱。应用会读取文件中的元数据以在列表中展示。
 
-  * **🎯 可视化键位预览**:
+    一个基础的琴谱文件结构如下:
 
-      * 一键开启按键位置预览,在屏幕上显示半透明的坐标点,方便用户将悬浮窗与游戏内的乐器界面精确对齐。
-
------
-
-### **📱 应用信息**
-
-| 属性         | 值                                            |
-|--------------|-----------------------------------------------|
-| **应用名称** | 光奏                                          |
-| **英文名** | GuangZou                                      |
-| **包名** | `com.GuangZou.sky`                            |
-| **平台** | Android                                       |
-| **开发语言** | Kotlin                                        |
-| **最低 SDK** | API 28 (Android 9.0)                          |
-| **构建工具** | Kotlin DSL (`build.gradle.kts`)               |
-| **ADB 工具** | [Shizuku](https://shizuku.rikka.app/zh-hans/) (可选) |
-| **Root** | ❌                                            |
-
------
-
-### **🎨 配色方案**
-
-  * **Android 12+**: 使用 **Material You** 动态取色,与系统壁纸和主题融为一体。
-  * **Android 10-11**: 启用系统的 **Force Dark** (强制深色) 模式。
-  * **Android 9**: 使用内置的 **Dark Theme** (深色主题)。
-
------
-
-### **🔐 权限说明**
-
-#### 必要权限
-
-  * **无障碍服务**: 应用的核心,用于执行模拟屏幕点击操作来弹奏乐曲。
-  * **存储访问**: 用于扫描、读取本地琴谱 (`.json`) 文件。
-  * **悬浮窗**: 用于显示浮动控制面板和悬浮球,实现在游戏顶层的交互操作。
-
-#### 可选权限
-
-  * **Shizuku**: 用于启用“高级触摸模式”,通过 ADB 指令执行更底层的模拟点击。若不使用此模式,则无需授予该权限。
-
------
-
-### **🎼 琴谱规格**
-
-  * **存储路径**: `/storage/emulated/0/光奏/谱/`
-  * **文件格式**: 应用适配基于 `JSON` 格式的未加密琴谱文件。`JSON` 文件的基本结构应如下所示：
     ```json
     {
       "name": "琴谱标题",
       "author": "作者",
       "bpm": 120,
       "notes": [
-        // 音符数据...
+        // ... 音符数据 ...
       ]
     }
-    ```
+    ```
+
+## ⚙️ 功能设置
+
+应用内提供了丰富的设置选项,让你能根据自己的习惯进行配置:
+
+  * **页面外观**: 切换应用的主题。
+  * **分辨率选择**: 手动选择一个最适合你设备的按键布局方案。
+  * **触摸方式**: 在 `无障碍服务` 和 `Shizuku` 两种模拟触摸模式之间切换。
+  * **悬浮窗/悬浮球不透明度**: 分别调整主窗口和最小化小球的透明度。
+  * **悬浮球图标**: 个性化设置最小化状态下的悬浮球图标。