foundation

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 时参考。

MUI 9 导航类组件在 Foundation 项目中的详尽用法。当使用 Tabs/Menu/Drawer/Breadcrumbs/Pagination/Stepper/SpeedDial/BottomNav/Link 时参考。

Foundation 项目 MUI 9 组件库总索引。汇总全部 Foundation×MUI 铁律（配色、圆角、图标、i18n、样式工厂、对话框）、styles.ts 工厂模式标准写法、全 skill 导航索引。当使用任何 MUI 组件时首先阅读本 SKILL。

MUI 9 容器表面类组件在 Foundation 项目中的详尽用法。当使用 Accordion/AppBar/Card/Paper 时参考。

Foundation 项目 MUI 9 工具类组件用法文档。覆盖 Modal / Popover / Popper / Portal / ClickAwayListener / CssBaseline / Transitions / useMediaQuery / NoSsr / TextareaAutosize / GlobalStyles。遵循 Foundation 配色、圆角、图标、i18n、样式工厂铁律。

@mui/x-charts v9.3 在 Foundation 项目中的详尽用法。社区版图表：Pie/Bar/Line/Scatter/Gauge/Sparkline + 项目自实现高级图表：Heatmap/Funnel/Radar/Candlestick/Sankey/Gantt/Treemap/Zoom。

@mui/x-data-grid v9.3 在 Foundation 项目中的详尽用法。社区版全功能 + 项目自实现的 Pro/Premium 功能（列钉住/树形数据/行分组/聚合/Excel导出等）。

Foundation 系统托盘使用指南：SystrayService（Enable/Disable）、注册式模块系统、托盘面板弹窗（MUI 风格）、内置模块（AppStatus/QuickActions/Notifications/ExitButton）、新增模块标准操作，以及 settings.ts 功能配置。

Foundation 脚手架的国际化（i18n）系统使用指南。说明语言注册、文案查找、模板插值、页面级语言包、运行时切换；以及"任何人类可见字符串都必须走 i18n"的铁律。

Foundation 脚手架的持久化层使用指南（SQLite + GORM + AutoMigrate）。说明加表三步、业务 service 接入、前端调用、路径切换、表统计与清空；以及"前端禁用 localStorage / 业务 service 不许 capture *DB"的铁律。

Foundation 脚手架的主题注册系统使用指南。说明如何注册新主题、切换主题、扩展调色板，以及如何在组件里安全地消费主题色。

Foundation 脚手架的 Go 工具层使用指南：httpx（HTTP 客户端）、procx（子进程 + Windows JobObject）、cryptox（AES-GCM）、logx（slog + 文件 rotate）、filex（原子写）。覆盖典型用法、跨平台细节、与 SQLite / 前端的边界，以及"业务代码不许直接 net/http / exec.Cmd / log.Println / os.WriteFile 配置"等铁律。

Wails v3 高级与杂项主题：自定义传输（WebSocket/gRPC）、单实例、文件关联、自定义 URL 协议、自动更新器（Updater）、性能优化、安全实践、Panic 处理、Raw Messages、HTTP/Gin 路由集成、E2E 测试 (Playwright)、单元测试、自定义模板。当用户问到「Custom Transport / SingleInstance / FileAssociations / myapp:// / app.Updater / Provider / GitHub Releases / RawMessageHandler / PanicHandler / Gin 路由 / e2e Playwright / wails3 generate template」时使用。

application.New / Options / Run / Quit / RegisterService / OnShutdown / ShouldQuit / Logger / RawMessageHandler / 平台 Options。当用户问到 application.Options 字段、Mac/Windows/Linux 平台选项、应用入口写法时使用。

编写 Service、生成 TypeScript 绑定、方法签名、模型映射、枚举支持、最佳实践。当用户问到「Service / Greet / NewService / 服务生命周期 / ServiceStartup / ServiceShutdown / 类型映射 / TypeScript 生成 / 自定义 binding 名 / Internal 隐藏方法」时使用。

Wails v3 构建系统 (Task)：本地构建、跨平台编译（Docker）、平台特定打包（NSIS/MSI/dmg/AppImage/deb/rpm）、代码签名（Windows/macOS notarization）、Garble 混淆、安装器（NSIS/Windows installer）、服务器模式构建（无 GUI）、Windows UAC。当用户问到「wails3 build / package / GOOS GOARCH / Task / Docker setup / signing / notarytool / NSIS / dmg / AppImage / nfpm / obfuscation / server build / UAC manifest / wails.exe.manifest」时使用。

wails3 命令行参考。当用户问到「wails3 init / dev / build / package / generate / doctor / tool / service / ios / sign / update」等 CLI 命令、Taskfile 集成、构建产物路径、generate bindings 用法时使用。

Wails v3 事件系统：自定义事件、应用事件、窗口事件、events.Common 常量、ApplicationEvent / WindowEvent 类型、JS Events.On / Events.Emit。当用户问到「Emit / On / Off / OnApplicationEvent / OnWindowEvent / events.Common.WindowFocus / WindowClosing / ThemeChanged / 事件命名空间 common: windows: mac: linux:」时使用。

应用菜单（菜单栏）、上下文菜单（右键）、系统托盘（systray）、对话框（消息/文件/自定义）。当用户问到「app.NewMenu / app.Menu.Set / Submenu / AddRole / FileMenu EditMenu / OnClick / SystemTray / app.SystemTray.New / app.Dialog / OpenFile / SaveFile / Question / Info / Custom Dialog」时使用。

理解 Wails v3 整体架构、应用生命周期、Go-Frontend 桥接、构建系统、Manager API 与版本对比。当用户问到「Wails 是什么 / 工作原理 / 与 Electron 区别 / 启动流程 / 桥接性能 / 构建步骤 / app.Window 等管理器」时使用。

Wails v3 安装、依赖检查、新建项目、第一个应用、项目结构解析。当用户问到「如何安装 wails3 / wails3 init / wails3 doctor / 项目目录结构 / 新手开始 / Go 版本要求 / WebView2 依赖」时使用。

剪贴板、通知、屏幕、自启动、平台 API（dock）、键盘快捷键、文件/HTML 拖放、浏览器集成、环境信息、前端 @wailsio/runtime。当用户问到「app.Clipboard / Notifications / app.Screen / Autostart / Dock / KeyBinding / EnableFileDrop / OpenURL / app.Env / @wailsio/runtime / Application Window WML Events Browser Dialogs Flags Screens System」等运行时功能时使用。

完整动手教程（QR Code Service / TODO List / Notes / Self-Update App）+ v2→v3 迁移指南。当用户说「教程 / step-by-step / 教我做一个 todo / notes 应用 / 自动更新教程 / 从 wails v2 升级 / wails.Run / Bind / startup / Bind 列表 / 迁移」时使用。

窗口创建、配置、控制、frameless、多窗口、窗口事件、自定义。当用户问到 app.Window / WebviewWindow / WebviewWindowOptions / SetTitle / SetSize / Frameless / Center / 多窗口管理 / 窗口事件监听时使用。