mailcode 0.1.0__tar.gz → 0.1.2__tar.gz

{mailcode-0.1.0 → mailcode-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mailcode
-Version: 0.1.0
+Version: 0.1.2
 Summary: Email ↔ AI Agent bidirectional remote command bridge
 License: MIT
 Requires-Python: >=3.9

mailcode-0.1.2/README.md

@@ -0,0 +1,252 @@
+# MailCode
+
+Python 邮件连接器，通过邮件远程操控 Claude Code。
+
+```
+收件箱 ──> IMAP 监听器 ──> claude -p 子进程 ──> SMTP 邮件通知
+```
+
+## 设计理念
+
+MailCode 的核心理念是**轻量化的人与 Coding Agent 直连**。
+
+市面上的 AI 工具链往往依赖飞书、钉钉等重型协作平台——建机器人、配 Webhook、在对话框里和 Agent 来回聊天。MailCode 反其道而行：直接用邮件，因为你本来就有一个邮箱。
+
+**人与 Agent 直连，而不是和机器人对话。** 回复邮件就是下达指令，收件箱就是控制台,不需要打开任何第三方应用。
+
+**轻量异步。** 不需要常驻复杂服务，不需要数据库，不需要消息队列。一个 Python 脚本 + 邮件协议，跑在任何能联网的机器上。Agent 在后台慢慢跑，你做别的事，完事了邮件通知你。
+
+MailCode 不做大而全的平台，只做一件事：**让你用最习惯的方式（邮件）和  Agent 对话。**
+
+## 邮箱账户架构
+
+MailCode 需要 **两个邮箱账户**——一个当 Bot，一个当用户：
+
+- **Bot 邮箱**（例：`mailcode_bot@xxx.com`）—— MailCode 监听它的收件箱，Claude 处理完任务后通过它把结果发回给你
+- **用户邮箱**（你的私人邮箱，例：`your@qq.com`）—— 你从这个邮箱向 Bot 邮箱发邮件下达指令
+
+工作流：
+
+```
+[用户邮箱]  ──发指令邮件──▶  [Bot 邮箱收件箱]
+  your@qq.com                  mailcode_bot@xxx.com
+                                      │
+                                      ▼
+                                 IMAP 监听
+                                      │
+                                      ▼
+                                 Claude 处理
+                                      │
+                                      ▼
+  [用户邮箱]  ◀──回复邮件──  [Bot 邮箱发件箱]
+```
+
+> **为什么是 Bot 邮箱而不是你自己的主邮箱？** MailCode 要登录一个邮箱才能收信和发信，所以需要一个专用 Bot 邮箱；它和你日常使用的邮箱是分开的，配置 `allowed_senders` 限制只有你自己的私人邮箱能给它发指令。
+
+## 安装
+
+### 系统依赖
+
+- **python3**（≥3.9）
+- **Claude Code**（`claude` 命令需在 `PATH` 中）
+
+Python 零第三方依赖，全部使用标准库（`imaplib`、`smtplib`、`email`、`subprocess`、`json`、`secrets` 等）。
+
+### pip 安装
+
+```bash
+pip install mailcode
+```
+
+### 源码安装
+
+```bash
+git clone <repo-url> && cd MailCode
+bash install.sh
+```
+
+`install.sh` 自动完成：安装 mailcode 包、初始化配置、创建 `~/.mailcode` 软链接、自动添加 PATH。
+
+从本地 wheel 安装：`bash install.sh --local dist/mailcode-*.whl`
+
+## 配置
+
+编辑 `~/.config/mailcode/config.json`，必填字段。**两个邮箱要分清楚**——`mailcode_bot.email` 是 Bot 邮箱，`security.allowed_senders` 是允许给它发指令的邮箱（通常是你自己的私人邮箱）：
+
+```jsonc
+{
+  "mailcode_bot": {
+    "email": "mailcode_bot@xxx.com",    // ← Bot 邮箱：MailCode 登录此邮箱收信/回信
+    "password": "Bot 邮箱授权码",          // ← Bot 邮箱的授权码，不是登录密码
+    "check_interval": 60                  // ← 轮询间隔(秒); 163/126 推荐 60-120
+  },
+  "security": {
+    "allowed_senders": ["your@qq.com"]    // ← 允许发指令的邮箱（你的私人邮箱）
+  }
+}
+```
+
+SMTP 和 IMAP 配置由系统根据 Bot 邮箱的域名自动识别。支持：QQ 邮箱、163/126 邮箱、Gmail、Outlook/Hotmail。
+
+如需手动覆盖 SMTP/IMAP（如自建邮箱），可添加 `smtp` / `imap` 段，手动设置的值会覆盖自动识别结果。
+
+> 授权码获取：QQ 邮箱 → 设置 → 账户 → POP3/IMAP → 生成授权码；Gmail → Google 账户 → 安全性 → 应用密码。
+
+## 使用
+
+### CLI 概览
+
+| 子命令 | 用途 |
+|--------|------|
+| `mailcode serve` | 启动 IMAP 监听中继（含定时任务调度器）|
+| `mailcode schedule <动作>` | 定时任务管理（`list` / `show` / `add` / `enable` / `disable` / `delete` / `run-now` / `validate`）|
+| `mailcode config <动作>` | 配置管理（`show` / `init` / `init-test` / `path` / `validate`）|
+| `mailcode health` | 邮件连通性检查（SMTP/IMAP）|
+| `mailcode session <动作>` | 会话管理（`list` / `show` / `delete` / `cleanup`）|
+| `mailcode --version` | 显示版本号 |
+
+### 启动中继
+
+```bash
+# 前台运行（默认 IMAP IDLE 长连接, 单连接撑全场, 实时收信）
+mailcode serve
+
+# 干跑模式（仅打印邮件, 不调用 claude）
+mailcode serve --dry-run
+
+# 强制走轮询（不用 IDLE; 部分老旧邮箱要求）
+mailcode serve --no-idle
+
+# 单次轮询后退出
+mailcode serve --once
+```
+
+**IMAP IDLE 支持按邮箱而异**——MailCode 启动时检测 `IMAP CAPABILITY`, 没有 IDLE 就自动回退到轮询:
+
+| 邮箱 | IDLE | 行为 | 推荐 `check_interval` |
+|------|------|------|----------------------|
+| QQ 邮箱 (`imap.qq.com`) | ✅ | 实时推送, 秒级响应 | 60s（轮询时）|
+| 163/126 邮箱 (`imap.163.com` / `imap.126.com`) | ❌ | 自动回退到轮询, warning 日志告知 | **60-120s**（频率过高会被反滥用限速, 严重时封 IP）|
+| Gmail / Outlook | ✅ | 实时推送 | 60s（轮询时）|
+
+网易系邮箱**不支持 IDLE 扩展**, 频繁 IMAP 登录会触发反滥用。Bot 邮箱若用 163/126, 务必把 `mailcode_bot.check_interval` 调到 60-120 秒, 否则几小时内可能被临时封禁。
+
+查看日志：
+
+```bash
+tail -f ~/.config/mailcode/relay.log
+```
+
+### 配置管理
+
+```bash
+mailcode config show          # 查看当前配置（密码脱敏）
+mailcode config path          # 显示配置文件路径
+mailcode config init          # 初始化配置（已存在则跳过）
+mailcode config init --force  # 强制重新生成
+mailcode config validate      # 校验配置完整性
+```
+
+### 会话管理
+
+MailCode 默认按邮件主题维护多轮对话; 如需单次回复模式请设 `session.enabled = false`。
+
+```bash
+mailcode session list                # 列出所有 session
+mailcode session show <session_id>   # 查看单个 session 详情
+mailcode session delete <session_id> # 删除 session
+mailcode session cleanup             # 按 TTL 清理过期 session
+mailcode session cleanup --dry-run   # 仅预览，不实际删除
+```
+
+### 工作目录 (cwd 指令)
+
+在邮件正文**第一行**写 `cwd: <path>`，Claude 子进程会在该目录启动——适合「让 Claude 操作指定项目」。Session 模式下 cwd **粘性**：同一 session 内的后续邮件会沿用该目录，直到新邮件重新指定。
+
+```
+cwd: ~/Projects/my-app
+帮我看看 src/auth.py 里那段 JWT 校验逻辑
+```
+
+**路径解析规则**：
+
+- `~` / `~/foo` 走用户目录展开
+- 相对路径（`./foo`、`foo`）以 `Path.cwd()` 为基准
+- 路径必须存在且是目录（`is_dir()` 校验），否则忽略并回退默认（`$HOME`）
+- 写法不区分大小写，`Cwd:` / `CWD:` 等价
+
+**两种模式差异**：
+
+- **Session 模式**（`session.enabled = true` 默认）：cwd 粘性，整个 session 沿用；`mailcode session show <id>` 可查当前 cwd
+- **单次回复模式**（`session.enabled = false`）：cwd 不粘性，每封邮件独立解析
+
+cwd 行会在调用 Claude 前从 body 中剥离，不会污染 prompt。
+
+### 健康检查
+
+```bash
+mailcode health    # 检查 SMTP/IMAP 配置与连通性
+```
+
+检查项：SMTP 连接 / 登录 / 发信、IMAP 连接 / 登录 / 收件箱。
+
+### 定时任务
+
+MailCode 内置轻量定时任务引擎，无需外部 cron 或 systemd timer——直接在 `mailcode serve` 内跑，配置持久化到 `~/.config/mailcode/schedules.json`。
+
+支持四种调度类型：
+
+| 类型 | 参数 | 示例 |
+|------|------|------|
+| `interval` | `--interval-seconds <秒>` | 每 3600 秒运行一次 |
+| `daily` | `--time <HH:MM>` | 每天 09:00 运行 |
+| `weekly` | `--time <HH:MM> --day-of-week <0-6>` | 每周一 09:00（0=周日） |
+| `monthly` | `--time <HH:MM> --day-of-month <1-31>` | 每月 1 号 09:00 |
+
+定时任务会调用 `claude -p <prompt>` 执行指定指令，并将 Claude 的响应邮件发送给指定收件人。所有调度基于本地时间，错过触发窗口的任务自动跳过（不会追赶补跑）。
+
+```bash
+# 创建定时任务
+mailcode schedule add morning-digest --type daily --time 09:00 \
+  --prompt "总结 GitHub 通知, 列出今天待办" \
+  --to-email your@qq.com \
+  --subject-prefix "[晨间摘要]"
+
+# 列出所有任务
+mailcode schedule list
+
+# 查看任务详情
+mailcode schedule show morning-digest
+
+# 立即执行一次（不污染调度统计）
+mailcode schedule run-now morning-digest
+
+# 启用 / 禁用
+mailcode schedule enable morning-digest
+mailcode schedule disable morning-digest
+
+# 删除
+mailcode schedule delete morning-digest
+
+# 校验所有任务配置
+mailcode schedule validate
+```
+
+**配置**（`~/.config/mailcode/config.json`，可选）：
+
+```jsonc
+{
+  "schedule": {
+    "enabled": true,         // 全局开关
+    "tick_seconds": 30       // 调度器轮询间隔
+  }
+}
+```
+
+**特点**：
+
+- **热加载**——通过 CLI 增删改任务后，运行中的 `serve` 进程立即生效，无需重启
+- **并发防护**——同一任务的上次执行未完成时，不会重复触发
+- **错误通知**——Claude 调用或邮件发送失败时，自动通知收件人
+- **独立运行**——`mailcode schedule run-now` 不依赖 `serve` 进程，可单独使用
+- **干跑兼容**——`mailcode serve --dry-run` 下标记执行结果但不真实调用

mailcode-0.1.2/mailcode/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.2"

{mailcode-0.1.0 → mailcode-0.1.2}/mailcode/cli.py

@@ -77,6 +77,68 @@ def _build_session_handler():
     return ConversationHandler(email_channel=channel)
 
 
+def _build_schedule_store():
+    """构造 ScheduleStore 实例（默认路径 ~/.config/mailcode/schedules.json）。"""
+    from pathlib import Path
+
+    schedules_path = Path.home() / ".config" / "mailcode" / "schedules.json"
+    from mailcode.relay.scheduler import ScheduleStore
+    return ScheduleStore(schedules_path)
+
+
+def cmd_schedule(args):
+    """schedule 子命令: list/show/add/enable/disable/delete/run-now/validate。"""
+    from mailcode.schedule_cli import (
+        cmd_schedule_list, cmd_schedule_show, cmd_schedule_add,
+        cmd_schedule_enable, cmd_schedule_disable, cmd_schedule_delete,
+        cmd_schedule_run_now, cmd_schedule_validate,
+    )
+    sub = getattr(args, "schedule_command", None)
+    if sub is None:
+        print("用法: mailcode schedule <list|show|add|enable|disable|delete|run-now|validate>", file=sys.stderr)
+        sys.exit(1)
+
+    store = _build_schedule_store()
+
+    if sub == "list":
+        cmd_schedule_list(store)
+    elif sub == "show":
+        cmd_schedule_show(store, args.name)
+    elif sub == "add":
+        # 把 CLI 的 "mon" 字符串转为 int(0)，与 parse_schedule 的整数 api 一致
+        _DOW_MAP = {"mon": 0, "tue": 1, "wed": 2, "thu": 3, "fri": 4, "sat": 5, "sun": 6}
+        cmd_schedule_add(store, args.name,
+            schedule_type=args.type,
+            interval_seconds=args.interval_seconds,
+            time=args.time,
+            day_of_week=_DOW_MAP.get(args.day_of_week) if args.day_of_week else None,
+            day_of_month=args.day_of_month,
+            prompt=args.prompt,
+            to_email=args.to_email,
+            cwd=args.cwd,
+            subject_prefix=args.subject_prefix,
+            interactive=False,
+        )
+    elif sub == "enable":
+        cmd_schedule_enable(store, args.name)
+    elif sub == "disable":
+        cmd_schedule_disable(store, args.name)
+    elif sub == "delete":
+        cmd_schedule_delete(store, args.name, assume_yes=args.yes)
+    elif sub == "run-now":
+        from mailcode.utils.claude_runner import call_claude
+        from mailcode.channels.email_channel import EmailChannel
+        cmd_schedule_run_now(store, args.name,
+            email_channel=EmailChannel(),
+            call_claude_fn=call_claude,
+        )
+    elif sub == "validate":
+        cmd_schedule_validate(store)
+    else:
+        print("用法: mailcode schedule <list|show|add|enable|disable|delete|run-now|validate>", file=sys.stderr)
+        sys.exit(1)
+
+
 def cmd_config(args):
     import json
     from mailcode.config import load_config, _ensure_user_config, get_config_path
@@ -228,7 +290,7 @@ def build_parser():
             "工作流: 发件人给机器人邮箱发邮件 → MailCode 在 IMAP 拉取 → 注入到本地 Agent\n"
             "       → Agent 回复内容回写到同一主题 → MailCode 通过 SMTP 把回复转发给发件人。\n"
             "\n"
-            "本 CLI 主要用于: 配置管理、连通性检查、启动中继、以及维护 Agent 对话 session。"
+            "本 CLI 主要用于: 配置管理、连通性检查、启动中继（含定时任务调度器）、维护 Agent 对话 session。"
         ),
         epilog=(
             "典型使用流程:\n"
@@ -236,8 +298,9 @@ def build_parser():
             "  2) 编辑授权码 mailcode config path && $EDITOR .../config.json\n"
             "  3) 校验配置   mailcode config validate\n"
             "  4) 自检连通性 mailcode health\n"
-            "  5) 启动中继   mailcode serve --idle          # 长期后台运行\n"
+            "  5) 启动中继   mailcode serve                  # 长期后台运行 (默认 IDLE 长连接, 含定时任务调度器)\n"
             "  6) 维护会话   mailcode session list|show|delete|cleanup\n"
+            "  7) 定时任务   mailcode schedule add/list|enable|disable|run-now\n"
             "\n"
             "调试提示:\n"
             "  • 想看收到什么邮件但不想执行: mailcode serve --once --dry-run\n"
@@ -254,18 +317,21 @@ def build_parser():
     # ── serve ──
     p_serve = subparsers.add_parser(
         "serve",
-        help="启动 IMAP 监听中继 (前台常驻)",
+        help="启动 IMAP 监听中继 (前台常驻, 含定时任务调度器)",
         description=(
             "启动 IMAP 监听中继: 拉取 bot 邮箱里的未读邮件, 注入本地 AI Agent, 把回复通过 SMTP 转发回发件人。\n"
+            "同时运行定时任务调度器: 按 schedules.json 中的配置在后台周期性执行 claude -p 并邮件通知结果。\n"
+            "默认使用 IMAP IDLE 长连接 (实时推送, 适用于 QQ / Gmail / Outlook)。\n"
+            "126/163 邮箱不支持 IDLE, 自动回退到轮询, 需将 check_interval 调到 60-120 秒避免反滥用。\n"
             "Ctrl-C 退出, 日志写入 ~/.config/mailcode/relay.log。"
         ),
     )
     p_serve.add_argument("--dry-run", action="store_true",
                         help="干跑模式: 只打印邮件内容, 不注入 Agent, 不发送回复（用于排查邮件解析）")
     p_serve.add_argument("--once", action="store_true",
-                        help="处理完一轮未读后退出 (用于脚本/调试, 默认持续轮询)")
-    p_serve.add_argument("--idle", action="store_true",
-                        help="使用 IMAP IDLE 长连接, 实时接收新邮件推送 (推荐生产环境使用)")
+                        help="处理完一轮未读后退出 (调度器不启动, 用于脚本/调试, 默认持续监听)")
+    p_serve.add_argument("--no-idle", action="store_true",
+                        help="禁用 IMAP IDLE 长连接, 改用固定间隔轮询 (默认启用 IDLE)")
     p_serve.add_argument("--session", "-S", action="store_true",
                         help="按邮件主题维护多轮对话 session (覆盖 config 中 session.enabled)")
 
