raycast-alfred
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseRaycast & Alfred Skill
Raycast & Alfred 技能指南
Master macOS launcher automation with Raycast extensions and Alfred workflows. This skill covers TypeScript-based Raycast development, AppleScript/Python Alfred workflows, keyboard shortcuts, clipboard management, and productivity automation patterns.
掌握基于Raycast扩展和Alfred工作流的macOS启动器自动化技术。本技能涵盖基于TypeScript的Raycast开发、AppleScript/Python编写的Alfred工作流、键盘快捷键、剪贴板管理以及生产力自动化模式。
When to Use This Skill
适用场景
USE when:
适用情况:
- Building quick access tools for developer workflows
- Automating repetitive macOS tasks
- Creating custom search commands
- Building clipboard history managers
- Implementing text snippet expansion
- Creating project launchers and switchers
- Building API query tools
- Automating application control
- Creating custom keyboard shortcuts
- Building team productivity tools
- 为开发者工作流构建快速访问工具
- 自动化重复的macOS任务
- 创建自定义搜索命令
- 构建剪贴板历史管理器
- 实现文本片段扩展
- 创建项目启动器与切换器
- 构建API查询工具
- 自动化应用程序控制
- 创建自定义键盘快捷键
- 构建团队生产力工具
DON'T USE when:
不适用情况:
- Cross-platform automation needed (use shell scripts)
- Server-side automation (use cron/systemd)
- GUI testing automation (use Playwright/Selenium)
- Windows/Linux environments
- Heavy computation tasks (use proper CLI tools)
- 需要跨平台自动化(使用Shell脚本)
- 服务器端自动化(使用cron/systemd)
- GUI测试自动化(使用Playwright/Selenium)
- Windows/Linux环境
- 重型计算任务(使用专业CLI工具)
Prerequisites
前置条件
Raycast Setup
Raycast 配置
bash
undefinedbash
undefinedInstall Raycast
Install Raycast
brew install --cask raycast
brew install --cask raycast
Install Node.js (required for extension development)
Install Node.js (required for extension development)
brew install node
brew install node
Install Raycast CLI
Install Raycast CLI
npm install -g @raycast/api
npm install -g @raycast/api
Create new extension
Create new extension
npx create-raycast-extension --name my-extension
npx create-raycast-extension --name my-extension
Development mode
Development mode
cd my-extension
npm install
npm run dev
cd my-extension
npm install
npm run dev
Extension structure
Extension structure
my-extension/
my-extension/
├── package.json
├── package.json
├── tsconfig.json
├── tsconfig.json
├── src/
├── src/
│ ├── index.tsx # Main command
│ ├── index.tsx # Main command
│ └── other-command.tsx # Additional commands
│ └── other-command.tsx # Additional commands
└── assets/
└── assets/
└── icon.png # Extension icon
└── icon.png # Extension icon
undefinedundefinedAlfred Setup
Alfred 配置
bash
undefinedbash
undefinedInstall Alfred (Powerpack required for workflows)
Install Alfred (Powerpack required for workflows)
brew install --cask alfred
brew install --cask alfred
Alfred workflow locations
Alfred workflow locations
~/Library/Application Support/Alfred/Alfred.alfredpreferences/workflows/
~/Library/Application Support/Alfred/Alfred.alfredpreferences/workflows/
Create workflow via Alfred Preferences > Workflows > + > Blank Workflow
Create workflow via Alfred Preferences > Workflows > + > Blank Workflow
Workflow components:
Workflow components:
- Triggers: Keywords, hotkeys, file actions
- Triggers: Keywords, hotkeys, file actions
- Actions: Scripts, open URL, run NSAppleScript
- Actions: Scripts, open URL, run NSAppleScript
- Outputs: Notifications, copy to clipboard, play sound
- Outputs: Notifications, copy to clipboard, play sound
Script languages supported:
Script languages supported:
- bash, zsh
- bash, zsh
- Python (2 or 3)
- Python (2 or 3)
- AppleScript / JavaScript for Automation (JXA)
- AppleScript / JavaScript for Automation (JXA)
- Ruby, PHP, Perl
- Ruby, PHP, Perl
undefinedundefinedDevelopment Environment
开发环境
bash
undefinedbash
undefinedFor Raycast TypeScript development
For Raycast TypeScript development
npm install -g typescript @types/node
npm install -g typescript @types/node
For Alfred Python workflows
For Alfred Python workflows
pip install alfred-workflow # (legacy, but useful patterns)
pip install alfred-workflow # (legacy, but useful patterns)
AppleScript tools
AppleScript tools
brew install --cask script-debugger # Optional: AppleScript IDE
brew install --cask script-debugger # Optional: AppleScript IDE
Testing tools
Testing tools
brew install jq # JSON parsing
undefinedbrew install jq # JSON parsing
undefinedCore Capabilities
核心功能
1. Raycast Script Commands
1. Raycast 脚本命令
bash
#!/bin/bashbash
#!/bin/bashRequired parameters:
Required parameters:
@raycast.schemaVersion 1
@raycast.schemaVersion 1
@raycast.title Open Project
@raycast.title Open Project
@raycast.mode silent
@raycast.mode silent
Optional parameters:
Optional parameters:
@raycast.icon 📁
@raycast.icon 📁
@raycast.argument1 { "type": "text", "placeholder": "Project name", "optional": false }
@raycast.argument1 { "type": "text", "placeholder": "Project name", "optional": false }
@raycast.packageName Developer Tools
@raycast.packageName Developer Tools
Documentation:
Documentation:
@raycast.description Opens a project in VS Code
@raycast.description Opens a project in VS Code
@raycast.author Your Name
@raycast.author Your Name
@raycast.authorURL https://github.com/yourname
@raycast.authorURL https://github.com/yourname
PROJECT="$1"
PROJECT_DIR="$HOME/projects/$PROJECT"
if [ -d "$PROJECT_DIR" ]; then
code "$PROJECT_DIR"
echo "Opened $PROJECT"
else
echo "Project not found: $PROJECT"
exit 1
fi
```bash
#!/bin/bashPROJECT="$1"
PROJECT_DIR="$HOME/projects/$PROJECT"
if [ -d "$PROJECT_DIR" ]; then
code "$PROJECT_DIR"
echo "Opened $PROJECT"
else
echo "Project not found: $PROJECT"
exit 1
fi
```bash
#!/bin/bash@raycast.schemaVersion 1
@raycast.schemaVersion 1
@raycast.title Git Status
@raycast.title Git Status
@raycast.mode fullOutput
@raycast.mode fullOutput
@raycast.icon 🔀
@raycast.icon 🔀
@raycast.packageName Git
@raycast.packageName Git
@raycast.description Show git status for current directory
@raycast.description Show git status for current directory
@raycast.author workspace-hub
@raycast.author workspace-hub
cd "$(pwd)" || exit 1
if [ -d ".git" ]; then
echo "Branch: $(git branch --show-current)"
echo ""
echo "Status:"
git status --short
echo ""
echo "Recent commits:"
git log --oneline -5
else
echo "Not a git repository"
exit 1
fi
```python
#!/usr/bin/env python3cd "$(pwd)" || exit 1
if [ -d ".git" ]; then
echo "Branch: $(git branch --show-current)"
echo ""
echo "Status:"
git status --short
echo ""
echo "Recent commits:"
git log --oneline -5
else
echo "Not a git repository"
exit 1
fi
```python
#!/usr/bin/env python3Required parameters:
Required parameters:
@raycast.schemaVersion 1
@raycast.schemaVersion 1
@raycast.title UUID Generator
@raycast.title UUID Generator
@raycast.mode silent
@raycast.mode silent
Optional parameters:
Optional parameters:
@raycast.icon 🔑
@raycast.icon 🔑
@raycast.argument1 { "type": "dropdown", "placeholder": "Format", "data": [{"title": "Standard", "value": "standard"}, {"title": "No dashes", "value": "nodash"}, {"title": "Uppercase", "value": "upper"}] }
@raycast.argument1 { "type": "dropdown", "placeholder": "Format", "data": [{"title": "Standard", "value": "standard"}, {"title": "No dashes", "value": "nodash"}, {"title": "Uppercase", "value": "upper"}] }
@raycast.packageName Utilities
@raycast.packageName Utilities
import uuid
import subprocess
import sys
format_type = sys.argv[1] if len(sys.argv) > 1 else "standard"
new_uuid = str(uuid.uuid4())
if format_type == "nodash":
new_uuid = new_uuid.replace("-", "")
elif format_type == "upper":
new_uuid = new_uuid.upper()
import uuid
import subprocess
import sys
format_type = sys.argv[1] if len(sys.argv) > 1 else "standard"
new_uuid = str(uuid.uuid4())
if format_type == "nodash":
new_uuid = new_uuid.replace("-", "")
elif format_type == "upper":
new_uuid = new_uuid.upper()
Copy to clipboard
Copy to clipboard
subprocess.run(["pbcopy"], input=new_uuid.encode(), check=True)
print(f"Copied: {new_uuid}")
```bash
#!/bin/bashsubprocess.run(["pbcopy"], input=new_uuid.encode(), check=True)
print(f"Copied: {new_uuid}")
```bash
#!/bin/bash@raycast.schemaVersion 1
@raycast.schemaVersion 1
@raycast.title Kill Port
@raycast.title Kill Port
@raycast.mode compact
@raycast.mode compact
@raycast.icon 🔌
@raycast.icon 🔌
@raycast.argument1 { "type": "text", "placeholder": "Port number" }
@raycast.argument1 { "type": "text", "placeholder": "Port number" }
@raycast.packageName Developer Tools
@raycast.packageName Developer Tools
PORT="$1"
PORT="$1"
Find process on port
Find process on port
PID=$(lsof -ti:$PORT 2>/dev/null)
if [ -z "$PID" ]; then
echo "No process on port $PORT"
exit 0
fi
PID=$(lsof -ti:$PORT 2>/dev/null)
if [ -z "$PID" ]; then
echo "No process on port $PORT"
exit 0
fi
Kill the process
Kill the process
kill -9 $PID 2>/dev/null
if [ $? -eq 0 ]; then
echo "Killed process $PID on port $PORT"
else
echo "Failed to kill process on port $PORT"
exit 1
fi
undefinedkill -9 $PID 2>/dev/null
if [ $? -eq 0 ]; then
echo "Killed process $PID on port $PORT"
else
echo "Failed to kill process on port $PORT"
exit 1
fi
undefined2. Raycast TypeScript Extensions
2. Raycast TypeScript 扩展
tsx
// src/index.tsx
// ABOUTME: Raycast extension main command
// ABOUTME: Project launcher with favorites and recent
import {
ActionPanel,
Action,
List,
Icon,
LocalStorage,
showToast,
Toast,
getPreferenceValues,
} from "@raycast/api";
import { useState, useEffect } from "react";
import { exec } from "child_process";
import { promisify } from "util";
import fs from "fs";
import path from "path";
const execAsync = promisify(exec);
interface Preferences {
projectsDir: string;
editor: string;
}
interface Project {
name: string;
path: string;
lastOpened?: number;
isFavorite?: boolean;
}
export default function Command() {
const [projects, setProjects] = useState<Project[]>([]);
const [isLoading, setIsLoading] = useState(true);
const preferences = getPreferenceValues<Preferences>();
useEffect(() => {
loadProjects();
}, []);
async function loadProjects() {
try {
const projectsDir = preferences.projectsDir.replace("~", process.env.HOME || "");
const dirs = fs.readdirSync(projectsDir, { withFileTypes: true });
// Load favorites and recent from storage
const favoritesJson = await LocalStorage.getItem<string>("favorites");
const recentJson = await LocalStorage.getItem<string>("recent");
const favorites = favoritesJson ? JSON.parse(favoritesJson) : [];
const recent = recentJson ? JSON.parse(recentJson) : {};
const projectList: Project[] = dirs
.filter((dir) => dir.isDirectory() && !dir.name.startsWith("."))
.map((dir) => ({
name: dir.name,
path: path.join(projectsDir, dir.name),
lastOpened: recent[dir.name] || 0,
isFavorite: favorites.includes(dir.name),
}))
.sort((a, b) => {
// Favorites first, then by recent
if (a.isFavorite && !b.isFavorite) return -1;
if (!a.isFavorite && b.isFavorite) return 1;
return (b.lastOpened || 0) - (a.lastOpened || 0);
});
setProjects(projectList);
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Failed to load projects",
message: String(error),
});
} finally {
setIsLoading(false);
}
}
async function openProject(project: Project) {
try {
const editor = preferences.editor || "code";
await execAsync(`${editor} "${project.path}"`);
// Update recent
const recentJson = await LocalStorage.getItem<string>("recent");
const recent = recentJson ? JSON.parse(recentJson) : {};
recent[project.name] = Date.now();
await LocalStorage.setItem("recent", JSON.stringify(recent));
showToast({
style: Toast.Style.Success,
title: `Opened ${project.name}`,
});
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Failed to open project",
message: String(error),
});
}
}
async function toggleFavorite(project: Project) {
const favoritesJson = await LocalStorage.getItem<string>("favorites");
const favorites = favoritesJson ? JSON.parse(favoritesJson) : [];
if (project.isFavorite) {
const index = favorites.indexOf(project.name);
if (index > -1) favorites.splice(index, 1);
} else {
favorites.push(project.name);
}
await LocalStorage.setItem("favorites", JSON.stringify(favorites));
await loadProjects();
}
return (
<List isLoading={isLoading} searchBarPlaceholder="Search projects...">
{projects.map((project) => (
<List.Item
key={project.path}
title={project.name}
subtitle={project.path}
icon={project.isFavorite ? Icon.Star : Icon.Folder}
accessories={[
project.lastOpened
? { text: new Date(project.lastOpened).toLocaleDateString() }
: {},
]}
actions={
<ActionPanel>
<Action
title="Open in Editor"
icon={Icon.Code}
onAction={() => openProject(project)}
/>
<Action
title="Open in Finder"
icon={Icon.Finder}
shortcut={{ modifiers: ["cmd"], key: "o" }}
onAction={() => execAsync(`open "${project.path}"`)}
/>
<Action
title="Open in Terminal"
icon={Icon.Terminal}
shortcut={{ modifiers: ["cmd"], key: "t" }}
onAction={() => execAsync(`open -a Terminal "${project.path}"`)}
/>
<Action
title={project.isFavorite ? "Remove from Favorites" : "Add to Favorites"}
icon={project.isFavorite ? Icon.StarDisabled : Icon.Star}
shortcut={{ modifiers: ["cmd"], key: "f" }}
onAction={() => toggleFavorite(project)}
/>
<Action.CopyToClipboard
title="Copy Path"
content={project.path}
shortcut={{ modifiers: ["cmd", "shift"], key: "c" }}
/>
</ActionPanel>
}
/>
))}
</List>
);
}tsx
// src/search-github.tsx
// ABOUTME: GitHub repository search command
// ABOUTME: Search and open repositories
import {
ActionPanel,
Action,
List,
Icon,
showToast,
Toast,
getPreferenceValues,
} from "@raycast/api";
import { useState } from "react";
import fetch from "node-fetch";
interface Preferences {
githubToken: string;
}
interface Repository {
id: number;
full_name: string;
description: string | null;
html_url: string;
stargazers_count: number;
language: string | null;
updated_at: string;
}
export default function Command() {
const [results, setResults] = useState<Repository[]>([]);
const [isLoading, setIsLoading] = useState(false);
const preferences = getPreferenceValues<Preferences>();
async function searchRepositories(query: string) {
if (!query || query.length < 2) {
setResults([]);
return;
}
setIsLoading(true);
try {
const response = await fetch(
`https://api.github.com/search/repositories?q=${encodeURIComponent(query)}&sort=stars&per_page=20`,
{
headers: {
Authorization: `token ${preferences.githubToken}`,
Accept: "application/vnd.github.v3+json",
},
}
);
if (!response.ok) {
throw new Error(`GitHub API error: ${response.status}`);
}
const data = (await response.json()) as { items: Repository[] };
setResults(data.items || []);
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Search failed",
message: String(error),
});
} finally {
setIsLoading(false);
}
}
return (
<List
isLoading={isLoading}
searchBarPlaceholder="Search GitHub repositories..."
onSearchTextChange={searchRepositories}
throttle
>
{results.map((repo) => (
<List.Item
key={repo.id}
title={repo.full_name}
subtitle={repo.description || ""}
icon={Icon.Globe}
accessories={[
{ icon: Icon.Star, text: String(repo.stargazers_count) },
{ text: repo.language || "" },
]}
actions={
<ActionPanel>
<Action.OpenInBrowser url={repo.html_url} />
<Action.CopyToClipboard
title="Copy URL"
content={repo.html_url}
/>
<Action.CopyToClipboard
title="Copy Clone URL"
content={`git clone ${repo.html_url}.git`}
shortcut={{ modifiers: ["cmd", "shift"], key: "c" }}
/>
</ActionPanel>
}
/>
))}
</List>
);
}tsx
// src/clipboard-history.tsx
// ABOUTME: Custom clipboard history manager
// ABOUTME: Store and search clipboard items
import {
ActionPanel,
Action,
List,
Icon,
Clipboard,
LocalStorage,
showToast,
Toast,
} from "@raycast/api";
import { useState, useEffect } from "react";
interface ClipboardItem {
id: string;
content: string;
timestamp: number;
type: "text" | "url" | "code";
}
const MAX_ITEMS = 100;
export default function Command() {
const [items, setItems] = useState<ClipboardItem[]>([]);
const [isLoading, setIsLoading] = useState(true);
useEffect(() => {
loadHistory();
}, []);
async function loadHistory() {
try {
const historyJson = await LocalStorage.getItem<string>("clipboard-history");
const history = historyJson ? JSON.parse(historyJson) : [];
setItems(history);
} catch (error) {
console.error("Failed to load history:", error);
} finally {
setIsLoading(false);
}
}
async function pasteItem(item: ClipboardItem) {
await Clipboard.paste(item.content);
showToast({ style: Toast.Style.Success, title: "Pasted" });
}
async function deleteItem(item: ClipboardItem) {
const newItems = items.filter((i) => i.id !== item.id);
await LocalStorage.setItem("clipboard-history", JSON.stringify(newItems));
setItems(newItems);
}
async function clearHistory() {
await LocalStorage.setItem("clipboard-history", JSON.stringify([]));
setItems([]);
showToast({ style: Toast.Style.Success, title: "History cleared" });
}
function detectType(content: string): "text" | "url" | "code" {
if (content.match(/^https?:\/\//)) return "url";
if (content.includes("\n") && (content.includes("{") || content.includes("function")))
return "code";
return "text";
}
function getIcon(type: string) {
switch (type) {
case "url":
return Icon.Link;
case "code":
return Icon.Code;
default:
return Icon.Text;
}
}
function formatTimestamp(ts: number): string {
const now = Date.now();
const diff = now - ts;
if (diff < 60000) return "Just now";
if (diff < 3600000) return `${Math.floor(diff / 60000)}m ago`;
if (diff < 86400000) return `${Math.floor(diff / 3600000)}h ago`;
return new Date(ts).toLocaleDateString();
}
return (
<List isLoading={isLoading} searchBarPlaceholder="Search clipboard history...">
{items.map((item) => (
<List.Item
key={item.id}
title={item.content.slice(0, 100)}
subtitle={item.content.length > 100 ? "..." : ""}
icon={getIcon(item.type)}
accessories={[{ text: formatTimestamp(item.timestamp) }]}
actions={
<ActionPanel>
<Action
title="Paste"
icon={Icon.Clipboard}
onAction={() => pasteItem(item)}
/>
<Action.CopyToClipboard title="Copy" content={item.content} />
<Action
title="Delete"
icon={Icon.Trash}
style={Action.Style.Destructive}
shortcut={{ modifiers: ["cmd"], key: "d" }}
onAction={() => deleteItem(item)}
/>
<Action
title="Clear All"
icon={Icon.Trash}
style={Action.Style.Destructive}
shortcut={{ modifiers: ["cmd", "shift"], key: "d" }}
onAction={clearHistory}
/>
</ActionPanel>
}
/>
))}
</List>
);
}tsx
// src/index.tsx
// ABOUTME: Raycast extension main command
// ABOUTME: Project launcher with favorites and recent
import {
ActionPanel,
Action,
List,
Icon,
LocalStorage,
showToast,
Toast,
getPreferenceValues,
} from "@raycast/api";
import { useState, useEffect } from "react";
import { exec } from "child_process";
import { promisify } from "util";
import fs from "fs";
import path from "path";
const execAsync = promisify(exec);
interface Preferences {
projectsDir: string;
editor: string;
}
interface Project {
name: string;
path: string;
lastOpened?: number;
isFavorite?: boolean;
}
export default function Command() {
const [projects, setProjects] = useState<Project[]>([]);
const [isLoading, setIsLoading] = useState(true);
const preferences = getPreferenceValues<Preferences>();
useEffect(() => {
loadProjects();
}, []);
async function loadProjects() {
try {
const projectsDir = preferences.projectsDir.replace("~", process.env.HOME || "");
const dirs = fs.readdirSync(projectsDir, { withFileTypes: true });
// Load favorites and recent from storage
const favoritesJson = await LocalStorage.getItem<string>("favorites");
const recentJson = await LocalStorage.getItem<string>("recent");
const favorites = favoritesJson ? JSON.parse(favoritesJson) : [];
const recent = recentJson ? JSON.parse(recentJson) : {};
const projectList: Project[] = dirs
.filter((dir) => dir.isDirectory() && !dir.name.startsWith("."))
.map((dir) => ({
name: dir.name,
path: path.join(projectsDir, dir.name),
lastOpened: recent[dir.name] || 0,
isFavorite: favorites.includes(dir.name),
}))
.sort((a, b) => {
// Favorites first, then by recent
if (a.isFavorite && !b.isFavorite) return -1;
if (!a.isFavorite && b.isFavorite) return 1;
return (b.lastOpened || 0) - (a.lastOpened || 0);
});
setProjects(projectList);
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Failed to load projects",
message: String(error),
});
} finally {
setIsLoading(false);
}
}
async function openProject(project: Project) {
try {
const editor = preferences.editor || "code";
await execAsync(`${editor} "${project.path}"`);
// Update recent
const recentJson = await LocalStorage.getItem<string>("recent");
const recent = recentJson ? JSON.parse(recentJson) : {};
recent[project.name] = Date.now();
await LocalStorage.setItem("recent", JSON.stringify(recent));
showToast({
style: Toast.Style.Success,
title: `Opened ${project.name}`,
});
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Failed to open project",
message: String(error),
});
}
}
async function toggleFavorite(project: Project) {
const favoritesJson = await LocalStorage.getItem<string>("favorites");
const favorites = favoritesJson ? JSON.parse(favoritesJson) : [];
if (project.isFavorite) {
const index = favorites.indexOf(project.name);
if (index > -1) favorites.splice(index, 1);
} else {
favorites.push(project.name);
}
await LocalStorage.setItem("favorites", JSON.stringify(favorites));
await loadProjects();
}
return (
<List isLoading={isLoading} searchBarPlaceholder="Search projects...">
{projects.map((project) => (
<List.Item
key={project.path}
title={project.name}
subtitle={project.path}
icon={project.isFavorite ? Icon.Star : Icon.Folder}
accessories={[
project.lastOpened
? { text: new Date(project.lastOpened).toLocaleDateString() }
: {},
]}
actions={
<ActionPanel>
<Action
title="Open in Editor"
icon={Icon.Code}
onAction={() => openProject(project)}
/>
<Action
title="Open in Finder"
icon={Icon.Finder}
shortcut={{ modifiers: ["cmd"], key: "o" }}
onAction={() => execAsync(`open "${project.path}"`)}
/>
<Action
title="Open in Terminal"
icon={Icon.Terminal}
shortcut={{ modifiers: ["cmd"], key: "t" }}
onAction={() => execAsync(`open -a Terminal "${project.path}"`)}
/>
<Action
title={project.isFavorite ? "Remove from Favorites" : "Add to Favorites"}
icon={project.isFavorite ? Icon.StarDisabled : Icon.Star}
shortcut={{ modifiers: ["cmd"], key: "f" }}
onAction={() => toggleFavorite(project)}
/>
<Action.CopyToClipboard
title="Copy Path"
content={project.path}
shortcut={{ modifiers: ["cmd", "shift"], key: "c" }}
/>
</ActionPanel>
}
/>
))}
</List>
);
}tsx
// src/search-github.tsx
// ABOUTME: GitHub repository search command
// ABOUTME: Search and open repositories
import {
ActionPanel,
Action,
List,
Icon,
showToast,
Toast,
getPreferenceValues,
} from "@raycast/api";
import { useState } from "react";
import fetch from "node-fetch";
interface Preferences {
githubToken: string;
}
interface Repository {
id: number;
full_name: string;
description: string | null;
html_url: string;
stargazers_count: number;
language: string | null;
updated_at: string;
}
export default function Command() {
const [results, setResults] = useState<Repository[]>([]);
const [isLoading, setIsLoading] = useState(false);
const preferences = getPreferenceValues<Preferences>();
async function searchRepositories(query: string) {
if (!query || query.length < 2) {
setResults([]);
return;
}
setIsLoading(true);
try {
const response = await fetch(
`https://api.github.com/search/repositories?q=${encodeURIComponent(query)}&sort=stars&per_page=20`,
{
headers: {
Authorization: `token ${preferences.githubToken}`,
Accept: "application/vnd.github.v3+json",
},
}
);
if (!response.ok) {
throw new Error(`GitHub API error: ${response.status}`);
}
const data = (await response.json()) as { items: Repository[] };
setResults(data.items || []);
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Search failed",
message: String(error),
});
} finally {
setIsLoading(false);
}
}
return (
<List
isLoading={isLoading}
searchBarPlaceholder="Search GitHub repositories..."
onSearchTextChange={searchRepositories}
throttle
>
{results.map((repo) => (
<List.Item
key={repo.id}
title={repo.full_name}
subtitle={repo.description || ""}
icon={Icon.Globe}
accessories={[
{ icon: Icon.Star, text: String(repo.stargazers_count) },
{ text: repo.language || "" },
]}
actions={
<ActionPanel>
<Action.OpenInBrowser url={repo.html_url} />
<Action.CopyToClipboard
title="Copy URL"
content={repo.html_url}
/>
<Action.CopyToClipboard
title="Copy Clone URL"
content={`git clone ${repo.html_url}.git`}
shortcut={{ modifiers: ["cmd", "shift"], key: "c" }}
/>
</ActionPanel>
}
/>
))}
</List>
);
}tsx
// src/clipboard-history.tsx
// ABOUTME: Custom clipboard history manager
// ABOUTME: Store and search clipboard items
import {
ActionPanel,
Action,
List,
Icon,
Clipboard,
LocalStorage,
showToast,
Toast,
} from "@raycast/api";
import { useState, useEffect } from "react";
interface ClipboardItem {
id: string;
content: string;
timestamp: number;
type: "text" | "url" | "code";
}
const MAX_ITEMS = 100;
export default function Command() {
const [items, setItems] = useState<ClipboardItem[]>([]);
const [isLoading, setIsLoading] = useState(true);
useEffect(() => {
loadHistory();
}, []);
async function loadHistory() {
try {
const historyJson = await LocalStorage.getItem<string>("clipboard-history");
const history = historyJson ? JSON.parse(historyJson) : [];
setItems(history);
} catch (error) {
console.error("Failed to load history:", error);
} finally {
setIsLoading(false);
}
}
async function pasteItem(item: ClipboardItem) {
await Clipboard.paste(item.content);
showToast({ style: Toast.Style.Success, title: "Pasted" });
}
async function deleteItem(item: ClipboardItem) {
const newItems = items.filter((i) => i.id !== item.id);
await LocalStorage.setItem("clipboard-history", JSON.stringify(newItems));
setItems(newItems);
}
async function clearHistory() {
await LocalStorage.setItem("clipboard-history", JSON.stringify([]));
setItems([]);
showToast({ style: Toast.Style.Success, title: "History cleared" });
}
function detectType(content: string): "text" | "url" | "code" {
if (content.match(/^https?:\/\//)) return "url";
if (content.includes("\n") && (content.includes("{") || content.includes("function")))
return "code";
return "text";
}
function getIcon(type: string) {
switch (type) {
case "url":
return Icon.Link;
case "code":
return Icon.Code;
default:
return Icon.Text;
}
}
function formatTimestamp(ts: number): string {
const now = Date.now();
const diff = now - ts;
if (diff < 60000) return "Just now";
if (diff < 3600000) return `${Math.floor(diff / 60000)}m ago`;
if (diff < 86400000) return `${Math.floor(diff / 3600000)}h ago`;
return new Date(ts).toLocaleDateString();
}
return (
<List isLoading={isLoading} searchBarPlaceholder="Search clipboard history...">
{items.map((item) => (
<List.Item
key={item.id}
title={item.content.slice(0, 100)}
subtitle={item.content.length > 100 ? "..." : ""}
icon={getIcon(item.type)}
accessories={[{ text: formatTimestamp(item.timestamp) }]}
actions={
<ActionPanel>
<Action
title="Paste"
icon={Icon.Clipboard}
onAction={() => pasteItem(item)}
/>
<Action.CopyToClipboard title="Copy" content={item.content} />
<Action
title="Delete"
icon={Icon.Trash}
style={Action.Style.Destructive}
shortcut={{ modifiers: ["cmd"], key: "d" }}
onAction={() => deleteItem(item)}
/>
<Action
title="Clear All"
icon={Icon.Trash}
style={Action.Style.Destructive}
shortcut={{ modifiers: ["cmd", "shift"], key: "d" }}
onAction={clearHistory}
/>
</ActionPanel>
}
/>
))}
</List>
);
}3. Alfred Workflows - AppleScript
3. Alfred 工作流 - AppleScript
applescript
-- workflow-launcher.applescript
-- ABOUTME: Launch applications with Alfred
-- ABOUTME: AppleScript for application control
on alfred_script(q)
set appName to q
if appName is "" then
return "No application specified"
end if
try
tell application appName
activate
end tell
return "Launched " & appName
on error errMsg
return "Error: " & errMsg
end try
end alfred_scriptapplescript
-- window-manager.applescript
-- ABOUTME: Window positioning and management
-- ABOUTME: Move and resize windows with Alfred
on alfred_script(q)
-- Parse command: "left", "right", "top", "bottom", "maximize", "center"
set position to q
tell application "System Events"
set frontApp to name of first application process whose frontmost is true
end tell
tell application "Finder"
set screenBounds to bounds of window of desktop
set screenWidth to item 3 of screenBounds
set screenHeight to item 4 of screenBounds
end tell
-- Menu bar offset
set menuBarHeight to 25
tell application frontApp
if position is "left" then
set bounds of front window to {0, menuBarHeight, screenWidth / 2, screenHeight}
else if position is "right" then
set bounds of front window to {screenWidth / 2, menuBarHeight, screenWidth, screenHeight}
else if position is "top" then
set bounds of front window to {0, menuBarHeight, screenWidth, screenHeight / 2}
else if position is "bottom" then
set bounds of front window to {0, screenHeight / 2, screenWidth, screenHeight}
else if position is "maximize" then
set bounds of front window to {0, menuBarHeight, screenWidth, screenHeight}
else if position is "center" then
set winWidth to 1200
set winHeight to 800
set xPos to (screenWidth - winWidth) / 2
set yPos to ((screenHeight - winHeight) / 2) + menuBarHeight
set bounds of front window to {xPos, yPos, xPos + winWidth, yPos + winHeight}
end if
end tell
return "Moved " & frontApp & " to " & position
end alfred_scriptapplescript
-- clipboard-cleaner.applescript
-- ABOUTME: Clean and transform clipboard content
-- ABOUTME: Remove formatting, convert text
on alfred_script(q)
-- Get clipboard content
set clipContent to the clipboard
if q is "plain" then
-- Convert to plain text
set the clipboard to clipContent as text
return "Converted to plain text"
else if q is "trim" then
-- Trim whitespace
set trimmed to do shell script "echo " & quoted form of clipContent & " | xargs"
set the clipboard to trimmed
return "Trimmed whitespace"
else if q is "lower" then
-- Convert to lowercase
set lowered to do shell script "echo " & quoted form of clipContent & " | tr '[:upper:]' '[:lower:]'"
set the clipboard to lowered
return "Converted to lowercase"
else if q is "upper" then
-- Convert to uppercase
set uppered to do shell script "echo " & quoted form of clipContent & " | tr '[:lower:]' '[:upper:]'"
set the clipboard to uppered
return "Converted to uppercase"
else if q is "slug" then
-- Convert to URL slug
set slugged to do shell script "echo " & quoted form of clipContent & " | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd '[:alnum:]-'"
set the clipboard to slugged
return "Converted to slug: " & slugged
end if
return "Unknown command: " & q
end alfred_scriptapplescript
-- workflow-launcher.applescript
-- ABOUTME: Launch applications with Alfred
-- ABOUTME: AppleScript for application control
on alfred_script(q)
set appName to q
if appName is "" then
return "No application specified"
end if
try
tell application appName
activate
end tell
return "Launched " & appName
on error errMsg
return "Error: " & errMsg
end try
end alfred_scriptapplescript
-- window-manager.applescript
-- ABOUTME: Window positioning and management
-- ABOUTME: Move and resize windows with Alfred
on alfred_script(q)
-- Parse command: "left", "right", "top", "bottom", "maximize", "center"
set position to q
tell application "System Events"
set frontApp to name of first application process whose frontmost is true
end tell
tell application "Finder"
set screenBounds to bounds of window of desktop
set screenWidth to item 3 of screenBounds
set screenHeight to item 4 of screenBounds
end tell
-- Menu bar offset
set menuBarHeight to 25
tell application frontApp
if position is "left" then
set bounds of front window to {0, menuBarHeight, screenWidth / 2, screenHeight}
else if position is "right" then
set bounds of front window to {screenWidth / 2, menuBarHeight, screenWidth, screenHeight}
else if position is "top" then
set bounds of front window to {0, menuBarHeight, screenWidth, screenHeight / 2}
else if position is "bottom" then
set bounds of front window to {0, screenHeight / 2, screenWidth, screenHeight}
else if position is "maximize" then
set bounds of front window to {0, menuBarHeight, screenWidth, screenHeight}
else if position is "center" then
set winWidth to 1200
set winHeight to 800
set xPos to (screenWidth - winWidth) / 2
set yPos to ((screenHeight - winHeight) / 2) + menuBarHeight
set bounds of front window to {xPos, yPos, xPos + winWidth, yPos + winHeight}
end if
end tell
return "Moved " & frontApp & " to " & position
end alfred_scriptapplescript
-- clipboard-cleaner.applescript
-- ABOUTME: Clean and transform clipboard content
-- ABOUTME: Remove formatting, convert text
on alfred_script(q)
-- Get clipboard content
set clipContent to the clipboard
if q is "plain" then
-- Convert to plain text
set the clipboard to clipContent as text
return "Converted to plain text"
else if q is "trim" then
-- Trim whitespace
set trimmed to do shell script "echo " & quoted form of clipContent & " | xargs"
set the clipboard to trimmed
return "Trimmed whitespace"
else if q is "lower" then
-- Convert to lowercase
set lowered to do shell script "echo " & quoted form of clipContent & " | tr '[:upper:]' '[:lower:]'"
set the clipboard to lowered
return "Converted to lowercase"
else if q is "upper" then
-- Convert to uppercase
set uppered to do shell script "echo " & quoted form of clipContent & " | tr '[:lower:]' '[:upper:]'"
set the clipboard to uppered
return "Converted to uppercase"
else if q is "slug" then
-- Convert to URL slug
set slugged to do shell script "echo " & quoted form of clipContent & " | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd '[:alnum:]-'"
set the clipboard to slugged
return "Converted to slug: " & slugged
end if
return "Unknown command: " & q
end alfred_script4. Alfred Workflows - Python
4. Alfred 工作流 - Python
python
#!/usr/bin/env python3python
#!/usr/bin/env python3alfred-github-search.py
alfred-github-search.py
ABOUTME: Search GitHub repositories from Alfred
ABOUTME: Search GitHub repositories from Alfred
ABOUTME: Python script filter for Alfred
ABOUTME: Python script filter for Alfred
import sys
import json
import urllib.request
import urllib.parse
import os
def search_github(query):
"""Search GitHub repositories"""
if not query or len(query) < 2:
return []
token = os.environ.get("GITHUB_TOKEN", "")
url = f"https://api.github.com/search/repositories?q={urllib.parse.quote(query)}&sort=stars&per_page=10"
headers = {
"Accept": "application/vnd.github.v3+json",
"User-Agent": "Alfred-GitHub-Search",
}
if token:
headers["Authorization"] = f"token {token}"
request = urllib.request.Request(url, headers=headers)
try:
with urllib.request.urlopen(request) as response:
data = json.loads(response.read().decode())
return data.get("items", [])
except Exception as e:
return []def format_alfred_results(repos):
"""Format results for Alfred JSON output"""
items = []
for repo in repos:
items.append({
"uid": str(repo["id"]),
"title": repo["full_name"],
"subtitle": f"★ {repo['stargazers_count']} | {repo.get('description', 'No description')}",
"arg": repo["html_url"],
"icon": {
"path": "icon.png"
},
"mods": {
"cmd": {
"arg": f"git clone {repo['clone_url']}",
"subtitle": "Clone repository"
},
"alt": {
"arg": repo["clone_url"],
"subtitle": "Copy clone URL"
}
}
})
return {"items": items}if name == "main":
query = sys.argv[1] if len(sys.argv) > 1 else ""
repos = search_github(query)
result = format_alfred_results(repos)
print(json.dumps(result))
```python
#!/usr/bin/env python3import sys
import json
import urllib.request
import urllib.parse
import os
def search_github(query):
"""Search GitHub repositories"""
if not query or len(query) < 2:
return []
token = os.environ.get("GITHUB_TOKEN", "")
url = f"https://api.github.com/search/repositories?q={urllib.parse.quote(query)}&sort=stars&per_page=10"
headers = {
"Accept": "application/vnd.github.v3+json",
"User-Agent": "Alfred-GitHub-Search",
}
if token:
headers["Authorization"] = f"token {token}"
request = urllib.request.Request(url, headers=headers)
try:
with urllib.request.urlopen(request) as response:
data = json.loads(response.read().decode())
return data.get("items", [])
except Exception as e:
return []def format_alfred_results(repos):
"""Format results for Alfred JSON output"""
items = []
for repo in repos:
items.append({
"uid": str(repo["id"]),
"title": repo["full_name"],
"subtitle": f"★ {repo['stargazers_count']} | {repo.get('description', 'No description')}",
"arg": repo["html_url"],
"icon": {
"path": "icon.png"
},
"mods": {
"cmd": {
"arg": f"git clone {repo['clone_url']}",
"subtitle": "Clone repository"
},
"alt": {
"arg": repo["clone_url"],
"subtitle": "Copy clone URL"
}
}
})
return {"items": items}if name == "main":
query = sys.argv[1] if len(sys.argv) > 1 else ""
repos = search_github(query)
result = format_alfred_results(repos)
print(json.dumps(result))
```python
#!/usr/bin/env python3alfred-jira-search.py
alfred-jira-search.py
ABOUTME: Search JIRA issues from Alfred
ABOUTME: Search JIRA issues from Alfred
ABOUTME: JQL-powered issue search
ABOUTME: JQL-powered issue search
import sys
import json
import urllib.request
import urllib.parse
import base64
import os
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(query):
"""Search JIRA issues"""
if not query:
return []
# Build JQL query
jql = f'text ~ "{query}" ORDER BY updated DESC'
url = f"{JIRA_BASE_URL}/rest/api/3/search?jql={urllib.parse.quote(jql)}&maxResults=10"
# Basic auth
auth = base64.b64encode(f"{JIRA_EMAIL}:{JIRA_API_TOKEN}".encode()).decode()
headers = {
"Accept": "application/json",
"Authorization": f"Basic {auth}",
}
request = urllib.request.Request(url, headers=headers)
try:
with urllib.request.urlopen(request) as response:
data = json.loads(response.read().decode())
return data.get("issues", [])
except Exception as e:
return []def format_alfred_results(issues):
"""Format JIRA issues for Alfred"""
items = []
status_icons = {
"To Do": "⚪",
"In Progress": "🔵",
"Done": "✅",
"Blocked": "🔴",
}
for issue in issues:
fields = issue["fields"]
status = fields.get("status", {}).get("name", "Unknown")
icon = status_icons.get(status, "⚫")
items.append({
"uid": issue["key"],
"title": f"{icon} {issue['key']}: {fields['summary']}",
"subtitle": f"{status} | {fields.get('assignee', {}).get('displayName', 'Unassigned')}",
"arg": f"{JIRA_BASE_URL}/browse/{issue['key']}",
"icon": {"path": "jira-icon.png"},
"mods": {
"cmd": {
"arg": issue["key"],
"subtitle": "Copy issue key"
}
}
})
return {"items": items}if name == "main":
query = sys.argv[1] if len(sys.argv) > 1 else ""
issues = search_jira(query)
result = format_alfred_results(issues)
print(json.dumps(result))
```python
#!/usr/bin/env python3import sys
import json
import urllib.request
import urllib.parse
import base64
import os
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(query):
"""Search JIRA issues"""
if not query:
return []
# Build JQL query
jql = f'text ~ "{query}" ORDER BY updated DESC'
url = f"{JIRA_BASE_URL}/rest/api/3/search?jql={urllib.parse.quote(jql)}&maxResults=10"
# Basic auth
auth = base64.b64encode(f"{JIRA_EMAIL}:{JIRA_API_TOKEN}".encode()).decode()
headers = {
"Accept": "application/json",
"Authorization": f"Basic {auth}",
}
request = urllib.request.Request(url, headers=headers)
try:
with urllib.request.urlopen(request) as response:
data = json.loads(response.read().decode())
return data.get("issues", [])
except Exception as e:
return []def format_alfred_results(issues):
"""Format JIRA issues for Alfred"""
items = []
status_icons = {
"To Do": "⚪",
"In Progress": "🔵",
"Done": "✅",
"Blocked": "🔴",
}
for issue in issues:
fields = issue["fields"]
status = fields.get("status", {}).get("name", "Unknown")
icon = status_icons.get(status, "⚫")
items.append({
"uid": issue["key"],
"title": f"{icon} {issue['key']}: {fields['summary']}",
"subtitle": f"{status} | {fields.get('assignee', {}).get('displayName', 'Unassigned')}",
"arg": f"{JIRA_BASE_URL}/browse/{issue['key']}",
"icon": {"path": "jira-icon.png"},
"mods": {
"cmd": {
"arg": issue["key"],
"subtitle": "Copy issue key"
}
}
})
return {"items": items}if name == "main":
query = sys.argv[1] if len(sys.argv) > 1 else ""
issues = search_jira(query)
result = format_alfred_results(issues)
print(json.dumps(result))
```python
#!/usr/bin/env python3alfred-snippet-manager.py
alfred-snippet-manager.py
ABOUTME: Text snippet management
ABOUTME: Text snippet management
ABOUTME: Store and retrieve code snippets
ABOUTME: Store and retrieve code snippets
import sys
import json
import os
import hashlib
from pathlib import Path
SNIPPETS_DIR = Path.home() / ".alfred-snippets"
SNIPPETS_DIR.mkdir(exist_ok=True)
def load_snippets():
"""Load all snippets"""
snippets = []
for file in SNIPPETS_DIR.glob("*.json"):
with open(file) as f:
snippet = json.load(f)
snippet["file"] = str(file)
snippets.append(snippet)
return sorted(snippets, key=lambda x: x.get("uses", 0), reverse=True)
def save_snippet(name, content, tags=None):
"""Save a new snippet"""
snippet_id = hashlib.md5(name.encode()).hexdigest()[:8]
snippet = {
"id": snippet_id,
"name": name,
"content": content,
"tags": tags or [],
"uses": 0,
}
with open(SNIPPETS_DIR / f"{snippet_id}.json", "w") as f:
json.dump(snippet, f, indent=2)
return snippet
def increment_use(snippet):
"""Increment usage counter"""
snippet["uses"] = snippet.get("uses", 0) + 1
with open(snippet["file"], "w") as f:
json.dump({k: v for k, v in snippet.items() if k != "file"}, f, indent=2)
def search_snippets(query):
"""Search snippets by name or tags"""
snippets = load_snippets()
if not query:
return snippets
query_lower = query.lower()
return [
s for s in snippets
if query_lower in s["name"].lower()
or any(query_lower in tag.lower() for tag in s.get("tags", []))
]def format_alfred_results(snippets):
"""Format snippets for Alfred"""
items = []
for snippet in snippets:
tags = ", ".join(snippet.get("tags", []))
preview = snippet["content"][:50] + "..." if len(snippet["content"]) > 50 else snippet["content"]
items.append({
"uid": snippet["id"],
"title": snippet["name"],
"subtitle": f"Uses: {snippet.get('uses', 0)} | {tags} | {preview}",
"arg": snippet["content"],
"icon": {"path": "snippet-icon.png"},
"text": {
"copy": snippet["content"],
"largetype": snippet["content"]
},
"variables": {
"snippet_file": snippet.get("file", "")
}
})
return {"items": items}if name == "main":
query = sys.argv[1] if len(sys.argv) > 1 else ""
if query.startswith("save:"):
# Save new snippet: "save:name|content|tag1,tag2"
parts = query[5:].split("|")
if len(parts) >= 2:
name, content = parts[0], parts[1]
tags = parts[2].split(",") if len(parts) > 2 else []
snippet = save_snippet(name, content, tags)
print(json.dumps({"items": [{"title": f"Saved: {name}", "arg": ""}]}))
sys.exit(0)
snippets = search_snippets(query)
result = format_alfred_results(snippets)
print(json.dumps(result))undefinedimport sys
import json
import os
import hashlib
from pathlib import Path
SNIPPETS_DIR = Path.home() / ".alfred-snippets"
SNIPPETS_DIR.mkdir(exist_ok=True)
def load_snippets():
"""Load all snippets"""
snippets = []
for file in SNIPPETS_DIR.glob("*.json"):
with open(file) as f:
snippet = json.load(f)
snippet["file"] = str(file)
snippets.append(snippet)
return sorted(snippets, key=lambda x: x.get("uses", 0), reverse=True)
def save_snippet(name, content, tags=None):
"""Save a new snippet"""
snippet_id = hashlib.md5(name.encode()).hexdigest()[:8]
snippet = {
"id": snippet_id,
"name": name,
"content": content,
"tags": tags or [],
"uses": 0,
}
with open(SNIPPETS_DIR / f"{snippet_id}.json", "w") as f:
json.dump(snippet, f, indent=2)
return snippet
def increment_use(snippet):
"""Increment usage counter"""
snippet["uses"] = snippet.get("uses", 0) + 1
with open(snippet["file"], "w") as f:
json.dump({k: v for k, v in snippet.items() if k != "file"}, f, indent=2)
def search_snippets(query):
"""Search snippets by name or tags"""
snippets = load_snippets()
if not query:
return snippets
query_lower = query.lower()
return [
s for s in snippets
if query_lower in s["name"].lower()
or any(query_lower in tag.lower() for tag in s.get("tags", []))
]def format_alfred_results(snippets):
"""Format snippets for Alfred"""
items = []
for snippet in snippets:
tags = ", ".join(snippet.get("tags", []))
preview = snippet["content"][:50] + "..." if len(snippet["content"]) > 50 else snippet["content"]
items.append({
"uid": snippet["id"],
"title": snippet["name"],
"subtitle": f"Uses: {snippet.get('uses', 0)} | {tags} | {preview}",
"arg": snippet["content"],
"icon": {"path": "snippet-icon.png"},
"text": {
"copy": snippet["content"],
"largetype": snippet["content"]
},
"variables": {
"snippet_file": snippet.get("file", "")
}
})
return {"items": items}if name == "main":
query = sys.argv[1] if len(sys.argv) > 1 else ""
if query.startswith("save:"):
# Save new snippet: "save:name|content|tag1,tag2"
parts = query[5:].split("|")
if len(parts) >= 2:
name, content = parts[0], parts[1]
tags = parts[2].split(",") if len(parts) > 2 else []
snippet = save_snippet(name, content, tags)
print(json.dumps({"items": [{"title": f"Saved: {name}", "arg": ""}]}))
sys.exit(0)
snippets = search_snippets(query)
result = format_alfred_results(snippets)
print(json.dumps(result))undefined5. Raycast Extension - API Integration
5. Raycast 扩展 - API 集成
tsx
// src/api-tester.tsx
// ABOUTME: API testing and debugging tool
// ABOUTME: Make HTTP requests from Raycast
import {
ActionPanel,
Action,
Form,
showToast,
Toast,
Clipboard,
Detail,
useNavigation,
} from "@raycast/api";
import { useState } from "react";
import fetch from "node-fetch";
interface RequestResult {
status: number;
statusText: string;
headers: Record<string, string>;
body: string;
time: number;
}
function ResultView({ result }: { result: RequestResult }) {
const markdown = `tsx
// src/api-tester.tsx
// ABOUTME: API testing and debugging tool
// ABOUTME: Make HTTP requests from Raycast
import {
ActionPanel,
Action,
Form,
showToast,
Toast,
Clipboard,
Detail,
useNavigation,
} from "@raycast/api";
import { useState } from "react";
import fetch from "node-fetch";
interface RequestResult {
status: number;
statusText: string;
headers: Record<string, string>;
body: string;
time: number;
}
function ResultView({ result }: { result: RequestResult }) {
const markdown = `Response
Response
Status: ${result.status} ${result.statusText}
Time: ${result.time}ms
Status: ${result.status} ${result.statusText}
Time: ${result.time}ms
Headers
Headers
```json
${JSON.stringify(result.headers, null, 2)}
```
```json
${JSON.stringify(result.headers, null, 2)}\n```
Body
Body
```json
${result.body}
```
`;
return (
<Detail
markdown={markdown}
actions={
<ActionPanel>
<Action.CopyToClipboard title="Copy Response Body" content={result.body} />
<Action.CopyToClipboard
title="Copy Headers"
content={JSON.stringify(result.headers, null, 2)}
/>
</ActionPanel>
}
/>
);
}
export default function Command() {
const [method, setMethod] = useState("GET");
const [url, setUrl] = useState("");
const [headers, setHeaders] = useState("");
const [body, setBody] = useState("");
const [isLoading, setIsLoading] = useState(false);
const { push } = useNavigation();
async function makeRequest() {
if (!url) {
showToast({ style: Toast.Style.Failure, title: "URL is required" });
return;
}
setIsLoading(true);
const startTime = Date.now();
try {
// Parse headers
const headerObj: Record<string, string> = {};
if (headers) {
headers.split("\n").forEach((line) => {
const [key, ...valueParts] = line.split(":");
if (key && valueParts.length) {
headerObj[key.trim()] = valueParts.join(":").trim();
}
});
}
const options: RequestInit = {
method,
headers: headerObj,
};
if (body && ["POST", "PUT", "PATCH"].includes(method)) {
options.body = body;
if (!headerObj["Content-Type"]) {
headerObj["Content-Type"] = "application/json";
}
}
const response = await fetch(url, options);
const responseBody = await response.text();
const endTime = Date.now();
// Extract response headers
const responseHeaders: Record<string, string> = {};
response.headers.forEach((value, key) => {
responseHeaders[key] = value;
});
// Try to format JSON
let formattedBody = responseBody;
try {
formattedBody = JSON.stringify(JSON.parse(responseBody), null, 2);
} catch {
// Not JSON, keep as-is
}
const result: RequestResult = {
status: response.status,
statusText: response.statusText,
headers: responseHeaders,
body: formattedBody,
time: endTime - startTime,
};
push(<ResultView result={result} />);
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Request failed",
message: String(error),
});
} finally {
setIsLoading(false);
}}
return (
<Form
isLoading={isLoading}
actions={
<ActionPanel>
<Action.SubmitForm title="Send Request" onSubmit={makeRequest} />
</ActionPanel>
}
>
<Form.Dropdown id="method" title="Method" value={method} onChange={setMethod}>
<Form.Dropdown.Item value="GET" title="GET" />
<Form.Dropdown.Item value="POST" title="POST" />
<Form.Dropdown.Item value="PUT" title="PUT" />
<Form.Dropdown.Item value="PATCH" title="PATCH" />
<Form.Dropdown.Item value="DELETE" title="DELETE" />
</Form.Dropdown>
<Form.TextField
id="url"
title="URL"
placeholder="https://api.example.com/endpoint"
value={url}
onChange={setUrl}
/>
<Form.TextArea
id="headers"
title="Headers"
placeholder="Content-Type: application/jsonAuthorization: Bearer token"
value={headers}
onChange={setHeaders}
/>
{["POST", "PUT", "PATCH"].includes(method) && (
<Form.TextArea
id="body"
title="Body"
placeholder='{"key": "value"}'
value={body}
onChange={setBody}
/>
)}
</Form>);
}
undefined```json
${result.body}
```
`;
return (
<Detail
markdown={markdown}
actions={
<ActionPanel>
<Action.CopyToClipboard title="Copy Response Body" content={result.body} />
<Action.CopyToClipboard
title="Copy Headers"
content={JSON.stringify(result.headers, null, 2)}
/>
</ActionPanel>
}
/>
);
}
export default function Command() {
const [method, setMethod] = useState("GET");
const [url, setUrl] = useState("");
const [headers, setHeaders] = useState("");
const [body, setBody] = useState("");
const [isLoading, setIsLoading] = useState(false);
const { push } = useNavigation();
async function makeRequest() {
if (!url) {
showToast({ style: Toast.Style.Failure, title: "URL is required" });
return;
}
setIsLoading(true);
const startTime = Date.now();
try {
// Parse headers
const headerObj: Record<string, string> = {};
if (headers) {
headers.split("\n").forEach((line) => {
const [key, ...valueParts] = line.split(":");
if (key && valueParts.length) {
headerObj[key.trim()] = valueParts.join(":").trim();
}
});
}
const options: RequestInit = {
method,
headers: headerObj,
};
if (body && ["POST", "PUT", "PATCH"].includes(method)) {
options.body = body;
if (!headerObj["Content-Type"]) {
headerObj["Content-Type"] = "application/json";
}
}
const response = await fetch(url, options);
const responseBody = await response.text();
const endTime = Date.now();
// Extract response headers
const responseHeaders: Record<string, string> = {};
response.headers.forEach((value, key) => {
responseHeaders[key] = value;
});
// Try to format JSON
let formattedBody = responseBody;
try {
formattedBody = JSON.stringify(JSON.parse(responseBody), null, 2);
} catch {
// Not JSON, keep as-is
}
const result: RequestResult = {
status: response.status,
statusText: response.statusText,
headers: responseHeaders,
body: formattedBody,
time: endTime - startTime,
};
push(<ResultView result={result} />);
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Request failed",
message: String(error),
});
} finally {
setIsLoading(false);
}}
return (
<Form
isLoading={isLoading}
actions={
<ActionPanel>
<Action.SubmitForm title="Send Request" onSubmit={makeRequest} />
</ActionPanel>
}
>
<Form.Dropdown id="method" title="Method" value={method} onChange={setMethod}>
<Form.Dropdown.Item value="GET" title="GET" />
<Form.Dropdown.Item value="POST" title="POST" />
<Form.Dropdown.Item value="PUT" title="PUT" />
<Form.Dropdown.Item value="PATCH" title="PATCH" />
<Form.Dropdown.Item value="DELETE" title="DELETE" />
</Form.Dropdown>
<Form.TextField
id="url"
title="URL"
placeholder="https://api.example.com/endpoint"
value={url}
onChange={setUrl}
/>
<Form.TextArea
id="headers"
title="Headers"
placeholder="Content-Type: application/jsonAuthorization: Bearer token"
value={headers}
onChange={setHeaders}
/>
{["POST", "PUT", "PATCH"].includes(method) && (
<Form.TextArea
id="body"
title="Body"
placeholder='{"key": "value"}'
value={body}
onChange={setBody}
/>
)}
</Form>);
}
undefined6. Keyboard Shortcuts and Snippets
6. 键盘快捷键与代码片段
json
// raycast-snippets.json
// ABOUTME: Text expansion snippets
// ABOUTME: Common code templates and text patterns
{
"snippets": [
{
"name": "Python main block",
"keyword": "pymain",
"text": "if __name__ == \"__main__\":\n main()"
},
{
"name": "TypeScript async function",
"keyword": "tsasync",
"text": "async function ${1:functionName}(${2:params}): Promise<${3:void}> {\n $0\n}"
},
{
"name": "React component",
"keyword": "rcomp",
"text": "import React from 'react';\n\ninterface ${1:Component}Props {\n $2\n}\n\nexport function ${1:Component}({ $3 }: ${1:Component}Props) {\n return (\n <div>\n $0\n </div>\n );\n}"
},
{
"name": "Console log",
"keyword": "clog",
"text": "console.log('${1:label}:', ${2:value});"
},
{
"name": "Try catch",
"keyword": "trycatch",
"text": "try {\n $1\n} catch (error) {\n console.error('Error:', error);\n $0\n}"
},
{
"name": "Date ISO",
"keyword": "dateiso",
"text": "{clipboard | date:iso}"
},
{
"name": "UUID",
"keyword": "uuid",
"text": "{random:uuid}"
},
{
"name": "Email signature",
"keyword": "esig",
"text": "Best regards,\n{user:name}\n{user:email}"
}
]
}applescript
-- alfred-hotkey-actions.applescript
-- ABOUTME: Global hotkey actions
-- ABOUTME: Quick actions for common tasks
on alfred_script(q)
-- q contains the action to perform
if q is "screenshot-region" then
do shell script "screencapture -i ~/Desktop/screenshot-$(date +%Y%m%d-%H%M%S).png"
return "Screenshot saved to Desktop"
else if q is "toggle-dark-mode" then
tell application "System Events"
tell appearance preferences
set dark mode to not dark mode
end tell
end tell
return "Toggled dark mode"
else if q is "empty-trash" then
tell application "Finder"
empty trash
end tell
return "Trash emptied"
else if q is "show-hidden" then
do shell script "defaults write com.apple.finder AppleShowAllFiles -bool true && killall Finder"
return "Hidden files visible"
else if q is "hide-hidden" then
do shell script "defaults write com.apple.finder AppleShowAllFiles -bool false && killall Finder"
return "Hidden files hidden"
else if q is "flush-dns" then
do shell script "sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder" with administrator privileges
return "DNS cache flushed"
else if q is "ip-address" then
set localIP to do shell script "ipconfig getifaddr en0"
set publicIP to do shell script "curl -s ifconfig.me"
set the clipboard to publicIP
return "Local: " & localIP & " | Public: " & publicIP & " (copied)"
end if
return "Unknown action: " & q
end alfred_scriptjson
// raycast-snippets.json
// ABOUTME: Text expansion snippets
// ABOUTME: Common code templates and text patterns
{
"snippets": [
{
"name": "Python main block",
"keyword": "pymain",
"text": "if __name__ == \"__main__\":\n main()"
},
{
"name": "TypeScript async function",
"keyword": "tsasync",
"text": "async function ${1:functionName}(${2:params}): Promise<${3:void}> {\n $0\n}"
},
{
"name": "React component",
"keyword": "rcomp",
"text": "import React from 'react';\n\ninterface ${1:Component}Props {\n $2\n}\n\nexport function ${1:Component}({ $3 }: ${1:Component}Props) {\n return (\n <div>\n $0\n </div>\n );\n}"
},
{
"name": "Console log",
"keyword": "clog",
"text": "console.log('${1:label}:', ${2:value});"
},
{
"name": "Try catch",
"keyword": "trycatch",
"text": "try {\n $1\n} catch (error) {\n console.error('Error:', error);\n $0\n}"
},
{
"name": "Date ISO",
"keyword": "dateiso",
"text": "{clipboard | date:iso}"
},
{
"name": "UUID",
"keyword": "uuid",
"text": "{random:uuid}"
},
{
"name": "Email signature",
"keyword": "esig",
"text": "Best regards,\n{user:name}\n{user:email}"
}
]
}applescript
-- alfred-hotkey-actions.applescript
-- ABOUTME: Global hotkey actions
-- ABOUTME: Quick actions for common tasks
on alfred_script(q)
-- q contains the action to perform
if q is "screenshot-region" then
do shell script "screencapture -i ~/Desktop/screenshot-$(date +%Y%m%d-%H%M%S).png"
return "Screenshot saved to Desktop"
else if q is "toggle-dark-mode" then
tell application "System Events"
tell appearance preferences
set dark mode to not dark mode
end tell
end tell
return "Toggled dark mode"
else if q is "empty-trash" then
tell application "Finder"
empty trash
end tell
return "Trash emptied"
else if q is "show-hidden" then
do shell script "defaults write com.apple.finder AppleShowAllFiles -bool true && killall Finder"
return "Hidden files visible"
else if q is "hide-hidden" then
do shell script "defaults write com.apple.finder AppleShowAllFiles -bool false && killall Finder"
return "Hidden files hidden"
else if q is "flush-dns" then
do shell script "sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder" with administrator privileges
return "DNS cache flushed"
else if q is "ip-address" then
set localIP to do shell script "ipconfig getifaddr en0"
set publicIP to do shell script "curl -s ifconfig.me"
set the clipboard to publicIP
return "Local: " & localIP & " | Public: " & publicIP & " (copied)"
end if
return "Unknown action: " & q
end alfred_scriptIntegration Examples
集成示例
Project Switcher Integration
项目切换器集成
tsx
// src/project-switcher.tsx
// ABOUTME: Unified project switcher
// ABOUTME: Integrates with multiple project sources
import {
ActionPanel,
Action,
List,
Icon,
LocalStorage,
getPreferenceValues,
} from "@raycast/api";
import { useState, useEffect } from "react";
import { exec } from "child_process";
import { promisify } from "util";
import fs from "fs";
import path from "path";
const execAsync = promisify(exec);
interface Preferences {
projectDirs: string;
githubEnabled: boolean;
gitlabEnabled: boolean;
}
interface Project {
name: string;
path: string;
source: "local" | "github" | "gitlab";
url?: string;
lastAccessed?: number;
}
export default function Command() {
const [projects, setProjects] = useState<Project[]>([]);
const [isLoading, setIsLoading] = useState(true);
const preferences = getPreferenceValues<Preferences>();
useEffect(() => {
loadAllProjects();
}, []);
async function loadAllProjects() {
const allProjects: Project[] = [];
// Load local projects
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 entries = fs.readdirSync(expandedDir, { withFileTypes: true });
for (const entry of entries) {
if (entry.isDirectory() && !entry.name.startsWith(".")) {
allProjects.push({
name: entry.name,
path: path.join(expandedDir, entry.name),
source: "local",
});
}
}
}
}
// Load access times
const accessJson = await LocalStorage.getItem<string>("project-access");
const accessTimes = accessJson ? JSON.parse(accessJson) : {};
allProjects.forEach((p) => {
p.lastAccessed = accessTimes[p.path] || 0;
});
// Sort by last accessed
allProjects.sort((a, b) => (b.lastAccessed || 0) - (a.lastAccessed || 0));
setProjects(allProjects);
setIsLoading(false);
}
async function openProject(project: Project, app: string) {
const cmd =
app === "code"
? `code "${project.path}"`
: app === "terminal"
? `open -a Terminal "${project.path}"`
: `open "${project.path}"`;
await execAsync(cmd);
// Update access time
const accessJson = await LocalStorage.getItem<string>("project-access");
const accessTimes = accessJson ? JSON.parse(accessJson) : {};
accessTimes[project.path] = Date.now();
await LocalStorage.setItem("project-access", JSON.stringify(accessTimes));
}
const sourceIcons = {
local: Icon.Folder,
github: Icon.Globe,
gitlab: Icon.Globe,
};
return (
<List isLoading={isLoading} searchBarPlaceholder="Search projects...">
{projects.map((project) => (
<List.Item
key={project.path}
title={project.name}
subtitle={project.path}
icon={sourceIcons[project.source]}
accessories={[
project.lastAccessed
? { text: new Date(project.lastAccessed).toLocaleDateString() }
: {},
]}
actions={
<ActionPanel>
<Action
title="Open in VS Code"
icon={Icon.Code}
onAction={() => openProject(project, "code")}
/>
<Action
title="Open in Terminal"
icon={Icon.Terminal}
onAction={() => openProject(project, "terminal")}
/>
<Action
title="Open in Finder"
icon={Icon.Finder}
onAction={() => openProject(project, "finder")}
/>
</ActionPanel>
}
/>
))}
</List>
);
}tsx
// src/project-switcher.tsx
// ABOUTME: Unified project switcher
// ABOUTME: Integrates with multiple project sources
import {
ActionPanel,
Action,
List,
Icon,
LocalStorage,
getPreferenceValues,
} from "@raycast/api";
import { useState, useEffect } from "react";
import { exec } from "child_process";
import { promisify } from "util";
import fs from "fs";
import path from "path";
const execAsync = promisify(exec);
interface Preferences {
projectDirs: string;
githubEnabled: boolean;
gitlabEnabled: boolean;
}
interface Project {
name: string;
path: string;
source: "local" | "github" | "gitlab";
url?: string;
lastAccessed?: number;
}
export default function Command() {
const [projects, setProjects] = useState<Project[]>([]);
const [isLoading, setIsLoading] = useState(true);
const preferences = getPreferenceValues<Preferences>();
useEffect(() => {
loadAllProjects();
}, []);
async function loadAllProjects() {
const allProjects: Project[] = [];
// Load local projects
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 entries = fs.readdirSync(expandedDir, { withFileTypes: true });
for (const entry of entries) {
if (entry.isDirectory() && !entry.name.startsWith(".")) {
allProjects.push({
name: entry.name,
path: path.join(expandedDir, entry.name),
source: "local",
});
}
}
}
}
// Load access times
const accessJson = await LocalStorage.getItem<string>("project-access");
const accessTimes = accessJson ? JSON.parse(accessJson) : {};
allProjects.forEach((p) => {
p.lastAccessed = accessTimes[p.path] || 0;
});
// Sort by last accessed
allProjects.sort((a, b) => (b.lastAccessed || 0) - (a.lastAccessed || 0));
setProjects(allProjects);
setIsLoading(false);
}
async function openProject(project: Project, app: string) {
const cmd =
app === "code"
? `code "${project.path}"`
: app === "terminal"
? `open -a Terminal "${project.path}"`
: `open "${project.path}"`;
await execAsync(cmd);
// Update access time
const accessJson = await LocalStorage.getItem<string>("project-access");
const accessTimes = accessJson ? JSON.parse(accessJson) : {};
accessTimes[project.path] = Date.now();
await LocalStorage.setItem("project-access", JSON.stringify(accessTimes));
}
const sourceIcons = {
local: Icon.Folder,
github: Icon.Globe,
gitlab: Icon.Globe,
};
return (
<List isLoading={isLoading} searchBarPlaceholder="Search projects...">
{projects.map((project) => (
<List.Item
key={project.path}
title={project.name}
subtitle={project.path}
icon={sourceIcons[project.source]}
accessories={[
project.lastAccessed
? { text: new Date(project.lastAccessed).toLocaleDateString() }
: {},
]}
actions={
<ActionPanel>
<Action
title="Open in VS Code"
icon={Icon.Code}
onAction={() => openProject(project, "code")}
/>
<Action
title="Open in Terminal"
icon={Icon.Terminal}
onAction={() => openProject(project, "terminal")}
/>
<Action
title="Open in Finder"
icon={Icon.Finder}
onAction={() => openProject(project, "finder")}
/>
</ActionPanel>
}
/>
))}
</List>
);
}Best Practices
最佳实践
1. Raycast Extension Development
1. Raycast 扩展开发
typescript
// Use proper error handling
import { showToast, Toast } from "@raycast/api";
async function safeFetch(url: string) {
try {
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
return response.json();
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Request failed",
message: String(error),
});
return null;
}
}
// Use LocalStorage for persistence
import { LocalStorage } from "@raycast/api";
async function saveData(key: string, data: any) {
await LocalStorage.setItem(key, JSON.stringify(data));
}
async function loadData<T>(key: string, defaultValue: T): Promise<T> {
const json = await LocalStorage.getItem<string>(key);
return json ? JSON.parse(json) : defaultValue;
}typescript
// Use proper error handling
import { showToast, Toast } from "@raycast/api";
async function safeFetch(url: string) {
try {
const response = await fetch(url);
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
return response.json();
} catch (error) {
showToast({
style: Toast.Style.Failure,
title: "Request failed",
message: String(error),
});
return null;
}
}
// Use LocalStorage for persistence
import { LocalStorage } from "@raycast/api";
async function saveData(key: string, data: any) {
await LocalStorage.setItem(key, JSON.stringify(data));
}
async function loadData<T>(key: string, defaultValue: T): Promise<T> {
const json = await LocalStorage.getItem<string>(key);
return json ? JSON.parse(json) : defaultValue;
}2. Alfred Workflow Best Practices
2. Alfred 工作流最佳实践
python
undefinedpython
undefinedAlways output valid JSON for Script Filters
Always output valid JSON for Script Filters
import json
import sys
def output_items(items):
"""Output Alfred JSON format"""
print(json.dumps({"items": items}))
def output_error(message):
"""Output error as Alfred item"""
output_items([{
"title": "Error",
"subtitle": message,
"icon": {"path": "error.png"}
}])
import json
import sys
def output_items(items):
"""Output Alfred JSON format"""
print(json.dumps({"items": items}))
def output_error(message):
"""Output error as Alfred item"""
output_items([{
"title": "Error",
"subtitle": message,
"icon": {"path": "error.png"}
}])
Handle keyboard interrupt gracefully
Handle keyboard interrupt gracefully
if name == "main":
try:
main()
except KeyboardInterrupt:
sys.exit(0)
except Exception as e:
output_error(str(e))
sys.exit(1)
undefinedif name == "main":
try:
main()
except KeyboardInterrupt:
sys.exit(0)
except Exception as e:
output_error(str(e))
sys.exit(1)
undefined3. Performance Optimization
3. 性能优化
typescript
// Debounce search queries
import { useState, useCallback } from "react";
import { useDebouncedValue } from "@raycast/utils";
function SearchCommand() {
const [query, setQuery] = useState("");
const debouncedQuery = useDebouncedValue(query, 300);
// Use debouncedQuery for API calls
}
// Cache API responses
const cache = new Map<string, { data: any; timestamp: number }>();
const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
async function cachedFetch(url: string) {
const cached = cache.get(url);
if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
return cached.data;
}
const data = await fetch(url).then((r) => r.json());
cache.set(url, { data, timestamp: Date.now() });
return data;
}typescript
// Debounce search queries
import { useState, useCallback } from "react";
import { useDebouncedValue } from "@raycast/utils";
function SearchCommand() {
const [query, setQuery] = useState("");
const debouncedQuery = useDebouncedValue(query, 300);
// Use debouncedQuery for API calls
}
// Cache API responses
const cache = new Map<string, { data: any; timestamp: number }>();
const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
async function cachedFetch(url: string) {
const cached = cache.get(url);
if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
return cached.data;
}
const data = await fetch(url).then((r) => r.json());
cache.set(url, { data, timestamp: Date.now() });
return data;
}Troubleshooting
故障排除
Common Issues
常见问题
Issue: Raycast extension not loading
bash
undefined问题:Raycast 扩展无法加载
bash
undefinedClear Raycast cache
Clear Raycast cache
rm -rf ~/Library/Caches/com.raycast.macos
rm -rf ~/Library/Caches/com.raycast.macos
Rebuild extension
Rebuild extension
cd your-extension
npm run build
cd your-extension
npm run build
Check for errors
Check for errors
npm run lint
**Issue: Alfred workflow not executing**
```bashnpm run lint
**问题:Alfred 工作流无法执行**
```bashCheck script permissions
Check script permissions
chmod +x workflow-script.sh
chmod +x workflow-script.sh
Test script manually
Test script manually
./workflow-script.sh "test query"
./workflow-script.sh "test query"
Check Alfred debug log
Check Alfred debug log
Alfred Preferences > Workflows > Click workflow > Debug
Alfred Preferences > Workflows > Click workflow > Debug
**Issue: AppleScript permissions**
```applescript
-- Grant accessibility permissions
-- System Preferences > Security & Privacy > Privacy > Accessibility
-- Test permissions
tell application "System Events"
set frontApp to name of first application process whose frontmost is true
end tell
**问题:AppleScript 权限不足**
```applescript
-- Grant accessibility permissions
-- System Preferences > Security & Privacy > Privacy > Accessibility
-- Test permissions
tell application "System Events"
set frontApp to name of first application process whose frontmost is true
end tellDebug Commands
调试命令
bash
undefinedbash
undefinedTest Raycast script command
Test Raycast script command
./script.sh "test argument"
./script.sh "test argument"
Test Alfred Python script
Test Alfred Python script
python3 workflow.py "test query" | jq
python3 workflow.py "test query" | jq
Check Alfred workflow variables
Check Alfred workflow variables
echo $alfred_workflow_data
echo $alfred_workflow_data
Monitor Raycast logs
Monitor Raycast logs
log stream --predicate 'subsystem == "com.raycast.macos"'
undefinedlog stream --predicate 'subsystem == "com.raycast.macos"'
undefinedVersion History
版本历史
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-01-17 | Initial release with Raycast and Alfred patterns |
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.0.0 | 2026-01-17 | 初始版本,包含 Raycast 和 Alfred 相关模式 |
Resources
参考资源
- Raycast Developer Documentation
- Raycast API Reference
- Alfred Workflow Documentation
- AppleScript Language Guide
- Raycast Store
- Alfred Gallery
This skill provides production-ready patterns for macOS launcher automation, enabling keyboard-driven productivity and seamless workflow integration.
本技能提供可用于生产环境的macOS启动器自动化模式,助力实现键盘驱动的高效生产力与工作流无缝集成。