AllWorkin / Articles / 2026.05.15

用 AI 原生迁移一个应用:Raycast 2.0 重写给我们的 3 条路线

Raycast 2.0 用混合栈(原生壳+React+Node+Rust)完成跨平台重写。本文不测评产品,而是提炼「AI 原生迁移」五阶段、四层架构模板、三条技术路线及 Claude Code 可复制 prompt,帮你把 AI 用在能写好的层,把原生边界留给人。

2026.05.15约 8 分钟#Claude#设计#Cursor#Agent

image

你想把应用从「只跑 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 用户该做的 高度同构:

  1. 早期用 Web 技术验证(Notes 就是 React 塞进 WebView 的试验)

  2. 原型证明「看起来像、摸起来像」再 all-in(半透明窗口、原生 tooltip 叠在 WebView 上)

  3. 产品逻辑沉到可 AI 协作的层(React + TypeScript + Node 占大部分工时)

  4. 只有 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 最终是 四块。你可以把它当成 迁移目标的默认模板:

ChatGPT Image 2026年5月15日 18_09_45

层与层之间:接口一处声明,各端生成类型化客户端(他们混用平台消息处理器 + 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 级别做法是:

  1. 文件索引这种 OS 级能力 用 Rust 重写(Windows 上读 NTFS MFT),不再依赖 Spotlight——这是 迁移动机 之一(v1 文件搜索在 Windows 上不可能)

  2. 业务沉到 Node,扩展与主应用 同一套栈(扩展不用再单独装 Node)

  3. 开发体验:热重载 UI 不到一秒 vs 以前编 Swift 重启——AI 迭代速度才能释放出来

你若只让 AI 翻译 UI,收益上限很低。要问自己:迁移是否顺便解决了旧架构里最痛的那根刺?(编译慢、无法跨平台、某 OS API 不可用)


7、我的判断:AI 原生迁移 = 人机分工重划,不是「全自动重写」

Raycast 花了很久,因为他们 手感不对就不 ship。AI 能缩短的是 中间层代码的生成与迭代;不能缩短的是「这个产品摸起来还是不是它自己」。

给你三条 可执行结论:

  1. 能放进 React + Node 的,尽量交给 AI(含接口生成、页面、业务逻辑、测试脚手架)

  2. Host + WebView 生命周期 + 平台惯例,建一个「原生清单」文件,迁移全程只许人 + 资深工程师改

  3. 用 HTML 原型 + /goal 式验收 贯穿迁移,别用「感觉差不多了」收工

Raycast 2.0 证明了一件事:跨平台重写不一定需要两倍人马;但需要 刻意把栈切成 AI 好啃的四层,并在原生边界上死抠细节。

你下一个要迁的项目,不妨先问:Notes 模块能不能先上 WebView 做试验田? 能,再谈 X-Ray 式的全面重写。

AI工具实战派

觉得有用?每周的新笔记先发公众号。

每周的实战笔记先发在这里。扫码关注,新文章第一时间推给你。

关注 / 加入社群 →