dootask/resources/ai-kb/zh/howto/org-department/add.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
org-department.add.howto	新建或修改部门	howto	org-department	admin	zh	新建部门 加部门 添加部门 创建部门 修改部门 改部门名字 加子部门			需要系统管理员权限（userIsAdmin）	部门名称必须 2-20 字，不能含特殊符号（`~!@#$%^&*()+-_=.:?<>,`）或字符串 `(M)` 部门层级最多 3 级，第 4 级会被接口拒绝 每个父部门最多 20 个直属子部门 全系统最多 200 个部门 不能选自己的子部门作为上级（防成环） owner_userid 必填且必须是有效用户；一个用户最多负责 10 个部门	v1.7.90

新建或修改部门

入口

• 桌面端：管理后台 → 团队管理 → 底部「+ 新建部门」按钮
• 桌面端：管理后台 → 团队管理 → 某部门行尾「⋯」→「添加子部门」或「编辑」
• 接口：GET api/users/department/add（限管理员）

操作步骤

1. 点击「新建部门」或某部门「⋯」→「编辑」
2. 填写部门名称（2-20 字，禁特殊符号）
3. 选择上级部门（可空，空即顶级部门）
4. 选择部门负责人（必填，单选）
5. 创建时可选部门群模式：
   • new（默认）：自动创建同名部门群
   • use：选一个已有用户群转为部门群（dialog_useid 必填）
6. 提交，成功提示「新建成功」/「保存成功」

校验规则

校验	说明
名称长度	2-20 字符（mb_strlen）
名称符号	禁正则 [\Q~!@#$%^&*()+-_=.:?<>,\E]
父部门层级	父部门的 parents 不能超过 2（实际最多 3 级）
子部门数量	每个父部门 ≤ 20 个直属子
全局总数	≤ 200 个部门
同一用户负责数	≤ 10 个部门

改部门负责人

传入 id + 新 owner_userid 即可；底层会自动转让部门群群主（role=1），原负责人 role 降为 0。

相关

• 任命部门管理员（多人）：org-department.add-deputy.howto
• 删除部门：org-department.delete.howto