linear权限管理采用“工作区级权限+团队级覆盖”双层模型,通过角色分配、项目归属、议题隐私设置及自动化规则实现细粒度控制,并支持api导出权限快照用于审计。

在Linear中设置权限管理,是为了控制团队成员对项目、工作区、议题和文档的可见性与操作范围,防止敏感信息泄露或误操作影响协作流程。
确认工作区权限模型
Linear默认采用“工作区级权限 + 团队级覆盖”的双层模型。新工作区创建后,所有成员初始为“Member”角色,但无法访问未被明确分配的团队或项目。
进入Settings → Workspace → Permissions,查看当前启用的权限模式:若显示“Team-based permissions”,说明已启用细粒度控制;若为“Legacy permissions”,需先切换——【切换后不可逆,且会重置所有团队级权限设置】。
设置团队成员角色
Linear中只有三种内置角色:Guest、Member、Admin。角色权限不能自定义,但可按团队分配:
方法一:通过团队页面批量设置
打开Team → Members → 点击右上角“Invite or manage members” → 找到目标成员 → 下拉选择角色 → 保存。
方法二:通过工作区成员页逐个调整
Settings → Workspace → Members → 找到用户 → 点击其当前角色标签 → 选择新角色 → 确认。注意:将Member降为Guest会立即移除其对所有私有项目的访问权,包括已订阅的议题。
控制项目与议题的可见范围
项目是Linear中最小的权限隔离单元。每个项目必须归属一个团队,且仅对该团队及其上级团队(如有)可见。
第一步:创建项目时指定所属团队
点击“+ New project” → 填写名称后,下拉选择“Team” → 仅可选你有管理权限的团队。
第二步:修改已有项目归属
进入Project Settings → General → Team → 更换团队 → 保存。该操作会自动移除原团队成员的访问权限,并向新团队所有成员开放(除非他们角色为Guest)。
第三步:手动限制议题可见性(仅限Admin)
打开任意议题 → 右侧栏“Privacy” → 点击“Make private” → 输入最多5个成员或团队名称 → 确认。此操作不改变项目归属,但使该议题仅对指定对象可见。
配置自动化权限规则
Linear不提供基于属性(如标签、状态)的动态权限策略,但可通过Workflow Automation间接实现部分控制:
例如:当议题被标记为“security-sensitive”时,自动移出公开项目并归档到专用安全团队项目。
操作路径:Settings → Automation → Create automation → Trigger: “Label added” → Condition: label is “security-sensitive” → Action: “Move to project” → 选择安全团队下的私有项目。
注意:Automation无法触发权限变更类动作(如更改成员角色、设置议题隐私),仅支持移动、标记、通知等操作。
导出与审计权限配置
Linear不提供内置权限报告功能,但可通过API导出完整权限快照:
使用GraphQL API调用以下查询(需Personal Access Token且具备admin scope):
`query { workspace { members { user { name email } role teams { name } } } }`
将返回JSON结果保存为权限基线文件,建议每周执行一次并比对diff。这一步做完即可结束。











