feat(client): initialize procurement tool skeleton

docs/current-state.md

@@ -12,30 +12,33 @@
 ## 当前快照
 
 - 日期：2026-08-03
-- 阶段：**Phase 0 · 地基（采购服务骨架完成，采购工具骨架进行中）**
+- 阶段：**Phase 0 · 地基（采购服务与采购工具骨架已初始化，尚无采购业务代码）**
 - MVP 形态：手工填链接建单 → 批量开始试选 → 定时轮询 → **第一趟试选** → 人工确认 → **第二趟下单** → 待付款
 - 技术栈：已定。采购服务（`admin/`）使用 Go 1.23+ / gin / SQLite；采购工具（`client/`）
   使用 Python 3.11+ / uiautomator2 / PySide6。
   详见 [`03-tech-stack.md`](03-tech-stack.md)
-- 生产代码：`admin/` 已有最小 Go 服务、`GET /healthz` 与 SQLite 驱动封装；尚无采购业务代码
-- 测试：采购服务 2 项离线单元测试
+- 生产代码：`admin/` 已有最小 Go 服务、`GET /healthz` 与 SQLite 驱动封装；`client/` 已有
+  Python 包、PySide6 最小入口、运行目录与日志脱敏策略；两端均尚无采购业务代码
+- 测试：采购服务 2 项离线单元测试；采购工具 6 项离线单元测试（不连接真机）
 - 数据：**无**
-- 标准启动路径：`./init.ps1`（Windows）/ `./init.sh`。当前会验证采购服务，再因
-  `client/requirements.txt` 尚不存在以退出码 3 提示 T-002——这是预期行为
-- 标准验证路径：`admin/` 下运行 `go test ./...`、`go vet ./...`、`go build ./...`；仓库根运行
+- 标准启动路径：`./init.ps1`（Windows）/ `./init.sh`。两端骨架现已存在，但 `init.ps1` 仍使用
+  默认 Python 3.10，不能正确验证要求 Python 3.11+ 的采购工具；T-003 负责统一入口与解释器选择。
+- 标准验证路径：`admin/` 下运行 `go test ./...`、`go vet ./...`、`go build ./...`；`client/` 下使用
+  `py -3.12 -m unittest discover -s tests -t .`、`py -3.12 -m compileall -q src tests scripts`；仓库根运行
   `python scripts/validate_agent_context.py`
-- 当前 blocker：无外部 blocker。T-002 正在实现；T-004 已因 T-001 完成而可领取。
+- 当前 blocker：无外部 blocker。T-002 已完成；T-004 核心数据模型正在进行；T-003 统一入口与
+  T-101 真机环境盘点已就绪。当前不宣称统一入口或桌面 GUI 已验收。
 
 ## 当前目录要点
 
 | 路径 | 状态 | 说明 |
 | --- | --- | --- |
 | `docs/` | 已有 | 项目规范化文档，本次已完整生成 |
-| `docs/tasks/` | 已有（T-001、T-002、T-005～T-009） | T-001 已完成；T-002 正在进行；其余既有任务已完成 |
+| `docs/tasks/` | 已有（T-001、T-002、T-004～T-009） | T-001、T-002 已完成；T-004 正在进行；其余既有任务已完成 |
 | `docs/design/` | 已有（6 个原型） | web 登录 / 建单 / 工作台 / 详情，desk 采购执行 / 配置；均已人工确认 |
 | `scripts/` | 已有 | 上下文门禁、Vikunja 单向导出与 MCP 启动包装 |
 | `admin/` | 已初始化 | Go 1.23+ / gin / SQLite 骨架与健康检查；无采购业务路由 |
-| `client/` | **待建** | “采购工具”Python 桌面端（T-002） |
+| `client/` | 已初始化 | Python 3.11+ 包、依赖源、PySide6 最小入口、离线测试与 wheel 元数据检查；无真机或采购流程 |
 | `init.ps1` / `init.sh` | 已有（骨架） | 统一入口。两端目录建好后由 T-003 补全并验证 |
 
 ## 任务状态
@@ -45,8 +48,8 @@
 - 已完成：T-005（采购服务交互原型）、T-006（采购工具交互原型）、T-007（产品名称与
   源码目录契约）、T-008（Vikunja 任务权威与单向导出）、T-009（MVP 关键路径与并行波次），
   以及 T-001（采购服务 Go 骨架）。
-- 正在进行：T-002（采购工具 Python 骨架）。采购服务方向可并行落成 T-004；T-002 完成后
-  立即推进 T-101 → T-102 → T-103，并可补 T-003 统一入口。
+- 已完成：T-002（采购工具 Python 骨架）。正在进行：T-004（核心数据模型）。
+  T-003（统一入口）与 T-101（真机环境盘点）已就绪，立即推进 T-101 → T-102 → T-103。
 - T-103 是当前最高优先级和 MVP 生死线。通过前不开发依赖真机可读字段的 Phase 2 生产页面。
 - 已确认原型继续只作信息架构依据；原型假数据不调用真实接口、不驱动真机。真机结论改变
   可读字段时必须先回修原型与交互清单。
@@ -73,7 +76,31 @@ cd ..
 python scripts/validate_agent_context.py
 ```
 
-采购工具与统一入口的真实命令分别等待 T-002、T-003 完成后补齐。
+采购工具当前可运行的离线验证与 wheel 元数据检查：
+
+```powershell
+cd client
+py -3.12 -m unittest discover -s tests -t .
+py -3.12 -m compileall -q src tests scripts
+$wheelDir = Join-Path $env:TEMP ('cmbuyer-client-wheel-' + [guid]::NewGuid())
+New-Item -ItemType Directory -Path $wheelDir | Out-Null
+py -3.12 -m pip wheel --no-deps . --wheel-dir $wheelDir
+py -3.12 scripts/verify_wheel_metadata.py (Get-ChildItem $wheelDir -Filter '*.whl').FullName
+```
+
+采购工具规范安装与本地开发入口：
+
+```powershell
+cd client
+py -3.12 -m venv .venv
+.\.venv\Scripts\python.exe -m pip install -e .
+.\.venv\Scripts\python.exe -m cmbuyer_client
+```
+
+`client/requirements.txt` 是唯一依赖来源，`client/pyproject.toml` 动态读取它生成 wheel 的
+`Requires-Dist`。Python 3.12 已验证 6 项离线测试、编译与 wheel 元数据；完整运行时依赖安装
+（`pip install -e .`）已通过。`init.ps1` 当前仍选择 Python 3.10，因此不能声称统一入口已正确；
+桌面 GUI 与真机流程未作为 T-002 验收执行。
 
 ## 关键背景