可打包运行版本,该版本具有模块化特性。如果重置脚本换了,直接改相应类就可以了
This commit is contained in:
91
tingquan_assistant.py
Normal file
91
tingquan_assistant.py
Normal file
@@ -0,0 +1,91 @@
|
||||
"""
|
||||
听泉助手 - 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
|
||||
│
|
||||
├── config.py # 配置管理
|
||||
├── logger.py # 日志管理
|
||||
├── machine_resetter.py # 机器码重置
|
||||
├── update_disabler.py # 更新禁用
|
||||
├── cursor_token_refresher.py # Token刷新
|
||||
└── 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中整合界面
|
||||
- 更新配置和日志相关代码
|
||||
"""
|
||||
|
||||
import sys
|
||||
import os
|
||||
|
||||
# 添加项目根目录到Python路径
|
||||
current_dir = os.path.dirname(os.path.abspath(__file__))
|
||||
sys.path.insert(0, current_dir)
|
||||
|
||||
from PyQt5.QtWidgets import QApplication
|
||||
from gui.windows.main_window import MainWindow
|
||||
|
||||
def main():
|
||||
"""程序入口"""
|
||||
# 创建应用
|
||||
app = QApplication(sys.argv)
|
||||
|
||||
# 设置应用样式
|
||||
app.setStyle('Fusion')
|
||||
|
||||
# 创建主窗口
|
||||
window = MainWindow()
|
||||
window.show()
|
||||
|
||||
# 运行应用
|
||||
sys.exit(app.exec_())
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user