feat: v1.0 发版准备步骤 2-4

步骤 2: README.md 更新为 v1.0
- 版本号升级，macOS 平台标注
- 新增 status、gui 命令说明
- 新增 --workers 参数说明
- 新增 v1.0 更新记录

步骤 3: RELEASE_POST.md 更新（docs/ gitignore，不入仓库）
- 补充 GUI、并发、status 描述
- 更新包内清单和快速上手

步骤 4: 新增 scripts/build_release.sh
- 白名单逐文件打包，33 个文件
- 路径检查、空格文件名处理、zipinfo 核对

Author: Astro-Han

README.md

@@ -3,7 +3,9 @@
 自动从 QuantClass 下载股票和币圈数据，帮你把本地数据保持最新。
 好几天没跑也没关系，一条命令就能把缺的全补上。
 
-当前版本：**v0.8.2**
+当前版本：**v1.0**
+
+macOS 工具。Windows 用户推荐使用 QuantClass 官方客户端。
 
 ---
 
@@ -97,6 +99,7 @@ python3 quantclass_sync.py update    # 写全也行，效果一样
 | `--force` | 不管本地是不是最新，强制重新下载 |
 | `--products` | 只更新指定的产品（可以写多个） |
 | `--no-verbose` | 不想看那么多日志就加这个 |
+| `--workers N` | 并发下载线程数（1-8，默认 1） |
 
 **例子** — 只更新两个产品：
 
@@ -106,6 +109,24 @@ python3 quantclass_sync.py --products stock-trading-data --products stock-main-i
 
 **凭证从哪读？** 按优先级：命令行参数 > `user_secrets.env` > 环境变量。
 
+### status — 查看状态
+
+```bash
+python3 quantclass_sync.py status
+```
+
+一屏看全局：哪些产品已同步、落后几天、上次运行结果。离线可用，不调 API。
+
+### gui — 图形界面
+
+```bash
+python3 quantclass_sync.py gui
+```
+
+打开图形界面窗口，包含总览、同步、历史三个页面。关闭窗口后命令退出。
+
+macOS 用户也可以直接双击 `QuantClass Sync.command` 启动 GUI，不需要打开终端。首次运行会提示输入 conda 环境名。
+
 ### 币圈合成（自动的，不用管）
 
 如果你的数据目录里有 `coin-binance-spot-swap-preprocess-pkl-1h`，并且这次跑的时候 spot 或 swap 有新数据进来，工具会自动帮你跑一遍合成预处理。
@@ -209,6 +230,17 @@ ls -t <data_root>/.quantclass_sync/log/run_report_* | head -1 | xargs cat
 
 ## 更新记录
 
+<details>
+<summary>v1.0</summary>
+
+- 新增图形界面（GUI）：总览、同步、历史三个页面
+- 新增并发下载：`--workers` 参数支持 1-8 线程
+- 新增 `status` 命令：一屏查看全局同步状态
+- 新增 `.command` 双击启动 GUI（macOS）
+- 测试用例从 199 增加到 315 个
+
+</details>
+
 <details>
 <summary>v0.8.2</summary>
 

scripts/build_release.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+# 打包发布 zip，白名单逐文件添加
+# 用法：bash scripts/build_release.sh v1.0
+
+set -euo pipefail
+
+# --- 参数检查 ---
+if [[ $# -lt 1 ]]; then
+    echo "错误：缺少版本号参数" >&2
+    echo "用法：bash scripts/build_release.sh v1.0" >&2
+    exit 1
+fi
+
+VERSION="$1"
+OUTPUT="release/quantclass-sync-tool-${VERSION}.zip"
+
+# --- 白名单 ---
+FILES=(
+    "README.md"
+    "catalog.txt"
+    "requirements.txt"
+    "requirements-archive.txt"
+    "quantclass_sync.py"
+    "coin_preprocess_builtin.py"
+    "QuantClass Sync.command"
+    "quantclass_sync_internal/__init__.py"
+    "quantclass_sync_internal/cli.py"
+    "quantclass_sync_internal/config.py"
+    "quantclass_sync_internal/models.py"
+    "quantclass_sync_internal/constants.py"
+    "quantclass_sync_internal/orchestrator.py"
+    "quantclass_sync_internal/file_sync.py"
+    "quantclass_sync_internal/csv_engine.py"
+    "quantclass_sync_internal/http_client.py"
+    "quantclass_sync_internal/status_store.py"
+    "quantclass_sync_internal/reporting.py"
+    "quantclass_sync_internal/data_query.py"
+    "quantclass_sync_internal/archive.py"
+    "quantclass_sync_internal/gui/__init__.py"
+    "quantclass_sync_internal/gui/api.py"
+    "quantclass_sync_internal/gui/assets/index.html"
+    "quantclass_sync_internal/gui/assets/style.css"
+    "quantclass_sync_internal/gui/assets/app.js"
+    "quantclass_sync_internal/gui/assets/alpine.min.js"
+    "coin_preprocess_internal/__init__.py"
+    "coin_preprocess_internal/runner.py"
+    "coin_preprocess_internal/csv_source.py"
+    "coin_preprocess_internal/symbol_mapper.py"
+    "coin_preprocess_internal/pivot.py"
+    "coin_preprocess_internal/constants.py"
+    "scripts/repair_coin_cap.py"
+)
+
+# --- 检查所有文件是否存在 ---
+echo "检查白名单文件..."
+MISSING=0
+for f in "${FILES[@]}"; do
+    if ! test -e "$f"; then
+        echo "  缺失：$f" >&2
+        MISSING=1
+    fi
+done
+if [[ $MISSING -ne 0 ]]; then
+    echo "错误：存在缺失文件，打包中止" >&2
+    exit 1
+fi
+echo "全部 ${#FILES[@]} 个文件均存在"
+
+# --- 准备输出目录，清理旧包 ---
+mkdir -p release
+if [[ -f "$OUTPUT" ]]; then
+    rm "$OUTPUT"
+    echo "已删除旧包：$OUTPUT"
+fi
+
+# --- 逐文件追加到 zip（路径含空格用数组元素引用） ---
+echo "开始打包..."
+for f in "${FILES[@]}"; do
+    zip -r "$OUTPUT" "$f"
+done
+
+echo ""
+echo "打包完成：$OUTPUT"
+echo ""
+echo "--- 包内文件列表 ---"
+zipinfo -1 "$OUTPUT"