123 lines
6.3 KiB
Markdown
123 lines
6.3 KiB
Markdown
# 执行流水
|
|
|
|
> 记录已经完成的任务、验证命令、结果和关键决策。任务完成必须有可执行证据，不只写“已完成”。
|
|
|
|
## 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 并运行 `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。
|