PotatoChat 支持通过邮箱添加好友：在“联系人”或“添加好友”界面填写对方邮箱并发送邀请，对方通过邮件确认并在客户端接受后，即完成加好友流程。邮件邀请只携带必要的标识与验证信息，隐私可控，邀请可撤销或拉黑，适合个人与团队协作。
为什么用邮箱加好友？先把原理讲清楚
先说一个简单的事实：邮箱是最广泛的数字身份之一。很多人把邮箱当成“长期可联系的账号”，所以用邮箱发邀请既直观又容易被找到。PotatoChat 之所以支持通过邮箱加好友，是为了降低对方找到你的成本，同时在保证隐私的前提下完成身份验证和密钥交换。
核心思路（像讲给新手朋友听）
- 你发邀请：在客户端输入对方邮箱，PotatoChat 把一封包含邀请令牌（token）和公钥指纹的邮件发给对方。
- 对方确认：对方点邮件里的“接受”链接或在客户端收到提醒后确认，客户端会相互交换必要的元数据来建立信任。
- 建立联系：双方在本地保存对方的公钥和一些可选的联系人信息（昵称、头像），之后的消息走端到端加密通道。
一步步操作：用户视角（最实用的流程）
这里按你实际会用的顺序把每一步写清楚，像在教一个不懂技术的朋友。
发送邀请（你的操作）
- 打开 PotatoChat 的“联系人”或“添加好友”界面。
- 选择“通过邮箱添加”或直接输入邮箱地址。
- 可选地填写一段验证消息（简单说明是谁、为什么要加）。
- 点击“发送邀请”。客户端会生成邀请令牌并把它连同必要的公钥信息放到邮件里发出。
接收并确认（对方的操作）
- 对方在邮箱中收到来自 PotatoChat 的邀请邮件，邮件正文会说明邀请来源和接收后的动作。
- 对方点击邮件中的接受链接，或者在对方的 PotatoChat 客户端里看到“有人通过邮箱邀请你”为提醒并确认。
- 确认后，客户端之间会完成一次基于公钥的握手，双方成为联系人。
完成后你会看到什么
- 联系人列表新增该用户（可能显示邮箱、昵称或你保存的备注）。
- 会话界面可直接开始加密聊天。第一条消息通常会有“已验证”的提示，或者让你核对指纹。
技术与隐私细节（多问几步，别被表面迷住）
这里有点干货，但我尽量把复杂的东西分解成简单问题来解答。
邀请里都包含什么？
- 邀请令牌（短期有效的随机字符串，用于证明这次邀请是有效的）。
- 发起方的公钥指纹或公钥摘要（用于后续的加密通信与身份核验）。
- 一些最小限度的元数据：用户名或昵称（可选）、应用版本、邀请过期时间。
邮件是明文的，隐私如何保证？
这点许多人会疑惑：邮件本身不是加密的，那么我是不是泄露了什么？
- 重要的秘密（私钥、消息内容）从不放在邮件里。邮件只传递一段短期令牌与公钥指纹。
- 即便邮件被第三方看到，也无法伪装成你完成最终握手，因为握手需要本地私钥的签名。
- PotatoChat 推荐在设置里控制邮件能显示的联系人信息（如昵称、头像等），你可以选择最小化共享。
客户端如何验证“这真的是某某人”
验证通常分两步：
- 自动验证：通过邀请令牌和公钥指纹自动完成一次基本信任链，适合日常场景。
- 人工核验（可选）：查看双方的公钥指纹或扫描二维码，线下或语音确认，用于高安全需求的场景。
常见问题与故障排查（遇到时别慌）
我把常见问题列出来，带上简短的解决方法，像备忘录一样。
- 邮件收不到：检查垃圾箱、筛选规则、确认邮箱地址拼写正确，企业邮箱可能拦截自动邮件；让对方从邮箱管理员处白名单 potatochat 的发信域名。
- 邀请过期：邀请通常设有有效期（例如 24 小时），过期后重新发送即可。
- 握手失败：检查双方的客户端是否为最新版本，网络是否被代理或防火墙阻断；有时因为时间差导致令牌校验失败，重发邀请是最快的办法。
- 已经是联系人但看不到昵称或头像：对方可能没有允许共享，或者你本地缓存未刷新，尝试重新同步联系人或让对方在设置中允许共享。
表格速览：通过邮箱加好友的关键步骤
| 步骤 | 操作 | 备注 |
| 1 | 在客户端输入对方邮箱并发送邀请 | 可附简短验证消息，避免被误删 |
| 2 | 对方通过邮件或客户端接受邀请 | 邮件仅含令牌与指纹；不传私钥 |
| 3 | 客户端完成公钥握手并建立联系人 | 生成本地联系人条目并开始加密会话 |
| 4 | 可选：核对公钥指纹或线下验证 | 用于高安全场景 |
企业和团队使用时需要注意的点
在公司环境下，邮箱通常与身份管理系统绑定。这会带来一些便利和额外的配置需求：
- 统一域名策略：管理员可以允许公司域名的邮件自动信任或通过 SCIM/SSO 做额外绑定验证。
- 联系人同步策略：企业可设置是否允许员工导入通讯录或使用“发现联系人”功能。
- 审计与合规：PotatoChat 的设计通常避免把聊天内容存储在服务器，但企业可能需要审计元数据，需根据隐私政策平衡。
安全建议（几条真心话）
- 不要在邀请邮件中写敏感信息。邀请只需标识身份和目的，任何账户或私密信息都不应在邮件正文出现。
- 核对指纹。在重要联系建立后，最好通过电话、面谈或其它可信渠道核对公钥指纹。
- 谨慎处理一次性邮箱或公用邮箱。这些邮箱可能被多人访问，建议使用个人或公司受控邮箱。
- 如果不认识发起者、邮件很奇怪，就别点接受链接。
一些场景例子（帮你想清楚怎么用）
- 朋友之间：直接用个人邮箱加，省去手机号互换的尴尬。
- 跨组织合作：用工作邮箱加为同事或外部合作者，便于建立受信任的沟通通道。
- 临时活动联络：活动组织者可以通过邮件群发邀请，参与者确认后形成私密群聊。
实操小提示
- 发送邀请前写一句短说明（比如“我是小张，在XX项目”），能显著提升通过率。
- 如果对方没收到，先让对方在客户端“搜索邮箱”，有时客户端能直接发现已有用户并跳过邮件。
- 保持客户端更新，很多握手或兼容性问题都是因为版本差导致。
写着写着我又想到一个事：如果你是产品或管理员，设计邮箱邀请功能时最好把隐私设置做成默认最小化共享，同时提供明确的撤回与举报路径，这样既方便用户又能降低滥用风险。嗯，好像该停笔了，这些都是我在用过类似产品后总结的点，希望对你直接去尝试 PotatoChat 的邮箱加好友功能有用。