
你想把应用从「只跑 macOS」迁到 Windows,或者从 Swift 单体迁到 React + 跨平台——第一反应往往是:找十个工程师,开分支,干两年。
Raycast 刚公开 beta 的 2.0 走了一条不一样的路:2023 年底立项 X-Ray(跨平台 Raycast),从零重写,技术栈变成 TypeScript、Swift、C#、Rust、Node、React 叠在一起。官方自己说,难点从来不是「让应用跑起来」,而是 「让它感觉还对」。
这篇文章不聊 Raycast 好不好用。我把它当成 「AI 时代怎么做应用迁移」 的教科书案例——你正在用 Claude Code / Cursor 维护老项目、想跨平台、想换栈的人,能直接抄思路。
1、先分清:什么叫「AI 原生迁移」?
传统迁移:人读代码 → 人画架构图 → 人写新代码 → 人测。AI 顶多帮你补几个函数。
AI 原生迁移 是另一套默认动作:
Raycast 没写「我们全程用 Claude 写的」,但他们的流程和今天 Claude Code 用户该做的 高度同构:
-
早期用 Web 技术验证(Notes 就是 React 塞进 WebView 的试验)
-
原型证明「看起来像、摸起来像」再 all-in(半透明窗口、原生 tooltip 叠在 WebView 上)
-
产品逻辑沉到可 AI 协作的层(React + TypeScript + Node 占大部分工时)
-
只有 OS 咬合处留给人 + 原生工程师(热键、窗口、WebKit 节流)
说白了:把 AI 擅长写的部分最大化,把 AI 写不好的部分圈起来。
2、迁移第一步:别先选框架,先选「AI 能守住哪几层」
Raycast 评估过 Electron、Tauri、自建混合栈(系统 WebView + 原生壳)。他们否了 Electron,核心就一句:我们要掌控每一层,需要时能退回原生。
对正在迁移的你,可以翻译成 三条路线(按 AI 协作友好度排序):
路线 A:混合栈(Raycast 选的)——最适合「要强原生 + 要跨平台」
-
原生壳:macOS Swift/AppKit,Windows C#/WPF
-
UI:一套 React + TypeScript,装进
WKWebView/ WebView2 -
业务:Node 常驻进程,数据库、扩展运行时
-
性能热点:Rust(文件索引等)
AI 能帮你什么:React 页面、Node API、类型化的 IPC 接口声明、Rust 里相对独立的模块。 你必须自己啃:全局热键、窗口不抢焦点、WebKit 节流、popover 超出窗口边界。
路线 B:Electron / Tauri——最适合「先迁起来、团队小」
官方原话:对多数公司,Electron 就是正确答案。VS Code、Linear 都证明了。
AI 能帮你什么:几乎整个应用逻辑 + UI,资料多,模型最熟。 代价:macOS 上多绑 Chromium、原生细控弱,和 Raycast 这类「启动器级 OS 集成」产品不匹配。
路线 C:纯原生双端——AI 只能当助手,不适合当主力
两套 UI、两套逻辑。AI 可以写单点功能,很难帮你维持「一个团队、两个平台、功能同步 ship」。
我的判断:如果你用 Claude Code 做迁移,除非产品极简,否则别选 C。Raycast 若选 C,Windows 版会晚两年,招聘也会崩。
3、目标架构:四层模型(可直接画进你的迁移 Brief)
Raycast 2.0 最终是 四块。你可以把它当成 迁移目标的默认模板:

