docs: add harness coding documentation
This commit is contained in:
@@ -0,0 +1,39 @@
|
||||
# 项目愿景
|
||||
|
||||
## 项目目标
|
||||
|
||||
`cmbone` 的目标是提供一个简单、可维护的 Wails v3 桌面应用基础工程,让后续功能可以在稳定的 Go 后端、Vue 前端和本地 SQLite 存储上继续演进。
|
||||
|
||||
当前最重要的结果是:
|
||||
|
||||
- 新成员能按 README 和 Harness Coding 文档启动项目。
|
||||
- 初级程序员能看懂目录职责和常用命令。
|
||||
- 每次改动都有明确任务、验证命令和提交记录。
|
||||
|
||||
## 目标用户
|
||||
|
||||
- 项目维护者:需要快速判断当前状态、任务边界和验证方式。
|
||||
- 初级前端 / 后端程序员:需要沿着清晰模块做小范围改动。
|
||||
- AI coding agent:需要稳定的上下文入口、任务看板和质量规则。
|
||||
|
||||
## 产品方向
|
||||
|
||||
短期方向是桌面工具壳和设置中心:
|
||||
|
||||
- 主窗口负责常驻设置、快捷键和信息展示。
|
||||
- 第二窗口用于快捷打开轻量功能,如 OCR 示例。
|
||||
- 后端服务负责平台能力、本地配置和数据持久化。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 现在不做云端账号、远程同步、复杂权限、支付或 SaaS 化。
|
||||
- 现在不把项目改造成大型前端单页应用。
|
||||
- 现在不引入 Electron、Tauri 或其他桌面框架替代 Wails。
|
||||
- 现在不追逐 latest 依赖版本,优先保持当前 Go 1.23.0 可构建。
|
||||
|
||||
## 成功标准
|
||||
|
||||
- 文档、目录、命令和代码事实一致。
|
||||
- `.\init.ps1` 可以完成依赖安装、测试、前端构建和后端编译。
|
||||
- 新增功能能落在明确模块内,不需要跨多层猜测。
|
||||
- 提交历史能看出每次改动的意图和验证结果。
|
||||
Reference in New Issue
Block a user