PopClip-Extensions

PopClip 扩展

English

简体中文

繁體中文

日本語

这是一个面向 macOS 的 PopClip 扩展和 snippet 扩展集合。仓库中的可编辑源文件位于 src/，可本地构建的安装包位于 dist/。

安装

打开 dist/ 中的 .popclipextz 文件，即可在 PopClip 中安装扩展。Snippet 扩展使用 .popcliptxt 格式。

扩展

以下 14 个扩展已配置为提交到 PopClip 扩展目录：

扩展	说明	源码	安装包
Comment Switcher	使用可配置的前缀切换行注释。	源码	安装
DeepL Translator	使用 DeepL 应用或网站翻译文本。	源码	安装
Format JSON	使用可配置的缩进格式化选中的 JSON。	源码	安装
Password Generator	在本地生成可配置的随机密码。	源码	安装
Markdown List	将多行文本转换为有序或无序 Markdown 列表。	源码	安装
Mosaic Text	使用可配置的马赛克字符替换文本。	源码	安装
Multi-Line to Array	将多行文本转换为 JavaScript 数组。	源码	安装
Open GitHub Repo	根据 AUTHOR/REPO 文本打开仓库。	源码	安装
PinYin	将中文文本转换为拼音或注音。	源码	安装
Color Conversion	转换 RGB 和十六进制颜色。	源码	安装
Text Repeater	使用倍数后缀重复文本。	源码	安装
Variable Name Convert	在 snake case 和 camel case 之间转换。	源码	安装
Add to WordClip	将选中的文本发送到 WordClip。	源码	安装
ray.so	使用 ray.so 生成代码图片。	源码	安装

每个扩展包都有自己的 README，包含用法、选项、隐私说明和更新记录：

• Comment Switcher
• DeepL Translator
• Format JSON
• Password Generator
• Markdown List
• Mosaic Text
• Multi-Line to Array
• Open GitHub Repo
• PinYin
• Color Conversion
• Text Repeater
• Variable Name Convert
• Add to WordClip
• ray.so

Snippet

以下是独立的 PopClip snippet 扩展，不包含在目录提交的 package glob 中：

• Search in NPM · 安装

• ChatGPT Make PopClip Extension

  将选中的请求发送到 ChatGPT 对话框，让 ChatGPT 生成可安装的 PopClip snippet。需要 ChatGPT macOS 应用，以及为 System Events 授予辅助功能权限。

• Fancy Text

构建

build.sh 用于构建、安装、创建和删除 PopClip 扩展包及 snippet。不带参数运行时会打开交互式菜单，提供以下操作：

• 构建扩展包
• 构建并安装扩展包
• 构建 snippet
• 构建并安装 snippet
• 根据模板创建扩展包
• 根据模板创建 snippet
• 确认后删除源文件和生成文件

./build.sh

直接执行命令时，可以使用：

./build.sh PinYin
./build.sh build PinYin
./build.sh install PinYin
./build.sh build FancyText
./build.sh create-package yaml NewExtension
./build.sh create-snippet javascript NewSnippet
./build.sh remove NewExtension
./build.sh help

./build.sh NAME 是 ./build.sh build NAME 的简写。

build NAME 会构建 src/NAME.popclipext/ 或 src/ 中的 snippet 源文件，并将结果写入 dist/NAME.popclipextz 或 dist/NAME.popcliptxt。install NAME 会先构建目标，然后使用 macOS 的 open 命令打开生成文件，以便在 PopClip 中安装。

可用的扩展包模板格式有 plist、yaml、json 和 module；可用的 snippet 模板格式有 javascript、typescript 和 yaml。Module 扩展包包含 YAML 配置和 TypeScript 源码。扩展名称只能包含字母、数字、点号、连字符和下划线。

构建扩展包时会检查：根目录必须恰好包含一个 Config 文件，文件总数不超过 100 个，单个文件不超过 1 MB，总大小不超过 2 MB。remove NAME 只有在交互确认后才会删除对应的源文件和生成文件。运行 ./build.sh help 可查看命令参考。

提交到目录

仓库通过 popclip-directory.yaml 配置提交范围。PopClip 目录会在推送符合条件的新 Git tag 后读取发生变化的扩展目录，运行 Submission Check，并将成功的提交排队等待人工审核。具体流程请参阅官方提交指南。

参考资料

• PopClip 扩展目录
• PopClip 扩展开发文档
• PopClip Snippets

This site is open source. Improve this page.