Cursor Plugins 是什么：先看目录，再看单个插件
部署 Cursor 插件：处理客户端、版本和凭据
按选中插件的组件决定部署工作，不把整个仓库当成服务器
部署 Cursor 插件：处理客户端、版本和凭据知识学习CN编辑简报更新 2026-10-08
你将学会
- 确定分发层次
- 单独管理外部集成
- 留下发布记录
开始前需要
- 可丢弃的客户端配置
- 一个明确选中的插件
- 固定的仓库提交
把目录中的候选插件转成可复现的团队决策
先看结论
- 市场清单与插件清单职责不同。
- 跨客户端条目范围存在差异。
- 某些插件会增加网络或 Hook 依赖。
确定分发层次
市场条目指定来源目录，插件清单还可以写 `minClientVersions`。固定版本的 GitHub 集成清单要求 Cursor 3.13.0 或以上。
这个目录本身没有统一的服务端口或数据库。某个插件可能会执行 Hook，另一个可能连接 MCP 服务，所以部署要求必须按具体条目确认。
单独管理外部集成
GitHub 插件把 `GITHUB_PERSONAL_ACCESS_TOKEN` 声明为必填变量，并在 MCP 配置里指向 HTTP 端点。启用前要确定令牌范围和保存位置。
该提交下 `.claude-plugin/marketplace.json` 只列出 `origin-apps`，不是 Cursor 目录的完整镜像。目录名相似不等于跨客户端安装行为一致。
留下发布记录
记录仓库提交、插件目录、客户端版本、清单版本和环境变量。团队共享时，还要确定谁能更新插件以及怎样恢复上一版本。
本文没有验证真实客户端部署、兼容性协商或令牌存储。正式接入前应使用不含生产凭据的测试配置核实。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
固定来源和客户端版本。
- 2
不要把集成令牌写进共享文件。
- 3
在测试配置中验证更新和移除。
可复制示例
yaml
selected_plugin: github
repository_commit: d0ef80d
client: verify_supported_version
credential: scoped_GITHUB_PERSONAL_ACCESS_TOKEN
rollback: restore_previous_plugin_version常见问题
需要给整个仓库部署 Docker 吗？
官方目录没有统一服务；具体操作取决于选中插件。
团队能共用一个高权限令牌吗？
应按实际操作和使用者缩小各集成凭据的权限。
资料来源
- Cursor Plugins / .cursor-plugin/marketplace.json来源核查 2026-10-08
- Cursor Plugins / .claude-plugin/marketplace.json来源核查 2026-10-08
- Cursor Plugins / third_party/github/.cursor-plugin/plugin.json来源核查 2026-10-08
- Cursor Plugins / third_party/github/mcp.json来源核查 2026-10-08