cutThenThink/docs/BUILD.md

CutThenThink 打包指南

Windows 打包

方法一：使用批处理脚本（推荐）

# 双击运行
build.bat

方法二：手动命令

# 1. 安装依赖
pip install -r requirements.txt

# 2. 安装 PyInstaller
pip install pyinstaller

# 3. 构建
python -m PyInstaller CutThenThink.spec --clean

输出位置

dist/
└── CutThenThink/
    ├── CutThenThink.exe    # 主程序
    └── _internal/         # 运行时依赖

可选：安装 OCR 支持

pip install -r requirements-ocr.txt

Linux/macOS 打包

使用 Shell 脚本

# 添加执行权限
chmod +x build.sh

# 运行
./build.sh

手动命令

# 1. 安装依赖
pip install -r requirements.txt

# 2. 安装 PyInstaller
pip install pyinstaller

# 3. 构建
python -m PyInstaller CutThenThink.spec --clean

打包说明

PyInstaller 配置

• --onefile: 打包成单个 EXE
• --windowed: 无控制台窗口
• --upx: 使用 UPX 压缩（减小体积）
• --clean: 清理旧的构建

包含的隐式导入

• PyQt6.QtCore
• PyQt6.QtGui
• PyQt6.QtWidgets
• yaml

排除的模块

• test, tests, pytest

首次运行配置

程序首次运行时会创建配置文件：

Windows: %USERPROFILE%\.cutthenthink\config.yaml Linux/macOS: ~/.cutthenthink/config.yaml

upload:
  provider: custom
  endpoint: https://your-server.com/upload
  api_key: your-api-key
  auto_copy: true

screenshot:
  format: png
  save_path: ~/Pictures/Screenshots

hotkeys:
  capture: Ctrl+Shift+A
  region: Ctrl+Shift+R
  upload: Ctrl+Shift+U

ocr:
  enabled: false
  auto_copy: false

故障排除

PyInstaller 构建失败

1. 确保 PyInstaller 已安装：pip list | grep pyinstaller
2. 检查 Python 版本：需要 Python 3.8+
3. 清理缓存：删除 build/ 和 dist/ 目录后重试

运行时错误

1. 检查是否有防火墙阻止
2. 检查 OCR 功能是否可选安装
3. 查看日志文件（如果有）

体积优化建议

当前打包体积预估：

• 核心依赖：~50MB
• 可选 OCR：+10MB

如需进一步减小体积：

1. 使用 --exclude-module 排除不需要的模块
2. 启用 UPX 压缩（已启用）
3. 使用虚拟环境减少依赖