# 执行流水

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

## 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。