cmbone/docs/02-requirements.md

需求说明

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、本地数据库或用户配置。