spark-recipe-label-organize

配方：整理标签和文件夹

使用标签和文件夹整理邮件。添加项目标签、移除错误的标签，并将归档错误的邮件移至正确位置。

**前提条件：**阅读 use-spark 基础技能，了解命令参考和筛选语法。

**所需访问级别：**triage。

步骤

步骤 1：查看当前文件夹和标签结构

spark folders

针对特定账户：

spark folders [email protected]

记录现有标签及其邮件数量。找出空标签或不再相关的标签。

步骤 2：识别需要添加标签的邮件

搜索应添加项目或主题相关标签的邮件：

spark search "project name"
spark emails --filter "from:[email protected] newer_than:30d"

步骤 3：添加标签

为邮件添加标签，但不将其移出当前位置：

spark action attachLabel <id> --folder "[email protected]:ProjectAlpha"

批量为多封邮件添加标签：

spark action attachLabel <id1> --folder "[email protected]:ProjectAlpha"
spark action attachLabel <id2> --folder "[email protected]:ProjectAlpha"

步骤 4：移除错误的标签

移除错误添加的标签：

spark action detachLabel <id> --folder "[email protected]:WrongLabel"

步骤 5：移动归档错误的邮件

将邮件移至正确的文件夹：

spark action moveToFolder <id> --folder "[email protected]:Projects"

步骤 6：验证

浏览整理后的标签，确认邮件归属正确：

spark emails [email protected]:ProjectAlpha

提示

• 使用 folders 查找标签的准确限定名称（例如 [email protected]:MyLabel）。
• attachLabel 会添加标签，但不会移动邮件——邮件仍会留在当前文件夹中。这就是 Gmail 标签的工作方式。
• detachLabel 会移除标签，但不会将邮件移动到其他位置。
• moveToFolder 会将邮件实际移动到另一个文件夹——用于 IMAP 风格的整理。
• 对于 Gmail 账户，优先使用 attachLabel/detachLabel，而不是 moveToFolder，因为 Gmail 使用标签而非文件夹。
• 共享收件箱的标签格式为 [email protected]:LabelName 或 "Team Name:LabelName"。
• 可结合 recipe-meeting-prep 或项目跟踪工作流，在更大型的流程中为邮件会话添加标签。
• 定期运行此配方，以便在收到新的相关邮件时及时更新项目标签。