管理端配置
资源与分发
使用 Resource Hub 创建、校验并发布 Skill、Work、Connector;再使用 Explore Management 将已发布的不可变版本分发给指定角色。
分发流程概览
使用 Resource Hub 创建、校验并发布 Skill、Work、Connector;再使用 Explore Management 将已发布的不可变版本分发给指定角色。资源内容维护和用户侧可发现性是两个独立阶段。
连接 Git 仓库
- 进入 System → Git repositories(
/admin/settings/git-repositories),创建或核对 Git Repository Connection。 - 填写仓库地址、默认分支、认证方式和 Access Scope;一个连接同一时间只服务一种资源类型。
- 确认仓库结构与
.workbenchManifest、路径安全和资源类型目录要求相符,且仓库没有密码、Token 或私钥。
创建并发布 Resource Hub 资源
- 进入 Resources → Resource Hub(
/admin/resource-hub),创建 Skill、Work 或 Connector;创建后类型保持锁定。 - 从 Git、本地上传或空白资源创建首个命名草稿。草稿名称在当前资源内应唯一。
- 在发布前检查入口文件与类型规则:三种资源均须有
SKILL.md;Work 还应包含至少一个一级成员目录及<member>/SKILL.md。 - 设置文件或目录的 Publish policy:
Read-only/Writable决定用户端是否可修改,Overwrite/Keep决定更新时是否保留用户端同路径内容。规则不从父目录自动继承。 - 保存草稿并执行类型校验,发布为不可变版本。修改已发布版本时,先创建新草稿,不能原地编辑。
在 Explore 分发已发布资源
- 进入 Resources → Explore Management(
/admin/skillhub/explore),点击New。 - 仅从 Resource Hub 的已发布资源中选择目标版本;草稿、Git 分支和未发布版本不能直接加入。
- 在
Display配置 Icon、Name、Description 和 Display Order;这些只影响 Explore 展示,不修改 Resource Hub 内容。 - 在
Visible Roles选择可见角色;选择多个角色按或关系匹配,空角色范围表示所有角色可见。 - 在
Version updates选择Always use latest version或Specific version并保存。 - 分别用具备与不具备目标角色的测试账号检查可见性、安装、授权和最小调用链路。
核对与异常处理
- 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 是否会自动作用于子目录?
不会。文件和文件夹的策略分别保存;需要保留具体内容时直接在对应节点配置。