dootask/resources/ai-kb/zh/howto/system-setting/column-template.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
system-setting.column-template.howto	列模板（创建项目预置列）	howto	system-setting	admin	zh	列模板 项目模板 默认看板列 预置列 新建项目选模板 项目预设 看板模板			需要系统管理员权限（普通用户只能 get 读取）	模板只控制「初始列」，不能预置任务卡、流程、负责人等其他内容 不支持按部门 / 项目分类区分模板 修改模板不会影响已创建项目，仅影响后续新建 保存时空 list 或 list 中没有合法条目会报「参数错误」/「参数为空」	v1.8.89

列模板（创建项目预置列）

入口

桌面端：左上角头像 →「系统设置」→「项目设置」→「项目模板」。 对应后端：POST api/system/column/template，type=get 读取，type=save 写入（限 admin）。

是什么

创建新项目时，用户可以从一组预置「列模板」里挑一个直接套用，省去手动建列。模板就是「模板名 + 列名清单」。

例如内置一个「研发任务」模板：

• 列：待办、进行中、待测试、已完成

新建项目时勾选这个模板，项目就自动有这 4 列。

字段结构

保存时上传 list 数组：

[
  {
    "name": "研发任务",
    "columns": "待办,进行中,待测试,已完成"
  },
  {
    "name": "市场活动",
    "columns": "策划,执行中,复盘"
  }
]

• name — 模板名（必填）
• columns — 逗号分隔的列名字符串，服务端会按 , 切分 → 去重 → 去空，落库为数组

任何缺 name 或 columns 的条目会被服务端跳过；最终为空数组直接报「参数为空」。

操作步骤

1. 进入「项目设置」tab 的「项目模板」区块
2. 「新增模板」→ 填写模板名
3. 在列输入框输入列名（多个用逗号分隔）
4. 重复添加多个模板
5. 点击页面底部「提交」，与同页项目设置一起保存并立即生效

删除某一行时点击最右侧的删除图标并确认；删除先保留在当前表单中，点击「提交」后才会生效，点击「重置」可撤销未提交的删除。系统至少保留一个项目模板。

与项目创建的关系

用户「新建项目」对话框 →「选择模板」下拉就是这里维护的列表。选某个模板后，项目创建时按列名顺序生成空列，无任务卡。

不支持

• 不能模板化「任务流程」、「负责人」、「成员」、「自定义字段」
• 不能跨终端导出/导入模板
• 修改模板不会回溯到已创建的项目（仅对新项目生效）