SuperAPI AI 工具集

vicinae

编程与开发

查看项目

更新于 10-15 23:47

技能介绍

用途:为 Vicinae 启动器开发扩展,使用 TypeScript 与 React。命令分两类:view 命令显示 React UI,no-view 命令执行无界面动作。

主要能力:通过 @vicinae/api 提供 List、ActionPanel、Action、Icon、showToast、useNavigation、getPreferenceValues 等组件与接口;支持视图间导航(push/pop)与偏好设置。所有 Action 必须带 icon 属性。

使用方式:推荐用 Vicinae 内置的 Create Extension 命令创建。手动方式:mkdir my-extension && cd my-extension;npm init -y;npm install @vicinae/api typescript @types/react @types/node;mkdir src && touch src/command.tsx。在 package.json 中声明 name、title、version、commands(含 name、title、description、mode)及依赖 @vicinae/api。视图命令在 src/command.tsx 中默认导出 React 组件;无界面命令在 src/action.ts 中默认导出异步函数。开发流程:npm run build 生产构建,npx tsc --noEmit 类型检查;可用 tmux 运行开发服务器:tmux has -t vicinae-dev || tmux new-session -d -s vicinae-dev 'bunx vici develop',并用 tmux capture-pane -t vicinae-dev -p -S - 读取日志。

适用场景:需要为 Vicinae 启动器添加自定义命令、列表/表单/详情界面或快捷动作的开发者。

限制:资料未提供收费、价格、平台支持范围及具体版本兼容性等信息;高级 UX 模式、完整 API 参考与键盘快捷键见 references/ 目录。