# 任务看板

> 单 agent / 小项目使用本文件。多 agent 并发时，改用 [`tasks/README.md`](tasks/README.md) 的一任务一文件规则。

## 使用规则

1. 一次只做一个任务：领取第一个状态为 `TODO` 且依赖均为 `DONE` 的任务。
2. 开始后把状态改为 `DOING`。
3. 完成并验证后把状态改为 `DONE`。
4. 任务完成必须在 [`../progress.md`](../progress.md) 写入验证命令和结果。
5. 完成后更新 [`current-state.md`](current-state.md)，并过一遍 [`clean-state-checklist.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 |

## Phase 1 · 近期维护

| ID | 任务 | 依赖 | 验收要点 | 状态 |
| --- | --- | --- | --- | --- |
| T-010 | 梳理主窗口最大化与自适应布局策略 | T-001 | 明确是否默认最大化；主内容区域能填满空余空间；移动/小窗口尺寸下无明显溢出；更新 `routes.md` 或架构说明 | TODO |
| T-011 | 文档化 Wails bindings 生成流程 | T-001 | README 或技术栈文档说明 `wails3 generate bindings` 的使用、失败处理和版本要求 | TODO |
| T-012 | 增加前端最小质量检查 | T-001 | 前端至少保留 `npm run build`；如新增 lint/test，命令写入 `package.json` 和文档 | TODO |

## Phase 2 · 服务边界

| ID | 任务 | 依赖 | 验收要点 | 状态 |
| --- | --- | --- | --- | --- |
| T-020 | 补强 SQLite 初始化测试 | T-001 | `store_test.go` 覆盖默认配置和热键初始化；`go test ./...` 通过 | TODO |
| T-021 | 收敛热键服务错误处理 | T-020 | 注册失败、更新失败和重复注册路径有明确错误返回或日志 | TODO |
| T-022 | 完善 OCR 失败反馈 | T-001 | OCR 失败时前端能展示可理解提示；后端错误不被吞掉 | TODO |

## Phase 3 · 发布准备

| ID | 任务 | 依赖 | 验收要点 | 状态 |
| --- | --- | --- | --- | --- |
| T-030 | 补充 Windows 打包验证文档 | T-011 | `wails3 package` 前置条件、输出目录和常见失败处理写入 README 或 docs | TODO |
| T-031 | 完成一次人工 smoke 清单 | T-010 | 主窗口、第二窗口、语言、主题、热键、托盘都按清单验证并记录结果 | TODO |

## Backlog

- 梳理应用真实产品方向和名称。
- 评估是否需要 Playwright / Vitest 覆盖前端关键页面。
- 评估是否需要平台能力降级策略。