mailcode 0.1.0__py3-none-any.whl

mailcode/relay/stateless_handler.py

@@ -0,0 +1,101 @@
+"""单次回复模式核心 — 每封邮件独立调一次 claude -p, 不维护 session。"""
+
+import logging
+from pathlib import Path
+
+from mailcode.relay.conversation_handler import (
+    call_claude,
+    extract_cwd,
+    send_error_email,
+    strip_cwd,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class StatelessHandler:
+    """单次回复处理器: 一封邮件 → 一次 ``claude -p`` → 一封回信。
+
+    与 ``ConversationHandler`` 的区别:
+        - 不写 session 文件, 不读 index
+        - 无状态, 可安全 lazy init 后复用同一实例
+        - cwd 解析复用 ``extract_cwd`` / ``strip_cwd`` (行为对齐)
+    """
+
+    def __init__(self, email_channel):
+        self.email_channel = email_channel
+
+    def handle_email(self, from_email: str, subject: str, body: str,
+                     references: str = "", in_reply_to: str = "") -> bool:
+        """主入口: 处理一封单次回复邮件。
+
+        流程:
+            1. 提取 cwd + 剥离
+            2. 构建 prompt
+            3. 调 ``claude -p``
+            4. 错误处理 (发通知邮件)
+            5. SMTP 发回复
+
+        Returns:
+            True 表示成功发送回复
+        """
+        logger.info("处理单次回复邮件: from=%s subject=%s", from_email, subject)
+
+        # 1. 提取 cwd + 剥离
+        extracted_cwd = extract_cwd(body)
+        clean_body = strip_cwd(body) if extracted_cwd is not None else body
+
+        # 2. 构建 prompt (单次回复: 无 session, 直接给邮件正文)
+        prompt = (
+            f"用户最新邮件:\n\n"
+            f"主题: {subject}\n\n"
+            f"{clean_body}\n\n"
+            f"请直接回复这封邮件, 内容将作为邮件正文发送, 用纯文本格式。"
+        )
+
+        # 3. 调 claude
+        cwd = extracted_cwd or str(Path.home())
+        response = call_claude(prompt, cwd=cwd)
+
+        # 4. claude 失败 → 写日志 + 发邮件通知用户
+        if response is None:
+            logger.error("claude -p 调用失败, 通知用户: from=%s", from_email)
+            send_error_email(
+                self.email_channel, from_email, subject,
+                "抱歉, 处理你的邮件时遇到技术问题。请稍后再试。详细错误已记录到日志。",
+                references, in_reply_to,
+            )
+            return False
+
+        # 5. 空 response → 写日志 + 发邮件通知用户
+        if not response:
+            logger.error("claude -p 返回空 response, 通知用户: from=%s", from_email)
+            send_error_email(
+                self.email_channel, from_email, subject,
+                "抱歉, AI 助手这次没有回复内容。请稍后再试, 或换个方式描述你的问题。",
+                references, in_reply_to,
+            )
+            return False
+
+        # 6. 准备 outgoing 邮件
+        reply_subject = subject if subject.startswith("Re:") else f"Re: {subject}"
+
+        # 7. SMTP 发回复
+        try:
+            send_ok, _ = self.email_channel.send_reply(
+                to_email=from_email,
+                subject=reply_subject,
+                body=response,
+                in_reply_to_msg_id=in_reply_to,
+                references=references,
+            )
+        except Exception as e:
+            logger.error("单次回复发送异常: %s", e)
+            return False
+
+        if not send_ok:
+            logger.error("单次回复发送失败: from=%s", from_email)
+            return False
+
+        logger.info("单次回复已发送: from=%s", from_email)
+        return True

mailcode/resources/default.json

@@ -0,0 +1,36 @@
+{
+  "mailcode_bot": {
+    "_notes": {
+      "email": "MailCode 机器人管理的邮箱地址。MailCode 会监听此邮箱的收件箱，也用此邮箱发信",
+      "password": "邮箱授权码/应用专用密码，不是登录密码。QQ邮箱: 设置→账户→POP3/IMAP→生成授权码",
+      "from_name": "发件人显示名称",
+      "check_interval": "检查新邮件的间隔（秒），默认 5 秒"
+    },
+    "from_name": "Mailcode Remote",
+    "check_interval": 5,
+    "email": "",
+    "password": ""
+  },
+  "security": {
+    "_notes": {
+      "allowed_senders": "哪些邮箱可以给 MailCode 发命令，填你自己的邮箱。多个用逗号分隔。示例: your@qq.com",
+      "auth_policy": "邮件认证策略。warn=仅警告, strict=严格拒绝, off=关闭"
+    },
+    "allowed_senders": [],
+    "auth_policy": "warn"
+  },
+  "session": {
+    "_notes": {
+      "enabled": "是否启用 session 模式",
+      "response_timeout_seconds": "等待 AI 回复的超时时间（秒）",
+      "idle_timeout_hours": "空闲超时时间（小时）",
+      "session_ttl_days": "session 过期天数, 0 或负数不清理",
+      "cleanup_on_startup": "启动时自动清理过期 session"
+    },
+    "enabled": true,
+    "response_timeout_seconds": 180,
+    "idle_timeout_hours": 4,
+    "session_ttl_days": 90,
+    "cleanup_on_startup": true
+  }
+}

mailcode/server.py

@@ -0,0 +1,40 @@
+"""MailCode IMAP 监听服务 — 由 cli.py:cmd_serve 调用"""
+
+import sys
+import signal
+import logging
+
+from mailcode.relay.email_listener import IMAPListener
+
+logger = logging.getLogger("mailcode")
+
+
+def run_serve(args):
+    """启动 IMAP 监听器，根据 args 运行（单次轮询 / IDLE / 普通监听）。
+
+    Args:
+        args: 具有 dry_run、once、idle 属性的 Namespace 对象。
+    """
+    listener = IMAPListener()
+
+    def signal_handler(signum, frame):
+        print("\n🛑 收到关闭信号，正在停止监听器...", flush=True)
+        listener.stop()
+
+    signal.signal(signal.SIGINT, signal_handler)
+    signal.signal(signal.SIGTERM, signal_handler)
+
+    try:
+        if args.once:
+            emails = listener.fetch_unread_emails(dry_run=args.dry_run)
+            logger.info(f"发现 {len(emails)} 封新邮件")
+            for entry in emails:
+                success, message = listener.process_email(
+                    entry, dry_run=args.dry_run, force_session=args.session or None,
+                )
+                logger.info(f"{'✅' if success else '❌'} [{entry.get('token')}] {message}")
+        else:
+            listener.listen(dry_run=args.dry_run, use_idle=args.idle)
+    except Exception:
+        logger.exception("监听器主循环异常退出")
+        sys.exit(1)

mailcode/session_cli.py

@@ -0,0 +1,149 @@
+"""mailcode session 子命令的 CLI 格式化与呈现"""
+
+import sys
+
+
+def fmt_ts(ts) -> str:
+    """time.time() 浮点 → 'YYYY-MM-DD HH:MM' 本地时间。"""
+    import datetime
+    try:
+        ts = float(ts or 0)
+    except (TypeError, ValueError):
+        return "-"
+    if ts <= 0:
+        return "-"
+    return datetime.datetime.fromtimestamp(ts).strftime("%Y-%m-%d %H:%M")
+
+
+def shorten(text: str, width: int) -> str:
+    """按显示宽度截断（CJK 字符按 2 算，简化处理）。"""
+    if text is None:
+        return ""
+    text = str(text).replace("\n", " ").replace("\r", " ").strip()
+    if width <= 0:
+        return text
+    if len(text) <= width:
+        return text
+    return text[: max(width - 1, 1)] + "…"
+
+
+def first_incoming(emails):
+    """从 emails 列表中找出首封 incoming 邮件（作为 session 的代表）。"""
+    if not emails:
+        return None
+    for e in emails:
+        if e.get("direction") == "incoming":
+            return e
+    return emails[0]
+
+
+def cmd_session_list(handler):
+    """列出所有 session。"""
+    sessions = handler.list_sessions()
+    if not sessions:
+        print("暂无 session")
+        return
+
+    rows = []
+    for s in sessions:
+        sid = s.get("session_id", "")
+        detail = handler.get_session_status(sid)
+        first = first_incoming(detail.get("emails", [])) if detail else None
+        from_email = first.get("from", "-") if first else "-"
+        subject = first.get("subject", "-") if first else "-"
+        rows.append({
+            "id": sid,
+            "from": from_email,
+            "subject": subject,
+            "last": fmt_ts(s.get("last_interaction")),
+            "count": s.get("email_count", 0),
+            "cwd": s.get("cwd", "") or "-",
+        })
+
+    header = f"{'SESSION ID':<14}  {'FROM':<28}  {'SUBJECT':<24}  {'LAST INTERACTION':<17}  {'MSGS':>4}  CWD"
+    print(header)
+    print("-" * len(header))
+    for r in rows:
+        print(
+            f"{shorten(r['id'], 14):<14}  "
+            f"{shorten(r['from'], 28):<28}  "
+            f"{shorten(r['subject'], 24):<24}  "
+            f"{r['last']:<17}  "
+            f"{r['count']:>4}  "
+            f"{shorten(r['cwd'], 40)}"
+        )
+
+
+def cmd_session_show(handler, session_id: str):
+    """查看单个 session 详情。"""
+    detail = handler.get_session_status(session_id)
+    if detail is None:
+        print(f"未找到 session: {session_id}", file=sys.stderr)
+        sys.exit(1)
+
+    emails = detail.get("emails", [])
+    first = first_incoming(emails)
+    from_email = first.get("from", "-") if first else "-"
+    subject = first.get("subject", "-") if first else "-"
+
+    print(f"Session:    {detail.get('session_id', session_id)}")
+    print(f"From:       {from_email}")
+    print(f"Subject:    {subject}")
+    print(f"Created:    {fmt_ts(detail.get('created_at'))}")
+    print(f"Last seen:  {fmt_ts(detail.get('last_interaction'))}")
+    print(f"Cwd:        {detail.get('cwd', '') or '-'}")
+    print(f"Messages:   {detail.get('email_count', len(emails))}")
+    print()
+    print(f"Emails ({len(emails)}):")
+    if not emails:
+        print("  (空)")
+        return
+    for e in emails:
+        direction = e.get("direction", "?")
+        tag = "[in]" if direction == "incoming" else "[out]" if direction == "outgoing" else f"[{direction}]"
+        ts = fmt_ts(e.get("ts") or e.get("date"))
+        addr = e.get("from", "-")
+        body = shorten(e.get("body", ""), 60)
+        print(f"  {tag:<5} {ts:<17}  {shorten(addr, 28):<28}  {body}")
+
+
+def cmd_session_delete(handler, session_id: str, assume_yes: bool = False):
+    """删除 session，含确认提示。"""
+    detail = handler.get_session_status(session_id)
+    if detail is None:
+        print(f"未找到 session: {session_id}", file=sys.stderr)
+        sys.exit(1)
+
+    if not assume_yes:
+        emails = detail.get("emails", [])
+        first = first_incoming(emails)
+        from_email = first.get("from", "-") if first else "-"
+        subject = first.get("subject", "-") if first else "-"
+        print(f"即将删除 session: {session_id}")
+        print(f"  From:    {from_email}")
+        print(f"  Subject: {subject}")
+        print(f"  Emails:  {len(emails)}")
+        try:
+            confirm = input("确认删除? [y/N]: ").strip().lower()
+        except EOFError:
+            confirm = ""
+        if confirm not in ("y", "yes"):
+            print("已取消")
+            return
+
+    ok = handler.terminate_session(session_id)
+    if ok:
+        print(f"已删除 session: {session_id}")
+    else:
+        print(f"删除失败: {session_id}", file=sys.stderr)
+        sys.exit(1)
+
+
+def cmd_session_cleanup(handler, dry_run: bool = False):
+    """按 TTL 清理过期 session。"""
+    if dry_run:
+        count = handler._cleanup_expired_sessions(dry_run=True)
+        print(f"[dry-run] 将清理 {count} 个过期 session (实际未删除)")
+    else:
+        count = handler._cleanup_expired_sessions(dry_run=False)
+        print(f"已清理 {count} 个过期 session")

mailcode/utils/__init__.py

@@ -0,0 +1,3 @@
+from mailcode.utils.logging import setup_logging, get_logger
+
+__all__ = ["setup_logging", "get_logger"]

mailcode/utils/logging.py

@@ -0,0 +1,48 @@
+import logging
+import os
+import sys
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+
+
+def setup_logging(log_file: Path = None, level: int = None):
+    if logging.root.handlers:
+        return logging.getLogger(__name__)
+
+    if level is None:
+        level = getattr(
+            logging,
+            os.environ.get("MAILCODE_LOG_LEVEL", "INFO").upper(),
+            logging.INFO,
+        )
+
+    handlers = []
+
+    if log_file:
+        log_file.parent.mkdir(parents=True, exist_ok=True)
+        handlers.append(
+            RotatingFileHandler(
+                log_file,
+                encoding="utf-8",
+                maxBytes=5 * 1024 * 1024,
+                backupCount=3,
+            )
+        )
+
+    # 错误级别输出到 stderr，让用户看到出问题了
+    err_handler = logging.StreamHandler(sys.stderr)
+    err_handler.setLevel(logging.ERROR)
+    handlers.append(err_handler)
+
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s [%(levelname)s] %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+        handlers=handlers,
+    )
+
+    return logging.getLogger(__name__)
+
+
+def get_logger(name: str = "mailcode"):
+    return logging.getLogger(name)

