cmbone/docs/quality-document.md

质量文档

当前质量概览

领域	当前等级	说明
项目结构	B	已从模板整理为普通工程，目录职责基本清楚
后端服务	B	服务边界清晰，但热键和 OCR 的错误路径仍可加强
本地存储	B	SQLite 初始化和基础测试已存在，后续可补更多迁移测试
前端结构	B	Vue 组件按功能拆分，主窗口布局策略仍需明确
构建验证	B	Go 测试、前端构建、后端编译可运行
文档	B	Harness Coding 文档已接入，后续随代码继续维护

主要风险

• Wails v3 alpha 版本兼容性风险。
• bindings 与 Go 服务签名不一致的运行时风险。
• 热键和 OCR 跨平台行为不完全一致。
• 前端缺少专门单元测试，主要依赖构建和人工 smoke。

质量门槛

每个代码任务至少达到：

• Go 代码 gofmt。
• go test ./... 通过。
• 涉及前端时 npm run build 通过。
• 涉及后端启动时 go build -o bin/cmbone.exe . 通过。
• 涉及 UI 时完成对应窗口的人工检查。

改进方向

• 为存储迁移、配置服务、热键服务补充更细测试。
• 为主窗口最大化和自适应布局建立明确规则。
• 为 OCR 失败、热键注册失败补充用户可理解反馈。
• 为 Wails bindings 生成流程补充完整操作说明。