81 lines
4.2 KiB
Markdown
81 lines
4.2 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。
|