chengma/cmshoppe
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add versioned release packaging

Browse Source
This commit is contained in:
chengma
2026-07-07 14:21:30 +08:00
parent 148c4a73eb
commit 7838554c3d
14 changed files with 407 additions and 113 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/03-tech-stack.md
+7 -7
View File
@@ -7,7 +7,7 @@
| 维度 | 选型 | 状态 | 理由 / 说明 |
| --- | --- | --- | --- |
| 语言 | Python 3.10+ | 已定 | 已有脚本均为 Python；标准库够用 |
| 语言 | Python 3.10（正式打包固定）；CI 使用 3.11 | 已定 | 发布构建固定使用 `py -3.10`；源码曾验证可在 3.7.9 运行，但不作为发布打包基线 |
| 运行平台 | Windows（生产）；WSL 可用于开发 | 已定 | Chrome 与各 user-data-dir 在 Windows；GUI 与 Chrome 同机，CDP 走 `localhost` |
| 浏览器自动化 | 自研 CDP 客户端 `app/cdp.py` | 已定 | 基于 websocket-client + requests 手写；不引入 playwright/selenium，规避代理与 Origin 坑 |
| WebSocket | `websocket-client`（import `websocket`） | 已定 | 讲 CDP 协议；用 `suppress_origin=True` 绕过 403 |
@@ -41,19 +41,19 @@
- **T-504 更新执行增强**：③ 支持 dry-run 预览、运行日志和按账号并行；默认 dry-run 关闭、并行关闭，不引入新依赖。
- **不引入数据库（指外部 DB）**：用 stdlib SQLite 足够；不引入 Postgres/MySQL 等。
- **生产在 Windows 直跑**：开发期我们用过 WSL→Windows 的 `netsh portproxy`（9333→9222）连 CDP；但 GUI 与 Chrome 都在 Windows 时，直接连 `127.0.0.1:9222`，无需 portproxy。
- **PyInstaller 使用 onedir 免安装包**：T-524 先做 `dist/cmshopee/` onedir，不做自动更新器；当前打包依赖锁定 PyInstaller 5.13.2，onedir 产物是扁平结构，`cmshopee.exe` 和 DLL/PYD/依赖目录同级，`_internal/` 不作为当前验收标准。T-538 后打包版不再 `chdir` 到 exe 目录，用户本地配置、DB、图片、日志、登录态和提示词统一保留在 exe 同级 `data/` 子目录，更新时覆盖程序文件并保留 `data/`。
- **PyInstaller 使用 onedir 免安装包**：T-524 先做 `dist/cmshopee/` onedir，不做自动更新器；T-540 后当前打包依赖锁定 PyInstaller 6.11.1，产物必须是 `cmshopee.exe` + `_internal/` 集中依赖布局。T-538 后打包版不再 `chdir` 到 exe 目录，用户本地配置、DB、图片、日志、登录态和提示词统一保留在 exe 同级 `data/` 子目录，更新时覆盖程序文件并保留 `data/`。`app/version.py` 是唯一版本源，打包脚本固定使用 `py -3.10`，并把 `dist/cmshopee/` 组装为 `release/cmshopee-<APP_VERSION>/` 与 `release/cmshopee-<APP_VERSION>-portable.zip`。
## 三、构建与运行命令
| 用途 | 命令 |
| --- | --- |
| 安装依赖 | `python -m pip install -r requirements.txt` |
| 安装依赖 | `py -3.10 -m pip install -r requirements.txt` |
| 检查 PySide6 | `python -c "import PySide6; print(PySide6.__version__)"` |
| 语法检查 | `python -m compileall app main.py` |
| 启动 GUI | `python main.py` / `python -m app` |
| 单元测试（T-006 后） | `python -m unittest discover -s tests` |
| 语法检查 | `py -3.10 -m compileall app main.py` |
| 启动 GUI | `py -3.10 main.py` / `py -3.10 -m app` |
| 单元测试（T-006 后） | `py -3.10 -m unittest discover -s tests` |
| CI 自动验证 | GitHub Actions `.github/workflows/tests.yml`（Windows + Python 3.11 + `QT_QPA_PLATFORM=offscreen`） |
| 安装打包依赖 | `python -m pip install -r requirements-build.txt` |
| 安装打包依赖 | `py -3.10 -m pip install -r requirements-build.txt` |
| 打包 exe | `powershell -ExecutionPolicy Bypass -File scripts\\build_exe.ps1` |
| 跑单账号演示 | `python prototypes/demo.py`（分步）/ `set AUTO=1 && python prototypes/demo.py`（自动） |
| 提交更新（真改线上） | `set UPDATE=1 && python prototypes/demo.py` |