Feature Groups zh

English · Tiếng Việt · 中文

Account groups（账户分组）

从 0.1.3 起：给你的账户建立带名字、颜色/emoji 的「文件夹」，外加一些 group 可以下发给其成员的设置。

解决什么问题

一旦账户超过两三个，「全部堆在一个平铺列表里」就不再是有条理的做法了。 Group 让你把账户聚成一类——工作、个人、客户——按 group 过滤统一收件箱，并且 （对其中一个设置，见下文）避免要在一个集群里的每个账户上都重复配置同一个出 口。

位置

Settings ▸ Groups。 查看 group 列表对每一个已登录用户开放（viewer 及以上）；创建、编辑、删除、排序和重置 group 是 operator 的操作。见 用户与角色。

创建和编辑一个 group

一个名字（必填）、一个颜色和一个用于侧边栏的 emoji，外加一组创建/编辑表单 称之为「共享」的设置：一个出口指定（代理、WireGuard 隧道或 relay）、一 个同步深度，以及一个通知开关。每个字段都是独立打补丁的——请求里省 略某个字段就保持不变。

什么真正从 group 继承，什么只是看起来如此

这是这一页最值得仔细读的地方，因为上面这三个「共享」设置的行为并不一样：

• 出口是真正的继承。 解析一个账户的出口（它的 IMAP 连接实际通过哪个代 理、隧道或 relay 拨号）时，会先检查账户自己的指定，如果账户没有自己的指 定，才回落到它所在 group 的指定——这是一次真实的、服务端的关联查询，每次 解析出口计划时都会用到：拨号时、点击 Test 时，以及账户卡片上显示的 IP。完整的出口模型见 Connections。
• 同步深度不会被继承，甚至不会影响 group 自己的账户。 group 的 sync_depth_days 字段会被保存并返回给 UI，但真正决定一个账户往回同步多 远的代码只读取账户自己的那一列——它根本不会去看账户所在的 group。把 一个账户加入某个 group 也不会把 group 的深度复制到那个账户上。实际上这 个字段只是摆在那里；对应的按账户发现见 Accounts 和 同步与同步健康。
• 通知开关会被保存，但从不会被读取。 group 的这个开关会持久化到一个 notify_policy 列，而发送通知的代码（channel 路由、Watchtower 告警、按 账户推送）里没有任何一处会读取它。它看起来像是一个整组静音开关；实际上 它没有接到任何东西上。真正控制通知的开关是按账户的——见 Notifications。

排序、计数和重置

• 对 group 排序，以及对一个 group 内的账户排序，都是拖放动作，保存 为一个 sort_order——只用于显示。
• 侧边栏的 group 过滤器会在每个 group 名字旁边显示一个实时的、按 group 统计的邮件数量。
• Reset 提供两种模式：unassign 清空每一个 group（账户回落到未分组 状态，group 本身保留）或者 delete 彻底删除每一个 group。不管哪种方 式，账户凭证和缓存的邮件都不受影响——只有分组关系受影响——而且它作为一个 事务运行，所以要么全部完成要么全部不做。曾经从所属 group 继承出口的账 户，之后会立刻让它们池化的 IMAP 连接失效，这样下一次拨号就会反映账户新 的（未分组的）出口，而不是悄悄继续复用一个仍然走着旧 group 代理的连接。
• Reset 只作用于你自己的 group。它以前会重置整个实例，不管是谁按下按 钮——这是 1.12.0 修复的跨用户问题之一，见用户与角色。

删除单个 group

只删除这个 group。它的账户会被解除关联（group_id 被清空），绝不会被删 除——它们的凭证和缓存的邮件完全不受影响。

限制

起始版本	0.1.3
角色	viewer 可查看列表；operator 可创建/编辑/删除/排序/重置
层级限制	Community 2 · Sponsor 5 · Pro 无限制——见 Plan and license
真正继承的	只有出口（代理/隧道/relay）
保存但未使用	同步深度、通知开关
归属	group 自 1.10.0 起按用户划分；group 能指向的出口端点本身仍然属于整个实例

它不做什么

• 不会把一个同步深度默认值下发给成员账户。 请在账户自己身上设置它的同 步深度。
• 不会为其成员静音或路由通知。 这个开关只存在于 UI 和数据库里，别处都 没有。
• 删除一个 group 绝不会删除或重新配置它的账户——只会解除关联。
• group 不会跨用户携带出口端点。 group 自 1.10.0 起按用户划分，而一个 group 能指向的代理/隧道/relay 仍然属于整个实例——如果你管理一个多用户共 享的实例，这一点值得知道。

另请参阅

• Accounts —— 添加、编辑，以及按账户的同步深度默 认值
• Connections —— 完整的出口模型，包括上面提到的 group 回落机制
• 同步与同步健康 —— 为什么同步深度不会从一个设 置传播到一个邮箱
• Notifications —— 通知的把关逻辑实际在哪里
• Plan and license —— Community/Sponsor/Pro 的 group 数量限制
• 用户与角色 —— Reset-groups 的跨用户修复

---

SkimMail · skimmail@base101.app · 2026-09-15 · commit dffbb18