管理端配置

资源与分发

使用 Resource Hub 创建、校验并发布 Skill、Work、Connector;再使用 Explore Management 将已发布的不可变版本分发给指定角色。

分发流程概览

使用 Resource Hub 创建、校验并发布 Skill、Work、Connector;再使用 Explore Management 将已发布的不可变版本分发给指定角色。资源内容维护和用户侧可发现性是两个独立阶段。

连接 Git 仓库

  1. 进入 System → Git repositories(/admin/settings/git-repositories),创建或核对 Git Repository Connection。
  2. 填写仓库地址、默认分支、认证方式和 Access Scope;一个连接同一时间只服务一种资源类型。
  3. 确认仓库结构与 .workbench Manifest、路径安全和资源类型目录要求相符,且仓库没有密码、Token 或私钥。

创建并发布 Resource Hub 资源

  1. 进入 Resources → Resource Hub(/admin/resource-hub),创建 Skill、Work 或 Connector;创建后类型保持锁定。
  2. 从 Git、本地上传或空白资源创建首个命名草稿。草稿名称在当前资源内应唯一。
  3. 在发布前检查入口文件与类型规则:三种资源均须有 SKILL.md;Work 还应包含至少一个一级成员目录及 <member>/SKILL.md
  4. 设置文件或目录的 Publish policy:Read-onlyWritable 决定用户端是否可修改,OverwriteKeep 决定更新时是否保留用户端同路径内容。规则不从父目录自动继承。
  5. 保存草稿并执行类型校验,发布为不可变版本。修改已发布版本时,先创建新草稿,不能原地编辑。

在 Explore 分发已发布资源

  1. 进入 Resources → Explore Management(/admin/skillhub/explore),点击 New
  2. 仅从 Resource Hub 的已发布资源中选择目标版本;草稿、Git 分支和未发布版本不能直接加入。
  3. Display 配置 Icon、Name、Description 和 Display Order;这些只影响 Explore 展示,不修改 Resource Hub 内容。
  4. Visible Roles 选择可见角色;选择多个角色按或关系匹配,空角色范围表示所有角色可见。
  5. Version updates 选择 Always use latest versionSpecific version 并保存。
  6. 分别用具备与不具备目标角色的测试账号检查可见性、安装、授权和最小调用链路。

核对与异常处理

  • Git 同步会生成新的命名草稿,不覆盖既有草稿或已发布版本;同步失败也不应修改现有内容。
  • Resource Hub 发布并不自动在 Explore 出现;需创建 Explore Release。
  • 移除 Explore Release 不会编辑 Resource Hub 的资源定义或已发布版本。
  • Connector 测试应包括用户 Connection、Test Connection、最小调用、重新授权和解绑路径;不要把管理端保存成功当作用户可用证明。

常见问题

资源更新后,用户为什么还在使用旧版本?

检查 Explore Release 的 Version mode。Specific version 会固定版本;Always use latest version 才会在新版本发布后自动切换。

Keep 是否会自动作用于子目录?

不会。文件和文件夹的策略分别保存;需要保留具体内容时直接在对应节点配置。

相关页面