cmbone/progress.md

执行流水

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

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 可初始化并加载前端资源。

接入 Harness Coding 文档

• 任务：参考 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。

确定 Windows-first 窗口与布局策略

• 任务：落地 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。

添加 Windows Wails 快捷脚本

• 任务：完成 T-034，新增一行 bat 脚本运行 Wails dev 和 build 命令。
• 结果：
  • 新增 dev.bat，切到项目根目录，通过 go env GOPATH 把 Go bin 加入当前进程 PATH，并从 9245 开始选择空闲端口运行 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 通过。
• 修复记录：
  • 用户反馈 dev.bat 没有 GUI 窗口后，复现发现原因是 Vite 端口 9245 被占用，Wails dev 在前端启动阶段失败。
  • dev.bat 已改为先切到项目根目录，再从 9245 开始选择空闲端口运行 wails3 dev。
  • 修复后 dev.bat 已进入 windows:run，连接前端 dev server，并加载 WebView 资源。
  • build.bat 已改为先切到项目根目录，避免从其他目录运行时找不到项目配置。
• 非阻塞警告：
  • wails3 build 提示 wails3 build 是 wails3 task 的 alias。
  • npm install 仍报告 3 个 moderate audit findings。
  • 前端构建仍提示 Browserslist 数据过期。
  • Vite 仍提示生产 chunk 大于 500 kB。

修复 dev.bat GUI 启动等待过长

• 任务：用户反馈 dev.bat 仍然看不到 GUI 后，继续排查 Windows dev 启动链路。
• 发现：
  • 清理旧的无窗口 bin/cmbone.exe 残留进程后，dev.bat 可以进入 windows:run。
  • GUI 不是完全无法创建，而是开发启动链路先执行 vue-tsc && vite build --minify false --mode development，窗口要等该步骤完成后才出现。
  • 窗口枚举确认主窗口可见，标题为 main，第二窗口保持隐藏。
• 结果：
  • frontend/package.json 新增 typecheck 脚本。
  • build:dev 改为只执行快速 Vite dev 构建，避免开发启动时被 vue-tsc 长时间阻塞。
  • npm run build 仍保留 vue-tsc，提交前完整质量门禁不变。
  • 修复 App.vue 的 ConfigProvider 导入和第二窗口 OCR 卡片的 TransitionGroup key 警告。
• 验证：
  • go test ./... 通过。
  • cd frontend && npm run typecheck 通过。
  • cd frontend && npm run build:dev 通过，Vite dev 构建约 1 秒完成。
  • cd frontend && npm run build 通过。
  • go build -o bin\cmbone.exe . 通过。
  • cmd /c build.bat 通过。
  • dev.bat 烟测通过，进入 windows:run 后拉起 bin/cmbone.exe，窗口枚举显示主窗口 main 可见，第二窗口 second 保持隐藏。
• 非阻塞警告：
  • cmd /c build.bat 仍提示 wails3 build 是 wails3 task 的 alias。
  • npm install 仍报告 3 个 moderate audit findings。
  • 前端构建仍提示 Browserslist 数据过期和 chunk 大小警告。