congsh/cutThenThink
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

build: 添加 Windows 打包方案

Browse Source 
- 更新 PyInstaller spec 配置
- 简化 build.sh 构建脚本
- 更新 build.bat Windows 打包脚本
- 添加 docs/BUILD.md 打包说明文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
congsh
2026-02-12 15:59:23 +08:00
parent e853161975
commit 0ce1d71a90
4 changed files with 223 additions and 189 deletions
Download Patch File Download Diff File Expand all files Collapse all files

66
CutThenThink.spec
View File

@@ -1,20 +1,47 @@
# -*- mode: python ; coding: utf-8 -*-
"""
CutThenThink - Windows 打包配置
极简截图上传工具的 PyInstaller 配置
"""
import sys
from PyInstaller.building.build_main import Analysis, EXE, COLLECT, PYZ
from PyInstaller.building.api import PKG
# 项目信息
APP_NAME = 'CutThenThink'
APP_VERSION = '2.0.0'
# 分析配置
a = Analysis(
['src/main.py'],
pathex=[],
binaries=[],
datas=[('src', 'src')],
hiddenimports=['PyQt6.QtCore', 'PyQt6.QtGui', 'PyQt6.QtWidgets', 'sqlalchemy'],
datas=[
# 包含配置文件模板
('config.yaml.template', '.'),
],
hiddenimports=[
'PyQt6.QtCore',
'PyQt6.QtGui',
'PyQt6.QtWidgets',
'yaml',
],
hookspath=[],
hooksconfig={},
runtime_hooks=[],
excludes=[],
excludes=[
# 排除测试相关
'test',
'tests',
'pytest',
],
noarchive=False,
optimize=0,
)
pyz = PYZ(a.pure)
# 打包配置
pyz = PYZ(a.pure, a.zipped_data, cipher=None)
exe = EXE(
pyz,
@@ -22,17 +49,42 @@ exe = EXE(
a.binaries,
a.datas,
[],
name='CutThenThink',
exclude_binaries=True,
name=APP_NAME,
debug=False,
bootloader_ignore_signals=False,
strip=False,
upx=True,
upx=True, # 使用 UPX 压缩
upx_exclude=[],
runtime_tmpdir=None,
console=False,
console=False, # 无控制台窗口
disable_windowed_traceback=False,
argv_emulation=False,
target_arch=None,
codesign_identity=None,
entitlements_file=None,
icon=None, # TODO: 添加图标路径
)
# 收集所有文件
coll = COLLECT(
exe,
a.binaries,
a.zipfiles,
a.datas,
strip=False,
upx=True,
upx_exclude=[],
name=APP_NAME,
)
# 构建 MSI 安装包（Windows）
pkg = PKG(
coll,
name=APP_NAME,
version=APP_VERSION,
description='极简截图上传工具',
author='CutThenThink',
keywords=['screenshot', 'upload', 'OCR'],
license='MIT',
)

104
build.bat
View File

@@ -1,99 +1,49 @@
@echo off
REM ================================
REM CutThenThink Windows Build Script - Cloud Only Version
REM ================================
REM 纯云端版本 - 无需本地 ML 库
REM CutThenThink 极简版本 Windows 打包脚本
REM 设置控制台编码为 UTF-8
chcp 65001 >nul 2>&1
cd /d "%~dp0"
echo ========================================
echo CutThenThink 纯云端版本构建
echo ========================================
echo ===================================
echo CutThenThink v2.0 极简版构建
echo ===================================
echo.
echo 特点：
echo - OCR 使用云端 API
echo - AI 使用 API (OpenAI/Anthropic)
echo - 无需任何本地 ML 库
echo ========================================
echo - 核心依赖：PyQt6, requests, Pillow
echo - 可选 OCR：RapidOCR 插件
echo - 无重型依赖：torch, transformers, paddleocr
echo ===================================
echo.
REM Check Python
echo [1/5] 检查 Python...
python --version 2>nul
if errorlevel 1 (
echo 错误: 未找到 Python
pause
exit /b 1
)
echo.
echo [2/5] 检查源码大小...
set SIZE=0
for /r %%A in (src\*) do (
set /a SIZE+=%%~zA
)
if %SIZE% GTR 5242880 (
echo 警告: src 目录大小超过 5MB，构建的 exe 可能会很大
echo 当前大小: %SIZE% 字节
echo.
)
echo.
echo [3/5] 安装核心依赖...
python -m pip install --user pyinstaller 2>nul
python -m pip install --user "PyQt6>=6.7.0" 2>nul
python -m pip install --user "SQLAlchemy>=2.0.36" 2>nul
python -m pip install --user openai anthropic 2>nul
python -m pip install --user requests pyyaml pillow pyperclip 2>nul
echo.
echo [4/5] 清理旧的构建...
REM [1/3] 清理旧的构建
echo [1/3] 清理旧的构建...
if exist build rmdir /s /q build
if exist dist rmdir /s /q dist
REM [2/3] 安装构建依赖
echo.
echo [5/5] 开始构建...
python -m PyInstaller ^
--noconfirm ^
--name "CutThenThink" ^
--windowed ^
--onefile ^
--add-data "src:src" ^
--hidden-import=PyQt6.QtCore ^
--hidden-import=PyQt6.QtGui ^
--hidden-import=PyQt6.QtWidgets ^
--hidden-import=sqlalchemy ^
--hidden-import=sqlalchemy.orm ^
--hidden-import=PIL ^
--hidden-import=PIL.Image ^
--hidden-import=pyperclip ^
--hidden-import=yaml ^
--hidden-import=requests ^
--hidden-import=openai ^
--hidden-import=anthropic ^
--collect-all pyqt6 ^
src/main.py
echo [2/3] 安装构建依赖...
pip install pyinstaller 2>NUL || echo PyInstaller 已安装
REM [3/3] 构建可执行文件
echo.
echo [3/3] 构建可执行文件...
python -m PyInstaller CutThenThink.spec --clean
if errorlevel 1 (
echo.
echo ================================
echo 构建失败！
echo ================================
pause
exit /b 1
)
echo.
echo ================================
echo 构建成功！
echo ================================
echo 可执行文件: dist\CutThenThink.exe
echo ===================================
echo 构建完成！
echo ===================================
echo.
echo 首次运行请配置：
echo - AI API Key (OpenAI/Anthropic)
echo - 云端 OCR API
echo 输出位置：
echo - dist\CutThenThink\ # 可执行文件目录
echo.
echo 首次运行前请配置：
echo 1. 可选安装 OCR：pip install -r requirements-ocr.txt
echo 2. 配置文件：%%USERPROFILE%%\.cutthenthink\config.yaml
echo.
pause

80
build.sh
View File

@@ -1,76 +1,46 @@
#!/bin/bash
# CutThenThink 纯云端版本打包脚本
# 无需任何本地 ML 库
# CutThenThink 极简版本打包脚本
set -e
echo "==================================="
echo "CutThenThink 纯云端版本构建"
echo "CutThenThink v2.0 极简版构建"
echo "==================================="
echo ""
echo "特点："
echo "- OCR 使用云端 API"
echo "- AI 使用 API (OpenAI/Anthropic)"
echo "- 无需任何本地 ML 库"
echo "- 核心依赖：PyQt6, requests, Pillow"
echo "- 可选 OCR：RapidOCR 插件"
echo "- 无重型依赖：torch, transformers, paddleocr"
echo "==================================="
# 使用系统Python和pip
# 检测 Python
PYTHON="python3"
PIP="python3 -m pip"
if ! command -v python3 &>/dev/null; then
PYTHON="python"
fi
PIP="$PYTHON -m pip"
echo ""
echo "[1/4] 安装打包工具..."
$PIP install --user pyinstaller 2>/dev/null || echo " PyInstaller可能已安装"
echo ""
echo "[2/4] 安装核心依赖..."
$PIP install --user "PyQt6>=6.7.0" 2>/dev/null || echo " PyQt6可能已安装"
$PIP install --user "SQLAlchemy>=2.0.36" 2>/dev/null || echo " SQLAlchemy可能已安装"
$PIP install --user openai anthropic 2>/dev/null || echo " AI库可能已安装"
$PIP install --user requests pyyaml pillow pyperclip 2>/dev/null || echo " 工具库可能已安装"
echo ""
echo "[3/4] 清理旧的构建..."
echo "[1/5] 清理旧的构建..."
rm -rf build dist
echo ""
echo "[4/4] 开始构建..."
$PYTHON -m PyInstaller \
--name "CutThenThink" \
--windowed \
--onefile \
--add-data "src:src" \
--hidden-import=PyQt6.QtCore \
--hidden-import=PyQt6.QtGui \
--hidden-import=PyQt6.QtWidgets \
--hidden-import=sqlalchemy \
--hidden-import=sqlalchemy.orm \
--hidden-import=PIL \
--hidden-import=PIL.Image \
--hidden-import=pyperclip \
--hidden-import=yaml \
--hidden-import=requests \
--hidden-import=openai \
--hidden-import=anthropic \
--collect-all pyqt6 \
src/main.py
echo "[2/5] 安装构建依赖..."
$PIP install --user pyinstaller 2>/dev/null || echo " PyInstaller 已安装"
echo ""
echo "[3/5] 构建可执行文件..."
$PYTHON -m PyInstaller CutThenThink.spec --clean
echo ""
echo "==================================="
echo "构建完成！"
echo "可执行文件: dist/CutThenThink"
echo ""
echo "输出位置："
echo " - dist/CutThenThink/ # 可执行文件"
echo ""
echo "首次运行前请配置："
echo " 1. 可选安装 OCR：pip install -r requirements-ocr.txt"
echo " 2. 配置文件：~/.cutthenthink/config.yaml"
echo "==================================="
echo ""
echo "首次运行请配置："
echo "- AI API Key (OpenAI/Anthropic)"
echo "- 云端 OCR API"
echo ""
# 测试运行提示
echo ""
read -p "是否测试运行？(y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
echo "启动测试..."
./dist/CutThenThink
fi

162
docs/BUILD.md
View File

@@ -1,74 +1,136 @@
# CutThenThink 打包指南
## 方式一：使用 build.sh 脚本（推荐）
## Windows 打包
在您的本地环境（有管理员权限）中运行：
### 方法一：使用批处理脚本（推荐）
```bash
cd /path/to/CutThenThink
bash build.sh
```cmd
# 双击运行
build.bat
```
---
### 方法二：手动命令
## 方式二：手动打包
### 1. 安装 PyInstaller
```bash
# 使用 pipx（推荐）
pipx install pyinstaller
# 或使用系统包管理器
sudo apt install python3-pyinstaller
```
### 2. 安装项目依赖
```bash
```cmd
# 1. 安装依赖
pip install -r requirements.txt
# 2. 安装 PyInstaller
pip install pyinstaller
# 3. 构建
python -m PyInstaller CutThenThink.spec --clean
```
### 3. 执行打包
### 输出位置
```
dist/
└── CutThenThink/
├── CutThenThink.exe # 主程序
└── _internal/ # 运行时依赖
```
### 可选：安装 OCR 支持
```cmd
pip install -r requirements-ocr.txt
```
## Linux/macOS 打包
### 使用 Shell 脚本
```bash
python3 -m PyInstaller \
--name "CutThenThink" \
--windowed \
--onefile \
--add-data "src:src" \
--hidden-import=PyQt6.QtCore \
--hidden-import=PyQt6.QtGui \
--hidden-import=PyQt6.QtWidgets \
--hidden-import=sqlalchemy \
src/main.py
# 添加执行权限
chmod +x build.sh
# 运行
./build.sh
```
### 4. 测试运行
### 手动命令
```bash
./dist/CutThenThink
# 1. 安装依赖
pip install -r requirements.txt
# 2. 安装 PyInstaller
pip install pyinstaller
# 3. 构建
python -m PyInstaller CutThenThink.spec --clean
```
---
## 打包说明
## 打包参数说明
### PyInstaller 配置
| 参数 | 说明 |
|------|------|
| `--name` | 应用名称 |
| `--windowed` | 无控制台窗口 |
| `--onefile` | 单文件打包 |
| `--add-data` | 添加数据文件（源代码） |
| `--hidden-import` | 隐式导入模块 |
- `--onefile`: 打包成单个 EXE
- `--windowed`: 无控制台窗口
- `--upx`: 使用 UPX 压缩（减小体积）
- `--clean`: 清理旧的构建
---
### 包含的隐式导入
## 打包后
- PyQt6.QtCore
- PyQt6.QtGui
- PyQt6.QtWidgets
- yaml
可执行文件位置：`dist/CutThenThink`
### 排除的模块
分发时建议：
1. 将 `dist/CutThenThink` 打包为 tar.gz
2. 创建安装脚本
3. 包含 README 说明
- test, tests, pytest
## 首次运行配置
程序首次运行时会创建配置文件：
**Windows**: `%USERPROFILE%\.cutthenthink\config.yaml`
**Linux/macOS**: `~/.cutthenthink/config.yaml`
```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. 使用虚拟环境减少依赖