概述
套件是由技能、命令、智能体、规则、钩子、连接等多项能力组合而成的一个整体，以套件维度统一上传、统一管控、统一下发。企业管理员可在 企业控制台 > AI 资源管理 > 套件管理 统一分发和管理组织内的套件。
特征
特征 | 说明 |
一体化分发 | 一个套件包含多项能力（技能 / 命令 / 智能体 / 规则 / 钩子 / 连接），上传压缩包后由系统自动解析能力项，随套件整体生效 |
可管控性 | 管理员可控制每个套件的可见范围，并通过下发策略进一步收窄，套件额外支持强制下发的管控策略 |
双来源 | 支持企业自建上传与官方内置两种来源 |
关键区分
内置套件：平台预置的官方套件，名称 / 描述 / 能力项由官方维护，企业仅可调整企业内的可见范围与启用状态。
企业自建套件：企业管理员上传的组织专属套件包，包内能力项由系统自动解析，需配置可见范围（可选配下发策略）后对成员生效。
客户端浏览
套件作为客户端技能页下的二级分类“套件”“企业套件”页签展示。成员只能看到可见范围内的套件：未授权的套件不出现在列表中，被策略屏蔽的套件同样不展示。
说明：
目前仅 SaaS 旗舰版支持，WorkBuddy 客户端 5.12.0 版本、CodeBuddy 客户端 4.12.3 版本支持该功能（CodeBuddy 客户端展示位包含套件、插件）。
核心概念
套件管控采用“可见范围 + 下发策略”双层架构：
层级 | 控制对象 | 典型场景 |
可见范围 | 套件对哪些成员默认可见 | 套件仅对研发部门可见 |
下发策略 | 在可见范围内进一步限定、屏蔽或强制下发 | 对研发部门中的部分成员屏蔽某套件，或对全员强制安装 |
优先级规则：屏蔽 > 强制下发 > 限定 > 默认允许。
生效关系：“可见范围”绑定套件的默认可见成员，是硬门槛；策略仅能在该范围内收窄，不能越级放开。
新建套件
上传前：准备套件包
套件包为 .zip 格式，目录结构要求：
suite-package/├── plugin.json # [必填] 套件标识与元信息（name、version 等）├── skills/ # [可选] 技能├── commands/ # [可选] 命令├── agents/ # [可选] 智能体├── rules/ # [可选] 规则├── hooks/ # [可选] 钩子└── mcp.json # [可选] 连接（MCP）配置
步骤 1：上传套件包
1. 在企业控制台进入 AI 资源管理 > 套件管理 > 套件列表。
2. 单击右上角 + 新建套件。
3. 填写基本信息并上传套件压缩包。
说明：
企业上传的套件默认均会归入“企业套件”的统一市场分类下，暂不支持自定义分类。分类信息可在 AI 资源管理 > 技能管理 > 分类管理中查看。
字段 | 必填 | 说明 |
图标 | 否 | 支持 png / jpg / svg，推荐 200x200、不超过 512KB；不上传时系统自动取名并生成头像 |
套件标识 | 是 | 上传套件包后自动解析，取自 plugin.json 的 name；企业内唯一，不支持手动填写，重名时不允许变更 |
套件名称 | 是 | 客户端显示的名称 |
英文名称 | 否 | 客户端英文环境显示的名称 |
所属市场 | 是 | 默认为企业套件 |
版本 | 是 | 上传套件包后自动解析，取自 plugin.json 的 version，不支持手动填写 |
归属部门 | 是 | 选择套件归属的部门 |
描述 | 否 | 套件的简要说明，最长 500 字 |
英文描述 | 否 | 英文环境显示的描述，最长 500 字 |
套件压缩包 | 是 | 点击或拖拽 .zip 文件上传，仅支持 .zip 格式 |
权限配置（可见范围）：
所有成员（默认）：套件对企业内全员可见。
部分成员：通过部门 / 成员树勾选可见范围，支持选择部门或成员。
保存方式：取消 / 仅保存（保存后不启用）/ 保存并启用。
步骤 2：设置下发策略
如果需要进一步限制或强制安装特定套件：
1. 进入下发策略标签页。
2. 单击 + 新建策略。
3. 选择策略类型并配置，详情请参见 下发策略。
4. 单击保存后策略即时生效。
套件列表
套件列表是管理的核心入口，提供套件的全生命周期操作。
编辑套件
1. 在套件列表单击目标套件操作列的编辑。
2. 可修改：图标、套件名称、英文名称、归属部门、描述、英文描述、可见范围。
3. 不可修改：套件标识、所属市场、版本（均来自套件包，需更换套件包才能变更）。
4. 更换套件包：套件包区域显示当前包文件名、当前版本与大小，单击“更换套件包”重新上传 .zip；更换后系统重新解析能力项并更新版本号。
5. 单击保存并启用（或仅保存）完成。
删除套件
仅企业自建套件可删除。单击操作列 删除，二次确认后执行。
警告：
删除后将同时移除套件包含的全部能力项，且无法恢复。
内置套件管理
内置套件的名称 / 描述 / 能力项由官方维护，编辑页仅可调整企业内的可见范围（所有成员 / 部分成员），单击 保存可见范围 生效；启用状态请在套件列表的状态列中操作。
新增内置默认状态
有“先审后用”管控诉求的企业，可配置官方后续新增内置套件的默认状态，避免每批新增内置套件都要逐个手动停用。
将套件列表的来源筛选切换到 内置套件 后，列表顶部展示“新增内置默认状态”卡片。卡片为只读，展示当前状态；单击 修改 在弹窗中编辑，保存后即时生效。
默认启用：官方新增的内置套件下发后全员可用（与既有行为一致，为系统默认值）。
默认禁用：官方新增的内置套件进入企业清单即为禁用态，管理员手动启用后成员可用；默认禁用的新增内置套件不下发至成员客户端清单。
下发策略
策略说明
进入下发策略标签页，页首展示策略说明：
概念 | 说明 |
强制下发 | 默认强制安装到成员客户端并展示套件卡片，成员不可关闭、不可卸载；可选择“静默安装”（客户端不展示卡片，成员无感知）或“允许卸载”（安装后成员可自行关闭或卸载） |
限定策略（推荐下发） | 范围内成员可以使用指定套件；多条策略同时命中时，取交集生效 |
屏蔽策略 | 范围内成员不可使用指定套件，与强制策略同时命中时，以屏蔽为准 |
生效关系 | “可见范围”绑定套件的默认可见成员；策略仅在该范围内收窄，不能越级放开 |
配置指引 | 仅控制默认可见成员时，配置“可见范围”即可；需进一步限制其中一部分成员时，才创建策略 |
能力限制 | 连接器配置强制下发策略后，目前仍需客户端成员授权，不可跳过；规则仅 CodeBuddy 客户端支持，WorkBuddy 客户端不支持 |
策略类型详解
系统提供三种显式策略；未命中任何策略的成员按“默认允许”处理：
限定策略
定义：指定成员仅能使用列表中的套件，列表之外的一律不可用。
适用场景：
新员工入职，仅开放基础能力。
外包人员访问受限套件集。
合规要求限定可用能力范围。
屏蔽策略
定义：禁止指定成员使用列表中的套件，列表之外的仍按默认规则可用。
适用场景：
高风险套件需要限制访问。
敏感能力仅限核心人员。
试用期限制高级功能。
强制下发
定义：将指定套件强制安装到范围内成员的客户端。选择该类型后，需在“强制下发选项”中选择一种方式：
选项 | 效果 |
强制下发（默认） | 安装到成员客户端并展示套件卡片，成员不可自行关闭或卸载 |
静默安装 | 安装后不在成员客户端展示套件卡片，成员无感知 |
允许卸载 | 安装后成员可自行关闭或卸载套件，卸载后不会再自动安装 |
综合场景示例
以下为典型配置组合及成员侧实际结果；组合配置时建议核对“可见范围”与策略作用范围是否匹配。
场景 | 配置组合 | 成员结果 | 处置 |
S1 强推（全公司 / 部门） | 可见范围 = 全部成员 或 部门A + 强制下发（同一范围） | 范围内静默安装并强制生效，不可关闭 / 不可卸载；范围外成员不可见 | 推荐 |
S2 强制下发 + 允许自行卸载 | 可见范围 = 部门A + 强制下发（部门A）+ 开启“允许成员自行卸载” | 静默安装并生效；成员可自行关闭或卸载，卸载后不会再自动安装 | 推荐 |
S3 强推 + 个别避免 | 强制下发（全部成员）+ 屏蔽策略（部门B） | 全局强制生效，部门B 被禁用且已装的撤回 | 推荐 |
S4 默认可用 | 可见范围内 + 未命中任何策略 | 不下发，成员可在客户端企业市场自行安装使用 | 默认 |
S5 冲突：强制 ∩ 可见圈 | 强制下发（部门A）+ 可见范围（部门B） | 可见范围是硬门槛 → 两个集合无交集，套件无人可见 | 需处置 |
S6 组合：限定策略 + 强制下发 | 限定策略（部门A · 套件A/B/C）+ 强制下发（部门A · 套件C） | 套件C 静默安装后不可关闭 / 不可卸载；套件A/B 在限定集合内可用；集合外套件均不可用 | 推荐 |
注意事项与重点提示
信息收集与使用
收集项 | 类型 | 用途 |
企业账号信息（登录凭据） | 必要 | 登录企业控制台，进行套件的上传、配置和管理 |
套件包文件内容（plugin.json、技能、规则、钩子、连接配置等） | 必要 | 解析套件包含的能力项，构建套件的定义与行为能力 |
可见范围与下发策略配置（成员 / 部门选择） | 必要 | 控制套件的可见范围、安装与使用权限 |
成员客户端的套件使用行为 | 非必要 | 仅在成员客户端安装、使用套件时涉及 |
类型判定标准：
必要：使用套件管理核心功能时必须提供的信息（如企业账号、套件包内容、策略成员选择）。
非必要：仅在成员客户端实际安装、使用套件时才涉及的数据。
权限边界
管理员通过可见范围与下发策略控制成员能获取哪些套件，不直接干预成员在客户端中的实际调用行为。
策略只能在套件“可见范围”内收窄，不能越级放开。
内置套件由平台维护，企业仅可调整可见范围与启用状态，无法修改名称、描述与能力项。
删除套件将同时移除全部能力项且无法恢复，删除前请确认。
安全提示
上传套件包前请确认来源可靠，套件包中的技能脚本将在客户端沙箱中执行。
强制下发的套件会自动安装到成员客户端，建议仅对经过审核的套件使用；含敏感能力的套件建议使用静默安装以外的默认方式，并保留成员知情能力。
内置套件无需管理员额外操作，但无法由企业端修改或删除。
不再使用的套件请及时停用或删除，并同步清理关联的下发策略。
积分消耗提醒
套件的浏览、上传和管理不消耗积分；成员在客户端中安装、调用套件内的能力执行任务时，由客户端根据任务内容消耗相应积分。
第三方共享
企业自建套件的内容由企业管理和控制，不会共享给平台外第三方。
内置套件由平台提供和维护，遵循平台的数据管理策略。
套件内连接器的外部调用能力取决于套件包内的配置（mcp.json 等），不在企业管理范围内。
免责声明
企业自建套件的内容准确性和安全性由上传者负责，WorkBuddy 不对套件包内脚本的执行结果承担责任。
内置套件由平台维护，其功能的可用性和准确性取决于平台更新策略。
强制下发的套件在成员客户端的安装与展示由企业策略决定，企业应确保策略配置符合成员的实际使用需要。
使用建议
套件标识由 plugin.json 的 name 决定且企业内唯一，打包前先确认命名规范，避免重名导致无法上传。
下发策略配置后建议使用“权限查询”功能验证生效结果，确认目标成员获取了正确的套件权限。
强制下发与可见范围的交集为空时套件无人可见，配置组合策略前建议先用“查看说明示例”核对场景。
定期审查已上线的套件列表和下发策略，清理不再使用或过期的套件，保持企业空间中套件的质量和可维护性。
批量操作前确认选中范围，避免误操作影响生产环境中的成员使用。
