# 技术栈

## 后端

- Go：`1.23.0`
- 桌面框架：`github.com/wailsapp/wails/v3 v3.0.0-alpha.9`
- 本地数据库：`modernc.org/sqlite v1.38.2`
- 系统热键：`golang.design/x/hotkey v0.4.1`

Wails CLI 安装命令：

```powershell
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-alpha.9
```

不要直接安装 `wails3@latest`，避免 CLI、Go SDK 和前端 runtime 版本不匹配。

## 前端

- Vue：`^3.2.45`
- TypeScript：`^4.9.3`
- Vite：`^8.1.3`
- Wails runtime：`@wailsio/runtime 3.0.0-alpha.66`
- UI：Ant Design Vue `^4.2.6`
- 样式：Tailwind CSS `^3.4.1`
- 国际化：Vue I18n `^11.1.5`

## 目录职责

```text
.
├── main.go                  # Wails 应用入口、服务注册、资源嵌入
├── internal/
│   ├── models/              # 数据模型
│   └── services/            # Wails 服务、配置、数据库、热键、OCR
├── platform/                # Windows / macOS 平台差异实现
├── frontend/
│   ├── src/                 # Vue 源码
│   ├── bindings/            # Wails 生成的前端绑定
│   └── dist/                # 前端构建产物，git 忽略
├── build/                   # Wails 打包配置
└── docs/                    # Harness Coding 文档
```

## 常用命令

安装前端依赖：

```powershell
cd frontend
npm install
```

后端测试：

```powershell
go test ./...
```

前端构建：

```powershell
cd frontend
npm run build
```

后端编译：

```powershell
go build -o bin\cmbone.exe .
```

统一验证入口：

```powershell
.\init.ps1
```

开发启动：

```powershell
wails3 dev
```

打包：

```powershell
wails3 package
```

## 版本升级规则

- 升级 Go 前，先确认 Wails v3 alpha、SQLite 和热键库的兼容性。
- 升级 Wails 后，同时检查 `@wailsio/runtime` 和 `frontend/bindings`。
- 升级 Vite / TypeScript 后，必须跑 `npm run build`。
- 依赖升级必须单独提交，不和业务功能混在一起。