作用域
在 JSR 上,所有包都包含在一个作用域中。作用域是一个共同管理一组包的组。作用域由单个用户拥有,可以有多个成员。
JSR 上的作用域类似于 npm 组织。作用域以 @
符号为前缀。作用域名称必须在 2 到 20 个字符之间,并且只能包含小写字母、数字和连字符。它们不能以连字符开头。作用域名称在全球范围内是唯一的 - 两个作用域不能具有相同的名称。
您可以在 jsr.io/new 创建作用域。
成员
范围可以包含多个成员。成员可以管理范围并发布包。
角色
成员可以拥有两种角色之一:管理员或成员。
权限 | 成员 | 管理员 |
---|---|---|
创建包 | ✅ | ✅ |
删除包 | ❌ | ✅ |
发布包版本 | ✅ | ✅ |
撤回包版本 | ❌ | ✅ |
更新包描述 | ✅ | ✅ |
更新包 GitHub 仓库 | ❌ | ✅ |
邀请成员 | ❌ | ✅ |
更改成员角色 | ❌ | ✅ |
移除成员 | ❌ | ✅ |
删除范围 | ❌ | ✅ |
创建范围的用户自动成为该范围的管理员。管理员可以邀请其他用户加入范围,并可以更改其他成员的角色。管理员还可以删除范围。
邀请成员
管理员可以邀请其他用户加入范围。要邀请用户,请前往范围的“成员”选项卡,输入要邀请的用户的 GitHub 用户名,然后点击“邀请”。用户将收到一封电子邮件,邀请他们加入范围。用户必须拥有 JSR 帐户才能被邀请加入您的范围。如果他们还没有 JSR 帐户,请让他们在 jsr.io 创建一个帐户,然后再邀请他们。
当用户收到邀请时,他们会收到一封电子邮件邀请他们加入范围。电子邮件将包含一个接受邀请的链接。如果用户接受邀请,他们将被添加为范围成员。用户还可以查看其帐户邀请页面上的所有待处理邀请。
更改成员角色
管理员可以更改其他成员的角色。要更改成员的角色,请转到范围的“成员”选项卡,单击要更改角色的成员旁边的下拉菜单,然后选择新角色。新角色将立即生效。请注意,您不能将范围的最后一个管理员降级为成员。如果您想将范围的最后一个管理员降级为成员,则必须先将另一个成员提升为管理员。范围必须始终至少有一个管理员。
删除成员
管理员可以从范围内删除成员。要删除成员,请转到范围的“成员”选项卡,单击要删除的成员旁边的下拉菜单,然后选择“删除”。该成员将立即从范围内删除。该用户将不再能够管理或发布到该范围。如果该成员是范围的最后一个管理员,则必须先将另一个成员提升为管理员,然后才能删除最后一个管理员。
离开范围
您可以随时离开范围。要离开范围,请转到范围的“成员”选项卡,然后单击“离开”。您将立即从范围内删除。您将不再能够访问管理或发布到该范围。如果您是范围的最后一个管理员,则必须先将另一个成员提升为管理员,然后才能离开范围。
如果您是范围内的最后一个成员,则无法离开范围。您可以删除范围。
删除范围
只有在范围没有包的情况下才能删除范围。如果您想删除范围,则必须先删除该范围内的所有包。 了解有关包删除的更多信息。
范围管理员可以在范围设置页面中删除范围。
GitHub Actions 发布安全
如果您将范围内的包链接到 GitHub 存储库,则可以从 GitHub Actions 发布包,而无需配置任何密钥或身份验证。 了解有关从 GitHub Actions 发布的更多信息。
首先,只有在 GitHub Actions 工作流在与 JSR 上的包链接的 GitHub 存储库中运行时才允许发布。
作为范围管理员,您还可以进一步限制发布,使其仅在触发 GitHub Actions 工作流的用户是 JSR 上此范围的成员时才允许。此选项默认启用。
您可以在范围设置页面中禁用此选项,以允许从链接的 GitHub 存储库中的任何 GitHub Actions 工作流发布,而与触发工作流的用户无关。
要求从 CI 发布
作为范围管理员,您可以要求所有包版本都从 CI 环境(GitHub Actions)发布。启用此选项将阻止用户从其本地开发环境发布包版本。所有包版本必须使用来自 CI 环境的 OIDC 令牌发布。
您可以在范围设置页面启用此选项。