Files
cmbone/docs/01-vision.md
T

1.5 KiB

项目愿景

项目目标

cmbone 的目标是提供一个简单、可维护的 Wails v3 桌面应用基础工程,让后续功能可以在稳定的 Go 后端、Vue 前端和本地 SQLite 存储上继续演进。

当前最重要的结果是:

  • 新成员能按 README 和 Harness Coding 文档启动项目。
  • 初级程序员能看懂目录职责和常用命令。
  • 每次改动都有明确任务、验证命令和提交记录。

目标用户

  • 项目维护者:需要快速判断当前状态、任务边界和验证方式。
  • 初级前端 / 后端程序员:需要沿着清晰模块做小范围改动。
  • AI coding agent:需要稳定的上下文入口、任务看板和质量规则。

产品方向

短期方向是桌面工具壳和设置中心:

  • 主窗口负责常驻设置、快捷键和信息展示。
  • 第二窗口用于快捷打开轻量功能,如 OCR 示例。
  • 后端服务负责平台能力、本地配置和数据持久化。

非目标

  • 现在不做云端账号、远程同步、复杂权限、支付或 SaaS 化。
  • 现在不把项目改造成大型前端单页应用。
  • 现在不引入 Electron、Tauri 或其他桌面框架替代 Wails。
  • 现在不追逐 latest 依赖版本,优先保持当前 Go 1.23.0 可构建。

成功标准

  • 文档、目录、命令和代码事实一致。
  • .\init.ps1 可以完成依赖安装、测试、前端构建和后端编译。
  • 新增功能能落在明确模块内,不需要跨多层猜测。
  • 提交历史能看出每次改动的意图和验证结果。