任务看板
单 agent / 小项目使用本文件。多 agent 并发时，改用 tasks/README.md 的一任务一文件规则。
使用规则
- 一次只做一个任务：领取第一个状态为
TODO 且依赖均为 DONE 的任务。
- 开始后把状态改为
DOING。
- 完成并验证后把状态改为
DONE。
- 任务完成必须在
../progress.md 写入验证命令和结果。
- 完成后更新
current-state.md，并过一遍 clean-state-checklist.md。
状态图例
TODO 待开始 · DOING 进行中 · DONE 已完成并验收 · BLOCKED 受阻
Phase 0 · 基线与定位
| ID |
任务 |
依赖 |
验收要点 |
状态 |
| T-000 |
接入 Harness Coding 文档 |
- |
AGENTS.md、docs/、progress.md、init.ps1、init.sh 已创建；README 已登记入口；统一验证通过 |
DONE |
| T-001 |
验证迁移后构建基线 |
T-000 |
go test ./...、npm run build、go build -o bin/cmbone.exe . 通过 |
DONE |
| T-002 |
校准为可复用桌面应用模板 |
T-001 |
愿景、需求、架构、API、路由、任务和当前状态文档都改为 Windows-first 可复用模板方向 |
DONE |
Phase 1 · 应用壳与基础模块
| ID |
任务 |
依赖 |
验收要点 |
状态 |
| T-010 |
确定 Windows-first 窗口与布局策略 |
T-002 |
主窗口默认不最大化，初始 1280x800，最小 1024x720，居中，可调整大小；页面根容器 width: 100%、height: 100vh；内部用 flex/grid 填满窗口；第二窗口保持小窗 |
DONE |
| T-011 |
实现主窗口启动参数与根布局策略 |
T-010 |
Go 侧设置主窗口初始宽高、居中、可调整大小；前端根容器和主布局填满窗口；阅读型内容有最大宽度，列表/仪表盘/设置页可自适应拉伸 |
DONE |
| T-012 |
搭建主应用路由骨架 |
T-011 |
login、dashboard、image-optimizer、logs、statistics、settings、components 路由可访问 |
DONE |
| T-013 |
实现登录 provider 边界 |
T-012 |
支持本地固定账号 provider；预留 remote provider；账号密码不写死在前端；登录事件写审计日志 |
DONE |
| T-014 |
收敛设置模块 schema |
T-012 |
主题、语言、窗口行为、快捷键、数据目录、日志策略都有统一配置定义和默认值 |
DONE |
| T-015 |
持久化窗口尺寸和最大化状态 |
T-014 |
保存主窗口尺寸和最大化状态；下次启动恢复用户上次选择；第二窗口不参与该逻辑 |
DONE |
Phase 2 · 业务样例与日志统计
| ID |
任务 |
依赖 |
验收要点 |
状态 |
| T-020 |
建立商品图片 AI 优化任务模型 |
T-013 |
image_tasks、image_task_results 迁移和基础测试通过；可创建模拟任务 |
DONE |
| T-021 |
实现审计日志与运行日志边界 |
T-013 |
审计日志和运行日志分开；登录、设置变更、任务创建、任务失败可记录 |
DONE |
| T-022 |
实现 P0 数据统计 |
T-020 |
今日处理图片数、成功率、平均耗时、失败数、今日操作日志数、7 天趋势可查询 |
DONE |
| T-023 |
实现商品图片 AI 优化页面 |
T-020 |
上传/选择图片、任务列表、状态、结果预览、失败提示路径可用 |
DONE |
Phase 3 · 组件、质量与发布
| ID |
任务 |
依赖 |
验收要点 |
状态 |
| T-030 |
建立常用组件示例页 |
T-012 |
输入框、多选框、下拉框、多行文本、表格、筛选、分页、状态标签有可运行示例 |
TODO |
| T-031 |
文档化 Wails bindings 生成流程 |
T-012 |
README 或技术栈文档说明 wails3 generate bindings 的使用、失败处理和版本要求 |
TODO |
| T-032 |
补充 Windows 打包验证文档 |
T-031 |
wails3 package 前置条件、输出目录和常见失败处理写入 README 或 docs |
TODO |
| T-033 |
完成一次模板 smoke 清单 |
T-023 |
登录、设置、业务样例、日志、统计、组件示例、托盘、热键都按清单验证并记录结果 |
TODO |
| T-034 |
添加 Windows Wails 快捷脚本 |
T-001 |
dev.bat 一行切到项目根目录、补 Go bin PATH、自动选择空闲端口并运行 wails3 dev；build.bat 一行切到项目根目录、补 Go bin PATH 并运行 wails3 build；README、技术栈、当前状态和执行流水已同步 |
DONE |
Backlog
- 评估是否需要 Playwright / Vitest 覆盖前端关键页面。
- 评估是否需要平台能力降级策略。
- 评估真实 AI 后端 provider 的接口形态。
- 评估本地数据库备份、恢复和清理策略。
