默认工具配置

组织级默认工具配置，支持 Bot、Plugin 与快捷命令的新建空间自动初始化和手动推送

默认工具配置

功能概述

组织管理员可以配置默认的 Bot、Plugin 和快捷命令，使新建工作空间能够开箱即用。组织级配置会与平台级默认工具合并生效，并支持手动推送到已有工作空间。

权限说明：仅组织管理员可使用此功能。

默认工具

核心概念

继承机制

普通新建工作空间时，系统会合并平台级与组织级中标记为“新建空间默认添加”的配置。Bot 按同一个 Bot ID 去重，组织级配置覆盖平台级配置。未标记的工具不会自动添加到新空间，但仍可手动推送。

从模板创建空间时不读取平台级或组织级默认工具。空间内包含哪些 Bot、哪个 Bot 是默认 Bot，完全由模板声明的绑定和默认标记决定。

幂等新增原则

推送逻辑始终为"已存在则跳过，不存在则新增"
Plugin 按 pluginId 判重，QuickCommand 按 name 判重，Bot 按 botId 判重
默认不会删除或修改工作空间已有的配置
可开启“强制更新”模式，仅覆盖工作空间中已有的同名快捷命令；Plugin/Bot 绑定和空间默认 Bot 不会被覆盖

默认 Bot 优先级

平台级和组织级都可以配置多个 Bot，但每个作用域内最多只能有一个默认 Bot 配置。
普通新建空间或推送补绑定时，如果空间已有默认 Bot，则原默认标记保持不变。
空间尚无默认 Bot 时，有效组织级默认 Bot 优先；组织级默认不存在或已失效时，使用有效平台级默认 Bot。
平台级仅允许选择 PUBLIC 且已发布的 Bot；组织级允许 PUBLIC 已发布 Bot 或本组织 INTERNAL 已发布 Bot，PRIVATE Bot 不允许。
跨组织公开 Bot 的启用插件必须满足市场公开可用要求；配置失效时初始化或推送会跳过该 Bot，并在结果中给出原因。
停用的 Bot 配置不参与普通新建空间自动初始化；手动推送不受该开关限制，仍可显式推送到指定工作空间。

推送与自动添加的区别

操作	触发方式	影响范围	受"新建空间默认添加"开关控制
自动添加	系统在创建工作空间时自动执行	仅新建的工作空间	是
手动推送	管理员主动选择工作空间并推送	指定的已有工作空间	否，所有配置均可推送

使用方法

1. 进入配置

组织详情页 → 默认工具。默认工具内的 Tab 顺序为：默认 Bot → 默认 Plugin → 默认快捷命令。

2. 添加默认 Bot

在“默认 Bot”Tab 点击“添加 Bot”
搜索框仅在按下 Enter 后发起搜索，输入过程中不会自动请求
可选择公开 Bot 或本组织已发布的内部 Bot
可设置多个默认 Bot 绑定，并通过单选操作切换当前作用域的唯一默认 Bot
支持启停、上移/下移排序和删除

3. 添加默认 Plugin

点击"添加 Plugin"从 Plugin 列表中选择
可选择公开 Plugin 或本组织的内部 Plugin
每个工具可通过开关控制是否在新建空间时自动添加
支持删除操作

4. 添加默认快捷命令

点击"添加快捷命令"创建新的默认命令
填写名称、图标、分类、提示词模板、变量定义
支持编辑、删除操作
每个命令可通过开关控制是否在新建空间时自动添加
支持通过 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: 100

5. 推送到工作空间

点击"推送到工作空间"按钮
可选择全部工具或指定工具进行推送
目标范围仅限本组织下的工作空间
最多同时选择 500 个工作空间
支持按名称关键字和分类关键字筛选工作空间
推送对话框中，未开启"新建空间默认添加"的工具会显示"非默认"标签，但仍可正常选择推送
推送结果会展示 Bot 新增数、跳过数、逐项跳过原因，以及默认 Bot 已设置或已保留的状态

推送默认工具