服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 10月13日公告称Origin已集成20多个合作伙伴应用，并开放公开提交。Private用于命名空间内开发，Public支持直接链接安装，Listed才表示应用出现在市场。
- 创建应用看命名空间所有者的资格，而非调用者套餐。命名空间管理员在Edit App的Visibility中设为Public，并至少配置一项默认scope。
- 市场安装链接的client_id填写app_开头的应用ID，不填slug，也不附加scope或redirect_uri。提交需要详细应用说明和无需登录即可观看的5至10分钟演示。
- 安装令牌受已批准仓库和scope限制；镜像仓库仅支持规定的五项读取或同步scope。追加权限需重新征得同意，Manage只改仓库，下架不会终止已有安装。
先分清开放提交、公开安装与正式上架
Cursor于2026年10月13日宣布Origin App Marketplace开放公开提交。公告列出20多个合作伙伴应用，覆盖部署、CI、代码审查、安全、监控和项目管理，包括Cloudflare、Linear、Sentry等。这里讨论的是开发者发布Origin应用的流程。
新应用从Private开始，只有所属命名空间可以查看和安装。Public让其他Origin团队通过直接链接安装，但不会自动进入市场；Cursor审核批准后，应用才成为Listed。创建前还应注意，Origin API参考标明Early Beta，接口可能变化，更新集成时需核对OpenAPI规范。
Create App要求用户访问令牌和namespace:apps:create。资格取决于命名空间所有者：个人需为Pro、Pro Student、Pro+、Ultra或Start；团队需有有效付费团队套餐，不使用Privacy Mode (Legacy)，且团队管理员没有关闭Origin。所有者不符合条件会返回HTTP 400的FailedPrecondition；调用者有付费套餐不能替代这一检查。
设为Public后，核对市场实际使用的安装入口
先在自己的命名空间创建私有应用并完成开发核对，再由命名空间管理员打开应用设置中的Edit App，把Visibility设为Public。公开应用至少需要一项默认scope；根据产品功能申请最少必要权限，再检查外部命名空间的直接链接安装。
市场安装使用/codebase/apps/install路径，client_id必须填写app_开头的应用ID，而不是市场slug。官方模板还带有source=app-metadata和returnTo=/codebase/settings/apps；完整模板见下方发布文档。不要加入scope或redirect_uri，否则会进入由合作伙伴发起的安装流程，而非市场安装流程。
安装时用户同意默认权限，Origin会转到应用配置的第一个redirect URI。只有Listed状态才有可用的公开市场详情页，因此不要把尚未上架的slug详情页作为Public应用的安装验证入口。配置回调与演示时，应分别核对这两个页面的用途。
准备详细说明与无需登录的完整演示
Public应用由命名空间管理员点击Submit to marketplace提交。详细应用说明和约5至10分钟的演示视频是必需项；视频链接必须无需登录即可观看。slug与建议标签是可选项，但slug在应用上架后不能更改。审核清单还要求遵循Origin品牌规范。
每份演示都要展示主要产品流程、从Origin安装并同意默认权限、回到产品，以及Origin和产品两侧均显示Installed。安装必须覆盖个人命名空间与团队，也要覆盖所有仓库和选定仓库两种选择方式，不能只演示开发者自己的单个配置。
还要展示双向卸载：从Origin Apps卸载后，产品显示已断开且停止接收webhook；界面看不到时，用产品日志或事件历史展示。反过来从产品断开后，Origin Apps里不再出现该安装。只有产品支持时，才额外演示从产品网站安装、新老用户登录或注册、连接现有或新项目仓库、追加权限等流程。
应用JWT、安装回执和仓库令牌各有用途
应用用Ed25519私钥签署短期App JWT，再用JWT与安装ID换取短期installation access token。App JWT负责应用级操作，安装令牌用于已批准仓库范围内的API与Git操作；令牌不能添加用户未批准的仓库或scope。仅登记公钥，私钥保留在秘密管理系统，令牌不写入日志。
回调里的installation_receipt用于验证安装批准来自Origin。验证签名、签发者、应用受众和有效期；由产品发起安装时，还应核对事先生成的state。保存验证后的安装ID，再兑换安装令牌。回执不是Bearer访问令牌，Cursor API key也不能直接充当Origin Bearer凭据；不要让用户向表单或聊天粘贴这些秘密来代替安装授权。
镜像仓库即使被选中，也仅适用repository:metadata:read、repository:members:read、repository:contents:read、repository:mirror:read和repository:mirror:sync五项scope。其他scope在该仓库返回403，即使管理员已批准；PR、审查评论、checks及其他写入不能照原生Origin仓库处理。克隆和读取可用不等于可以推送或写回检查结果。
追加权限要重新同意，Manage只调整仓库
已安装应用需要更多scope时，要把工作区管理员送回安装页请求额外权限，Origin不会主动弹出新授权。传include_granted_scopes=true会保留原有授权并只请求新增部分；不传该标记时，scope参数会替换原来的授权集合。这个重新授权流程与不带scope、redirect_uri的市场首次安装入口应分别准备。
重新授权页会显示New Permissions和Granted Permissions，按钮为Reinstall，更新的是同一份安装。完成后两侧应显示Installed及新权限；用户取消时原权限保留。该页面也能切换所有或选定仓库，而Origin Apps里的Manage只改变仓库，不改变scope。
scope或仓库发生实际变化时，Origin会自动向应用发送installation.updated，不需要单独订阅。若没有变化则不会发送该事件。核对产品保存的授权状态时，不要把再次打开页面或收到回调本身当作权限已增加的证据。
提交后跟踪审核，下架后核对已有安装
Cursor会审核每份提交；提交后有确认邮件，上架后另有邮件。提交入口、确认邮件和Public状态都不是Listed的替代证明。已查阅材料没有给出审核时限、费用、完整地区名单或某个账号必定成功的承诺，规划发布时不要自行补上这些结论。
假设你正在开发一个向原生Origin仓库写回check run的CI应用：可以按产品流程、个人和团队安装、两种仓库选择、双向卸载组织演示，并单独处理镜像仓库的403限制。这只是未执行的设计例子；本文没有创建应用、安装集成、调用Origin API或录制成功演示。
Unlist或改回Private会隐藏市场展示，但已有安装继续工作。曾经Listed的应用改为Private，再改回Public，也不会自动重新上架；需要重新提交。若目标是断开某份集成，应按卸载流程核对两侧状态，不能把隐藏列表当作已有授权已经撤销。
资料来源
常见问题
我有Pro套餐，为什么Create App仍返回FailedPrecondition？
资格检查针对拥有应用的命名空间所有者，而不是发请求的人。核对目标是个人还是团队，以及该所有者的套餐、团队Privacy Mode (Legacy)和管理员是否关闭Origin。文档将不符合所有者资格的错误列为HTTP 400；本文未检查你的实际账号。
管理员已批准checks写入，为什么镜像仓库仍返回403？
镜像仓库对安装凭据只开放规定的五项读取或同步scope，批准更多权限不会突破该限制。checks、PR、评论和写入都被拒绝；应区分镜像仓库与原生Origin仓库，不要通过重复申请相同权限来推断写入已开放。
Public应用可以用slug打开市场详情页吗？
公开市场详情页只有Listed后才工作。Public阶段按官方市场安装模板验证直接链接，client_id填写应用ID，不填slug，不追加scope或redirect_uri；通过审核后再核对市场列表与详情页。
开放提交是否说明免费、所有地区可用或很快通过审核？
没有。公告开放的是提交入口，发布文档要求逐份审核，API还列出命名空间所有者资格。当前材料没有建立发布费用、完整地区范围、审核SLA或账号成功保证，需要分别确认，不能由入口开放推断。