CodeBuddy 套件管理

二、特征

三、关键区分

·内置套件：平台预置的套件，名称 / 描述 / 能力项由维护，企业仅可调整企业内的可见范围与启用状态。

·企业自建套件：企业管理员上传的组织专属套件包，包内能力项由系统自动解析，需配置可见范围（可选配下发策略）后对成员生效。

四、客户端浏览

套件作为客户端技能页下的二级分类“套件”“企业套件”页签展示。成员只能看到可见范围内的套件：未授权的套件不出现在列表中，被策略屏蔽的套件同样不展示。

注意：说明：

注意：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 资源管理 > 技能管理 > 分类管理中查看。

权限配置（可见范围）：

·所有成员（默认）：套件对企业内全员可见。

·部分成员：通过部门 / 成员树勾选可见范围，支持选择部门或成员。

保存方式：取消 / 仅保存（保存后不启用）/ 保存并启用。

九、步骤 2：设置下发策略

如果需要进一步限制或强制安装特定套件：

1. 进入下发策略标签页。

2. 单击 + 新建策略。

3. 选择策略类型并配置，详情请参见 下发策略。

4. 单击保存后策略即时生效。

十、套件列表

套件列表是管理的核心入口，提供套件的全生命周期操作。

十一、编辑套件

1. 在套件列表单击目标套件操作列的编辑。

2. 可修改：图标、套件名称、英文名称、归属部门、描述、英文描述、可见范围。

3. 不可修改：套件标识、所属市场、版本（均来自套件包，需更换套件包才能变更）。

4. 更换套件包：套件包区域显示当前包文件名、当前版本与大小，单击“更换套件包”重新上传 .zip；更换后系统重新解析能力项并更新版本号。

5. 单击保存并启用（或仅保存）完成。

十二、删除套件

仅企业自建套件可删除。单击操作列 删除，二次确认后执行。

注意：警告：

注意：删除后将同时移除套件包含的全部能力项，且无法恢复。

十三、内置套件管理

内置套件的名称 / 描述 / 能力项由维护，编辑页仅可调整企业内的可见范围（所有成员 / 部分成员），单击 保存可见范围 生效；启用状态请在套件列表的状态列中操作。

十四、新增内置默认状态

有“先审后用”管控诉求的企业，可配置后续新增内置套件的默认状态，避免每批新增内置套件都要逐个手动停用。

将套件列表的来源筛选切换到 内置套件 后，列表顶部展示“新增内置默认状态”卡片。卡片为只读，展示当前状态；单击 修改 在弹窗中编辑，保存后即时生效。

·默认启用：新增的内置套件下发后全员可用（与既有行为一致，为系统默认值）。

·默认禁用：新增的内置套件进入企业清单即为禁用态，管理员手动启用后成员可用；默认禁用的新增内置套件不下发至成员客户端清单。

十六、策略说明

进入下发策略标签页，页首展示策略说明：

十七、策略类型详解

系统提供三种显式策略；未命中任何策略的成员按“默认允许”处理：

限定策略

定义：指定成员仅能使用列表中的套件，列表之外的一律不可用。

适用场景：

·新员工入职，仅开放基础能力。

·外包人员访问受限套件集。

·合规要求限定可用能力范围。

屏蔽策略

定义：禁止指定成员使用列表中的套件，列表之外的仍按默认规则可用。

适用场景：

·高风险套件需要限制访问。

·敏感能力仅限核心人员。

·试用期限制高级功能。

强制下发

定义：将指定套件强制安装到范围内成员的客户端。选择该类型后，需在“强制下发选项”中选择一种方式：

十八、综合场景示例

以下为典型配置组合及成员侧实际结果；组合配置时建议核对“可见范围”与策略作用范围是否匹配。

20、信息收集与使用

类型判定标准：

·必要：使用套件管理核心功能时必须提供的信息（如企业账号、套件包内容、策略成员选择）。

·非必要：仅在成员客户端实际安装、使用套件时才涉及的数据。

21、权限边界

·管理员通过可见范围与下发策略控制成员能获取哪些套件，不直接干预成员在客户端中的实际调用行为。

·策略只能在套件“可见范围”内收窄，不能越级放开。

·内置套件由平台维护，企业仅可调整可见范围与启用状态，无法修改名称、描述与能力项。

·删除套件将同时移除全部能力项且无法恢复，删除前请确认。

22、安全提示

·上传套件包前请确认来源可靠，套件包中的技能脚本将在客户端沙箱中执行。

·强制下发的套件会自动安装到成员客户端，建议仅对经过审核的套件使用；含敏感能力的套件建议使用静默安装以外的默认方式，并保留成员知情能力。

·内置套件无需管理员额外操作，但无法由企业端修改或删除。

·不再使用的套件请及时停用或删除，并同步清理关联的下发策略。

23、积分消耗提醒

套件的浏览、上传和管理不消耗积分；成员在客户端中安装、调用套件内的能力执行任务时，由客户端根据任务内容消耗相应积分。

24、第三方共享

·企业自建套件的内容由企业管理和控制，不会共享给平台外第三方。

·内置套件由平台提供和维护，遵循平台的数据管理策略。

·套件内连接器的外部调用能力取决于套件包内的配置（mcp.json 等），不在企业管理范围内。

25、免责声明

·企业自建套件的内容准确性和安全性由上传者负责，WorkBuddy 不对套件包内脚本的执行结果承担责任。

·内置套件由平台维护，其功能的可用性和准确性取决于平台更新策略。

·强制下发的套件在成员客户端的安装与展示由企业策略决定，企业应确保策略配置符合成员的实际使用需要。

26、使用建议

·套件标识由 plugin.json 的 name 决定且企业内唯一，打包前先确认命名规范，避免重名导致无法上传。

·下发策略配置后建议使用“权限查询”功能验证生效结果，确认目标成员获取了正确的套件权限。

·强制下发与可见范围的交集为空时套件无人可见，配置组合策略前建议先用“查看说明示例”核对场景。

·定期审查已上线的套件列表和下发策略，清理不再使用或过期的套件，保持企业空间中套件的质量和可维护性。

·批量操作前确认选中范围，避免误操作影响生产环境中的成员使用。

27、声明

本节说明构成服务协议和隐私保护指引的组成部分，具有同等法律效力。如有不一致之处，以前述协议原文为准。