工作空间模板

了解可用的工作空间模板及其适用场景，掌握模板资源的初始化和同步机制

工作空间模板

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

模板概览

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

模板适用场景预配置内容
空白模板完全自定义无
团队协作团队日常沟通协作规范、沟通 Agent
项目管理项目执行任务管理、进度追踪
知识管理知识库建设文档结构、整理 Agent

模板初始化的资源

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

知识库文件

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

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

场景视图

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

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

快捷命令

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

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

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

Plugin 绑定

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

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

共享知识库引用

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

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

任务类型配置

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

  • 类型名称、图标、颜色
  • 允许的子类型（allowedChildren）
  • 状态定义（statuses）
  • 排序和系统标记

成员

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

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

工作空间元数据

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

字段说明
空间指引（guideline）模板的工作指引内容
分类（category）优先使用创建时指定的分类，否则继承模板分类
模板来源（templateSource）记录来源模板 ID，用于后续推送同步
模板版本（templateVersion）记录创建时模板的版本时间戳

创建自定义模板

从现有工作空间转换

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

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

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

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

从空白开始创建

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

模板推送到子空间

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

操作入口

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

同步策略

推送支持两种同步策略：

策略类型说明同步的资源
覆盖类直接替换子空间的值空间指引、分类标签、默认模型
增量类仅添加不存在的项成员列表、Plugin 绑定、快捷命令
智能合并已存在则更新，不存在则创建任务类型配置
目录同步rsync 增量同步知识库目录内容（含共享知识库软链接）

目录同步

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

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

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

模板类型说明

类型说明可编辑
系统预设模板平台提供的标准模板仅支持查看和克隆
自定义模板用户创建的模板支持完整编辑

版本管理

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

相关文档

工作空间模板 | Knodo 文档