# 鸡鸡一键修改prop2.0

**Repository Path**: honsikun/ikun-prop

## Basic Information

- **Project Name**: 鸡鸡一键修改prop2.0
- **Description**: 鸡鸡一键修改prop2.0
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-11
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🐔 鸡鸡一键修改prop

> **Android build.prop 属性管理工具箱** — by Hons  
> 集属性扫描提取、批量修改、ADB 设备导出与 Magisk 模块生成为一体

---

## 📋 目录

- [简介](#简介)
- [核心功能](#核心功能)
  - [🔍 扫描提取属性](#-扫描提取属性)
  - [✏️ 修改更新属性](#️-修改更新属性)
  - [📱 提取设备 prop](#-提取设备-prop)
  - [📦 生成模块](#-生成模块)
- [技术特点](#技术特点)
- [运行环境](#运行环境)
- [使用方式](#使用方式)
- [项目结构](#项目结构)

---

## 简介

鸡鸡一键修改prop 是一款面向 **Android 玩机用户** 的桌面工具，提供 build.prop 属性文件的全流程管理能力。基于 **Python + Tkinter** 构建，采用现代化卡片式 UI 设计，无需记忆命令行参数，所有功能一键完成。

主界面采用四标签页布局，操作路径清晰：提取 → 修改 → 导出 → 打包，覆盖从属性收集到 Magisk 模块发布的完整链路。

---

## 核心功能

### 🔍 扫描提取属性

从分区目录中自动扫描所有 `build.prop` 文件，按白名单过滤提取目标属性键值对。

![扫描提取属性](screenshots/01-扫描提取属性.png)

**功能亮点：**
- 自动识别 `system` / `vendor` / `product` / `odm` 等分区的 `build.prop` 路径
- 支持白名单文件过滤，精准提取所需属性
- 🎨 ColorOS 扩展：支持扫描 8 个 `my_*` 分区（OPPO / 一加 / Realme 专用）
- 🔧 拯救者固定属性：一键将 9 个 `lgsi` 属性强制设为指定值
- 输出标准 `key=value` 格式文件，自动用记事本打开

---

### ✏️ 修改更新属性

批量将属性更新应用到所有 `build.prop` 文件，支持 `.txt` 和 `.json` 两种输入格式。

![修改更新属性](screenshots/02-修改更新属性.png)

**功能亮点：**
- 自动扫描源目录下所有 `build.prop` 文件
- 复制到目标目录后原地修改（不污染源文件）
- 仅更新已存在的键，不新增键（安全可控）
- 详细日志：逐文件显示修改/跳过的键数量
- 完成后自动打开目标目录

---

### 📱 提取设备 prop

通过 ADB 直连 Android 设备，实时执行 `getprop` 命令提取设备属性。

![提取设备prop](screenshots/03-提取设备prop.png)

**功能亮点：**
- 一键通过 ADB 获取设备全部属性
- 5 大可选项前缀过滤：`ro.bootimage.*` / `ro.build.*` / `ro.product.*` / `ro.system.*` / `ro.vendor.*`
- 自动格式转换：`[ro.build.version.sdk]: [31]` → `ro.build.version.sdk=31`
- 完善错误处理：检测 ADB 未安装、设备未连接、返回空数据等情况
- 输出为标准 `.prop` 文件，自动打开

---

### 📦 生成模块

一键生成 **Magisk 改机型刷机模块**，选择属性源文件 + 填写机型名称，自动打包为 ZIP。

![生成模块](screenshots/04-生成模块.png)

**功能亮点：**
- 源文件灵活选择：支持 `target_ro.prop`（ADB 提取）和 `props_extracted.txt`（分区扫描）
- 机型名称实时预览：输入框旁显示 `鸡鸡的` 前缀，底部预览区实时展示 `module.prop` 完整内容
- 自动生成 `module.prop`：
  - `id=Hons-model`
  - `name=鸡鸡的{机型名称}`（如 `鸡鸡的小米14Ultra`）
  - `description=你干嘛哎哟，彻底修改机型为鸡鸡的{机型名称}`
- 自动整合 `META-INF` 目录结构
- 打包为 `鸡鸡的{机型名称}.zip`，可直接刷入 Magisk
- 完成后自动打开构建目录

---

## 技术特点

| 特性 | 说明 |
|------|------|
| 🎨 **现代化 UI** | 卡片式布局 + 主题蓝配色 + 淡蓝色日志面板，四标签页切换 |
| ⚡ **异步执行** | 后台线程处理耗时任务，界面不冻结 |
| 📟 **实时日志** | 带彩色 tag 的滚动日志窗口，运行状态一目了然 |
| 🛡️ **安全设计** | 修改前自动备份（复制到目标目录），不破坏源文件 |
| 📂 **自动打开** | 任务完成自动打开输出文件/目录，无需手动查找 |
| ❌ **完善报错** | ADB 检测、文件校验、异常捕获，中文弹窗提示 |
| 🪶 **绿色运行** | 单文件 + 依赖目录，无需安装，解压即用 |

---

## 运行环境

| 依赖 | 版本要求 |
|------|----------|
| Python | 3.8+ |
| Tkinter | 内置（无需额外安装） |
| ADB（可选） | Android SDK Platform Tools（仅 📱提取设备prop 功能需要） |

**Python 包依赖：**
```
# 均为标准库，无需 pip 安装
tkinter, threading, subprocess, json, shutil, zipfile, pathlib
```

---

## 使用方式

### 方式一：直接运行（推荐）

```batch
双击 run.bat
```

或

```bash
python gui_main.py
```

### 方式二：打包为 EXE

```batch
双击 build.bat
```

打包后可在 `dist/` 目录找到 `Chicken_OneClick_Modify_prop.exe`，无需 Python 环境即可运行。

---

## 项目结构

```
鸡鸡一键改prop项目/
├── gui_main.py              # 主程序入口 + GUI 逻辑
├── ui.py                    # UI 组件模块（主题、按钮、卡片、日志框）
├── build.bat                # PyInstaller 打包脚本
├── run.bat                  # 一键运行脚本
├── icon.ico                 # 程序图标
├── properties_whitelist.txt # 属性白名单
├── 工具简介.md              # 本文档
│
├── screenshots/             # 截图目录（放入截图后生效）
│   ├── 01-扫描提取属性.png
│   ├── 02-修改更新属性.png
│   ├── 03-提取设备prop.png
│   └── 04-生成模块.png
│
├── 生成模块/                # Magisk 模块构建目录
│   ├── META-INF/
│   ├── module.prop
│   └── system.prop
│
├── system/                  # 分区 prop 示例文件
├── vendor/
├── product/
├── odm/
└── ...
```

---

<p align="center">
  <sub>Made with 💙 by Hons · 酷安@Hons百年</sub>
</p>