smailr-mail-assistant-v2.1

Smailr 邮件助手 v2.0 新增功能清单

本次仅新增本地数据备份／恢复及其入口，现有邮件、写信、回复、多账户、提醒和样式逻辑均保留。

位置	新增内容
初始连接页	在“需要 API 密钥”右侧增加紫色 “备份数据登录”。点击后可直接选择备份文件恢复账户，无需逐个重新填写。
设置页	在“邮件地址备注”版块下方新增 “导入/导出数据”。
导出	生成 .smailrbackup 加密备份文件，并要求设置与再次确认备份密码。
导入	选择备份、输入密码、确认覆盖后恢复本机数据并同步当前账户。

---

smailr-mail-assistant-v2.0

Smailr 邮件助手 v2.0 新增功能清单

本清单汇总当前 v2.0 相对于基础版本逐步新增和完善的功能。除特别说明外，所有数据与状态均保存在当前浏览器扩展本地。

一、邮件查看与本地操作

功能	说明
邮件详情查看	在工具栏弹窗内点击邮件即可打开详情，查看发件人、收件人、时间和正文。
正文复制	邮件详情页提供“复制正文”按钮，可将可显示的邮件正文复制到剪贴板。
本地隐藏邮件	邮件列表右侧提供删除图标，可仅从插件列表隐藏邮件，不会删除、归档或修改 Smailr 服务端邮件。
本地已读联动	打开一封未读邮件后，列表小红点、未读数量、顶部提示和工具栏角标会同步减少。
已回复标记	在插件内成功回复某封邮件后，该邮件会在列表右侧显示“↩ 已回复”标记，位置在删除图标左侧。普通写信、取消发送或发送失败不会生成该标记。

二、写邮件与回复邮件

功能	说明
写邮件	主界面右上角提供“写邮件”入口，可选择发件邮箱并填写收件人、主题和正文。
发送确认	点击发送后，会再次展示发件邮箱和收件人并要求确认；确认后才调用 Smailr 发送接口。
直接回复	邮件详情页提供“回复”按钮，会自动预填原发件人地址、Re: 主题和原邮件引用内容。
发件账户保护	后台会验证所选发件邮箱属于当前账户，避免跨账户使用其他邮箱发信。
权限提示	如果 API 密钥缺少 mail:send，或者 Smailr 账户未获得发信权限，扩展会显示明确的失败提示。
回复状态记录	回复成功后，仅为当前账户、当前邮箱和对应原邮件保存“已回复”状态。

回复线程边界： 当前公开发送接口未提供 thread_id、in_reply_to 或 references 参数。因此扩展通过收件人、Re: 主题和引用正文提供标准回复体验；收件人侧是否合并为同一会话由邮件系统决定。

三、多账户管理与状态隔离

功能	说明
最多 8 个账户	可在设置页新增、切换和移除最多 8 个 Smailr API 账户。
账户快速切换	账户管理区域可直接切换当前账户；切换后仅加载该账户的数据。
账户名称修改	每个账户右侧提供铅笔图标，可修改默认“账户 1”等本地账户名称。
紧凑账户列表	账户名称和状态提示采用同行布局，减少设置页高度并保持清晰层级。
全面账户隔离	邮箱缓存、邮件备注、待提醒未读数、已确认邮件、本地隐藏邮件和已回复标记均按账户独立保存。
安全移除账户	从本机移除账户时，会一并清理该账户的本地缓存；不会影响 Smailr 原账户和服务器邮件。

四、新邮件提醒与未读联动

功能	说明
工具栏未读角标	发现待提示的新邮件时，浏览器工具栏显示未读数字角标。
规律闪动	有待提示新邮件时，工具栏角标按固定节奏闪动；数字状态变更时立即刷新。
邮件列表联动	未读邮件在列表中显示小红点，邮箱选择菜单和顶部状态文字同步显示对应未读信息。
单封确认	打开一封未读邮件后，只清除该邮件对应的一条本地提醒，不影响其他邮件。
一键清除提醒	点击主界面未读数字角标，可清除当前账户的本机提醒，不会改变 Smailr 服务端未读状态。
提醒隔离	账户 A 的阅读、清除提醒和未读角标，不会影响账户 B 的提醒状态。
颜色设置	工具栏未读角标支持红色和绿色两种颜色。
通知与声音	可分别控制系统通知和声音提醒；开启声音时会自动播放测试音，并可手动再次测试。

五、同步、性能与刷新控制

功能	说明
自定义轮询间隔	可选择 1、2、5、10 或 15 分钟作为后台检查间隔。
关闭自动检查	关闭后台检查后，扩展不会因定时器、启动或切换账户自动同步；只能通过主界面右上角刷新按钮手动更新。
手动刷新	随时可通过右上角刷新按钮强制读取当前账户的新邮件。
同账户请求合并	同一账户出现并发刷新请求时，扩展会合并为一次网络请求，减少不必要的 API 调用与内存占用。
账户级缓存	每个账户使用独立缓存作用域，切换账户时不会复用或串联另一账户的缓存结果。

六、邮箱显示与设置体验

功能	说明
邮箱地址备注	可为每个邮箱地址添加本地备注，备注显示在邮箱选择菜单中。
备注保存	邮箱备注集中编辑后通过“保存”按钮一次性写入本地设置。
文本溢出处理	邮箱名称、备注、邮件标题和账户名称均提供截断与悬停提示，避免布局溢出。
作者信息	设置页底部展示 Design by Evan，并链接至 evan.xin。
网页邮箱提示	“打开浏览器网页邮箱”会使用浏览器当前登录的 Smailr 网页会话，而不是扩展保存的 API 密钥；扩展会在打开前提示用户。

七、API 权限要求

使用场景	建议的 Smailr API 权限
查看邮箱与邮件	mailbox:read、mail:read
在插件内写邮件或回复邮件	mailbox:read、mail:read、mail:send

八、版本信息

项目	当前值
发布版本	v2.0
扩展清单版本	2.0.0
扩展标准	Manifest V3
数据保存方式	当前浏览器扩展本地存储

---

---

---