用途:指导使用 React 与 TypeScript 开发 Raycast 扩展,适用于创建扩展、命令或工具的场景。
主要能力:提供项目结构模板(package.json、tsconfig.json、.eslintrc.json、assets 图标与 src 命令文件);支持 view、no-view、menu-bar 三种命令模式;可配置热键、偏好设置与扩展图标;涵盖剪贴板、通知、AppleScript、fetch 等常用 API;并给出缓存与性能优化方案,如 Cache、withCache、useCachedPromise、useSQL、乐观 UI、sidecar 后台预加载、SQLite URI 只读直连、execFile 替代 exec 等。
使用方式:创建项目结构并编写 package.json 配置,在 src/ 实现命令,运行 npm install && npm run dev 启动热重载;npm run fix-lint 检查修复,npm run build 构建,npm run publish 提交至 Raycast Store 审核。可通过 raycast:// 深链触发命令或重载扩展。
适用场景:需要为 macOS 上的 Raycast 构建命令、后台任务或菜单栏工具,并关注启动速度与大数据集过滤性能的开发者。
限制:热键在 package.json 中仅为建议,需用户在 Raycast 偏好设置中设定;view 命令不支持 interval 后台调度,需借助 no-view 或 menu-bar 模式实现;后台同步建议使用 15 分钟至 1 小时间隔以避免耗电与限流;超过 1000 条数据建议改用 SQLite 而非 JSON 缓存。其他收费、价格与平台细节暂未提供。