docs: add harness coding documentation

2026-07-08 15:27:21 +08:00
parent e5d10577c0
commit d2eeb049d0
24 changed files with 1119 additions and 0 deletions
@@ -0,0 +1,75 @@
+# 当前状态
+
+更新时间：2026-07-08
+
+## 当前阶段
+
+项目处于迁移后基线稳定和 Harness Coding 文档接入阶段。当前主要任务是保持 Wails/Vue/SQLite 工程简单、可构建、可维护。
+
+## 已确认事实
+
+- Go 模块名：`cmbone`
+- Go 版本：`1.23.0`
+- Wails 版本：`v3.0.0-alpha.9`
+- 前端 runtime：`@wailsio/runtime 3.0.0-alpha.66`
+- 前端框架：Vue 3、Vite、TypeScript、Tailwind CSS、Ant Design Vue
+- 本地数据库：SQLite，用户配置目录下 `cmbone/cmbone.db`
+- 主窗口路由：`/#/`
+- 第二窗口路由：`/#/second`
+
+## 当前命令
+
+统一验证：
+
+```powershell
+.\init.ps1
+```
+
+拆分验证：
+
+```powershell
+go test ./...
+cd frontend
+npm run build
+cd ..
+go build -o bin\cmbone.exe .
+```
+
+Wails CLI：
+
+```powershell
+go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-alpha.9
+wails3 dev
+```
+
+## 已知风险
+
+- Wails v3 alpha 版本需要保持 CLI、Go 模块和前端 runtime 匹配。
+- OCR 和热键依赖平台实现，跨平台修改需要分别验证。
+- 当前前端以构建检查为主，暂未引入专门的前端单元测试。
+- bindings 生成依赖本机安装的 `wails3`。
+- `npm install` 当前报告 3 个 moderate audit findings，后续如做依赖治理应单独开任务。
+- 前端构建当前有 Browserslist 数据过期和 chunk 大小警告，不阻塞生产构建。
+
+## 最近验证
+
+2026-07-08 已运行：
+
+```powershell
+.\init.ps1
+```
+
+结果：
+
+- `npm install` 通过。
+- `go test ./...` 通过。
+- `npm run build` 通过。
+- `go build -o bin\cmbone.exe .` 通过。
+
+## 下一步
+
+从 [`06-tasks.md`](06-tasks.md) 领取第一个 `TODO` 任务。目前建议先做 `T-010`：梳理主窗口最大化与自适应布局策略。
+
+## 当前 blocker
+
+无。