@@ -332,6 +398,62 @@ def build_parser():
     p_session_cleanup.add_argument("--dry-run", action="store_true",
                                    help="只列出将被清理的 session, 不实际删除")
 
+    # ── schedule ──
+    p_schedule = subparsers.add_parser(
+        "schedule",
+        help="定时任务管理 (list|show|add|enable|disable|delete|run-now|validate)",
+        description=(
+            "管理 ~/.config/mailcode/schedules.json 中的定时任务 (无需外部 cron)。\n"
+            "支持 interval（固定间隔）/ daily（每天定点）/ weekly（每周某天）/ monthly（每月某天）四种类型。\n"
+            "运行 mailcode serve 时调度器自动在后台运行, 到期触发 claude -p <prompt> 并邮件通知。\n"
+            "missed_run 自动跳过不追赶; 任务配置热加载, 增删改立即生效无需重启 serve。"
+        ),
+    )
+    p_schedule_sub = p_schedule.add_subparsers(
+        dest="schedule_command", title="schedule 动作", metavar="<动作>"
+    )
+
+    p_schedule_sub.add_parser("list", help="列出全部定时任务 (名称/类型/调度/状态/下次运行时间)")
+
+    p_schedule_sub.add_parser("validate", help="校验 schedules.json 完整性 (名称唯一/调度合法/邮箱有效/prompt 非空, 只读不改)")
+
+    p_schedule_show = p_schedule_sub.add_parser("show", help="查看单个定时任务详情")
+    p_schedule_show.add_argument("name", help="任务名称")
+
+    p_schedule_add = p_schedule_sub.add_parser("add", help="添加新定时任务")
+    p_schedule_add.add_argument("name", help="任务名称 (唯一)")
+    p_schedule_add.add_argument("--type", choices=["interval", "daily", "weekly", "monthly"],
+                                required=True)
+    p_schedule_add.add_argument("--interval-seconds", type=int,
+                                help="type=interval 时必填")
+    p_schedule_add.add_argument("--time", help="type=daily/weekly/monthly 时必填, HH:MM 格式")
+    p_schedule_add.add_argument("--day-of-week",
+                                choices=["mon", "tue", "wed", "thu", "fri", "sat", "sun"],
+                                help="type=weekly 时必填")
+    p_schedule_add.add_argument("--day-of-month", type=int, choices=range(1, 32),
+                                metavar="[1-31]", help="type=monthly 时必填")
+    p_schedule_add.add_argument("--prompt", required=True, help="Claude prompt 文本")
+    p_schedule_add.add_argument("--to-email", required=True, help="结果邮件的收件人")
+    p_schedule_add.add_argument("--cwd", help="Claude 工作目录 (可选)")
+    p_schedule_add.add_argument("--subject-prefix", help="邮件主题前缀 (可选)")
+
+    p_schedule_enable = p_schedule_sub.add_parser("enable", help="启用一个定时任务")
+    p_schedule_enable.add_argument("name", help="任务名称")
+
+    p_schedule_disable = p_schedule_sub.add_parser("disable", help="禁用一个定时任务")
+    p_schedule_disable.add_argument("name", help="任务名称")
+
+    p_schedule_delete = p_schedule_sub.add_parser("delete", help="删除一个定时任务")
+    p_schedule_delete.add_argument("name", help="任务名称")
+    p_schedule_delete.add_argument("-y", "--yes", action="store_true",
+                                   help="跳过确认")
+
+    p_schedule_run = p_schedule_sub.add_parser(
+        "run-now",
+        help="立即同步执行指定任务 (不依赖 serve, 不污染 last_run_at / next_run_at)",
+    )
+    p_schedule_run.add_argument("name", help="任务名称")
+
     return parser
 
 
