OpenClip 是一款 macOS 开源文本动作弹窗工具，选中任意文本即可弹出上下文动作栏，支持自定义脚本、AI 动作与可扩展工作流。它的扩展商店（Extension Store）内置在应用偏好设置中，可以浏览、一键安装、自动更新和管理社区扩展。本文是一份面向新手的使用教程，覆盖从打开商店到管理已安装扩展的完整流程。

什么是 OpenClip 扩展商店？

扩展商店是 OpenClip 官方提供的扩展分发渠道，官方与社区发布的扩展统一托管其中。每个扩展条目都会展示名称、简介、作者、下载量、上架日期和版本号，帮助你快速判断是否安装。

商店核心能力一览：

商店入口在 ExtensionsStoreView.swift 中实现，浏览、分页、搜索等逻辑都由它驱动。

如何打开扩展商店？

步骤只有两步，30 秒即可完成首次安装：

1. 打开 OpenClip 偏好设置（菜单栏图标 → Preferences）。
2. 进入Actions页面，点击顶部的Store标签（也可以直接使用侧边栏的 Store 入口）。

打开后即可看到Featured 精选区（如 Quick Translate、Run in Terminal、Copy as Markdown、Shorten Link 等官方推荐扩展）、New 新上架区和All Extensions 全部列表。顶部搜索框支持按名称或关键词实时过滤，排序菜单可在 All / Popular（按下载量）/ New 之间切换。

💡 小贴士：如果列表显示 "Unable to Connect to Store"，说明网络或代理拦截了商店 API，点击Try Again可手动重新拉取目录。

一键安装社区扩展的步骤

在商店中找到心仪的扩展后，点击右侧蓝色Install按钮即可，无需任何命令行操作。

后台实际执行了 4 个步骤：

1. 通过 ExtensionsAPIClient.swift 拉取扩展发布目录；
2. 由 RemoteExtensionInstaller.swift 下载扩展的.zip或.openclipext包；
3. ExtensionManager.swift 解压并校验包内容，写入本地扩展目录~/.openclip/extensions/；
4. 重新加载目录，把新动作注册到全局动作清单。

安装完成后，商店中的 Install 按钮会变成红色垃圾桶图标，表示该扩展已安装。安装失败的错误信息会直接显示在条目下方的红色警告行中，方便排查。

扩展自动更新如何设置？

OpenClip 内置了扩展更新管理器 ExtensionUpdateManager.swift，它的策略是：

• 启动时以及每 6 小时自动检查一次商店中已安装扩展的版本；
• 版本对比逻辑见 ExtensionUpdatePlanner.swift，只有商店版本严格大于已安装版本时才提示可更新；
• 自动更新只作用于来源为 store 的扩展，不会覆盖你手动安装的本地扩展。

开启自动更新：进入偏好设置的About页面，在Extension Updates卡片中打开Automatically Update Extensions开关。

如果选择手动更新，商店列表中已安装且有新版本的扩展会显示Update按钮，点击即可从商店重新安装并保留信任状态。

管理已安装扩展：查看、禁用与卸载

每个已安装扩展都有独立的详情页（在侧边栏的已安装扩展列表中点击扩展名进入，源码见 ExtensionPackagePage.swift），一页之内可以：

• 📄 查看扩展的 README 与作者信息；
• ⚡ 逐个开关该扩展提供的动作（不需要整个卸载）；
• 📂 在 Finder 中定位扩展文件夹；
• 🗑️ 整包卸载（详情页工具栏或商店列表的垃圾桶按钮）。

商店条目与详情页的按钮行为在 ExtensionCardView.swift 中统一实现，安装、卸载、更新共用同一套状态反馈。

其他方式安装扩展（手动/本地）

除了商店，还有 3 种本地安装方式，适合开发或分发自己的扩展：

1. Install File… 按钮：商店右上角可直接选择本地的.openclipext或.zip文件安装；
2. Finder 双击：.openclipext是 OpenClip 注册的 macOS 文档包，双击即可弹出确认对话框并安装；
3. 直接放入目录：把扩展包或独立脚本（.sh/.py/.js/.applescript）放入~/.openclip/extensions/。

详细的包目录结构与 manifest.json 字段说明，可参考官方文档：

• 扩展管理指南：docs/user-guide/managing-extensions.md
• 包格式参考：docs/developer-guide/package-format.md
• 信任模型与架构：docs/architecture/extensions.md

⚠️ 安全提示：OpenClip 不沙箱化扩展执行，安装扩展等于信任其代码，请优先选择商店中的官方或知名作者扩展。

安装后扩展如何生效？

• 热重载：目录监听器 ExtensionsDirectoryWatcher.swift 每秒扫描~/.openclip/extensions/，文件变化稳定后约 2 秒自动重新加载，无需重启应用；
• 使用方式：在任何应用中选中文字，弹出动作栏即可看到新扩展的动作；按⌥⌘C打开搜索面板（Search Palette），可模糊检索全部已安装动作。

安装带补全类扩展后，输入文字时还会直接弹出联想浮层，例如按前缀即时补全常用词：

常见问题速查

小结

OpenClip 扩展商店把"浏览 → 安装 → 更新 → 卸载"全流程收进了偏好设置界面：Store 标签一键安装社区扩展，About 页一个开关搞定自动更新，侧边栏详情页负责日常管理与卸载。配合⌥⌘C搜索面板，装好的扩展随时随取随用。如果你有自己的脚本想封装成扩展，可以从 docs/developer-guide/package-format.md 开始动手。