Skip to content

INSTALL.md

Latest commit

 

History

History
234 lines (173 loc) · 5.37 KB

INSTALL.md

File metadata and controls

234 lines (173 loc) · 5.37 KB

Windows Update管理工具 - 安装指南

📋 系统要求

操作系统

  • Windows 10 (所有主流版本)
  • Windows 11 (所有主流版本)
  • 支持不同DPI缩放比例 (100%/125%/150%/200%)

软件环境

  • Python 3.8 或更高版本
  • 管理员权限（某些功能需要）

🚀 快速安装

方法一：使用安装脚本（推荐）

  1. 下载项目文件

    git clone https://github.com/your-repo/windows-update-manager.git
cd windows-update-manager

  2. 运行安装脚本

    • 双击 install.bat 文件
    • 或在命令行中运行： 
      install.bat

  3. 启动程序

    • 双击 run.bat 文件
    • 或在命令行中运行： 
      python main.py

方法二：手动安装

  1. 安装Python

    • 访问 Python官网
    • 下载并安装Python 3.8+
    • 安装时勾选"Add Python to PATH"

  2. 安装依赖包

    pip install -r requirements.txt

    如果网络较慢，可使用国内镜像源：

    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

  3. 创建配置文件

    copy config.ini.example config.ini

  4. 运行程序

    python main.py

⚙️ 配置说明

首次运行设置

程序首次运行时会自动进行初始化：

  1. 创建配置目录

    • 用户配置：~/.windows_update_manager/
    • 日志目录：~/.windows_update_manager/logs/
    • 备份目录：~/.windows_update_manager/backups/

  2. 主题设置

    • 自动检测系统主题
    • 可在设置中手动切换

  3. 权限检查

    • 检查管理员权限
    • 提示需要权限的功能

配置文件详解

主配置文件 config.ini 包含以下设置：

[general]
first_run = true          # 是否首次运行
auto_start = false        # 开机自启动
language = zh_CN          # 界面语言

[theme]
auto_theme = true         # 自动适配系统主题
manual_theme = light      # 手动主题 (light/dark)

[background]
background_run = true     # 后台运行
process_hiding = false    # 进程隐藏
start_minimized = false   # 启动时最小化
hotkey_combination = Ctrl+Alt+U  # 唤醒快捷键

[update]
auto_check = true         # 自动检查更新
check_interval = 3600     # 检查间隔（秒）
notification_enabled = true  # 更新通知
update_types = security,cumulative,driver  # 更新类型
system_takeover = false   # 系统接管

[advanced]
log_level = INFO          # 日志级别
log_retention_days = 30   # 日志保留天数
cache_cleanup_auto = false  # 自动清理缓存
backup_before_modify = true  # 修改前备份

🔧 高级安装选项

开机自启动设置

  1. 通过程序设置

    • 在"设置"选项卡中勾选"开机自动启动"
    • 程序会自动创建任务计划

  2. 手动设置任务计划

    schtasks /create /tn "WindowsUpdateManager" /tr "C:\path\to\python.exe C:\path\to\main.py" /sc onstart /ru SYSTEM

管理员权限配置

某些功能需要管理员权限：

  • 修改Windows Update设置
  • 停止/启动系统服务
  • 修改注册表项
  • 清理系统缓存

获取管理员权限的方法：

  1. 右键点击 run.bat → "以管理员身份运行"
  2. 或在管理员命令提示符中运行 python main.py

防火墙和杀毒软件设置

如果遇到被拦截的情况：

  1. Windows Defender

    • 添加程序到排除列表
    • 路径：设置 → 更新和安全 → Windows安全中心 → 病毒和威胁防护 → 排除项

  2. 第三方杀毒软件

    • 将程序目录添加到白名单
    • 允许程序的网络访问（用于更新检查）

🐛 常见问题

安装问题

Q: pip安装依赖包失败 A: 尝试以下解决方案：

# 升级pip
python -m pip install --upgrade pip

# 使用国内镜像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

# 清除缓存重试
pip cache purge
pip install -r requirements.txt

Q: Python版本不兼容 A: 确保使用Python 3.8或更高版本：

python --version

运行问题

Q: 程序启动失败 A: 检查以下项目：

  1. Python环境是否正确
  2. 依赖包是否完整安装
  3. 是否有足够的权限
  4. 查看日志文件获取详细错误

Q: 某些功能无法使用 A: 确保以管理员身份运行程序

Q: 主题显示异常 A: 尝试手动切换主题或重启程序

权限问题

Q: 提示需要管理员权限 A: 右键选择"以管理员身份运行"或在管理员命令提示符中启动

Q: 无法修改Windows Update设置 A: 确保：

  1. 以管理员身份运行
  2. 系统支持相关操作
  3. 没有被组策略限制

📞 技术支持

如果遇到安装或使用问题：

  1. 查看日志文件

    • 位置：~/.windows_update_manager/logs/
    • 包含详细的错误信息

  2. 检查系统兼容性

    • 确认Windows版本支持
    • 检查Python版本兼容性

  3. 提交问题报告

    • 在GitHub上创建Issue
    • 提供详细的错误信息和系统环境

🔄 更新升级

程序更新

git pull origin main
pip install -r requirements.txt --upgrade

配置迁移

程序更新时会自动处理配置文件兼容性，无需手动迁移。

安装完成后，建议先阅读 README.md 了解详细使用方法。