@@ -355,6 +477,8 @@ def main():
         cmd_health(args)
     elif args.command == "session":
         cmd_session(args)
+    elif args.command == "schedule":
+        cmd_schedule(args)
 
 if __name__ == "__main__":
     main()

{mailcode-0.1.0 → mailcode-0.1.2}/mailcode/config.py

@@ -197,6 +197,22 @@ def is_session_enabled() -> bool:
     return get_session_config().get("enabled", True)
 
 
+SCHEDULE_DEFAULTS = {
+    "enabled": True,
+    "tick_seconds": 30,
+    "max_concurrent": 1,
+    "missed_run_policy": "skip",  # v1 仅支持 skip, v2 加 run_immediately
+}
+
+
+def get_schedule_config() -> Dict[str, Any]:
+    config = load_config()
+    raw = config.get("schedule", {})
+    result = dict(SCHEDULE_DEFAULTS)
+    result.update(raw)
+    return result
+
+
 def validate_serve_config() -> list[str]:
     """校验 serve 启动所需配置项, 返回错误消息列表 (空列表 = 通过)。
 
@@ -241,6 +257,16 @@ def validate_serve_config() -> list[str]:
         allowed = security.get("allowed_senders", [])
         if not allowed:
             errors.append("security.allowed_senders 为空（至少应包含自己的邮箱）")
+
+        # schedule 段可选校验 (warn 而非阻塞)
+        schedule_cfg = config.get("schedule", {})
+        if schedule_cfg.get("enabled", True):
+            tick = schedule_cfg.get("tick_seconds", 30)
+            if not isinstance(tick, int) or tick <= 0:
+                errors.append(f"schedule.tick_seconds 应为正整数, 当前: {tick}")
+            max_c = schedule_cfg.get("max_concurrent", 1)
+            if not isinstance(max_c, int) or max_c < 1:
+                errors.append(f"schedule.max_concurrent 应为 >=1 整数, 当前: {max_c}")
     except Exception as e:
         logger.warning(f"配置校验过程中出错: {e}")
         errors.append(f"配置校验失败: {e}")

{mailcode-0.1.0 → mailcode-0.1.2}/mailcode/relay/conversation_handler.py

@@ -3,12 +3,13 @@
 import json
 import logging
 import re
-import subprocess
 import time
 import uuid
 from pathlib import Path
 from typing import Optional
 
+from mailcode.utils import claude_runner as cr_module
+
 logger = logging.getLogger(__name__)
 
 # MailCode 主目录
@@ -24,9 +25,6 @@ _CWD_RE = re.compile(r"^cwd:\s*(.+?)\s*$", re.MULTILINE | re.IGNORECASE)
 # 默认 session TTL (天), 0 或负数 = 不清理
 _DEFAULT_TTL_DAYS = 90
 
-# claude -p 子进程超时
-_CLAUDE_TIMEOUT = 300
-
 
 # ------------------------------------------------------------------ #
 # 模块级纯函数 — 供 ConversationHandler / StatelessHandler 复用
@@ -64,34 +62,6 @@ def strip_cwd(body: str) -> str:
     return _CWD_RE.sub("", body).strip()
 
 
-def call_claude(prompt: str, cwd: str = "") -> Optional[str]:
-    """调用 ``claude -p`` 子进程。失败返回 None。
-
-    Args:
-        prompt: 完整 prompt
-        cwd: 工作目录 (默认 ``Path.home()``)
-    """
-    cwd = cwd or str(Path.home())
-    try:
-        result = subprocess.run(
-            ["claude", "-p", prompt, "--dangerously-skip-permissions"],
-            capture_output=True,
-            text=True,
-            timeout=_CLAUDE_TIMEOUT,
-            cwd=cwd,
-        )
-        if result.returncode != 0:
-            logger.error("claude -p 失败: %s", result.stderr[:500])
-            return None
-        return result.stdout.strip()
-    except subprocess.TimeoutExpired:
-        logger.error("claude -p 超时")
-        return None
-    except FileNotFoundError:
-        logger.error("claude 命令未找到, 请确保已安装 Claude Code")
-        return None
-
-
 def send_error_email(email_channel, from_email: str, subject: str, body: str,
                      references: str, in_reply_to: str) -> bool:
     """发送错误通知邮件 (subject 加 Re: 前缀)。
