# 需求说明

## MVP 范围

### P0 · 必须保持

- 应用能启动 Wails 主窗口，并加载嵌入的 `frontend/dist` 资源。
- 主窗口包含 Dashboard、General、Shortcut、Tags、About 等现有区域。
- 多语言资源能从 `frontend/src/locales/*.json` 加载，并能通过 UI / 服务切换。
- 主题配置能保存到本地 SQLite 并在前端生效。
- 快捷键配置能从数据库读取、更新，并注册到系统热键层。
- 托盘菜单能执行显示、隐藏、语言切换和退出等基础动作。
- 第二窗口能通过热键或服务打开，承载 OCR 示例页面。
- `go test ./...`、`npm run build`、`go build -o bin/cmbone.exe .` 通过。

### P1 · 近期增强

- 明确主窗口默认大小、最大化策略和自适应布局规则。
- 补齐热键服务、配置服务、存储迁移的边界测试。
- OCR 失败时给出可理解的前端反馈。
- 文档化 Wails bindings 生成流程。

### P2 · 后续再做

- 发布安装包和自动更新。
- 更完整的系统通知能力。
- 可配置插件或更多工具模块。
- 业务化功能闭环。

## 验收标准

每个任务完成前至少满足：

- 相关代码已格式化。
- 相关单元测试或构建命令通过。
- 前端页面在目标窗口尺寸下没有明显溢出或不可用控件。
- 文档中的命令、版本、接口和当前代码一致。
- `progress.md` 记录了本次验证命令和结果。

## 约束

- 当前 Go 版本为 `1.23.0`。
- Wails 版本固定为 `v3.0.0-alpha.9`。
- 前端 runtime 固定为 `@wailsio/runtime 3.0.0-alpha.66`。
- 不提交 `node_modules`、`dist`、`bin`、本地数据库或用户配置。