默认工具配置
组织级默认工具配置,支持新建工作空间自动初始化和手动推送
默认工具配置
功能概述
组织管理员可以配置默认的 Plugin 和快捷命令,使新建工作空间能够开箱即用。同时支持手动将默认工具推送到已有工作空间。
权限说明:仅组织管理员可使用此功能。

核心概念
继承机制
新建工作空间时,系统会自动根据组织级的默认工具配置进行初始化。仅标记为"新建空间默认添加"的工具会自动初始化,未标记的工具不会自动添加到新空间,但仍可手动推送。
幂等新增原则
- 推送逻辑始终为"已存在则跳过,不存在则新增"
- Plugin 按 pluginId 判重,QuickCommand 按 name 判重
- 默认不会删除或修改工作空间已有的配置
- 可开启"强制更新"模式,覆盖工作空间中已有的同名配置
推送与自动添加的区别
| 操作 | 触发方式 | 影响范围 | 受"新建空间默认添加"开关控制 |
|---|---|---|---|
| 自动添加 | 系统在创建工作空间时自动执行 | 仅新建的工作空间 | 是 |
| 手动推送 | 管理员主动选择工作空间并推送 | 指定的已有工作空间 | 否,所有配置均可推送 |
使用方法
1. 进入配置
组织详情页 → 默认工具 Tab
2. 添加默认 Plugin
- 点击"添加 Plugin"从 Plugin 列表中选择
- 可选择公开 Plugin 或本组织的内部 Plugin
- 每个工具可通过开关控制是否在新建空间时自动添加
- 支持删除操作
3. 添加默认快捷命令
- 点击"添加快捷命令"创建新的默认命令
- 填写名称、图标、分类、提示词模板、变量定义
- 支持编辑、删除操作
- 每个命令可通过开关控制是否在新建空间时自动添加
- 支持通过 YAML 文件批量导入导出
YAML 导入导出
- 导出:点击"导出"按钮,将当前所有默认快捷命令下载为
.yaml文件 - 导入:点击"导入"按钮,上传
.yaml文件批量创建快捷命令 - 导入时同名命令会自动跳过,并在结果中提示跳过的命令名称
- YAML 格式示例:
quickCommands:
- name: "生成 PPT"
icon: "📊"
category: "文档转换"
description: "基于主题或知识库文件生成演示文稿"
promptTemplate: "请使用 pagecraft 工具帮我生成一份 PPT..."
variables:
- name: "topic"
label: "演示主题"
type: "text"
required: true
isActive: false
sortOrder: 1004. 推送到工作空间
- 点击"推送到工作空间"按钮
- 可选择全部工具或指定工具进行推送
- 目标范围仅限本组织下的工作空间
- 最多同时选择 100 个工作空间
- 支持按名称关键字和分类关键字筛选工作空间
- 推送对话框中,未开启"新建空间默认添加"的工具会显示"非默认"标签,但仍可正常选择推送