@@ -316,13 +286,22 @@ class ConversationHandler:
     # ------------------------------------------------------------------ #
 
     def _build_prompt(self, session_file_path: str) -> str:
-        """构建极简 prompt, 让 Claude 自助读 session 文件。"""
+        """构建极简 prompt, 让 Claude 自助读 session 文件。
+
+        末尾显式约束: session 文件里的 from/to/subject 字段只是上下文,
+        不要被 Claude 当成"邮件头模板"复述进回复正文; 也不要在末尾署名邮箱
+        —— 这些都已经由 SMTP MIME header 处理, 正文里复述只会冗余。
+        """
         return (
             f"用户最新邮件已写入 session 文件: {session_file_path}\n\n"
             "请用 Read 工具读取该文件, 了解完整对话上下文 "
             "(emails 字段是邮件列表, direction=incoming/outgoing), "
             "然后回复用户最新邮件。\n\n"
             "回复内容将作为邮件正文发送, 请用纯文本格式。"
+            "不要在正文里复述「发件人 / From」「收件人 / To」「主题 / Subject」"
+            "等邮件头字段(session 文件里的 from/to/subject 仅供上下文参考), "
+            "也不要在末尾署名或附上任何邮箱地址 — "
+            "这些会由邮件系统自动添加。"
         )
 
     # ------------------------------------------------------------------ #
@@ -444,7 +423,7 @@ class ConversationHandler:
         session_path = str(self._session_path(session_id))
         prompt = self._build_prompt(session_path)
         cwd = session.get("cwd") or str(Path.home())
-        response = call_claude(prompt, cwd=cwd)
+        response = cr_module.call_claude(prompt, cwd=cwd)
 
         # 7. claude 失败 → 写日志 + 发邮件通知用户
         if response is None: