spark-recipe-label-organize

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Recipe: Label & Folder Organize

方案：标签与文件夹整理

Organize emails using labels and folders. Attach project labels, detach incorrect ones, and move misfiled emails to the right location.

Prerequisite: Read the

use-spark

base skill for command reference and filter syntax.

Access level required: triage.

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

前提条件： 阅读

use-spark

基础技能文档以获取命令参考和过滤语法。

所需权限级别： triage。

Steps

步骤

Step 1: Review current folder and label structure

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

bash

spark folders

For a specific account:

bash

spark folders user@example.com

Note the existing labels and their message counts. Identify labels that are empty or no longer relevant.

bash

spark folders

针对特定账户：

bash

spark folders user@example.com

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

Step 2: Identify emails that need labeling

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

Search for project-related or topic-related emails that should be labeled:

bash

spark search "project name"
spark emails --filter "from:client@company.com newer_than:30d"

搜索与项目或主题相关、需要添加标签的邮件：

bash

spark search "project name"
spark emails --filter "from:client@company.com newer_than:30d"

Step 3: Attach labels

步骤3：添加标签

Add a label to an email without removing it from its current location:

bash

spark action attachLabel <id> --folder "user@example.com:ProjectAlpha"

Label multiple emails in a batch:

bash

spark action attachLabel <id1> --folder "user@example.com:ProjectAlpha"
spark action attachLabel <id2> --folder "user@example.com:ProjectAlpha"

为邮件添加标签，而不将其从当前位置移除：

bash

spark action attachLabel <id> --folder "user@example.com:ProjectAlpha"

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

bash

spark action attachLabel <id1> --folder "user@example.com:ProjectAlpha"
spark action attachLabel <id2> --folder "user@example.com:ProjectAlpha"

Step 4: Detach incorrect labels

步骤4：移除错误标签

Remove a label that was applied incorrectly:

bash

spark action detachLabel <id> --folder "user@example.com:WrongLabel"

移除错误添加的标签：

bash

spark action detachLabel <id> --folder "user@example.com:WrongLabel"

Step 5: Move misfiled emails

步骤5：移动放错位置的邮件

Move emails to the correct folder:

bash

spark action moveToFolder <id> --folder "user@example.com:Projects"

将邮件移动到正确的文件夹：

bash

spark action moveToFolder <id> --folder "user@example.com:Projects"

Step 6: Verify

步骤6：验证

Browse the organized label to confirm the right emails are there:

bash

spark emails user@example.com:ProjectAlpha

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

bash

spark emails user@example.com:ProjectAlpha

Tips

小贴士

Use
```
folders
```
to discover the exact qualified names for labels (e.g.,
```
user@gmail.com:MyLabel
```
).
```
attachLabel
```
adds a label without moving the email - the email stays in its current folder too. This is how Gmail labels work.
```
detachLabel
```
removes a label without moving the email elsewhere.
```
moveToFolder
```
physically moves the email to a different folder - use this for IMAP-style organization.
For Gmail accounts, prefer
```
attachLabel
```
/
```
detachLabel
```
over
```
moveToFolder
```
since Gmail uses labels rather than folders.

Shared inbox labels use the format

shared@company.com:LabelName

"Team Name:LabelName"

Combine with
```
recipe-meeting-prep
```
or project tracking workflows to label threads as part of a larger process.
Run this recipe periodically to keep project labels current as new related emails arrive.

使用
```
folders
```
命令查看标签的完整限定名称（例如
```
user@gmail.com:MyLabel
```
）。
```
attachLabel
```
命令添加标签但不会移动邮件——邮件仍会保留在当前文件夹中。这与Gmail的标签工作方式一致。
```
detachLabel
```
命令仅移除标签，不会将邮件移动到其他位置。
```
moveToFolder
```
命令会将邮件物理移动到另一个文件夹——适用于IMAP风格的整理方式。
对于Gmail账户，优先使用
```
attachLabel
```
/
```
detachLabel
```
而非
```
moveToFolder
```
，因为Gmail采用标签而非文件夹的管理方式。

共享收件箱标签的格式为

shared@company.com:LabelName

或

"Team Name:LabelName"

。

可与
```
recipe-meeting-prep
```
或项目跟踪工作流结合，将对话线程作为更大流程的一部分进行标签归类。
定期执行此方案，随着新相关邮件的到来，保持项目标签的时效性。