القائمة
完整动手教程（QR Code Service / TODO List / Notes / Self-Update App）+ v2→v3 迁移指南。当用户说「教程 / step-by-step / 教我做一个 todo / notes 应用 / 自动更新教程 / 从 wails v2 升级 / wails.Run / Bind / startup / Bind 列表 / 迁移」时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Foundation 脚手架的子窗口系统使用指南：ChildWindowService（Open/Close/List）、事件总线通信（定向 / 广播）、预设类型（confirm / message / blank）、新增子窗口类型标准操作，以及"子窗口 MVVM 与主窗口一致、通信只走事件总线"等铁律。
MUI 9 数据展示类组件在 Foundation 项目中的详尽用法。当使用 Typography/Avatar/Badge/Chip/Divider/List/Table/Tooltip 时参考。
MUI 9 反馈类组件在 Foundation 项目中的详尽用法。当使用 Alert/Dialog/Progress/Skeleton/Snackbar/Backdrop 时参考。
Foundation 项目 @mui/icons-material 图标库详尽用法指南。Icon 铁律：只用 *Rounded 系列，禁止 emoji/Unicode/第三方 icon 包。
MUI 9 输入类组件在 Foundation 项目中的详尽用法。当使用 Button/TextField/Select/Checkbox/Switch/Slider/Radio/Rating/Autocomplete/ToggleButton/FAB 时参考。
MUI 9 布局类组件在 Foundation 项目中的详尽用法。当使用 Box/Container/Grid/Stack/ImageList 时参考。
| name | wails-tutorials-migration |
| description | 完整动手教程（QR Code Service / TODO List / Notes / Self-Update App）+ v2→v3 迁移指南。当用户说「教程 / step-by-step / 教我做一个 todo / notes 应用 / 自动更新教程 / 从 wails v2 升级 / wails.Run / Bind / startup / Bind 列表 / 迁移」时使用。 |
包含 4 个完整动手教程（从浅到深），以及 v2→v3 迁移指南。
| # | 教程 | 时长 | 学到什么 |
|---|---|---|---|
| 01 | QR Code Service | ~10min | Service 架构基础、外部 Go 依赖、绑定 |
| 02 | TODO List (Vanilla JS) | ~20min | CRUD、线程安全的状态管理、类型安全绑定 |
| 03 | Notes (Apple Notes 风格) | ~30min | 原生文件对话框、JSON 持久化、防抖自动保存 |
| 04 | Self-Updating App | ~25min | app.Updater、GitHub Releases provider、Ed25519 签名、SHA256SUMS、自定义 UI |
⚠️ Tutorial 01（QR Code Service）的内容已合并到 wails-bindings skill 的 references。本 skill 主要包含 02/03/04。
| 角度 | v2 | v3 |
|---|---|---|
| API | wails.Run(&options.App{...}) 一调到底 | application.New(opts) 创建 → app.Window.NewWithOptions(...) → app.Run() 三步 |
| 多窗口 | 不易 | 任何时候 app.Window.New() |
| 错误处理 | 统一 | 各阶段独立 |
| 角度 | v2 | v3 |
|---|---|---|
| Context | 每个 struct 需要 ctx context.Context 字段 + startup(ctx) | Service 是普通 struct；需要 ctx 时方法首参 context.Context |
| 注册 | Bind: []interface{}{&App{}} | Services: []application.Service{application.NewService(&MyService{})} |
| 生命周期 | startup 函数 | 实现 ServiceStartup(ctx, opts) error 方法 |
| 角度 | v2 | v3 |
|---|---|---|
| API | runtime.EventsEmit(ctx, name, data) | app.Event.Emit(name, data) |
| 监听 | runtime.EventsOn(ctx, name, fn) | app.Event.On(name, fn) 返回 unsubscribe |
| 系统事件 | 字符串 | events.Common.WindowFocus 等常量 |
| 角度 | v2 | v3 |
|---|---|---|
| 创建 | wails.Run(&options.App{...}) 内置一个窗口 | 显式 app.Window.New() |
| 操作 | runtime.WindowSetTitle(ctx, "x") | window.SetTitle("x") |
| 多窗口 | 难 | 原生支持，app.Window.GetByName(name) |
| 角度 | v2 | v3 |
|---|---|---|
| API | runtime.MessageDialog(ctx, options) | app.Dialog.Info()/Question()/... builder |
| 文件 | runtime.OpenFileDialog(ctx, options) | app.Dialog.OpenFile().AddFilter().PromptForSingleSelection() |
| 角度 | v2 | v3 |
|---|---|---|
| 创建 | menu.NewMenuFromItems(...) | app.NewMenu().AddSubmenu("File").Add("New").OnClick(...) |
| 注册 | Menu field on options | app.Menu.Set(menu) + 窗口 UseApplicationMenu: true |
wails.json → v3 build/config.ymlwails.json 中的 frontend:install、frontend:build 等命令 → v3 Taskfile（Taskfile.yml）| v2 | v3 |
|---|---|
wails init | wails3 init |
wails build | wails3 build |
wails dev | wails3 dev |
wails generate module | wails3 generate bindings |
| 没有 | wails3 task --list 看所有 Task |
典型应用：1-4 小时。
app.NewWebviewWindow(...) API 不存在 —— 没有兼容包装层| 主题 | 文件 |
|---|---|
| 教程总览 | overview.md |
| 02 TODO List 完整教程 | 02-todo-vanilla.md |
| 03 Notes 完整教程 | 03-notes-vanilla.md |
| 04 Self-Update 完整教程 | 04-self-update-a-wails-app.md |
| v2 → v3 迁移指南（完整 breaking changes） | v2-to-v3.md |
wails-bindings 的 references/tutorial-creating-a-service.mdwails-bindingswails-menus-dialogswails-advanced（updater.md）wails-applicationwails-events