chore: add wails dev and build scripts

This commit is contained in:
QiuSW
2026-07-08 16:18:53 +08:00
parent a429353c42
commit 7c31554f64
33 changed files with 291 additions and 698 deletions
+17 -2
View File
@@ -94,12 +94,27 @@ go build -o bin\cmbone.exe .
wails3 dev
```
打包:
Wails 构建:
```powershell
wails3 package
wails3 build
```
Windows 快捷脚本:
```powershell
.\dev.bat
.\build.bat
```
Windows build 资源:
- `build/windows/wails.exe.manifest`
- `build/windows/info.json`
- `build/windows/icon.ico`
`wails3 build` 会重新生成 `frontend/bindings`,当前 CLI 生成的是 `.js` bindings。
## 版本升级规则
- 升级 Go 前,先确认 Wails v3 alpha、SQLite 和热键库的兼容性。
+1
View File
@@ -50,6 +50,7 @@
| T-031 | 文档化 Wails bindings 生成流程 | T-012 | README 或技术栈文档说明 `wails3 generate bindings` 的使用、失败处理和版本要求 | TODO |
| T-032 | 补充 Windows 打包验证文档 | T-031 | `wails3 package` 前置条件、输出目录和常见失败处理写入 README 或 docs | TODO |
| T-033 | 完成一次模板 smoke 清单 | T-023 | 登录、设置、业务样例、日志、统计、组件示例、托盘、热键都按清单验证并记录结果 | TODO |
| T-034 | 添加 Windows Wails 快捷脚本 | T-001 | `dev.bat` 一行把 Go bin 加入当前进程 PATH 并运行 `wails3 dev`;`build.bat` 一行把 Go bin 加入当前进程 PATH 并运行 `wails3 build`;README、技术栈、当前状态和执行流水已同步 | DONE |
## Backlog
+2
View File
@@ -123,6 +123,8 @@ MVP 可以先用本地模拟 provider,后续再接真实 AI 后端。
绑定目录:`frontend/bindings/cmbone/internal/services`
当前 Wails v3 CLI 会生成 `.js` bindings。前端源码使用无扩展名 import,允许 Vite 解析到这些 `.js` 文件。
服务签名变化后优先执行:
```powershell
+14
View File
@@ -22,6 +22,7 @@
- Wails 版本:`v3.0.0-alpha.9`
- 前端 runtime:`@wailsio/runtime 3.0.0-alpha.66`
- 前端框架:Vue 3、Vite、TypeScript、Tailwind CSS、Ant Design Vue
- 当前 Wails 前端 bindings:由 `wails3 build` / `wails3 generate bindings` 生成的 `.js` 文件。
- 本地数据库:SQLite,用户配置目录下 `cmbone/cmbone.db`
- 当前主窗口路由:`/#/`,已保留为主应用入口,不再自动跳转到第二窗口。
- 当前第二窗口路由:`/#/second`
@@ -53,6 +54,9 @@ Wails CLI:
```powershell
go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-alpha.9
wails3 dev
wails3 build
.\dev.bat
.\build.bat
```
## 已知风险
@@ -65,6 +69,7 @@ wails3 dev
- bindings 生成依赖本机安装的 `wails3`。
- `npm install` 当前报告 3 个 moderate audit findings,后续如做依赖治理应单独开任务。
- 前端构建当前有 Browserslist 数据过期和 chunk 大小警告,不阻塞生产构建。
- Windows 快捷脚本依赖 `go env GOPATH` 下的 `bin\wails3.exe`,如果未安装 Wails CLI,先按 README 安装固定版本。
## 最近验证
@@ -91,6 +96,15 @@ wails3 dev
- `go build -o bin\cmbone.exe .` 通过。
- `bin\cmbone.exe` 启动 6 秒 smoke 通过。
同日新增 Windows Wails 快捷脚本:
- `dev.bat` 一行把 Go bin 加入当前进程 PATH 并运行 `wails3 dev`。
- `build.bat` 一行把 Go bin 加入当前进程 PATH 并运行 `wails3 build`。
- 已补齐 `build/windows/wails.exe.manifest` 和 `build/windows/info.json`,使 `wails3 build` 的 Windows syso 生成步骤可运行。
- `cmd /c build.bat` 通过。
- 使用同样 PATH 逻辑执行 `wails3 dev -help` 通过。
- `.\init.ps1` 通过。
## 下一步
从 [`06-tasks.md`](06-tasks.md) 领取第一个 `TODO` 任务。目前建议先做 `T-012`:搭建主应用路由骨架。