Integration
Raycast Extensions
Personal Raycast extensions for SSH connections, translation, JWT inspection, OpenClaw, Kaon, and emoji.
Install
npm install --frozen-lockfile
README
# Raycast 扩展
个人维护的 Raycast 扩展集合。每个一级目录都是独立项目,分别安装依赖、配置和开发;根目录不是 pnpm workspace。当前以 macOS 为验证平台。
## 插件清单
| 插件 | 目录 | 命令与用途 | 依赖 |
| ------------ | -------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------- |
| JWT Editor | [jwt-editor](jwt-editor/README.md) | JWT Editor:解码 Header/Payload、查看过期时间;Quick Link:创建预填 token 的快捷链接 | 本地处理,无需 API |
| OpenClaw | [openclaw](openclaw/README.md) | Status、Sessions、Logs、Restart:查看本机 Gateway 状态、会话、日志,以及手动重启/清理 | 本机 OpenClaw CLI 和 Gateway |
| LinguaDock | [linguadock](linguadock/README.md) | Translate Text:选区或手动输入翻译,支持 21 种目标语言及中英自动互译 | 自定义 OpenAI-compatible API |
| Emoji Append | [emoji-append](emoji-append/README.md) | Append Contextual Emoji:按快捷键为选中文字追加 1~3 个应景 emoji | 自定义 OpenAI-compatible API |
| SSH Connections | [ssh-manager](ssh-manager/README.md) | SSH Connections:管理、搜索并连接 SSH 主机,选择默认终端 | 本机 SSH 和终端 |
| Kaon Router | [kaon](kaon/README.md) | Kaon Balance:菜单栏显示当日花费;Kaon Usage:预算、限速及按模型/Key/供应商/天的用量明细 | Kaon Admin API(usage:read) |
## 安装与开发
需要安装 Raycast、Node.js 和 pnpm。建议使用 Node.js 22.22.2+ 或 24 LTS;这是本地构建工具的运行环境,扩展执行时的 Node 由 Raycast 管理。参见 [Raycast 版本说明](https://developers.raycast.com/information/versioning)和 [CLI 运行环境变更](https://developers.raycast.com/misc/changelog)。
在目标插件目录执行,例如 Emoji Append:
```sh
cd emoji-append
pnpm install --frozen-lockfile
pnpm dev
```
`pnpm dev` 将扩展编译并加入本机 Raycast,持续监听源码变化。在 Raycast 的扩展设置中填写配置并绑定快捷键;开发进程可用 `Ctrl+C` 停止。目录迁移后,应先停止旧目录的开发进程,再从新目录启动。
Emoji Append 是普通 `no-view` command,不依赖 PopClip 仓库、Raycast AI Command 或 Raycast Pro。
常用开发检查:
```sh
pnpm test
pnpm lint
pnpm exec tsc --noEmit
pnpm build
```
各插件均提供 `pnpm test`,使用模拟响应、临时文件和本地测试进程,不调用真实付费 API。`ray build` 会打包代码,但不能替代 `tsc --noEmit`;构建成功不代表类型检查通过。
## 配置与数据处理
- Emoji Append 和 LinguaDock 在各自扩展设置中独立填写 API Base URL、API Key、模型。API Key 使用 password 字段,源码不包含密钥;执行时,输入文字会发送到配置的服务。
- Kaon Router 读 Kaon Admin API,只需 `usage:read` scope。token 可填在扩展设置(password 字段),也可留空改读 `~/.config/kaon/token`,与 Hammerspoon 的菜单栏组件共用同一个文件;token 不进缓存,也不出现在界面文案。401/403/429 和 Kaon 的停止信号会让扩展停止请求,需手动 Retry 清除,详见插件 README。
- JWT Editor 在本地解码,不验证签名。Quick Link 会将 token 放入链接上下文并保存到 Raycast;不适合保存长期有效或生产用途的 token。
- SSH Connections 读取和编辑本机 SSH 配置,密码和私钥内容由 SSH 管理;条件路由在连接时由 SSH 判断。详见 [SSH Connections 使用说明](ssh-manager/README.md)。
- OpenClaw 调用本机 CLI,CLI、状态目录、配置文件和日志路径支持自动发现或自定义,超时及日志展示参数均可在扩展设置中调整,详见插件 README。重启和清理会改变 Gateway/会话状态,只有执行相应动作时才触发。
- `pnpm dev`/`pnpm build` 是本地开发操作;`publish` 类脚本会发布扩展,应在确认发布目标后单独执行。
integration
Comments
Sign in to leave a comment