From 155a991897180d443a1ccf0122b111b89f72ed8f Mon Sep 17 00:00:00 2001
From: purpl <purpl@localhost>
Date: Sat, 27 Jun 2026 12:36:55 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=B8=AD=E6=96=87=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 创建 README.zh-CN.md，对照英文原版完整翻译
- 涵盖项目简介、修复内容、文件结构、使用方法、兼容性及注意事项
- 技术术语与代码块保持英文，自然语言部分使用简体中文
---
 README.zh-CN.md | 82 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
 create mode 100644 README.zh-CN.md

diff --git a/README.zh-CN.md b/README.zh-CN.md
new file mode 100644
index 0000000..e53d6db
--- /dev/null
+++ b/README.zh-CN.md
@@ -0,0 +1,82 @@
+# CB-C6s-STU GSI 修复包
+
+一个 TWRP 可刷写压缩包，用于在运行通用系统映像 (GSI) 时为 **CB-C6s-STU** 平板应用设备特定的修复。所有 `build.prop` 修改均采用**追加**方式——绝不会替换原有文件。
+
+## 修复内容
+
+| 领域 | 文件 | 问题 | 修复方式 |
+|------|------|------|----------|
+| 系统属性 | `build.prop` | 缺少平板特征声明、亮度范围错误、仅竖屏方向、蓝牙 A2DP offload 异常 | 追加缺失的属性 |
+| 触摸屏 | `goodix_ts.idc` | 未声明触摸方向和输入设备类型 | 安装 Goodix 触摸面板 IDC 配置 |
+| 摄像头传感器 | `sensor_config.xml` | 未配置前后摄像头传感器模块 | 安装 hi846 / gc8034 模块的传感器配置 |
+
+## 文件结构
+
+```
+CB-C6s-STU-GSI-Fixes.zip
+├── META-INF/com/google/android/
+│   ├── update-binary        # Shell 脚本 — 所有安装逻辑
+│   └── updater-script       # 占位文件（TWRP 使用 shell 脚本模式）
+├── system/
+│   ├── build.prop           # 追加到 /system/build.prop 的属性
+│   └── usr/idc/
+│       └── goodix_ts.idc    # 触摸屏输入设备配置
+└── vendor/etc/
+    └── sensor_config.xml    # 摄像头传感器模块映射
+```
+
+### build.prop 条目
+
+追加到设备已有的 `/system/build.prop`：
+
+```ini
+# 平板特性
+ro.build.characteristics=tablet
+
+# 解决：将 sprd_backlight 最大亮度设为 1023
+persist.sys.qcom-brightness=1023
+
+# 解决：将主显示屏方向设为横屏
+ro.surface_flinger.primary_display_orientation=ORIENTATION_90
+
+# 解决：禁用蓝牙 A2DP offload
+ro.bluetooth.a2dp_offload.supported=false
+persist.bluetooth.a2dp_offload.disabled=true
+```
+
+追加前会将原文件备份为 `/system/build.prop.bak`。
+
+## 使用方法
+
+1. 将 `CB-C6s-STU-GSI-Fixes.zip` 复制到设备（sdcard 或 adb push）。
+2. 启动进入 **TWRP Recovery**。
+3. 点击 **Install** → 选择压缩包 → **滑动确认刷写**。
+4. 重启设备。
+
+脚本会自动挂载 `/system` 和 `/vendor`，无需手动挂载。
+
+## TWRP 刷写输出
+
+刷写过程中，TWRP 将显示：
+
+```
+[1/3] 正在追加条目到 /system/build.prop...
+[2/3] 正在安装 goodix_ts.idc...
+[3/3] 正在安装 sensor_config.xml...
+```
+
+## 兼容性
+
+- **设备**：CB-C6s-STU 平板（Spreadtrum / Unisoc 平台）
+- **Recovery**：支持 `/sbin/sh` 的 TWRP（shell 脚本 update-binary 模式）
+- **GSI**：任何需要这些设备特定调整的 Android GSI
+
+## 注意事项
+
+- `build.prop` 条目是**追加而非替换**。多次刷写该压缩包会导致条目重复——如有需要，可从 `/system/build.prop.bak` 恢复，或先检查文件内容。
+- `sensor_config.xml` 覆盖四种摄像头传感器组合：后置（`hi846`、`gc8034_rear`）和前置（`hi846_front`、`gc8034`），每种都包含 OTP EEPROM 调校参数。
+- 对于 SAR（System-as-Root）设备，如果 `/vendor/etc/` 不可用，脚本会回退到 `/system/vendor/etc/`。
+
+## 许可
+
+按原样提供，用于设备维护。无任何担保。