成员与角色
项目权限的两套开关：治理权限与模块访问级别，以及部门标签、最后管理员保护
适用角色：查看需「查看项目」；换成员角色需「管理成员」；改角色定义需「管理角色」 · 最后更新：2026-07-30 · 约 5 分钟
「他为什么看不到缺陷模块？」「为什么有权限改设置的人反而动不了需求？」——十有八九是把项目权限的两套开关混为一谈了。这篇讲清楚它们怎么分工。
一个角色，两套权限
每个项目角色身上有两套互不重叠的权限：
- 治理权限
- 管「项目本身」：项目设置、成员、角色、验收配置、工作流配置、审计。
- 模块访问
- 管「业务数据」：需求、需求室、甘特排期、缺陷、里程碑、文档六个模块，每个模块单独一档。
这六个模块名与项目左侧导航一一对应——导航里有的模块，权限矩阵里就有同名的一行。
两套互不越界：模块全 manage 的角色照样改不了项目设置；拿满治理权限的角色，若「需求」模块是 none，连一条需求都看不到。
模块访问的四个级别
- none 不可见
- read 只读
- edit 可编辑
- manage 可管理
- none：导航里直接看不到该模块，直连也会被拒。
- read：看、搜、下载。
- edit：创建、编辑、评论、传附件、普通流转——日常干活够用。
- manage：再加删除、批量操作、重新归属和高影响动作(比如应用排期传播、删里程碑)。
日常操作
- 看成员：「项目设置 → 成员管理」列出所有成员——邮箱、角色、部门标签、飞书绑定状态一目了然。
- 调角色：在同一页给成员换角色即换权限，立即生效。系统会拒绝把最后一个有管理能力的成员降级或移除——项目永远至少留一个能管事的人。
- 改角色定义：角色定义不在成员管理里，在隔壁的「项目设置 → 权限设置」——那张矩阵才是改治理权限与模块访问级别的地方。编辑模块访问时六个模块要整组提交(读出来、改一档、整组存回)，不存在「漏填就是不变」。
API Token 的权限从哪来
用 API Token(PAT)访问时，实际权限 = token 的 scope ∩ 你此刻的角色权限，每次请求实时计算：
- 只读 token 把六个模块全部钳到 read，写命令一律拒绝；
- 你的角色被降级，手里所有 token 立即跟着降，不需要吊销重发；token 永远做不了你本人在界面里做不了的事。
常见问题
- 为什么我看不到某个模块的导航入口？
- 你的角色在该模块是 none。这是刻意设计：无权限的模块整个隐藏，而不是点进去再报错。
- 403 了怎么区分「没权限看」和「只能看不能改」？
- 报错信息会区分这两种情况，按提示找管理员调对应模块的级别即可。
- 能给某个人单独开权限、不动角色吗？
- 不能。权限只挂在角色上——想精细化就建一个新角色。这保证权限审计只看角色一处。