ce编辑器 (Config Editor)

一个功能强大的Python配置文件和用户管理工具，提供直观的GUI界面进行配置管理、用户认证和会话安全控制。

主要特性

🔐 用户认证系统

首次登录即注册：新用户首次登录自动创建账户

二级密码保护：敏感操作需要二级密码验证

会话超时锁定：空闲超过10分钟自动锁定，需要重新登录

安全的密码存储：使用JSON格式加密存储用户凭证

📁 配置文件管理

智能解析：自动识别Python配置文件中的配置项

格式保持：编辑时保留原始注释、空格和格式

分组显示：按规则将配置项分组显示在不同标签页

拖拽排序：支持通过拖拽重新排列配置项顺序

⚙️ 高级功能

规则管理：可自定义显示名称、分组、校验规则等

加密字段：标记敏感配置项，修改时需要二级密码

隐藏字段：隐藏不需要显示的配置项

导入导出：支持规则文件的导入导出

校验规则：支持必填、范围、正则表达式等校验

🎨 用户界面

现代化UI：基于PyQt6的响应式界面

直观操作：拖拽排序、分组管理、批量操作

实时反馈：修改高亮、校验提示、状态监控

主题支持：标准的Fusion主题，视觉舒适

系统要求
操作系统：Linux（已测试Ubuntu 20.04+）

Python版本：Python 3.8+

依赖：PyQt6 >= 6.5.0

安装方法

使用deb包安装
确保已安装依赖：

bash
sudo apt-get update
sudo apt-get install python3 python3-venv python3-pip
安装deb包：

bash
sudo dpkg -i config-editor_1.3_amd64.deb


使用指南

首次运行设置
启动程序：首次运行会显示登录界面

用户注册：

输入用户名和密码（首次登录自动创建账户）

选择账号配置文件保存目录

设置二级密码用于敏感操作验证

配置文件设置：

登录后首次运行需要设置要编辑的配置文件路径

支持浏览选择或手动输入文件路径

可以使用相对路径（相对于程序目录）

主要功能使用

1. 配置文件编辑

打开文件：通过菜单或工具栏打开Python配置文件

编辑配置：直接在界面上修改配置项值

保存更改：保存时显示变更列表确认，保留原始格式

重新加载：随时重新加载配置文件

2. 规则管理

进入管理界面：点击"管理规则"按钮

配置项管理：设置显示名称、分组、类型、校验规则等

隐藏/显示：标记配置项为隐藏，或批量显示/隐藏

分组管理：创建、删除和重命名分组

3. 高级操作

拖拽排序：在分组内拖拽配置项标签重新排序

加密字段：标记敏感字段，修改时需要二级密码

批量操作：一键隐藏所有配置项，或全部显示

导入导出：导入/导出规则文件，方便备份和迁移

安全特性

会话管理

程序监控用户活动，空闲10分钟后自动锁定

锁定后需要重新登录才能继续操作

取消重新登录会退出程序以保障安全

二级密码验证

以下操作需要验证二级密码：

修改标记为加密的配置项

打开配置文件

配置文件设置

管理规则

显示隐藏项

一键隐藏所有项

项目结构
text
config-editor/
├── main.py              # 程序入口
├── main_window.py       # 主窗口实现
├── login/               # 登录认证模块
│   ├── login.py         # 用户认证管理器
│   └── login_dialog.py  # 登录对话框
├── dialogs.py           # 各种对话框
├── config_parser.py     # 配置文件解析器
├── file_handler.py      # 文件读写管理
├── models.py            # 数据模型定义
├── utils.py             # 工具函数集合
├── widgets.py           # 自定义控件
├── build.sh             # 打包脚本
├── requirements.txt     # 依赖列表
└── README.md            # 本文档
配置文件格式

程序支持标准的Python配置文件格式：

python
'''
# 数据库配置
DATABASE_HOST = "localhost"
DATABASE_PORT = 3306
DATABASE_USER = "admin"
DATABASE_PASSWORD = "secret_password"  # 可以标记为加密字段

# 应用配置
APP_NAME = "My Application"
DEBUG_MODE = False
LOG_LEVEL = "INFO"

# API配置
API_CONFIG = {
    "key": "your_api_key",
    "timeout": 30,
    "retries": 3
}
'''

故障排除

常见问题

无法启动程序

text
# 检查Python版本
python3 --version

# 检查PyQt6是否安装
python3 -c "import PyQt6"
虚拟环境问题（deb安装）

bash
# 重新创建虚拟环境
sudo /opt/config-editor/init_venv.sh

# 或使用管理工具
sudo python3 /opt/config-editor/manage_venv.py recreate
权限问题

bash
# 确保用户对以下目录有读写权限
~/.config_editor/
~/.config/config-editor/
/opt/config-editor/config_editor_rules.json
配置文件无法保存

检查配置文件路径是否正确

确保对配置文件有写权限

检查磁盘空间是否充足

调试模式
如需调试，可以查看以下日志位置：

控制台输出：直接运行python3 main.py查看输出

用户设置：~/.config_editor/user_settings.json

账号文件：用户选择的目录中的users.json

规则文件：程序目录下的config_editor_rules.json

开发指南
环境搭建
克隆项目：

bash
git clone <项目仓库>
cd config-editor
创建虚拟环境：

bash
python3 -m venv venv
source venv/bin/activate
安装依赖：

bash
pip install -r requirements.txt
运行开发版本：

bash
python main.py
代码结构说明
main_window.py：主程序逻辑，包含UI生成、事件处理、会话管理等

login/：用户认证模块，处理登录、注册、密码验证

config_parser.py：配置文件解析，保持格式和注释

dialogs.py：各种对话框的实现

models.py：数据模型定义，使用Python dataclass

utils.py：工具函数，如规则合并、校验、格式化等

打包说明
使用提供的build.sh脚本打包：

bash
# 赋予执行权限
chmod +x build.sh

# 执行打包
./build.sh
打包脚本会：

清理之前的构建

创建deb包目录结构

复制项目文件

创建启动脚本和桌面入口

生成虚拟环境初始化脚本

构建deb包