尊敬的 {{name}}（{{department}}）：
您本月工资单已生成，请登录企业系统查看详情。
如有疑问，请联系财务部。
``` **执行批量发送**: ```bash email-163-tool batch-send \ --recipients recipients.csv \ --template template/salary_notice.html \ --subject "{{name}} - 工资单通知 {{salary_month}}" \ --rate-limit 10 \ --dry-run ``` 输出示例： ```text 📋 批量发送任务启动 收件人总数: 500 模板: template/salary_notice.html 发送速率: 10 封/分钟 模式: 试运行（dry-run） # ... [1/500] ✅ zhangsan@company.com - 张三 - 技术部 [2/500] ✅ lisi@company.com - 李四 - 市场部 [3/500] ✅ wangwu@company.com - 王五 - 财务部 ... # ... 📊 试运行完成: 500 封邮件预览成功，0 个错误 💡 移除 --dry-run 参数以实际发送 ``` ### 场景二：邮件归档与合规审计 财务部门需要将所有与发票相关的邮件归档保存，并生成审计报告. ```bash # 搜索所有发票相关邮件并归档 email-163-tool search-archive \ --from "invoice@" \ --subject "发票" \ --after "2026-01-01" \ --before "2026-07-18" \ --archive-folder "财务归档/2026年上半年" \ --export audit_report.csv # ... # 查看归档审计日志 email-163-tool audit-log --action archive --since "2026-07-01" ``` 审计日志输出： ```text 📜 审计日志 - 归档操作 时间范围: 2026-07-01 至 2026-07-18 # ... 2026-07-18 10:30:15 | ARCHIVE | 邮件ID: 234 | 主题: 7月发票 | 来源: invoice@vendor.com -> 财务归档/2026年上半年 2026-07-18 10:30:16 | ARCHIVE | 邮件ID: 235 | 主题: 6月发票 | 来源: invoice@vendor.com -> 财务归档/2026年上半年 ... 归档总数: 48 封 | 导出文件: audit_report.csv ``` ### 场景三：定时自动清理与汇总 设置每周一自动清理垃圾邮件，并汇总上周未读重要邮件. ```bash # 创建定时任务 email-163-tool schedule create \ --name "weekly-cleanup" \ --cron "0 9 * * 1" \ --actions "search --folder 垃圾邮件 --all | delete --batch" \ --notify "admin@company.com" # ... # 查看所有定时任务 email-163-tool schedule list # ... # 查看任务执行历史 email-163-tool schedule history --name "weekly-cleanup" ``` --- ## 不适用场景 以下场景163邮箱助手专业版不适合处理： - 垃圾信息群发 - 通信协议逆向 - 电话语音交互 ## 触发条件 需要消息发送、通知推送、邮件短信、通信集成时使用。不适用于非本工具能力范围的需求. ## 快速开始 1. 阅读## 核心能力章节了解skill功能 2. 按## 依赖说明配置环境 3. 执行所需能力对应的命令 4. 参考## 错误处理章节处理异常 5. 查看## FAQ解答常见疑问 ### 从免费版升级 专业版完全兼容免费版，无需修改现有配置： ```bash # 现有配置文件可直接使用 # ~/.config/email-163-tool/config.json # 验证升级后的基础功能 email-163-tool read --count 5 email-163-tool send --to test@example.com --subject "升级测试" --body "专业版已就绪" ``` ### 新增企业级配置 在配置文件中添加专业版扩展字段： ```json { "email": "enterprise@163.com", "password": "your_auth_code", "imap_server": "imap.163.com", "imap_port": 993, "smtp_server": "smtp.163.com", "smtp_port": 465, "pro": { "multi_account": { "enabled": true, "accounts_dir": "~/.config/email-163-tool/accounts" }, "batch": { "rate_limit": 10, "max_recipients": 1000, "retry_count": 3 }, "archive": { "enabled": true, "auto_archive": true, "retention_days": 365 }, "audit": { "enabled": true, "log_file": "~/.config/email-163-tool/audit.log" }, "schedule": { "enabled": true, "timezone": "Asia/Shanghai" } } } ``` ### 多账户配置 为每个邮箱账户创建独立配置文件： ```bash mkdir -p ~/.config/email-163-tool/accounts # ... # 创建账户配置 cat > ~/.config/email-163-tool/accounts/finance.json << 'EOF' { "name": "财务部邮箱", "email": "finance@company.com", "password": "finance_auth_code" } EOF # ... # 列出所有账户 email-163-tool accounts list ``` --- **响应解析**: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤. ## 示例 ### 批量发送配置 ```json { "batch": { "rate_limit": 10, "max_recipients": 1000, "retry_count": 3, "retry_delay": 60, "concurrency": 5, "on_failure": "skip", "failure_log": "~/.config/email-163-tool/batch_failures.log" } } ``` ### 归档规则配置 ```json { "archive_rules": [ { "name": "发票归档", "conditions": { "from": "invoice@", "subject": "发票" }, "target_folder": "财务归档", "retention_days": 1095 }, { "name": "通知归档", "conditions": { "from": "noreply@", "older_than_days": 90 }, "target_folder": "通知归档", "retention_days": 180 } ] } ``` ### 定时任务配置 ```json { "schedules": [ { "name": "daily-summary", "cron": "0 9 * * *", "action": "summary --unread --send admin@company.com" }, { "name": "weekly-cleanup", "cron": "0 10 * * 1", "action": "clean --folder 垃圾邮件 --older-than 7" } ] } ``` --- ## 最佳实践 ### 批量发送安全规范 ```bash # 始终先试运行，确认无误后正式发送 email-163-tool batch-send --recipients list.csv --template tpl.html --dry-run # ... # 已知限制 email-163-tool batch-send --recipients list.csv --template tpl.html --rate-limit 10 # ... # 失败重试与日志记录 email-163-tool batch-send --recipients list.csv --template tpl.html \ --retry 3 --retry-delay 60 --log batch_send.log ``` ### 邮件模板管理 ```bash # 创建模板 email-163-tool template create --name "月度报告" --file templates/monthly.html # ... # 预览模板渲染效果 email-163-tool template preview --name "月度报告" \ --data '{"name":"张三","month":"2026年7月"}' # ... # 列出所有模板 email-163-tool template list ``` ### 归档与合规 - 制定明确的归档规则，按业务类型分类 - 设置合理的保留期限（如财务邮件保留3年） - 定期检查归档审计日志 - 定期导出合规报告存档 ### 多账户安全 ```bash # 为每个账户使用独立授权码 # 定期轮换授权码 email-163-tool accounts rotate-key --account finance # ... # 监控账户健康状态 email-163-tool accounts health-check ``` --- ## 免费版与专业版对比 | 能力 | 免费版 | 专业版 | |:-----|:-----|:-----| | 基础邮件收发 | ✅ | ✅ | | 邮件搜索 | 基础搜索 | 高级组合搜索 | | 文件夹管理 | ✅ | ✅ | | 附件管理 | ✅ | ✅ | | 批量发送 | ❌ | ✅（支持变量替换） | | 邮件模板 | ❌ | ✅（模板系统） | | 定时任务 | ❌ | ✅（cron调度） | | 归档审计 | ❌ | ✅（合规日志） | | 多账户管理 | ❌ | ✅（租户隔离） | | 搜索结果导出 | ❌ | ✅（CSV/JSON） | | 技术支持 | 社区支持 | 优先支持 | --- ## 已知限制 - 本skill的能力范围受限于核心能力章节中定义的功能,不支持超出范围的操作 - 复杂业务场景建议结合人工经验判断 - 执行效率受模型能力与网络环境影响 ## 常见问题 ### 问题1：批量发送被限制 ```text Error: Rate limit exceeded ``` **解决**: 降低发送速率，163邮箱对发送频率有严格限制。建议 `--rate-limit` 设置为 5-10 封/分钟，并启用失败重试机制. ### 问题2：模板变量未替换 **解决**: 确保变量名与 CSV 列名完全一致（区分大小写），模板中使用 `{{variable}}` 语法： ```bash # 验证模板变量 email-163-tool template validate --name "通知" --data sample.json ``` ### 问题3：定时任务未执行 **解决**: 检查时区配置与 cron 表达式格式： ```bash # 验证 cron 表达式 email-163-tool schedule validate --cron "0 9 * * 1" # ... # 检查任务状态 email-163-tool schedule status --name "weekly-cleanup" ``` ### 问题4：多账户切换失败 **解决**: 确保各账户配置文件格式正确，授权码有效： ```bash # 验证所有账户配置 email-163-tool accounts validate --all # ... # 测试单个账户连接 email-163-tool accounts test --account finance ``` ### 问题5：归档空间不足 **解决**: 定期清理过期归档，或调整保留期限： ```bash # 清理超过保留期的归档邮件 email-163-tool archive clean --expired # ... # 查看归档空间使用情况 email-163-tool archive stats ``` --- ## 命令参考速查 | 命令 | 功能 | 专业版独有 | |---:|---:|---:| | `send` | 发送邮件 | - | | `read` | 读取邮件 | - | | `search` | 基础搜索 | - | | `search-archive` | 搜索并归档 | ✅ | | `batch-send` | 批量发送 | ✅ | | `template` | 模板管理 | ✅ | | `schedule` | 定时任务 | ✅ | | `audit-log` | 审计日志 | ✅ | | `accounts` | 多账户管理 | ✅ | | `archive` | 归档管理 | ✅ | | `export` | 结果导出 | ✅ | --- ## 依赖说明 ### 运行环境 - **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等） - **操作系统**: Windows / macOS / Linux - **Python版本**: 3.8 及以上（如使用 Python 脚本模式） - **网络环境**: 需可访问 `imap.163.com` 与 `smtp.163.com` - **磁盘空间**: 归档与日志建议预留 1GB 以上 ### 依赖详情 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:---:|:---:|:---:|:---:| | LLM API | API | 必需 | 由Agent内置LLM提供 | | Python 标准库 | 运行库 | 可选 | Python 自带（smtplib, imaplib, email） | | 163邮箱账号 | 账户 | 必需 | 注册163邮箱并开启IMAP/SMTP服务 | | 客户端授权码 | 凭证 | 必需 | 163邮箱设置页生成 | | cron 服务 | 系统服务 | 可选 | 系统自带（定时任务功能需要） | | 数据库 | 存储引擎 | 可选 | 用于归档索引（可选 SQLite 文件存储） | ### API Key 配置 - 本工具使用163邮箱客户端授权码进行认证，无需额外 API Key - 多账户场景下每个账户使用独立授权码 - 授权码通过配置文件或环境变量提供，支持加密存储 - 建议企业用户使用密钥管理服务统一管理授权码 ### 可用性分类 - **分类**: MD+EXEC（纯Markdown指令，部分功能需要 exec 命令行执行能力） - **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作，企业级功能通过扩展命令行工具完成，支持批量处理与定时调度 ## 错误处理 | 错误场景 | 原因 | 处理方式 | |:------|------:|:------| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |