You Jian

Safety Rules

参见 _shared/core/safety-rules.md

邮箱知识库 (Mail Knowledge Base)

把邮箱里的邮件变成可检索、可归档的本地知识库。三件事：收与读 → 建库 → 检索。 核心是 scripts/mailbox.py，agent 直接调用完成所有操作。

核心工作流

Step 1 收与读
   /邮箱 fetch all --unread            # 所有账号的未读列表（含 UID）
   /邮箱 fetch work --unread           # 单账号未读
   /邮箱 read work 42                  # 读第 42 封全文 + 附件清单

Step 2 建知识库
   /邮箱 kb work --dir ~/MailKB        # 把 work 邮箱邮件导出为 Markdown + index.json
   /邮箱 kb all --dir ~/MailKB --unread # 所有账号的未读邮件建库

Step 3 检索
   /邮箱 search all 发票               # 在所有邮箱按关键词检索（中文走客户端过滤）
   rg -l "关键词" ~/MailKB             # 在已建知识库里全文检索（Markdown 可被 rg/grep 检索）
   /邮箱 digest all --days 7           # 每日摘要：分类 + 高频发件人 + 待办

Step 4 附件与发送
   /邮箱 attach work 42 --dir ~/Downloads/发票
   /邮箱 send work --to a@b.com --subject 会议纪要 --body-file 纪要.txt --attach 纪要.pdf

知识库产物（/邮箱 kb）

对指定账号拉取邮件，导出到 <dir>/<账号>/：

<账号>/
├── index.json                        # 索引：uid/发件人/主题/日期/正文/附件清单
└── <uid>_<日期>_<主题>.md            # 每封一个 Markdown（front-matter + 正文 + 附件列表）

Markdown 带 YAML front-matter（uid/from/date/subject/attachments），可被 rg/grep 全文检索， 也可被 RAG 直接切片入库。

Quick Commands

English 别名：/mail fetch|read|search|kb|digest|attach|send|stats|folders|mark|move|delete。

约定

• 读操作只读：fetch / read / search / kb / digest / attach / stats / folders 不改变服务器状态。
• 写操作先 DRY-RUN：send / mark / move / delete 默认打印将要执行的动作，加 --yes 才真正执行。
• 账号名传 all 即遍历全部已配置邮箱，统一收/搜/建库/摘要。
• 邮件收发与授权由独立的命令行程序负责（用户自建 CLI）；本技能只约定读写、建库、检索的用法， 脚本支持环境变量 YOUJIAN_PASS_<账号名> 提供凭据，避免在技能/日志中泄露密码。

中文支持

• MIME 头部 RFC 2047 解码、正文 gbk/gb18030/big5 回退、HTML→纯文本。
• IMAP modified UTF-7 中文文件夹名；非 ASCII 关键词走客户端过滤搜索。
• 邮件主题/发件人里的中文正确解码为可检索文本。

Anti-Patterns

依赖

• Python ≥ 3.8，核心收发只用标准库（imaplib/smtplib/email）。
• 加密凭据库（可选）需 cryptography；不用它也可走环境变量提供凭据。

文件结构

skills/you-jian/
├── README.md              # 面向人的中文说明
├── SKILL.md               # 本文件
├── rules/
│   └── digest.md          # 摘要分类规则
├── scripts/
│   └── mailbox.py         # 多邮箱客户端（收/读/搜/建库/发）
└── tests/
    ├── test_mailbox.py    # 离线单测
    ├── mock_imap.py       # 极简 IMAP+SMTP 服务器（测试用）
    └── test_integration.py# 端到端集成测试

版本历史