mailcode-0.1.0.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: mailcode
+Version: 0.1.0
+Summary: Email ↔ AI Agent bidirectional remote command bridge
+License: MIT
+Requires-Python: >=3.9
+License-File: LICENSE
+Dynamic: license-file

mailcode-0.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+mailcode/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+mailcode/cli.py,sha256=CAoTj0-0NOjmAM9oY06eHE3ME2gcTcFcFkYDuD6sJ7I,14566
+mailcode/config.py,sha256=DOG_gsKospuNACVE7rnLWmuage97Ql9HWsH_IjQ0CP4,8810
+mailcode/health.py,sha256=FuHN7pti2MVqWIkmc-jvEwtcxhOKINnaQU_GakBpIXI,4237
+mailcode/provider_presets.py,sha256=Vp3Z4f9dbwwohiUAlquHfPneNPHS8s0kWfUCn5wAgAA,1598
+mailcode/server.py,sha256=2tyjiVLWfDSbuqyM8QBi7rG4gGWtPjp515qPrgIzyNk,1327
+mailcode/session_cli.py,sha256=wISpuV8DVQ6QNaaYbFV667vHo2VqWB33HKddqVWngu8,5050
+mailcode/channels/__init__.py,sha256=6xYU1pODC7TKf1Eo63d2r966cAQLBy9BGEmYuJda6Vo,68
+mailcode/channels/email_channel.py,sha256=vFZ1mjbrqHjny-MZ_QLIE4IHg50A9MI1CwX9CEY3KtE,4954
+mailcode/relay/__init__.py,sha256=WoCELWxxBDDyOPUrTgWJG2Nzgeu_3oXIcS7a5_RTh4Q,83
+mailcode/relay/conversation_handler.py,sha256=wxz45vTqlAIGugOsHnBA0Qr3ARSTt7eMxgiO8I3E-kc,22224
+mailcode/relay/email_listener.py,sha256=FnxIms__zNLA2QSxVhQTtWJKW9T41wB691HzGE7bO70,21366
+mailcode/relay/security.py,sha256=OTYYUpDMgLKevSnCwRGz1fstY0LM6OeL1UiP0uhekl8,4577
+mailcode/relay/stateless_handler.py,sha256=iuUKl6b74zosUwVuaQa6oIEUB5Q1PAX4o0MDFjkJSFI,3560
+mailcode/resources/default.json,sha256=SZCqNEoO5YoccnhmpwBr-dVPGr3r2qL85cLd9jwayQ0,1369
+mailcode/utils/__init__.py,sha256=5P-WOO4zIxA73NqxZ0Nsj7VQ4dqmRDFtbUdjK8qdyUg,104
+mailcode/utils/logging.py,sha256=ysYR3unsE22KRiWAAmhOsdOpPAXocmw4b9VMs2HQ1ac,1210
+mailcode-0.1.0.dist-info/licenses/LICENSE,sha256=98Ovxs3O_GFWhTZsIB655ChirkNFaIyJSxrRKqWGKno,1063
+mailcode-0.1.0.dist-info/METADATA,sha256=HE-FRnH2CPVT-9M_fyM-Sm4HO5VLbH8yfe7tZBkZx-8,196
+mailcode-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+mailcode-0.1.0.dist-info/entry_points.txt,sha256=UKjtmVVTsKhv7M1Y2SY2_24n8FNEfVcC-5c96vuDOiY,47
+mailcode-0.1.0.dist-info/top_level.txt,sha256=VCjkNSdOf7Zqo-FEVYMl96z5EtaTA2Qc1zjhGRgmZYc,9
+mailcode-0.1.0.dist-info/RECORD,,

mailcode-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mailcode-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mailcode = mailcode.cli:main

mailcode-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zsdfbb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mailcode-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mailcode