pi-caps-blink

用 MacBook Caps Lock 灯指示 Pi 代理运行状态

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-caps-blink。
它的用途是:用 MacBook Caps Lock 灯指示 Pi 代理运行状态
完整的 Skill 内容见:https://321skill.com/skills/pi-caps-blink/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“安装 pi-caps-blink 并让它在我的 Pi agent 运行时自动闪烁 Caps Lock 灯。” 它会执行 `npm install -g pi-caps-blink`,然后配置启动脚本,之后每当 Pi agent 开始处理任务,Caps Lock 灯就会规律闪烁,任务完成后停止闪烁,让你无需看屏幕就能感知代理状态。

介绍

在使用 Pi 智能体时需要随时知道代理是否正在运行,但频繁切换窗口查看很不方便。pi-caps-blink 通过闪烁 MacBook 的 Caps Lock 物理 LED 灯,直观地提醒你某个 Pi agent 当前处于活跃状态,无需额外显示器或软件弹窗。

安装后,只要 Pi agent 开始执行任务,Caps Lock 灯就会规律闪烁;代理停止运行后灯恢复常亮或熄灭。该工具完全基于系统底层键盘灯控制,对系统资源消耗极小,可无缝集成到现有 Pi 工作流中。

适合在 MacBook 上使用 Pi 生态的开发者、运维工程师和智能体开发者,尤其适合需要同时处理多个任务、经常离开电脑或屏幕空间有限的用户。它能让你在不看屏幕的情况下,仅凭余光感知代理状态。

注意:仅支持 macOS 系统,且需授予辅助功能权限以控制键盘灯。安装后请确保 Caps Lock 键本身未被用作其他快捷键,以免冲突。部分老旧 MacBook 机型可能不支持该功能。

核心特点

与常见的软件状态指示器(如菜单栏图标或通知弹窗)不同,pi-caps-blink 利用物理键盘灯,无需额外占用屏幕空间,且不依赖 AnyDesk 等远程工具,完全本地化运行。

注意事项

仅适用于 MacBook 且需要 macOS 辅助功能权限,无法在 Windows 或 Linux 上使用,也不支持外接键盘的 Caps Lock 灯。

常见问题

安装后 Caps Lock 灯不闪烁怎么办?

请检查是否已授予辅助功能权限(系统设置 > 隐私与安全性 > 辅助功能 > 勾选终端或相应应用),并确保 Pi agent 正在运行且被正确识别。

这个工具会影响 Caps Lock 的正常功能吗?

运行时灯会被闪烁控制,但 Caps Lock 键的输入功能不受影响。关闭工具后灯会恢复系统默认行为。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-caps-blink/raw/index.md 读取 pi-caps-blink 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。