# 光线投射和阿尔弗雷德技能使用 Raycast 扩展和 Alfred 工作流程掌握 macOS 启动器自动化。该技能涵盖基于 TypeScript 的 Raycast 开发、AppleScript/Python Alfred 工作流程、键盘快捷键、剪贴板管理和生产力自动化模式。 ## 何时使用此技能 ### 在以下情况下使用： * 为开发人员工作流程构建快速访问工具 * 自动执行重复的 macOS 任务 * 创建自定义搜索命令 * 构建剪贴板历史管理器 * 实现文本片段扩展 * 创建项目启动器和切换器 * 构建API查询工具 * 自动化应用程序控制 * 创建自定义键盘快捷键 * 构建团队生产力工具 ### 不要在以下情况下使用： * 需要跨平台自动化（使用 shell 脚本） * 服务器端自动化（使用 cron/systemd） * GUI 测试自动化（使用 Playwright/Selenium） * Windows/Linux环境 * 繁重的计算任务（使用适当的 CLI 工具） ## 先决条件 ### 光线投射设置 # 安装光线投射酿造安装——木桶光线投射 # 安装 Node.js（扩展开发所需）酿造安装节点 # 安装 Raycast CLI npm install -g @raycast/api # 创建新扩展 npx create-raycast-extension --name my-extension # 开发模式 cd my-扩展名 npm 安装 npm 运行开发 # 扩展结构 # 我的扩展/ # ├── package.json # ├── tsconfig.json # ├── src/ # │ ├── index.tsx # 主命令 # │ └── other-command.tsx # 附加命令 # └── 资产/ # └── icon.png # 扩展图标 ### 阿尔弗雷德设置 # 安装 Alfred（工作流程需要 Powerpack）酿造安装--木桶阿尔弗雷德 # Alfred 工作流程位置 # ~/Library/Application Support/Alfred/Alfred.alfredpreferences/workflows/ # 通过 Alfred Preferences > Workflows > + > Blank Workflow 创建工作流程 # 工作流程组件： # - 触发器：关键字、热键、文件操作 # - 操作：脚本、打开 URL、运行 NSAppleScript # - 输出：通知、复制到剪贴板、播放声音 # 支持的脚本语言: # - bash、zsh # - Python（2 或 3） # - 用于自动化的 AppleScript / JavaScript (JXA) # - Ruby、PHP、Perl ### 开发环境 # 用于 Raycast TypeScript 开发 npm install -g 打字稿@types/node # 对于 Alfred Python 工作流程 pip install alfred-workflow #（遗留但有用的模式） # AppleScript 工具 brew install --cask script-debugger # 可选：AppleScript IDE # 测试工具 brew install jq # JSON解析 ## 核心能力 ### 1\.光线投射脚本命令 #!/bin/bash # 所需参数： # @raycast.schema版本 1 # @raycast.title 打开项目 # @raycast.mode 静音 # 可选参数： # @raycast.icon 📁 # @raycast.argument1 { "type": "text", "placeholder": "项目名称", "optional": false } # @raycast.packageName 开发者工具 # 文档： # @raycast.description 在 VS Code 中打开项目 # @raycast.author 你的名字 # @raycast.authorURL https://github.com/yourname 项目=“$1” PROJECT_DIR="$HOME/projects/$PROJECT" 如果[-d“$PROJECT_DIR”];然后代码“$PROJECT_DIR” echo“已打开$PROJECT” 否则 echo“未找到项目：$PROJECT” 1号出口菲 #!/bin/bash # @raycast.schema版本 1 # @raycast.title Git 状态 # @raycast.mode fullOutput # @raycast.icon 🔀 # @raycast.packageName Git # @raycast.description 显示当前目录的 git 状态 # @raycast.author 工作空间中心 cd "$(pwd)" || 1号出口如果[-d“.git”];然后 echo“分支：$（git分支--show-current）” 回声“” 回显“状态：” git status --短回声“” echo“最近提交：” git log --oneline -5 否则 echo "不是 git 存储库" 1号出口菲 #!/usr/bin/env python3 # 所需参数： # @raycast.schema版本 1 # @raycast.title UUID 生成器 # @raycast.mode 静音 # 可选参数： # @raycast.icon 🔑 # @raycast.argument1 { "type": "dropdown", "placeholder": "格式", "data": [{"title": "标准", "value": "标准"}, {"title": "无破折号", "value": "nodash"}, {"title": "大写", "value": "大写"}] } # @raycast.packageName 实用程序导入uuid 导入子流程导入系统 format_type = sys.argv[1] 如果 len(sys.argv) > 1 否则“标准” new_uuid = str(uuid.uuid4()) 如果 format_type == "nodash": new_uuid = new_uuid.replace("-", "") elif format_type == "上部": new_uuid = new_uuid.upper() # 复制到剪贴板 subprocess.run(["pbcopy"], input=new_uuid.encode(), check=True) print(f"已复制：{new_uuid}") #!/bin/bash # @raycast.schema版本 1 # @raycast.title 杀死端口 # @raycast.mode 紧凑 # @raycast.icon 🔌 # @raycast.argument1 { "type": "text", "placeholder": "端口号" } # @raycast.packageName 开发者工具端口=“$1” # 查找端口上的进程 PID=$(lsof -ti:$PORT 2>/dev/null) 如果[-z“$PID”];然后 echo "端口 $PORT 上没有进程" 出口0 菲 # 杀死进程杀死 -9 $PID 2>/dev/null 如果 [ $? -eq 0]；然后 echo“杀死了端口$PORT上的进程$PID” 否则 echo "无法终止端口 $PORT 上的进程" 1号出口菲 ### 2\. Raycast TypeScript 扩展 // src/index.tsx // ABOUTME: Raycast 扩展主命令 // 关于我：包含收藏夹和最近的项目启动器导入{ 操作面板，行动，列表，图标，本地存储，显示吐司，吐司，获取偏好值，来自“@raycast/api”；从“react”导入{ useState，useEffect }；从“child_process”导入{exec}；从“util”导入{promisify}；从“fs”导入 fs；从“路径”导入路径； const execAsync = promisify(exec); 界面首选项{ 项目目录：字符串；编辑器：字符串； } 接口项目{ 名称：字符串；路径：字符串；最后打开？：数量；是最喜欢的吗？：布尔值； } 导出默认函数 Command() { const [projects, setProjects] = useState([]); const [isLoading, setIsLoading] = useState(true); const 首选项 = getPreferenceValues<首选项>(); 使用效果（（）=> { 加载项目（）； }, []); 异步函数 loadProjects() { 尝试{ constprojectsDir=preferences.projectsDir.replace("~", process.env.HOME || ""); const dirs = fs.readdirSync(projectsDir, { withFileTypes: true }); // 从存储中加载收藏夹和最近的内容 const favoritesJson = wait LocalStorage.getItem("favorites"); constcentrecentJson=awaitLocalStorage.getItem("最近"); const 收藏夹 = favoritesJson ？ JSON.parse(favoritesJson) : []; 常量最近=最近Json？ JSON.parse(recentJson) : {}; const projectList: 项目[] = 目录 .filter((dir) => dir.isDirectory() && !dir.name.startsWith(".")) .map((目录) => ({ 名称：目录名称，路径：path.join(projectsDir, dir.name), 上次打开：最近[目录名] || 0, isFavorite: favorites.includes(dir.name), }）） .sort((a, b) => { // 首先是最喜欢的，然后是最近的 if (a.isFavorite && !b.isFavorite) 返回 -1; if (!a.isFavorite && b.isFavorite) 返回 1; 返回(b.lastOpened || 0) - (a.lastOpened || 0); }); setProjects(项目列表); } 捕获（错误）{ 显示吐司（{ 样式：Toast.Style.Failure， title: "加载项目失败", 消息：字符串（错误）， }); }最后{ setIsLoading(假); } } 异步函数 openProject(项目: 项目) { 尝试{ const 编辑器=preferences.editor || “代码”; 等待 execAsync(`${editor} "${project.path}"`); // 更新最近的 constcentrecentJson=awaitLocalStorage.getItem("最近"); 常量最近=最近Json？ JSON.parse(recentJson) : {}; 最近[项目名称] = Date.now(); 等待 LocalStorage.setItem("最近", JSON.stringify(最近)); 显示吐司（{ 风格：Toast.Style.Success， title: `打开${project.name}`, }); } 捕获（错误）{ 显示吐司（{ 样式：Toast.Style.Failure， title: "无法打开项目", 消息：字符串（错误）， }); } } 异步函数toggleFavorite（项目：项目）{ const favoritesJson = wait LocalStorage.getItem("favorites"); const 收藏夹 = favoritesJson ？ JSON.parse(favoritesJson) : []; if (project.isFavorite) { const index = favorites.indexOf(project.name); if (index > -1) favorites.splice(index, 1); } 否则{ 收藏夹.push(项目.名称); } 等待 LocalStorage.setItem("收藏夹", JSON.stringify(收藏夹)); 等待加载项目（）； } 返回（ {projects.map((项目) => ( <列表.项目 key={项目.路径} 标题={项目.名称} 副标题={项目.路径} 图标={项目.isFavorite ?图标.星号：图标.文件夹} 配件={[ 项目.lastOpened ？ { 文本：新日期(project.lastOpened).toLocaleDateString() } ：{}， ]} 行动={ <操作面板> <动作 title="在编辑器中打开" 图标={图标.代码} onAction={() => openProject(项目)} /> <动作 title="在 Finder 中打开" 图标={图标.Finder} 快捷方式={{修饰符：[“cmd”]，键：“o”}} onAction={() => execAsync(`打开 "${project.path}"`)} /> <动作 title =“在终端中打开” 图标={图标.终端} 快捷方式={{修饰符：[“cmd”]，键：“t”}} onAction={() => execAsync(`打开 -a 终端 "${project.path}"`)} /> <动作标题={项目.isFavorite ? “从收藏夹中删除”：“添加到收藏夹”} 图标={项目.isFavorite ? Icon.StarDisabled : Icon.Star} 快捷方式={{修饰符：[“cmd”]，键：“f”}} onAction={() => 切换收藏夹(项目)} /> } /> ))} ）； } // src/search-github.tsx // ABOUTME：GitHub 存储库搜索命令 // 关于我：搜索并打开存储库导入{ 操作面板，行动，列表，图标，显示吐司，吐司，获取偏好值，来自“@raycast/api”；从“反应”导入{useState}；从“节点获取”导入获取；界面首选项{ githubToken：字符串； } 接口存储库{ id：号码；全名：字符串；描述：字符串 |无效的; html_url：字符串； stargazers_count：数量；语言：字符串 |无效的; update_at：字符串； } 导出默认函数 Command() { const [结果，setResults] = useState([]); const [isLoading, setIsLoading] = useState(false); const 首选项 = getPreferenceValues<首选项>(); 异步函数 searchRepositories(query: string) { if (!query || query.length < 2) { 设置结果（[]）；返回; } setIsLoading(true); 尝试{ 常量响应 = 等待获取（ `https://api.github.com/search/repositories?q=${encodeURIComponent(query)}&sort=stars&per_page=20`, { 标题：{ 授权：`令牌${preferences.githubToken}`，接受：“application/vnd.github.v3+json”， }, } ）；如果（！response.ok）{ 抛出新错误（`GitHub API 错误：${response.status}`）； } const data = (await response.json()) as { items: Repository[] }; setResults(data.items || []); } 捕获（错误）{ 显示吐司（{ 样式：Toast.Style.Failure， title: "搜索失败", 消息：字符串（错误）， }); }最后{ setIsLoading(假); } } 返回（ <列表正在加载={正在加载} searchBarPlaceholder="搜索 GitHub 存储库..." onSearchTextChange={searchRepositories} 油门 > {结果.map((repo) => ( <列表.项目密钥={repo.id} 标题={repo.full_name} 副标题={repo.description || “”} 图标={图标.地球仪} 配件={[ { 图标：Icon.Star，文本：String(repo.stargazers_count) }, { 文本：repo.语言 || "" }, ]} 行动={ <操作面板> } /> ))} ）； } // src/clipboard-history.tsx // ABOUTME：自定义剪贴板历史管理器 // ABOUTME：存储和搜索剪贴板项目导入{ 操作面板，行动，列表，图标，剪贴板，本地存储，显示吐司，吐司，来自“@raycast/api”；从“react”导入{ useState，useEffect }；接口剪贴板项{ id：字符串；内容：字符串；时间戳：数字；类型：“文本”| “网址”| “代码”; } 常量 MAX_ITEMS = 100; 导出默认函数 Command() { const [items, setItems] = useState([]); const [isLoading, setIsLoading] = useState(true); 使用效果（（）=> { 加载历史记录（）； }, []); 异步函数 loadHistory() { 尝试{ const HistoryJson =等待 LocalStorage.getItem("剪贴板历史记录"); 常量历史=historyJson？ JSON.parse(historyJson) : []; 设置项目（历史）； } 捕获（错误）{ console.error("加载历史记录失败：", error); }最后{ setIsLoading(假); } } 异步函数pasteItem（项目：ClipboardItem）{ 等待 Clipboard.paste(item.content); showToast({ style: Toast.Style.Success, title: "粘贴" }); } 异步函数deleteItem(item: ClipboardItem) { const newItems = items.filter((i) => i.id !== item.id); 等待 LocalStorage.setItem("剪贴板历史", JSON.stringify(newItems)); 设置项目（新项目）； } 异步函数clearHistory() { 等待 LocalStorage.setItem("剪贴板历史", JSON.stringify([])); 设置项目（[]）； showToast({ style: Toast.Style.Success, title: "历史记录已清除" }); } 函数检测类型（内容：字符串）：“文本”| “网址”| “代码”{ if (content.match(/^https?:\/\//)) return "url"; if (content.includes("\n") && (content.includes("{") || content.includes("function"))) 返回“代码”；返回“文本”； } 函数 getIcon(类型：字符串) { 开关（类型）{ 案例“网址”：返回图标.链接；案例“代码”：返回图标.代码；默认：返回图标.文本； } } 函数 formatTimestamp(ts: number): string { const now = Date.now(); const diff = now - ts； if (diff < 60000) return "刚才"; if (diff < 3600000) return `${Math.floor(diff / 60000)}m 前`; if (diff < 86400000) return `${Math.floor(diff / 3600000)}小时前`; 返回新的 Date(ts).toLocaleDateString(); } 返回（ {items.map((item) => ( <列表.项目键={项目.id} 标题={item.content.slice(0, 100)} 副标题={item.content.length > 100 ? “...”：“”} 图标={getIcon(item.type)} 配件={[{ 文本: formatTimestamp(item.timestamp) }]} 行动={ <操作面板> <动作标题=“粘贴” 图标={图标.剪贴板} onAction={() => PasteItem(项目)} /> <动作标题=“删除” 图标={图标.垃圾桶} 样式={Action.Style.Destructive} 快捷方式={{修饰符：[“cmd”]，键：“d”}} onAction={() => 删除项目(项目)} /> <动作 title="全部清除" 图标={图标.垃圾桶} 样式={Action.Style.Destructive} 快捷方式={{修饰符：[“cmd”，“shift”]，键：“d”}} onAction={清除历史记录} /> } /> ))} ）； } ### 3\. Alfred 工作流程 - AppleScript -- 工作流程启动器.applescript -- 关于我：与 Alfred 一起启动应用程序 -- 关于：用于应用程序控制的 AppleScript 关于阿尔弗雷德脚本（q）将应用程序名称设置为 q 如果应用程序名称是“”那么返回“未指定应用程序” 结束如果尝试告诉应用程序appName 激活结束告诉返回“已启动”和应用程序名称错误 errMsg 返回“错误：”& errMsg 结束尝试结束阿尔弗雷德脚本 -- 窗口管理器.applescript -- ABOUTME: 窗口定位和管理 -- 关于我：与 Alfred 一起移动窗口并调整窗口大小关于阿尔弗雷德脚本（q） -- 解析命令：“左”、“右”、“上”、“下”、“最大化”、“中心” 将位置设置为 q 告诉应用程序“系统事件” 将 frontApp 设置为最前面为 true 的第一个应用程序进程的名称结束告诉告诉应用程序“Finder” 将 screenBounds 设置为桌面窗口的边界将 screenWidth 设置为 screenBounds 的第 3 项将 screenHeight 设置为 screenBounds 的第 4 项结束告诉 -- 菜单栏偏移将菜单栏高度设置为 25 告诉应用程序frontApp 如果位置是“左”那么将前窗口的边界设置为 {0, menuBarHeight, screenWidth / 2, screenHeight} 否则如果位置是“正确的”那么将前窗口的边界设置为 {screenWidth / 2, menuBarHeight, screenWidth, screenHeight} 否则如果位置是“顶部”那么将前窗口的边界设置为 {0, menuBarHeight, screenWidth, screenHeight / 2} 否则如果位置是“底部”那么将前窗口的边界设置为 {0, screenHeight / 2, screenWidth, screenHeight} 否则如果位置是“最大化”那么将前窗口的边界设置为 {0, menuBarHeight, screenWidth, screenHeight} 否则如果位置是“中心”那么将 winWidth 设置为 1200 将 winHeight 设置为 800 将 xPos 设置为 (screenWidth - winWidth) / 2 将 yPos 设置为 ((screenHeight - winHeight) / 2) + menuBarHeight 将前窗口的边界设置为 {xPos, yPos, xPos + winWidth, yPos + winHeight} 结束如果结束告诉返回“已移动”＆frontApp＆“到”＆位置结束阿尔弗雷德脚本 -- 剪贴板清理器.applescript -- 关于：清理和转换剪贴板内容 -- ABOUTME：删除格式、转换文本关于阿尔弗雷德脚本（q） -- 获取剪贴板内容将 ClipContent 设置为剪贴板如果 q 是“普通”那么 -- 转换为纯文本将剪贴板设置为 ClipContent 作为文本返回“转换为纯文本” 否则如果 q 是“修剪”那么 -- 修剪空白设置修剪以执行 shell 脚本“echo”和引用形式的 ClipContent &“| xargs” 将剪贴板设置为修剪状态返回“修剪后的空白” 否则如果 q 是“更低”那么 -- 转换为小写设置 lowered 执行 shell 脚本 "echo " & 引用形式的 ClipContent & " | tr '[:upper:]' '[:lower:]'" 将剪贴板设置为降低返回“转换为小写” 否则如果 q 是“上”则 -- 转换为大写设置 uppered 执行 shell 脚本 "echo " & 引用形式的 ClipContent & " | tr '[:lower:]' '[:upper:]'" 将剪贴板设置为上部返回“转换为大写” 否则如果 q 是“slug”那么 -- 转换为 URL slug 设置 slugged 执行 shell 脚本 "echo " & 引用形式的 ClipContent & " | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd '[:alnum:]-'" 将剪贴板设置为 slugged return "转换为 slug: " & slugged 结束如果返回“未知命令：”&q 结束阿尔弗雷德脚本 ### 4\. Alfred 工作流程 - Python #!/usr/bin/env python3 # alfred-github-search.py # 关于我：从 Alfred 搜索 GitHub 存储库 # 关于我：Alfred 的 Python 脚本过滤器导入系统导入 json 导入 urllib.request 导入 urllib.parse 导入操作系统 def search_github（查询）： """搜索 GitHub 存储库""" 如果不是查询或 len(query) < 2: 返回[] token = os.environ.get("GITHUB_TOKEN", "") url = f"https://api.github.com/search/repositories?q={urllib.parse.quote(query)}&sort=stars&per_page=10" 标题= { "接受": "application/vnd.github.v3+json", “用户代理”：“Alfred-GitHub-Search”， } 如果令牌： headers["授权"] = f"令牌 {token}" 请求 = urllib.request.Request(url, headers=headers) 尝试：以 urllib.request.urlopen(request) 作为响应：数据 = json.loads(response.read().decode()) 返回 data.get("项目", []) 除了异常 e：返回[] def format_alfred_results(repos): """Alfred JSON 输出的格式结果""" 项目=[] 对于回购中的回购：项目.追加（{ “uid”：str（repo [“id”]）， “标题”：repo[“full_name”]， "subtitle": f"★ {repo['stargazers_count']} | {repo.get('描述', '无描述')}", “arg”：存储库[“html_url”]， “图标”：{ “路径”：“图标.png” }, “模组”：{ “命令”：{ “arg”：f“git克隆{repo ['clone_url']}”， "subtitle": "克隆存储库" }, “替代”：{ “arg”：repo[“clone_url”]， "subtitle": "复制克隆 URL" } } }) 返回{“项目”：项目} 如果 __name__ == "__main__": 查询 = sys.argv[1] if len(sys.argv) > 1 else "" 仓库 = search_github(查询) 结果 = format_alfred_results(repos) 打印（json.dumps（结果）） #!/usr/bin/env python3 # alfred-jira-search.py # 关于我：从 Alfred 搜索 JIRA 问题 # 关于我：JQL 支持的问题搜索导入系统导入 json 导入 urllib.request 导入 urllib.parse 导入base64 导入操作系统 JIRA_BASE_URL = os.environ.get("JIRA_URL", "https://your-company.atlassian.net") JIRA_EMAIL = os.environ.get("JIRA_EMAIL", "") JIRA_API_TOKEN = os.environ.get("JIRA_API_TOKEN", "") def search_jira(查询): """搜索 JIRA 问题""" 如果没有查询：返回[] # 构建 JQL 查询 jql = f'text ~ "{query}" ORDER BY 更新的 DESC' url = f"{JIRA_BASE_URL}/rest/api/3/search?jql={urllib.parse.quote(jql)}&maxResults=10" # 基本认证 auth = base64.b64encode(f"{JIRA_EMAIL}:{JIRA_API_TOKEN}".encode()).decode() 标题= { “接受”：“应用程序/json”， "授权": f"基本{auth}", } 请求 = urllib.request.Request(url, headers=headers) 尝试：以 urllib.request.urlopen(request) 作为响应：数据 = json.loads(response.read().decode()) return data.get("问题", []) 除了异常 e：返回[] def format_alfred_results（问题）： """Alfred 的格式 JIRA 问题""" 项目=[] 状态图标 = { “待办事项”：“⚪”， “进行中”：“🔵”， “完成”：“✅”， "已屏蔽": "🔴", } 对于问题中的问题：字段=问题[“字段”] status = fields.get("状态", {}).get("名称", "未知") 图标 = status_icons.get(status, "⚫") 项目.追加（{ “uid”：问题[“密钥”]， "title": f"{icon} {issue['key']}: {fields['summary']}", "subtitle": f"{status} | {fields.get('受让人', {}).get('displayName', '未分配')}", "arg": f"{JIRA_BASE_URL}/browse/{issue['key']}", "icon": {"path": "jira-icon.png"}, “模组”：{ “命令”：{ “arg”：问题[“key”]， "subtitle": "复制问题密钥" } } }) 返回{“项目”：项目} 如果 __name__ == "__main__": 查询 = sys.argv[1] if len(sys.argv) > 1 else "" 问题 = search_jira(查询) 结果 = format_alfred_results(问题) 打印（json.dumps（结果）） #!/usr/bin/env python3 # 阿尔弗雷德-snippet-manager.py # 关于：文本片段管理 # 关于我：存储和检索代码片段导入系统导入 json 导入操作系统导入哈希库从 pathlib 导入路径 SNIPPETS_DIR = Path.home() / ".alfred-snippets" SNIPPETS_DIR.mkdir(exist_ok=True) def load_snippets(): """加载所有片段""" 片段=[] 对于 SNIPPETS_DIR.glob("*.json") 中的文件：打开（文件）为 f：代码片段 = json.load(f) 片段[“文件”] = str(文件) 片段.追加（片段）返回已排序（片段，key=lambda x：x.get（“uses”，0），reverse=True） def save_snippet(名称、内容、标签=无): """保存新片段""" snippet_id = hashlib.md5(name.encode()).hexdigest()[:8] 片段={ “id”：snippet_id， “姓名”：姓名， “内容”：内容， “tags”：标签或[]， “使用”：0， } open(SNIPPETS_DIR / f"{snippet_id}.json", "w") 作为 f： json.dump（片段，f，缩进= 2）返回片段 defincrement_use（片段）： """增量使用计数器""" snippet["uses"] = snippet.get("uses", 0) + 1 将 open(snippet["file"], "w") 作为 f： json.dump({k: v for k, v in snippet.items() if k != "file"}, f, indent=2) def search_snippets(查询): """按名称或标签搜索片段""" 片段 = load_snippets() 如果没有查询：返回片段 query_lower = query.lower() 返回[ s for s 在片段中 if query_lower in s["name"].lower() 或 any(tag.lower() 中的 query_lower for tag in s.get("tags", [])) ] def format_alfred_results（片段）： """为 Alfred 格式化片段""" 项目=[] 对于片段中的片段：标签 = ", ".join(snippet.get("标签", [])) 预览 = 片段["内容"][:50] + "..." if len(片段["内容"]) > 50 else 片段["内容"] 项目.追加（{ “uid”：片段[“id”]， “标题”：片段[“名称”]， "subtitle": f"使用: {snippet.get('uses', 0)} | {tags} | {preview}", “arg”：片段[“内容”]， "icon": {"path": "snippet-icon.png"}, “文本”：{ “复制”：片段[“内容”]， “大类型”：片段[“内容”] }, “变量”：{ "snippet_file": snippet.get("文件", "") } }) 返回{“项目”：项目} 如果 __name__ == "__main__": 查询 = sys.argv[1] if len(sys.argv) > 1 else "" if query.startswith("保存:"): # 保存新片段：“save:name|content|tag1,tag2” 零件 = 查询[5:].split("|") 如果 len(部分) >= 2: 名称、内容 = 零件[0]、零件[1] 标签 = parts[2].split(",") if len(parts) > 2 else [] snippet = save_snippet(名称、内容、标签) print(json.dumps({"items": [{"title": f"已保存: {name}", "arg": ""}]})) 系统退出(0) 片段 = search_snippets(查询) 结果 = format_alfred_results(片段) 打印（json.dumps（结果）） ### 5\. Raycast 扩展 - API 集成 // src/api-tester.tsx // ABOUTME：API测试和调试工具 // ABOUTME：从 Raycast 发出 HTTP 请求导入{ 操作面板，行动，形式，显示吐司，吐司，剪贴板，细节，使用导航，来自“@raycast/api”；从“反应”导入{useState}；从“节点获取”导入获取；接口请求结果{ 状态：数量；状态文本：字符串；标题：记录<字符串，字符串>；主体：字符串；时间：数量； } 函数 ResultView({ 结果 }: { 结果: RequestResult }) { 常量降价=` # 响应 **状态：** ${result.status} ${result.statusText} **时间：** ${result.time}ms ## 标题 ``````json ${JSON.stringify(result.headers, null, 2)} `````` ## 身体 ``````json ${结果.body} `````` `; 返回（ <详细内容降价={降价} 行动={ <操作面板> } /> ）； } 导出默认函数 Command() { const [方法，setMethod] = useState("GET"); const [url, setUrl] = useState(""); const [headers, setHeaders] = useState(""); const [body, setBody] = useState(""); const [isLoading, setIsLoading] = useState(false); const { 推 } = useNavigation(); 异步函数 makeRequest() { 如果（！网址）{ showToast({ style: Toast.Style.Failure, title: "网址为必填项" }); 返回; } setIsLoading(true); const startTime = Date.now(); 尝试{ // 解析头部 const headerObj: Record<字符串, 字符串> = {}; 如果（标题）{ headers.split("\n").forEach((line) => { const [key, ...valueParts] = line.split(":"); if (key && valueParts.length) { headerObj[key.trim()] = valueParts.join(":").trim(); } }); } 常量选项：RequestInit = { 方法，标题： headerObj， }; if (body && ["POST", "PUT", "PATCH"].includes(method)) { 选项.body = 正文; if (!headerObj["内容类型"]) { headerObj["内容类型"] = "application/json"; } } const 响应 = 等待 fetch(url, 选项); const responseBody =等待response.text(); const endTime = Date.now(); // 提取响应头 const responseHeaders: Record<字符串, 字符串> = {}; response.headers.forEach((值, 键) => { 响应头[键] = 值； }); // 尝试格式化 JSON 让 formattedBody = responseBody; 尝试{ formattedBody = JSON.stringify(JSON.parse(responseBody), null, 2); } 抓住 { // 不是 JSON，保持原样 } 常量结果：RequestResult = { 状态：响应.状态，状态文本：响应.状态文本，标头：响应标头，正文：格式化正文，时间：结束时间 - 开始时间， }; 推(); } 捕获（错误）{ 显示吐司（{ 样式：Toast.Style.Failure， title: "请求失败", 消息：字符串（错误）， }); }最后{ setIsLoading(假); } } 返回（ <表格正在加载={正在加载} 行动={ <操作面板> } > <表单.文本字段 id=“网址” 标题=“网址” 占位符=“https://api.example.com/endpoint” 值={网址} onChange={setUrl} /> <表单.文本区域 id =“标题” 标题=“标题” placeholder =“内容类型：应用程序/json 授权：不记名令牌” 值={标题} onChange={setHeaders} /> {["POST", "PUT", "PATCH"].includes(方法) && ( <表单.文本区域 id=“正文” 标题=“正文” 占位符='{"键":"值"}' 值={正文} onChange={setBody} /> )} ）； } ### 6\.键盘快捷键和片段 // raycast-snippets.json // ABOUTME：文本扩展片段 // ABOUTME：常用代码模板和文本模式 { “片段”：[ { "name": "Python 主块", “关键字”：“pymain”， "text": "if __name__ == \"__main__\":\n main()" }, { "name": "TypeScript 异步函数", “关键字”：“tsasync”， "text": "异步函数 ${1:functionName}(${2:params}): Promise<${3:void}> {\n $0\n}" }, { "name": "反应组件", “关键字”：“rcomp”， "text": "从 'react' 导入 React;\n\n接口 ${1:Component}Props {\n $2\n}\n\n导出函数 ${1:Component}({ $3 }: ${1:Component}Props) {\n return (\n

\n $0\n

\n );\n}" }, { "name": "控制台日志", “关键字”：“木屐”， "text": "console.log('${1:label}:', ${2:value});" }, { "name": "尝试捕获", “关键字”：“trycatch”， "text": "try {\n $1\n} catch (error) {\n console.error('Error:', error);\n $0\n}" }, { "name": "ISO 日期", “关键字”：“dateiso”， “文本”：“{剪贴板|日期：iso}” }, { “名称”：“UUID”， “关键字”：“uuid”， “文本”：“{随机：uuid}” }, { "name": "电子邮件签名", “关键字”：“esig”， "text": "最诚挚的问候，\n{用户:名称}\n{用户:电子邮件}" } ] } -- 阿尔弗雷德-热键-actions.applescript -- 关于：全局热键操作 -- 关于我：常见任务的快速操作关于阿尔弗雷德脚本（q） -- q 包含要执行的操作如果 q 是“屏幕截图区域”那么执行 shell 脚本“screencapture -i ~/Desktop/screenshot-$(date +%Y%m%d-%H%M%S).png” 返回“屏幕截图已保存到桌面” 否则如果 q 是“切换暗模式”那么告诉应用程序“系统事件” 说出外观偏好将深色模式设置为非深色模式结束告诉结束告诉返回“切换暗模式” 否则如果 q 是“空垃圾”那么告诉应用程序“Finder” 清空垃圾箱结束告诉返回“垃圾箱已清空” 否则如果 q 是“显示隐藏”那么执行 shell 脚本“默认写入 com.apple.finder AppleShowAllFiles -bool true && Killall Finder” 返回“隐藏文件可见” 否则如果 q 是“隐藏-隐藏”那么执行 shell 脚本“默认写入 com.apple.finder AppleShowAllFiles -bool false && Killall Finder” 返回“隐藏文件隐藏” 否则如果 q 是“flush-dns”那么使用管理员权限执行 shell 脚本“sudo dscacheutil -flushcache && sudo Killall -HUP mDNSResponder” 返回“DNS 缓存已刷新” 否则如果 q 是“ip-address”那么设置 localIP 执行 shell 脚本“ipconfig getifaddr en0” 设置 publicIP 执行 shell 脚本“curl -s ifconfig.me” 将剪贴板设置为 publicIP return "Local: " & localIP & " | Public: " & publicIP & " (复制)" 结束如果返回“未知操作：”&q 结束阿尔弗雷德脚本 ## 集成示例 ### 项目切换器集成 // src/project-switcher.tsx // 关于：统一项目切换器 // ABOUTME：与多个项目源集成导入{ 操作面板，行动，列表，图标，本地存储，获取偏好值，来自“@raycast/api”；从“react”导入{ useState，useEffect }；从“child_process”导入{exec}；从“util”导入{promisify}；从“fs”导入 fs；从“路径”导入路径； const execAsync = promisify(exec); 界面首选项{ 项目目录：字符串； github启用：布尔值； gitlabEnabled：布尔值； } 接口项目{ 名称：字符串；路径：字符串；来源：“本地” | “github”| “亚特实验室”；网址？：字符串；最后访问？：数字； } 导出默认函数 Command() { const [projects, setProjects] = useState([]); const [isLoading, setIsLoading] = useState(true); const 首选项 = getPreferenceValues<首选项>(); 使用效果（（）=> { 加载所有项目（）； }, []); 异步函数 loadAllProjects() { const allProjects: 项目[] = []; // 加载本地项目 const dirs = preferences.projectDirs.split(",").map((d) => d.trim()); for (const dir of dirs) { const ExpandedDir = dir.replace("~", process.env.HOME || ""); if (fs.existsSync(expandedDir)) { const 条目 = fs.readdirSync(expandedDir, { withFileTypes: true }); for (const 条目条目) { if (entry.isDirectory() && !entry.name.startsWith(".")) { allProjects.push({ name: 条目.name, 路径：path.join（expandedDir，entry.name），来源：“本地”， }); } } } } // 加载访问时间 const accessJson = wait LocalStorage.getItem("project-access"); const accessTimes = accessJson ？ JSON.parse(accessJson) : {}; allProjects.forEach((p) => { p.lastAccessed = accessTimes[p.path] || 0; }); // 按最后访问的顺序排序 allProjects.sort((a, b) => (b.lastAccessed || 0) - (a.lastAccessed || 0)); 设置项目（所有项目）； setIsLoading(假); } 异步函数 openProject(project: Project, app: string) { 常量命令= 应用程序===“代码” ？ `代码“${project.path}”` ：应用===“终端” ？ `打开 -a 终端“${project.path}”` : `打开“${project.path}”`; 等待 execAsync(cmd); // 更新访问时间 const accessJson = wait LocalStorage.getItem("project-access"); const accessTimes = accessJson ？ JSON.parse(accessJson) : {}; accessTimes[project.path] = Date.now(); 等待 LocalStorage.setItem("项目访问", JSON.stringify(accessTimes)); } 常量源图标 = { 本地：图标.文件夹， github：图标.Globe， gitlab：图标.Globe， }; 返回（ {projects.map((项目) => ( <列表.项目 key={项目.路径} 标题={项目.名称} 副标题={项目.路径} 图标={sourceIcons[项目.source]} 配件={[ 项目.lastAccessed ？ { 文本：新日期(project.lastAccessed).toLocaleDateString() } ：{}， ]} 行动={ <操作面板> <动作 title="在 VS Code 中打开" 图标={图标.代码} onAction={() => openProject(项目, "代码")} /> <动作 title =“在终端中打开” 图标={图标.终端} onAction={() => openProject(项目, "终端")} /> <动作 title="在 Finder 中打开" 图标={图标.Finder} onAction={() => openProject(project, "finder")} /> } /> ))} ）； } ## 最佳实践 ### 1\. Raycast 扩展开发 // 使用正确的错误处理从“@raycast/api”导入 { showToast, Toast }；异步函数 safeFetch(url: string) { 尝试{ const 响应 = 等待 fetch(url); 如果（！response.ok）{ 抛出新错误(`HTTP ${response.status}`); } 返回response.json(); } 捕获（错误）{ 显示吐司（{ 样式：Toast.Style.Failure， title: "请求失败", 消息：字符串（错误）， }); 返回空值； } } // 使用LocalStorage进行持久化从“@raycast/api”导入{LocalStorage}；异步函数 saveData(key: string, data: any) { 等待 LocalStorage.setItem(key, JSON.stringify(data)); } 异步函数 loadData(key: string, defaultValue: T): Promise { const json = 等待 LocalStorage.getItem(key); 返回 json ? JSON.parse(json) : 默认值； } ### 2\. Alfred 工作流程最佳实践 # 始终为脚本过滤器输出有效的 JSON 导入 json 导入系统 def 输出项目（项目）： """输出 Alfred JSON 格式""" 打印（json.dumps（{“项目”：项目}）） def 输出错误（消息）： """作为 Alfred 项目输出错误""" 输出项（[{ "标题": "错误", “副标题”：消息， “图标”：{“路径”：“错误.png”} }]) # 优雅地处理键盘中断如果 __name__ == "__main__": 尝试：主要() 除了键盘中断：系统退出(0) 除了异常 e：输出错误（str（e））系统退出(1) ### 3\.性能优化 // 反跳搜索查询从“react”导入{useState，useCallback}；从“@raycast/utils”导入{ useDebouncedValue }；函数搜索命令() { const [查询，setQuery] = useState(""); const debouncedQuery = useDebouncedValue(查询, 300); // 使用 debouncedQuery 进行 API 调用 } // 缓存 API 响应 const 缓存 = new Map(); 常量 CACHE_TTL = 5 * 60 * 1000; // 5 分钟异步函数cachedFetch(url: string) { const 缓存=cache.get(url); if (cached && Date.now() - cached.timestamp < CACHE_TTL) { 返回缓存的数据； } const data = wait fetch(url).then((r) => r.json()); 缓存.set(url, { 数据, 时间戳: Date.now() }); 返回数据； } ## 故障排除 ### 常见问题 **问题：Raycast 扩展未加载** # 清除光线投射缓存 rm -rf ~/Library/Caches/com.raycast.macos # 重建扩展 cd 你的扩展名 npm 运行构建 # 检查是否有错误 npm 运行 lint **问题：Alfred 工作流程未执行** # 检查脚本权限 chmod +x 工作流脚本.sh # 手动测试脚本 ./workflow-script.sh“测试查询” # 检查 Alfred 调试日志 # Alfred 首选项 > 工作流程 > 单击工作流程 > 调试 **问题：AppleScript 权限** -- 授予可访问权限 -- 系统偏好设置 > 安全和隐私 > 隐私 > 辅助功能 -- 测试权限告诉应用程序“系统事件” 将 frontApp 设置为最前面为 true 的第一个应用程序进程的名称结束告诉 ### 调试命令 # 测试 Raycast 脚本命令 ./script.sh“测试参数” # 测试 Alfred Python 脚本 python3workflow.py“测试查询”|杰克 # 检查 Alfred 工作流程变量回显 $alfred_workflow_data # 监控 Raycast 日志日志流--谓词'子系统==“com.raycast.macos”' ## 版本历史版本 |日期 |变化 ---|---|--- 1.0.0 | 2026-01-17 |具有 Raycast 和 Alfred 模式的初始版本 ## 资源 * [Raycast 开发者文档]() * [Raycast API 参考]() * [Alfred 工作流程文档]() * [AppleScript 语言指南]() * [Raycast 商店]() * [阿尔弗雷德画廊]() ** ** _此技能为 macOS 启动器自动化提供生产就绪模式，从而实现键盘驱动的生产力和无缝工作流程集成。_

射线投射阿尔弗雷德

包含技能