受限域成员与名单模板
本文说明如何在 mdocs 里维护 restricted（受限）域 的成员，以及如何使用 域成员模板 减少重复勾选。与权限模型相关的设计背景见 域隔离。
谁能用这些功能
- 管理某受限域的成员：仅限该域的 创建者（你在域列表里对该域拥有完整操作按钮的那个人）。
- 创建 / 编辑 / 删除成员模板：当前登录访客自己的模板列表；模板数据按创建者隔离，其他人看不到你的模板。
公开域、个人域 没有「成员」名单能力：前者对所有人开放入口，后者只有域主一人。
UI 界面
域管理界面显示的域，都是用户可见的域. 公开域，团队成员的受限域，私域 （如果域中存在一篇文章邀请了别的用户，那么该域对那名用户也是可见的，哪怕是私域）
入口在哪里
点击应用左下角，包含用户头像的栏目
| 侧栏项（中文界面示例） | 作用 |
|---|---|
| 域管理 | 新建域、筛选域类型、对 受限域 打开「成员」维护弹窗 |
| 域成员模板 | 维护可复用的访客 ID 名单（名称 + 一套勾选结果） |
「活跃访客目录」来自服务端的访客列表接口：一般包含当前未停用的访客，用于左侧勾选。
创建受限域与首批成员
-
进入 设置 → 域管理。
-
在「新建域」里填写名称，类型选择 受限（restricted），提交创建。
-
创建成功后，你（创建者）会自动写入该域的
domain_members，无需额外操作。
之后团队其他成员要 完整进入该域（侧栏树、在域内 新建文档 等），需要由创建者把他们加进成员名单。
维护成员名单
- 在 域管理 表格中找到目标 受限域，且你仍是创建者。
- 点击 成员（或界面中与「管理成员」同义的按钮），打开 访客选择器 弹窗。
弹窗习惯用法：
- 左栏：当前可选的访客目录，支持搜索昵称或 UUID 片段；勾选即加入右侧。
- 右栏：即将保存的成员；每人显示完整 visitor_id（UUID），便于复制给队友核对。
- 域创建者 在行内会锁定，不能从名单中移除；服务端在保存时也会 自动把创建者并回名单，所以不要依赖「删掉创建者」来转让域。
保存时的规则简述：
- 只允许提交 在库里仍然存在的 visitor id；若包含从未注册过的 id，接口会报错，需对照 UUID 修正。
- 已停用 的访客若仍在历史成员里，界面可能以灰色或标签提示「停用」；创建者仍可保留这些 id 在名单中（是否保留由团队策略决定）。
仅从 左栏目录 勾选时，列表里只会出现 当前「活跃」访客。若某人已停用，但 曾经写入过成员表，打开弹窗时仍可能在 右栏 看到完整 UUID 与相应提示（数据来自成员接口，不依赖左栏是否展示）。
套用模板（在成员弹窗内）
弹窗顶部可选择 已有模板 并点击 套用：
- 会把模板里保存的访客 ID 与当前左栏目录求交集：只有 此刻仍在活跃目录里 的 ID 会被 追加 进右侧勾选（不会清空你已选的人）。
- 若模板里有 ID 暂不在目录（例如对方访客已停用），套用 不会 自动带上这些 ID；需要你改模板、或等对方恢复为活跃访客后再套用 / 勾选。
编辑某一模板时，选择器里 不会 把「当前正在编辑的这一条」放进套用下拉，避免无意义的自引用。
维护「域成员模板」
在 设置 → 域成员模板：
- 新建：填模板显示名称，用访客选择器（与域成员相同的双栏界面）选好一组人，保存。
- 编辑：在列表中选一条，改名称或人员后保存。
- 删除：删除前会有确认提示。
模板 不会 自动同步到任何域；只是在 域管理 → 成员 弹窗里作为「一键追加勾选」的快捷方式。真正生效仍以你在成员弹窗里 确认保存 后的结果为准。
与文档邀请的区别
- 域成员：决定谁能 完整进入 受限域（与创建者同级入口）、能否在该域 新建文档 等。
- 文档级邀请（
document_invites叠加层）：细到单篇文档。非域成员也可只被邀请到某几篇文档，此时在域侧往往是 受限入口，不能随意在域内开新档。详见 文档级邀请。
注意：邀请与域成员互斥——已是域成员的人不能被邀请。
设计取舍
- 受限域 mdocs偏向于小规模团队文档维护，在设计之初并未考虑引入组织架构的复杂管理能力。但很多场景下，存在团队成员这一概念，因此引入受限域，只允许团队成员进入
- 成员模板 项目不维护组织架构，因此受限域的域成员需要重复添加，为了解决该问题，引入成员模板导入功能，避免重复行为