用途:为需要在 macOS、Windows(可选 Linux)上运行且要有原生手感的桌面应用提供架构建议,覆盖设计、原型与重写阶段。
主要能力:以哲学八条原则为纲,配套架构分层、WebView 存活、IPC 契约、内存真相、原生惯例、Raycast 实证等参考文件,以及决策树和 30 项发布就绪检查清单。
核心思路:原生外壳(macOS 用 Swift/AppKit,Windows 用 C#/WPF)掌管窗口、热键、菜单栏、材质与生命周期,系统 WebView(WKWebView 或 WebView2)仅作渲染面,共享 React/TypeScript UI;业务逻辑放在随应用打包的常驻 Node 进程;性能关键子系统(文件索引、计算、加密)用 Rust 编写,经 UniFFI 生成类型化绑定跨平台共享。四套运行时通过单一声明接口通信。
使用方式:先读 references/01-philosophy.md,再按问题匹配对应参考文件,避免整包倾倒;给出架构建议前先跑 checklists/decision-tree.md,宣称“有原生感”前跑 checklists/ship-readiness.md。
限制与反模式:不建议用 Electron 或 Tauri 加主题来追求原生手感,不建议用 Swift/C# 渲染 UI 而只共享业务逻辑,不建议手写各语言 IPC 类型,不建议自行轮询绕过 WebKit 节流,也不要用 cursor: pointer 制造响应感。该架构有约 400 MB 常驻内存基线(其中约 150 MB 为 WebView 与 Node 不可避免),决策树会排除若干常见项目形态,此时应直接说明不适用。具体命令与代码示例暂未提供。