执行流水

记录已经完成的任务、验证命令、结果和关键决策。任务完成必须有可执行证据，不只写“已完成”。

2026-07-08

任务：从 SuiDemo 迁移并整理为 cmbone Wails v3 项目。
结果：完成项目结构整理、README 维护、.gitignore 更新和初始提交。
已知验证：
- go test ./... 通过。
- cd frontend && npm run build 通过。
- go build -o bin/cmbone.exe . 通过。
- 启动 bin/cmbone.exe 后 Wails/WebView2 可初始化并加载前端资源。

任务：参考 D:\github\harness_coding_docs 的模板，在本项目生成 Harness Coding 文档。
决策：保留模板的 AGENTS.md、docs/00-ai-start-here.md、任务看板、当前状态、质量清单和初始化脚本结构；内容改为本项目真实技术栈和命令。
结果：新增仓库级 agent 入口、文档导航、需求/架构/API/路由/质量/任务文档和 init.ps1 / init.sh。
验证：
- .\init.ps1 通过。
- 脚本内 npm install 通过。
- 脚本内 go test ./... 通过。
- 脚本内 cd frontend && npm run build 通过。
- 脚本内 go build -o bin\cmbone.exe . 通过。
非阻塞警告：
- npm install 报告 3 个 moderate audit findings，本次文档任务未处理依赖审计。
- 前端构建提示 Browserslist 数据过期。
- Vite 提示生产 chunk 大于 500 kB。

任务：根据项目愿景，把文档从基础 Wails 工程调整为 Windows-first、可扩展到其他平台的可复用桌面应用模板。
决策：
- 模板核心模块包括应用壳、设置、登录、主业务、操作日志、数据统计和常用组件示例。
- 第一批业务样例使用“电商商品图片 AI 优化”。
- 登录设计为本地固定账号 provider 和真实后端 provider 两种路径。
- 操作日志分为审计日志和运行日志，分别服务审计和排错。
- 第一批统计指标为今日处理图片数、AI 优化成功率、平均处理耗时、失败任务数、今日操作日志数、最近 7 天处理趋势。
结果：更新 README、AGENTS、愿景、需求、技术栈、架构、编码规则、任务看板、API、路由、当前状态、方法地图和质量文档。
验证：
- 旧定位关键词搜索通过，未发现旧定位残留。
- git diff --check 通过。
- .\init.ps1 通过。
- 脚本内 npm install 通过。
- 脚本内 go test ./... 通过。
- 脚本内 cd frontend && npm run build 通过。
- 脚本内 go build -o bin\cmbone.exe . 通过。
非阻塞警告：
- npm install 仍报告 3 个 moderate audit findings。
- 前端构建仍提示 Browserslist 数据过期。
- Vite 仍提示生产 chunk 大于 500 kB。

任务：落地 T-010，明确主窗口、页面根容器、内容区和第二窗口的布局策略。
决策：
- 主窗口默认不最大化。
- 主窗口初始尺寸为 1280x800，最小尺寸为 1024x720。
- 主窗口启动时居中，并允许用户调整大小。
- 页面根容器使用 width: 100% 和 height: 100vh。
- 主布局内部使用 flex 或 grid 填满窗口。
- 阅读型内容保留最大宽度；列表、仪表盘、设置页自适应拉伸。
- 保存窗口尺寸和最大化状态作为后续增强任务，不阻塞主布局。
- 第二窗口保持小窗，不参与最大化和尺寸恢复逻辑。
结果：更新 docs/06-tasks.md、docs/routes.md、docs/04-architecture.md、docs/02-requirements.md、docs/00-ai-start-here.md、docs/current-state.md 和 docs/quality-document.md。
验证：
- 旧 T-010 / 最大化策略相关临时表述搜索通过，未发现残留。
- git diff --check 通过。
- .\init.ps1 通过。
- 脚本内 npm install 通过。
- 脚本内 go test ./... 通过。
- 脚本内 cd frontend && npm run build 通过。
- 脚本内 go build -o bin\cmbone.exe . 通过。
非阻塞警告：
- npm install 仍报告 3 个 moderate audit findings。
- 前端构建仍提示 Browserslist 数据过期。
- Vite 仍提示生产 chunk 大于 500 kB。

任务：实现 T-011，把已确定的主窗口与布局策略落到代码。
结果：
- Go 侧主窗口设置为初始 1280x800、最小 1024x720、居中、可调整大小、正常窗口状态。
- 第二窗口继续保持 340x320 小窗。
- 前端 html、body、#app 和应用根容器撑满窗口并隐藏外层滚动。
- 主窗口侧边栏、顶部栏和内容区使用 flex 填满窗口。
- Dashboard、General、Tags 等现有页面补充了宽度和最小尺寸约束。
- 根路由保留为主窗口入口，不再自动跳转到第二窗口。
验证：
- .\init.ps1 通过。
- go test ./... 通过。
- cd frontend && npm run build 通过。
- go build -o bin\cmbone.exe . 通过。
- bin\cmbone.exe 启动 6 秒 smoke 通过。
非阻塞警告：
- npm install 仍报告 3 个 moderate audit findings。
- 前端构建仍提示 Browserslist 数据过期。
- Vite 仍提示生产 chunk 大于 500 kB。

任务：完成 T-034，新增一行 bat 脚本运行 Wails dev 和 build 命令。
结果：
- 新增 dev.bat，通过 go env GOPATH 把 Go bin 加入当前进程 PATH 并运行 wails3 dev。
- 新增 build.bat，通过 go env GOPATH 把 Go bin 加入当前进程 PATH 并运行 wails3 build。
- 补齐 build/windows/wails.exe.manifest 和 build/windows/info.json，满足 Windows syso 生成步骤。
- wails3 build 按当前 CLI 重新生成 frontend/bindings，当前绑定文件形态为 .js。
- 更新 README、技术栈、API、当前状态和任务看板。
验证：
- wails3.exe version 通过，版本为 v3.0.0-alpha.9。
- 使用 bat 中同样 PATH 逻辑执行 wails3 dev -help 通过。
- cmd /c build.bat 通过。
- .\init.ps1 通过。
- git diff --check 通过。
非阻塞警告：
- wails3 build 提示 wails3 build 是 wails3 task 的 alias。
- npm install 仍报告 3 个 moderate audit findings。
- 前端构建仍提示 Browserslist 数据过期。
- Vite 仍提示生产 chunk 大于 500 kB。