docs: document wails binding generation

README.md

@@ -69,6 +69,25 @@ Windows 下也可以直接运行：
 `dev.bat` 会从 `9245` 开始选择一个空闲 Vite 端口，避免已有 dev server 占用端口时无法打开 GUI。
 开发启动使用快速前端 dev 构建以尽快打开桌面窗口；提交前仍以 `npm run build` 做完整 TypeScript 检查和生产构建。
 
+## Wails Bindings
+
+修改 Go 服务的公开方法、参数模型、返回模型，或在 `main.go` 注册新服务后，需要从项目根目录重新生成前端 bindings：
+
+```powershell
+$env:Path += ";$(go env GOPATH)\bin"
+wails3 generate bindings -clean=true
+```
+
+当前固定使用 `wails3 v3.0.0-alpha.9`，前端 runtime 固定为 `@wailsio/runtime 3.0.0-alpha.66`。不要用 `latest` 混装。
+
+常见失败处理：
+
+- `wails3` 找不到：先按环境准备安装固定版本，或把 `$(go env GOPATH)\bin` 加入当前终端 PATH。
+- 生成失败：先运行 `go test ./...` 或 `go build -o bin\cmbone.exe .` 修复 Go 编译错误。
+- 前端 import 失效：重新执行 `wails3 generate bindings -clean=true`，前端源码继续使用无扩展名 import。
+
+生成后提交 `frontend/bindings` 的变更，并运行 `npm run build` 验证前端类型和打包。
+
 本地演示登录账号为 `admin` / `admin123`；密码由后端初始化为 hash，不写在前端页面里。
 
 ## 维护约定