听泉助手

听泉助手是一个用于管理 Cursor 编辑器激活的工具软件。

功能特点

• 激活码管理
• Cursor 编辑器授权刷新
• 机器码重置
• 更新禁用
• 系统托盘支持
• 自动更新检查

项目结构

├── services/           # 服务层 - 处理核心业务逻辑
│   ├── cursor_service.py   # Cursor服务管理类
│   └── __init__.py
│
├── gui/               # GUI层 - 处理界面相关逻辑
│   ├── components/    # 可复用的GUI组件
│   │   ├── widgets.py     # 基础UI组件
│   │   ├── workers.py     # 后台工作线程
│   │   └── __init__.py
│   ├── windows/      # 窗口类
│   │   ├── main_window.py # 主窗口实现
│   │   └── __init__.py
│   └── __init__.py
│
├── utils/            # 工具类
│   ├── version_manager.py  # 版本管理
│   └── __init__.py
│
├── config.py         # 配置管理
├── logger.py         # 日志管理
├── common_utils.py   # 通用工具函数
└── tingquan_assistant.py  # 程序入口文件

开发规范

1. 分层设计

   • services层: 处理核心业务逻辑,与界面解耦
   • gui层: 只处理界面相关逻辑,通过services层调用业务功能
   • 工具类: 独立的功能模块(如日志、配置等)

2. 代码规范

   • 使用类型注解
   • 函数必须有文档字符串
   • 遵循PEP 8命名规范
   • 异常必须合理处理和记录日志

3. 界面设计

   • 使用PyQt5构建GUI
   • 所有耗时操作必须在后台线程中执行
   • 界面组件需实现合理的状态管理

4. 配置管理

   • 用户配置存储在 %APPDATA%/TingquanAssistant/
   • 激活信息使用JSON格式存储
   • 配置文件需要权限控制

5. 日志规范

   • 所有关键操作必须记录日志
   • 日志按日期分文件存储
   • 包含足够的错误诊断信息

使用说明

1. 运行入口: python tingquan_assistant.py
2. 开发新功能流程:
   • 在services层添加业务逻辑
   • 在gui/components添加必要的界面组件
   • 在gui/windows中整合界面
   • 更新配置和日志相关代码

环境要求

• Python 3.8+
• PyQt5
• Windows 10/11

安装依赖

pip install -r requirements.txt

开发环境设置

1. 克隆仓库

git clone https://git.586vip.cn/oadmin/tingquanzhushou.git
cd tingquanzhushou

2. 创建虚拟环境

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

3. 安装依赖

pip install -r requirements.txt

构建和打包

使用 build.bat 脚本进行构建和打包：

build.bat

打包后的文件将在 dist 目录中生成。

许可证

版权所有 © 2024 听泉助手