层与层之间:接口一处声明,各端生成类型化客户端(他们混用平台消息处理器 + stdio)。
这对 AI 协作极其重要——你可以让 Claude Code 只改 contracts/ 下的 IDL,再生成 Swift/TS/Rust 桩代码,减少「改一层漏一层」。
迁移时给 AI 的 Brief 模板(可复制):
我们要把 [老应用名] 从 [老栈] 迁到四层架构:
1. Host 只负责 [列出必须原生的能力]
2. Web 前端负责全部可见 UI,单仓,入口:A/B/C
3. Node 负责 [业务列表]
4. Rust 仅负责 [性能模块,若无则写「暂无」]
请先输出:各层目录结构 + 层间 IPC 消息列表(JSON schema),
不要写实现。我确认后再分模块实现。
4、用 Claude Code 迁移的 5 个阶段(对照 Raycast 时间线)
阶段 0:在旧代码里做「Web 试验田」(Raycast:Notes)
别一上来就重写。Raycast 先在 v1 里用 WebView + React 做 Notes,验证:Web 块会不会破坏整体手感。
你可以做:挑一个相对独立模块(设置页、报表页、编辑器),用 HTML/React 做一版,嵌进现有壳。 给 Claude Code 的 prompt 方向:
在现有 [macOS/Win] 应用里新增一个 WebView 页面,加载本地 React 构建产物。
要求:单文件或可静态部署,不引 CDN。列出与原生壳的 postMessage 接口。
阶段 1:原型验证「像不像自家产品」(Raycast:X-Ray 早期)
Raycast 在 all-in 前问了三件事:半透明行不行?原生 tooltip 能不能叠在 WebView 上?看起来像不像 Raycast?
这是 AI 最该烧 token 的阶段——用 HTML 出视觉与交互原型,比写 Swift 快一个数量级。你上一篇若已接受「让 Agent 出 HTML 而不是 Markdown」,这里正好用上:让 Claude 出 可点击的单文件 HTML,给产品/自己摸一遍。
阶段 2:定栈 + 划界(Raycast:否 Electron,选混合)
用 AI 做 决策备忘录,而不是让它替你拍板:
我们的应用需要:[全局热键/系统托盘/文件索引/富文本/…]
请对比 Electron、Tauri、混合 WebView 三种方案,
从「AI 可维护面积」「原生控制力」「内存基线」「招聘」四维打分,各用 200 字。
人来做最终选择。Raycast 的结论是:混合栈 infra 成本高,但对他们值得;你是小工具,可能 Electron 就够。
阶段 3:纵向切一条「黄金路径」先 ship(别平行重写所有功能)
Raycast 团队大部分时间泡在 Web 前端 + Node。功能在这两层 只写一次,两平台同时有。
迁移时别让 AI 平行重写 47 个页面。选一条路径,例如:登录 → 主列表 → 详情 → 保存。
对 Claude Code 用 /goal(若你已升级 v2.1.139+):
/goal 黄金路径 E2E 跑通:从空数据库到完成一次 [核心业务动作],
macOS Host 与 Web 前端联调通过,附带最小单测;Windows 暂不实现
阶段 4:原生「露馅」清单——必须人审,别让 AI 自由发挥
Raycast 列过一堆 Web 应用在桌面会露馅 的细节,他们全部改掉了。这份清单你可以直接当 Code Review checklist:
-
控件不要用
cursor: pointer(一股网页味) -
列表项不要 Web 式 hover 高亮(macOS 惯例不同)
-
设置页用 独立原生窗口,不要模态网页
-
Popover / tooltip 用 原生窗口,要能超出 WebView 边界
-
窗口 show/hide 不能闪(WebKit 老毛病)
给 Claude Code:
审查当前 React 页面是否符合「桌面原生惯例」清单:[粘贴上面几条]。
列出违规点及改法,优先改 CSS/组件层,不要引入新依赖。
WebKit 那些硬核 workaround(alphaValue = 0 骗过节流、WKWebView frame 常驻全尺寸等)——别指望 AI 一次写对,要对照 Raycast 文里案例 逐条验收。
5、AI 迁移时,Raycast 替你踩过的 3 个坑
坑 1:以为「迁到 Web」就等于「能跨平台」
扩展 API 设计时就要 平台无关。Raycast 扩展从没假定只在 macOS 跑,所以搬 Windows 时 商店里一大批扩展能跟着走。
你若用 AI 生成插件 API,在 prompt 里 写死:禁止 NS* / Win32 泄漏到扩展 SDK。
坑 2:内存数字吓退自己,但产品形态变了
v1 大约 200–300 MB,v2 大约 350–450 MB。Raycast 没有粉饰,但解释得很清楚:WebView + Node 有基线成本,原生壳反而很轻。 你用 AI 迁到混合栈,要预先跟用户(或老板)对齐:内存会涨,但 功能 ship 速度、双端覆盖 是收益。
坑 3:让 AI 写「感觉像原生」——太模糊
Raycast 的测试标准极其具体:不知道技术栈的用户,会不会以为这是普通 Mac 应用?
把你的验收标准也改成 可观察行为,写进 CLAUDE.md:
## 迁移验收
- 冷启动主窗口 < 300ms(M1, 16GB)
- 连续 show/hide 启动器 20 次无可见闪烁
- 设置页为独立窗口,非 Web 模态
AI 需要 可验证终态,这和 /goal 是同一套哲学。
6、和「只重写 UI」相比,AI 原生迁移多做了什么?
很多人用 AI 做迁移,其实只是 把 Swift 界面翻译成 React,业务逻辑还在老地方。
Raycast 级别做法是:
-
文件索引这种 OS 级能力 用 Rust 重写(Windows 上读 NTFS MFT),不再依赖 Spotlight——这是 迁移动机 之一(v1 文件搜索在 Windows 上不可能)
-
业务沉到 Node,扩展与主应用 同一套栈(扩展不用再单独装 Node)
-
开发体验:热重载 UI 不到一秒 vs 以前编 Swift 重启——AI 迭代速度才能释放出来
你若只让 AI 翻译 UI,收益上限很低。要问自己:迁移是否顺便解决了旧架构里最痛的那根刺?(编译慢、无法跨平台、某 OS API 不可用)
7、我的判断:AI 原生迁移 = 人机分工重划,不是「全自动重写」
Raycast 花了很久,因为他们 手感不对就不 ship。AI 能缩短的是 中间层代码的生成与迭代;不能缩短的是「这个产品摸起来还是不是它自己」。
给你三条 可执行结论:
-
能放进 React + Node 的,尽量交给 AI(含接口生成、页面、业务逻辑、测试脚手架)
-
Host + WebView 生命周期 + 平台惯例,建一个「原生清单」文件,迁移全程只许人 + 资深工程师改
-
用 HTML 原型 +
/goal式验收 贯穿迁移,别用「感觉差不多了」收工
Raycast 2.0 证明了一件事:跨平台重写不一定需要两倍人马;但需要 刻意把栈切成 AI 好啃的四层,并在原生边界上死抠细节。
你下一个要迁的项目,不妨先问:Notes 模块能不能先上 WebView 做试验田? 能,再谈 X-Ray 式的全面重写。