工作空间模板

工作空间模板帮助您快速创建预配置的工作空间。基于模板创建工作空间时，会自动初始化一系列资源，免去重复配置。

模板入口会先展示模板信息弹框，包含资产摘要和可执行操作；只有明确点击“编辑模板”才会进入模板空间编辑页。模板包支持导出为仅包含结构化配置的 ZIP，也支持导入前预检依赖、重新检查和确认导入。导入不会携带密钥、个人凭证、源码、知识库内容、目录文件或运行数据。

模板概览

Knodo 提供以下工作空间模板：

模板初始化的资源

从模板创建工作空间时，以下资源会自动从模板复制到新工作空间：

知识库文件

模板的全部知识库文件（Git 仓库内容）会被复制到新工作空间，包括：

• 目录结构和所有文件
• Markdown 文档、代码文件等
• 不保留 Git 提交历史（全新仓库）
• 排除 .git 目录

场景视图

模板中配置的所有场景视图会被克隆，包括：

• 视图名称、图标、排序
• Prompt 配置
• 父子层级关系完整保留（两阶段克隆：先创建节点，再更新父 ID）

快捷命令

模板中的所有快捷命令会被批量克隆：

• 命令名称、图标、分类、排序
• 提示词模板和变量定义
• 描述信息
• 克隆后的命令标记为用户自定义命令（非系统命令）
• 使用计数重置为 0

注意：链接类型命令（commandType='link'）和附件类型变量也会被克隆。

Plugin 绑定

模板绑定的所有 Plugin 会被复制到新工作空间：

• Plugin ID 和配置覆盖（configOverride）
• 绑定后新工作空间即可使用模板推荐的 AI Agent 和技能

共享知识库引用

模板中引用的共享知识库会被同步到新工作空间：

• 共享知识库 ID、本地路径、容器路径
• 自动更新共享知识库的引用计数

任务类型配置

模板中的任务类型配置会被批量克隆：

• 类型名称、图标、颜色
• 允许的子类型（allowedChildren）
• 启用的自定义字段（enabledCustomFields）
• 隐藏的内置字段（hiddenBuiltinFields）
• 状态定义（statuses）
• 排序和系统标记

任务自定义字段会与任务类型配置一起初始化，但两者是两个独立步骤：

1. 复制自定义字段配置：复制字段名称、唯一 key、字段类型、选项、是否必填、排序和启用状态等定义。
2. 复制任务类型的启用字段关系：将模板任务类型中 enabledCustomFields 引用的字段 ID 映射为新工作空间中的字段 ID，确保任务类型仍启用了正确的自定义字段。

标签和优先级配置也会随模板初始化和模板包迁移，包括选项值、颜色、排序和启用状态；它们保存在模板包 assets/tasks.json 的 fieldConfigs 分区，不会与自定义字段定义混合。

成员

模板中的成员会被自动添加到新工作空间：

• 仅添加属于目标组织的成员（非组织成员会被跳过）
• 保留原有角色（admin / editor / viewer）
• 创建者自动被设为 admin（即使已通过模板成员添加，也会确保为 admin）

工作空间元数据

以下元数据会从模板继承到新工作空间：

Bot 绑定与定时任务

模板只保存 Bot 的组织内稳定 botSlug。创建空间或推送到子空间时，平台按“组织 + slug”恢复绑定；找不到 Bot 时会作为依赖提示，不会按名称或数据库 ID 猜测。

模板中的定时任务定义可以随模板包导出和预检。创建空间后任务默认处于待确认/未启用状态，不会自动注册调度；缺少 Bot 或视图依赖时必须先处理依赖，避免新空间创建后误触发任务。

创建自定义模板

从现有工作空间转换

如果您已经有一个配置完善的工作空间，可以将其转换为模板：

1. 进入目标工作空间
2. 在当前空间 Header 点击齿轮设置图标，进入工作空间设置
3. 在"基本信息"弹框中找到"转换为模板"选项
4. 确认转换

转换时，以下资源会被复制到新模板中：

• 场景视图（含父子关系）
• 快捷命令（重置使用计数）
• Plugin 绑定（含配置覆盖）
• 知识库文件（不保留 Git 历史）
• 空间指引、分类等元数据

从空白开始创建

1. 在工作空间创建界面选择"创建模板"
2. 填写模板名称和描述
3. 配置场景视图、快捷命令、工作指引
4. 绑定推荐的 Plugin
5. 填写可选的 newChatGuide 和 setup prompt
6. 保存模板

已创建模板的 setup prompt 也可以在模板空间的“设置 → 基本信息”中维护；保存后后续从模板创建的空间使用最新内容。

模板推送到子空间

当模板配置更新后，管理员可以将变更批量推送到基于该模板创建的子空间。

操作入口

进入模板工作空间 → 空间设置 → 推送到子空间 Tab

同步策略

推送支持两种同步策略：

目录同步

目录同步支持两种类型的内容：

• 普通目录：使用 rsync 增量同步文件内容，并自动生成 Git 提交
• 共享知识库软链接：创建相同的软链接路径，并同步 SharedKBReference 元数据

详细操作步骤请参阅 模板推送到子空间

任务自定义字段同步

模板推送中的任务配置同步同样分为两个步骤：

• 自定义字段配置：按空间内唯一的 key 匹配。目标空间不存在时新增，已存在时更新模板字段定义；目标空间中模板未定义的自定义字段会保留，不会被删除。
• 任务类型启用字段：按任务类型名称合并，并将模板的字段引用转换为目标空间字段 ID，避免直接复用模板空间的字段 ID。

因此，基于模板创建空间和推送模板到已有子空间，都会同时同步“字段定义”和“任务类型启用哪些字段”这两部分配置。该同步只处理配置，不会复制已有任务记录中的自定义字段值。

模板类型说明

版本管理

• 模板更新后，已创建的工作空间不会自动同步
• 管理员可通过推送到子空间功能，将模板配置批量同步到子空间
• 支持选择性推送：可灵活选择需要同步的配置项和目标子空间

相关文档

• 创建第一个工作空间
• 工作空间管理
• 工作指引详解
• 模板推送到子空间
• 快捷工具