Raycast扩展开发

技能简介

本技能用于基于Raycast API构建和维护扩展程序，支持使用React与TypeScript开发List、Grid、Detail、Form等UI组件，集成AI.ask、LocalStorage、Cache、showToast及BrowserExtension等功能。

能做什么

• 创建可搜索的列表或网格界面
• 展示富文本详情页与Markdown内容
• 构建用户输入表单并处理提交
• 实现加载/成功/失败状态反馈
• 管理缓存数据与持久化存储
• 调用AI接口与浏览器扩展功能

使用说明

1. 安装依赖：运行 npm install @raycast/api 初始化项目
2. 确定UI类型：根据数据特征选择List（文本为主）或Grid（图片为主）
3. 查阅参考文档：打开 references/api/ 下对应组件的md文件获取规范
4. 应用默认模式：使用showToast反馈状态，Cache存临时数据，LocalStorage存用户数据
5. 权限检查：调用AI或BrowserExtension前先用environment.canAccess验证
6. 实现与引用：编写代码并在注释中链接所使用的参考文档

输入与输出

见下方输入与输出表格。

风险提示

• AI与浏览器扩展需先检查访问权限，否则运行时出错
• HUD仅适用于后台快速完成场景，避免滥用
• Cache数据非持久化，重启后丢失
• 敏感数据应使用LocalStorage而非Cache

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/xaif/raycast/SKILL.md
来源类型：GitHub仓库