im-hub-pro 0.2.36 → 0.2.37

package/CHANGELOG.md

@@ -2,6 +2,65 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.2.37] - 2026-05-10 — Reminders + Email + Multi-agent MCP
+
+> 设计文档：`docs/architecture/reminders.md`
+
+### Added — `/remind` 子系统
+
+**核心**
+- `/remind` slash command（一次性 + 定期 + 邮件 + 字面/LLM 模式）
+- 时间解析：中文 NL 时长 / 时点 / 循环表达式（每天 N 点 / 每周 X / 工作日 / 周末 / 每隔 N），英文 / HH:MM / ISO
+- 5 秒 tick 调度器；崩溃恢复（`firing → pending`）；7 天 fireAt 上限；50 条 / 用户配额
+
+**LLM 增强（默认开启）**
+- **F1 LLM 意图识别**：非 slash 消息走 detector，时间词正则预过滤后调当前 thread 的 active agent 抽 JSON。置信度 ≥ 0.85 弹"要不要为这件事设个提醒？"卡片，y/n 确认。可 `/remind aiwatch off` 关
+- **F2 LLM 投递润色**：fire 时把字面文本作为 prompt 喂给当前 agent 重写成自然投递语（系统约束："不献媚、不过度幽默、不夸大"，≤ 80 字）。20s 超时 fallback 字面。`/remind literal …` 强制字面投递。每 N 分钟（< 1h）+ LLM 模式被拒绝（防止高频 LLM 调用）
+- **Agent context snippet**：每次 agent 调用前在 prompt 前注入 ≤ 5 条 pending 提醒摘要，agent 不用主动 list_reminders 就能看到现状
+
+**Agent MCP 工具（提醒兜底创建）**
+- 4 个工具：`create_reminder` / `list_reminders` / `cancel_reminder` / `snooze_reminder`
+- claude-code：复用现有 `--mcp-config` per-spawn 注入
+- opencode (stdio)：`prepareCommand` 注入 `IMHUB_RUN_ID` extraEnv，全局 `mcp.imhub` config 自动注册
+- opencode (http)：常驻 daemon 共享 MCP server，agent-asserted `_im_context` 兜底（**单用户限定**——agent 可伪造身份）
+- codex：未实施（`codex exec` 不支持外部 MCP）
+
+**Web 管理**
+- `/reminders` 页面（dark mode、状态筛选、取消、延后）
+- 3 个 REST endpoint：`GET /api/reminders`、`POST /api/reminders/:id/cancel`、`POST /api/reminders/:id/snooze`
+
+### Added — 邮件投递通道
+- 注册为 `email` messenger（`threadId` 即邮箱地址）
+- nodemailer + Gmail / QQ / 163 / 任意 SMTP（env：`IMHUB_SMTP_HOST/PORT/USER/PASS/FROM/SECURE`）
+- `/remind email <addr> <time> <text>` 内联 / `/remind bindemail` 绑定默认 / `/remind email <time> <text>` 走默认
+- 邮件 + 循环 + LLM 润色组合自由
+
+### Added — WeChat context_token 持久化
+- iLink Bot API 30 分钟 context_token TTL 之前只存内存，重启即丢，导致循环提醒在 wechat 端高概率失败
+- 新 SQLite 表（`~/.im-hub/wechat-context.db`），收消息时写穿，启动时 warm 内存 Map，cleanup 同步清 DB
+
+### Schema migrations
+新建 / 扩展三张表（在 `reminders.db` 内）：
+- `reminders` 主表：`recurrence` `last_fired_at` `prompt_mode` 三列追加（idempotent ALTER）
+- `user_email_bindings`
+- `user_aiwatch_settings`
+
+新独立 SQLite：`wechat-context.db`
+
+### Tests
+新增 7 个测试文件，~50 个新 case：`agent-helper`、`pending-reminder`、`remind-intent`、`reminder-rpc`、`email-adapter`、`wechat-context-store`、扩展的 `reminders.test.ts`。bun test 1033 pass / 34 skip / 0 new fail。
+
+### Dependencies
+- `nodemailer ^8.0.7`
+
+### Known limitations
+- opencode http 多用户场景不安全（`_im_context` 可伪造）；多用户部署应选 stdio 或 claude-code
+- `/api/reminders` 无 per-user owner-scoping（单运营者部署）
+- codex 暂无 MCP reminder 工具（重写需 ~5h，下一轮专项）
+- F1 detector 时区跟随 server `toLocaleString()`
+
+---
+
 ## [0.2.35] - 2026-05-09
 
 ### Added — WeChat & Telegram rich media support

package/README.md

@@ -8,8 +8,9 @@
 
 ## Highlights
 
-- **4 messengers, 4+ agents** — WeChat (image / file / voice), Feishu, Telegram, Discord; Claude Code, Codex, Copilot, OpenCode, plus any ACP endpoint
-- **Browser dashboard** — chat UI, tasks panel (jobs / schedules / approvals / health / files / audit), settings page with workspace CRUD
+- **4 messengers + email, 4+ agents** — WeChat (image / file / voice), Feishu, Telegram, Discord, Email (SMTP); Claude Code, Codex, Copilot, OpenCode, plus any ACP endpoint
+- **`/remind` reminders subsystem** — one-shot + recurring (`每天8点喝水`); LLM auto-detects reminder intent in casual chat; LLM polishes delivery; agent MCP tools; web `/reminders` page; email + IM delivery
+- **Browser dashboard** — chat UI, tasks panel (jobs / schedules / approvals / health / files / audit), reminders panel, settings page with workspace CRUD
 - **Human-in-the-loop tool approval** — Claude tool calls pause for `y`/`n` in IM or in-page card; works across all platforms
 - **Rich media in WeChat & Telegram** — receive images, files, videos; voice messages transcribed via WeChat STT, OpenAI Whisper, or whisper.cpp
 - **Smart routing** — intent classifier (CJK + ASCII), sticky sessions, circuit breaker, rate limiter
@@ -52,8 +53,9 @@ im-hub-pro start          # config, env vars, headers all unchanged
 
 | Category | Details |
 |----------|---------|
-| **Messengers** | WeChat (iLink — image / file / voice / video), Feishu (WebSocket), Telegram (grammy — photo / voice / audio), Discord (discord.js) |
+| **Messengers** | WeChat (iLink — image / file / voice / video), Feishu (WebSocket), Telegram (grammy — photo / voice / audio), Discord (discord.js), Email (SMTP, push-only) |
 | **Agents** | Claude Code, Codex, Copilot, OpenCode — all via shared `AgentBase`; any HTTP agent via ACP |
+| **Reminders** | `/remind` slash, LLM intent detection, LLM-polished delivery, MCP tools for agents (claude-code + opencode), web `/reminders` UI |
 | **Web UI** | Chat with streaming, three-state theme (light / dark / system), bilingual (EN / 中文), SSE dashboard |
 | **Tool Approval** | Human-in-the-loop over IM + in-page cards; MCP sidecar for Claude |
 | **Jobs** | Persistent SQLite job board + cron scheduler; batch ops; background task reader |
@@ -85,9 +87,10 @@ im-hub-pro messengers      # List available messengers
 | `/new` | New conversation (clear context) |
 | `/model [provider/model]` | View or switch model |
 | `/think on\|off` | Toggle extended thinking |
+| `/remind …` | Reminders — see [Reminders](#reminders) below |
 | `/job`, `/schedule`, `/audit`, `/stats` | Manage jobs, schedules, audit, stats |
 | `/router status\|explain` | Inspect routing decisions |
-| `y` / `n` / `批准` / `拒绝` | Approve / deny Claude tool call |
+| `y` / `n` / `批准` / `拒绝` | Approve / deny Claude tool call (or reminder confirmation card) |
 
 ## Human-in-the-loop Tool Approval
 
@@ -102,6 +105,132 @@ Reply y to approve / n to deny  (auto-deny in 5 min)
 
 Reply `y` / `n` in IM, or click Allow / Deny in the web UI. Works identically across WeChat, Telegram, Feishu, and Discord. Disable with `IMHUB_APPROVAL_DISABLED=1`.
 
+## Reminders
+
+Built-in `/remind` subsystem — one-shot or recurring, with three creation paths and three delivery enhancements.
+
+```bash
+# One-shot
+/remind 2m drink water
+/remind 40秒喝水
+/remind 下午6点下班
+/remind 18:30 出门
+
+# Recurring 🔁
+/remind 每5分钟看屏幕外
+/remind 每天早上8点喝水
+/remind 每周一三五9点站会
+/remind 每个工作日18:00下班
+
+# Email delivery ✉️ (requires SMTP — see Configuration)
+/remind email me@x.com 8:00 morning briefing
+/remind bindemail me@x.com   # bind default → /remind email 每天8点 早安
+/remind unbindemail
+
+# Manage
+/remind list
+/remind cancel <id>
+/remind clear
+/remind snooze <id> 5m
+/remind aiwatch on|off       # toggle the LLM intent detector
+
+# Disable LLM polish for one reminder
+/remind literal 每5分钟 喝水
+```
+
+**Three creation paths** (all land in the same `~/.im-hub/reminders.db`):
+
+1. **`/remind` slash** — explicit, structured input
+2. **LLM intent detection** (default-on) — say "明天早上8点提醒我开会" without `/remind`, the bot pops a confirmation card; reply `y` to create
+3. **Agent MCP tools** — claude-code and opencode (stdio) auto-call `create_reminder` when you mention future commitments in chat. Works with opencode (http) too via single-user agent-asserted context
+
+**Two delivery enhancements**:
+
+- **LLM polish** (default-on): at fire time the active agent rewrites the literal seed text into a natural one-liner ("早上好，记得喝杯水"). Tone constrained: *no flattery, no over-humor, no exaggeration*. Falls back to literal text on agent failure / timeout
+- **Late-delivery tag**: > 1 h overdue gets `⏰ 延迟投递` prefix so users know the bot was offline
+
+Manage reminders in the web UI at `/reminders` (status filters, snooze, cancel).
+
+Full design: [`docs/architecture/reminders.md`](docs/architecture/reminders.md).
+
+## Configuration
+
+### Config file
+`~/.im-hub/config.json` (validated by zod at startup):
+
+```json
+{
+  "messengers": ["wechat-ilink", "telegram"],
+  "agents": ["claude-code", "opencode"],
+  "defaultAgent": "claude-code",
+  "telegram": { "botToken": "***" },
+  "acpAgents": [
+    {
+      "name": "my-agent",
+      "endpoint": "https://api.example.com",
+      "auth": { "type": "bearer", "token": "***" }
+    }
+  ],
+  "workspaces": [
+    {
+      "id": "team-data",
+      "name": "Data team",
+      "agents": ["opencode", "my-agent"],
+      "members": ["user-123"],
+      "rateLimit": { "rate": 30, "intervalSec": 60, "burst": 60 }
+    }
+  ]
+}
+```
+
+### Email reminders (SMTP)
+
+To enable `/remind email …`, set these environment variables before starting:
+
+```bash
+# Required
+export IMHUB_SMTP_HOST=smtp.gmail.com
+export IMHUB_SMTP_USER=you@gmail.com
+export IMHUB_SMTP_PASS=<16-char-app-password>      # NOT your normal password
+
+# Optional
+export IMHUB_SMTP_PORT=465                         # default 465
+export IMHUB_SMTP_FROM=you@gmail.com               # default = USER
+export IMHUB_SMTP_SECURE=auto                      # auto | true | false
+```
+
+**Provider quick reference**:
+
+| Provider | HOST | PORT | Notes |
+|----------|------|------|-------|
+| Gmail | `smtp.gmail.com` | 465 | Use [App Password](https://myaccount.google.com/apppasswords) — 2-Step Verification required |
+| QQ Mail | `smtp.qq.com` | 465 | "授权码" (account → POP3/SMTP service) |
+| 163 Mail | `smtp.163.com` | 465 | "授权码" (account → POP3/SMTP/IMAP service) |
+| Outlook | `smtp-mail.outlook.com` | 587 | Set `IMHUB_SMTP_SECURE=false` (STARTTLS) |
+| Custom | any host | any port | Set `SECURE` per provider docs |
+
+Without these env vars, the email adapter still loads but `/remind email …` returns "Email adapter not configured" — IM reminders keep working.
+
+For systemd, put env in your unit file:
+```ini
+[Service]
+Environment="IMHUB_SMTP_HOST=smtp.gmail.com"
+Environment="IMHUB_SMTP_USER=you@gmail.com"
+Environment="IMHUB_SMTP_PASS=xxxxxxxxxxxxxxxx"
+```
+
+### Other env vars
+
+| Env | Default | What it does |
+|-----|---------|-------------|
+| `IMHUB_WEB_BIND` | `127.0.0.1` | Web UI bind address (set `0.0.0.0` to expose; front with HTTPS reverse proxy) |
+| `IMHUB_APPROVAL_DISABLED` | unset | Set `=1` to skip the human-in-the-loop tool approval gate |
+| `IMHUB_OPENCODE_DRIVER` | `stdio` | `http` selects the HTTP driver (faster, but reminder MCP path uses single-user agent-asserted context) |
+| `IMHUB_OPENCODE_GATE` | `medium` | `strict` / `loose` / `none` — opencode permission gate |
+| `IM_HUB_LLM_JUDGE_AGENT` | unset | Agent name used as LLM router fallback judge |
+| `OPENAI_API_KEY` | unset | Enables OpenAI Whisper for voice transcription |
+| `IMHUB_WHISPERCPP_BIN` + `IMHUB_WHISPERCPP_MODEL` | unset | Local Whisper.cpp for voice transcription (no cloud) |
+
 ## Architecture
 
 ```
@@ -145,35 +274,6 @@ Single process, zero external dependencies — SQLite + session files are the en
 
 For the full deep-dive see [`docs/architecture/current.md`](docs/architecture/current.md).
 
-## Configuration
-
-Config file: `~/.im-hub/config.json` (validated by zod at startup)
-
-```json
-{
-  "messengers": ["wechat", "telegram"],
-  "agents": ["claude-code", "opencode"],
-  "defaultAgent": "claude-code",
-  "telegram": { "botToken": "***" },
-  "acpAgents": [
-    {
-      "name": "my-agent",
-      "endpoint": "https://api.example.com",
-      "auth": { "type": "bearer", "token": "***" }
-    }
-  ],
-  "workspaces": [
-    {
-      "id": "team-data",
-      "name": "Data team",
-      "agents": ["opencode", "my-agent"],
-      "members": ["user-123"],
-      "rateLimit": { "rate": 30, "intervalSec": 60, "burst": 60 }
-    }
-  ]
-}
-```
-
 ## Requirements
 
 - **Node.js ≥ 18** (≥ 22 LTS recommended)
@@ -215,9 +315,11 @@ See [`docs/deployment.md`](docs/deployment.md) for systemd, Docker, nginx, monit
 | v0.2.20–23 | Web console — theme, approvals, SSE, files, batch ops |
 | v0.2.30 | Production hardening — session isolation, serial WS, loopback bind |
 | v0.2.35 | WeChat & Telegram rich media — image / file / voice / video |
+| v0.2.37 | Reminders subsystem — `/remind`, LLM intent + polish, agent MCP tools, email channel, web `/reminders`, WeChat context_token persistence |
 
 ### v0.3.0 (next)
 
+- [ ] codex MCP-server mode (so codex can use reminder tools too)
 - [ ] DingTalk adapter
 - [ ] Slack adapter
 - [ ] Feishu / Discord button-style approval cards

package/README.zh-CN.md

@@ -8,8 +8,9 @@
 
 ## 亮点
 
-- **4 种 IM 通道，4+ 种 Agent** — 微信（图片 / 文件 / 语音）、飞书、Telegram、Discord；Claude Code、Codex、Copilot、OpenCode，以及任意 ACP 端点
-- **浏览器控制台** — 对话界面、任务面板（Jobs / 调度 / 审批 / 健康 / 文件 / 审计）、设置页含工作区 CRUD
+- **4 种 IM + 邮件，4+ 种 Agent** — 微信（图片 / 文件 / 语音）、飞书、Telegram、Discord、Email（SMTP）；Claude Code、Codex、Copilot、OpenCode，以及任意 ACP 端点
+- **`/remind` 提醒子系统** — 一次性 + 定期（`每天8点喝水`）；非 slash 消息 LLM 自动识别意图；LLM 润色投递文本；Agent MCP 工具直接创建；Web `/reminders` 管理页；邮件 + IM 双通道投递
+- **浏览器控制台** — 对话界面、任务面板（Jobs / 调度 / 审批 / 健康 / 文件 / 审计）、提醒面板、设置页含工作区 CRUD
 - **工具调用人审（HITL）** — Claude 调用工具时暂停，IM 回复 `y`/`n` 或在页面点卡片审批；全平台一致
 - **微信和 Telegram 富媒体** — 接收图片、文件、视频；语音消息支持微信 STT、OpenAI Whisper、whisper.cpp 转写
 - **智能路由** — 意图分类（中英文）、Sticky 会话、断路器、限流器
@@ -52,8 +53,9 @@ im-hub-pro start          # 配置、环境变量、Header 全部不变
 
 | 分类 | 内容 |
 |------|------|
-| **IM 通道** | 微信（iLink — 图片 / 文件 / 语音 / 视频）、飞书（WebSocket）、Telegram（grammy — 图片 / 语音 / 音频）、Discord（discord.js） |
+| **IM 通道** | 微信（iLink — 图片 / 文件 / 语音 / 视频）、飞书（WebSocket）、Telegram（grammy — 图片 / 语音 / 音频）、Discord（discord.js）、Email（SMTP，仅推送） |
 | **Agent** | Claude Code、Codex、Copilot、OpenCode（统一 `AgentBase`）；任何 HTTP Agent 通过 ACP 接入 |
+| **提醒** | `/remind` slash、LLM 意图识别、LLM 润色投递、Agent MCP 工具（claude-code + opencode）、Web `/reminders` 页面 |
 | **Web 控制台** | 流式对话、三态主题（浅 / 深 / 跟随系统）、中英双语、SSE 实时仪表盘 |
 | **工具人审** | IM 端 + 页面内审批卡；Claude MCP sidecar |
 | **任务** | SQLite 持久化 Job Board + cron 调度；批量操作；后台任务读取 |
@@ -85,9 +87,10 @@ im-hub-pro messengers      # 列出可用 IM
 | `/new` | 开新会话（清空历史） |
 | `/model [provider/model]` | 查看或切换模型 |
 | `/think on\|off` | 切换深度思考模式 |
+| `/remind …` | 提醒子系统 — 详见 [提醒](#提醒) |
 | `/job`、`/schedule`、`/audit`、`/stats` | 管理任务、调度、审计、统计 |
 | `/router status\|explain` | 查看路由策略 |
-| `y` / `n` / `批准` / `拒绝` | 同意 / 拒绝 Claude 工具调用 |
+| `y` / `n` / `批准` / `拒绝` | 同意 / 拒绝（工具调用 或 提醒确认卡片） |
 
 ## 工具调用人审
 
@@ -102,6 +105,132 @@ im-hub-pro messengers      # 列出可用 IM
 
 在 IM 回复 `y` / `n`，或在 Web 界面点 Allow / Deny。微信、Telegram、飞书、Discord 行为一致。`IMHUB_APPROVAL_DISABLED=1` 可关闭。
 
+## 提醒
+
+内置 `/remind` 子系统——一次性 / 定期，三种创建路径，三种投递增强。
+
+```bash
+# 一次性
+/remind 2m 喝水
+/remind 40秒喝水
+/remind 下午6点下班
+/remind 18:30 出门
+
+# 定期 🔁
+/remind 每5分钟看屏幕外
+/remind 每天早上8点喝水
+/remind 每周一三五9点站会
+/remind 每个工作日18:00下班
+
+# 邮件 ✉️ （需要 SMTP 配置——见 [配置](#配置)）
+/remind email me@x.com 8:00 早安
+/remind bindemail me@x.com   # 绑定默认邮箱 → /remind email 每天8点 早安
+/remind unbindemail
+
+# 管理
+/remind list
+/remind cancel <id>
+/remind clear
+/remind snooze <id> 5m
+/remind aiwatch on|off       # 切换 LLM 意图识别
+
+# 关掉某条提醒的 LLM 润色
+/remind literal 每5分钟 喝水
+```
+
+**三种创建路径**（最终都落到同一个 `~/.im-hub/reminders.db`）：
+
+1. **`/remind` slash** — 显式、结构化输入
+2. **LLM 意图识别**（默认开启）— 直接说"明天早上8点提醒我开会"，机器人弹"要不要为这件事设个提醒？"卡片，回复 `y` 创建
+3. **Agent MCP 工具** — 在 claude-code / opencode (stdio) 会话里聊到未来事件时，agent 自动调 `create_reminder`。opencode (http) 走单用户 agent-asserted context 路径
+
+**两种投递增强**：
+
+- **LLM 润色**（默认开启）：触发时由当前 agent 把字面文本重写成自然提醒（"早上好，记得喝杯水"）。系统约束：**不献媚、不过度幽默、不夸大**。Agent 失败 / 超时时回退字面文本
+- **延迟投递标记**：超过 1 小时未投递的提醒前缀加 `⏰ 延迟投递`，让用户知道 bot 离线过
+
+Web 界面 `/reminders` 可视化管理（状态筛选、延后、取消）。
+
+完整设计：[`docs/architecture/reminders.md`](docs/architecture/reminders.md)。
+
+## 配置
+
+### 配置文件
+`~/.im-hub/config.json`（启动时 zod 校验）：
+
+```json
+{
+  "messengers": ["wechat-ilink", "telegram"],
+  "agents": ["claude-code", "opencode"],
+  "defaultAgent": "claude-code",
+  "telegram": { "botToken": "***" },
+  "acpAgents": [
+    {
+      "name": "my-agent",
+      "endpoint": "https://api.example.com",
+      "auth": { "type": "bearer", "token": "***" }
+    }
+  ],
+  "workspaces": [
+    {
+      "id": "team-data",
+      "name": "数据团队",
+      "agents": ["opencode", "my-agent"],
+      "members": ["user-123"],
+      "rateLimit": { "rate": 30, "intervalSec": 60, "burst": 60 }
+    }
+  ]
+}
+```
+
+### 邮件提醒（SMTP）
+
+要启用 `/remind email …`，启动前设置以下环境变量：
+
+```bash
+# 必填
+export IMHUB_SMTP_HOST=smtp.gmail.com
+export IMHUB_SMTP_USER=you@gmail.com
+export IMHUB_SMTP_PASS=<16位应用专用密码>      # 不是登录密码
+
+# 可选
+export IMHUB_SMTP_PORT=465                    # 默认 465
+export IMHUB_SMTP_FROM=you@gmail.com          # 默认 = USER
+export IMHUB_SMTP_SECURE=auto                 # auto | true | false
+```
+
+**常见邮箱配置参考**：
+
+| 服务商 | HOST | PORT | 备注 |
+|-------|------|------|------|
+| Gmail | `smtp.gmail.com` | 465 | 用 [应用专用密码](https://myaccount.google.com/apppasswords)，需先开两步验证 |
+| QQ 邮箱 | `smtp.qq.com` | 465 | 设置 → 账号 → POP3/SMTP 服务 → 授权码 |
+| 163 邮箱 | `smtp.163.com` | 465 | 设置 → POP3/SMTP/IMAP → 授权码 |
+| Outlook | `smtp-mail.outlook.com` | 587 | 设 `IMHUB_SMTP_SECURE=false`（STARTTLS） |
+| 企业邮箱 | 厂商提供 | 任意 | `SECURE` 按厂商文档设 |
+
+不设这些环境变量也不会启动失败——邮件 adapter 仍会注册，但 `/remind email …` 会返回"Email adapter not configured"，IM 提醒不受影响。
+
+systemd 部署示例：
+```ini
+[Service]
+Environment="IMHUB_SMTP_HOST=smtp.gmail.com"
+Environment="IMHUB_SMTP_USER=you@gmail.com"
+Environment="IMHUB_SMTP_PASS=xxxxxxxxxxxxxxxx"
+```
+
+### 其他环境变量
+
+| 变量 | 默认值 | 作用 |
+|------|--------|------|
+| `IMHUB_WEB_BIND` | `127.0.0.1` | Web UI 监听地址（设 `0.0.0.0` 对外暴露，建议前面挂 HTTPS 反代） |
+| `IMHUB_APPROVAL_DISABLED` | 未设 | 设 `=1` 跳过工具调用人审 |
+| `IMHUB_OPENCODE_DRIVER` | `stdio` | 设 `http` 启用 HTTP driver（更快，但 reminder MCP 路径会走单用户 agent-asserted context） |
+| `IMHUB_OPENCODE_GATE` | `medium` | `strict` / `loose` / `none` — opencode 权限闸 |
+| `IM_HUB_LLM_JUDGE_AGENT` | 未设 | 路由分类失败时用作兜底的 LLM judge agent 名 |
+| `OPENAI_API_KEY` | 未设 | 启用 OpenAI Whisper 做语音转写 |
+| `IMHUB_WHISPERCPP_BIN` + `IMHUB_WHISPERCPP_MODEL` | 未设 | 本地 Whisper.cpp 转写（不走云） |
+
 ## 架构
 
 ```
@@ -145,35 +274,6 @@ im-hub-pro messengers      # 列出可用 IM
 
 深入架构详见 [`docs/architecture/current.md`](docs/architecture/current.md)。
 
-## 配置
-
-配置文件：`~/.im-hub/config.json`（启动时 zod 校验）
-
-```json
-{
-  "messengers": ["wechat", "telegram"],
-  "agents": ["claude-code", "opencode"],
-  "defaultAgent": "claude-code",
-  "telegram": { "botToken": "***" },
-  "acpAgents": [
-    {
-      "name": "my-agent",
-      "endpoint": "https://api.example.com",
-      "auth": { "type": "bearer", "token": "***" }
-    }
-  ],
-  "workspaces": [
-    {
-      "id": "team-data",
-      "name": "数据团队",
-      "agents": ["opencode", "my-agent"],
-      "members": ["user-123"],
-      "rateLimit": { "rate": 30, "intervalSec": 60, "burst": 60 }
-    }
-  ]
-}
-```
-
 ## 环境要求
 
 - **Node.js ≥ 18**（推荐 ≥ 22 LTS）
@@ -215,9 +315,11 @@ systemd、Docker、nginx、监控与升级详见 [`docs/deployment.md`](docs/dep
 | v0.2.20–23 | Web 控制台 — 主题、审批、SSE、文件、批量操作 |
 | v0.2.30 | 生产硬化 — 会话隔离、WS 串行、回环监听 |
 | v0.2.35 | 微信和 Telegram 富媒体 — 图片 / 文件 / 语音 / 视频 |
+| v0.2.37 | 提醒子系统 — `/remind`、LLM 意图识别 + 润色、Agent MCP 工具、邮件通道、Web `/reminders`、微信 context_token 持久化 |
 
 ### v0.3.0（下一版）
 
+- [ ] codex MCP-server 模式（让 codex 也能用提醒工具）
 - [ ] 钉钉适配器
 - [ ] Slack 适配器
 - [ ] 飞书 / Discord 卡片按钮版审批

package/dist/cli.js

@@ -22,6 +22,10 @@ import { workspaceRegistry } from './core/workspace.js';
 import { bootstrapAgentWorkspaces } from './core/agent-cwd.js';
 import { approvalBus, threadKey } from './core/approval-bus.js';
 import { install as installApprovalRouter, tryHandleApprovalReply, platformToMessengerName } from './core/approval-router.js';
+import { tryConsumeReply as tryConsumePendingReminderReply } from './core/pending-reminder.js';
+import { tryDetectReminderIntent } from './core/remind-intent.js';
+import { createReminder } from './core/reminders.js';
+import { setReminderConfirmNotifier } from './core/reminder-rpc.js';
 import { checkMessengerConfig, checkAgentAvailability, runMessengerOnboarding, formatAgentInstallHint, formatMessengerStartError, loadConfig as loadOnboardingConfig, saveConfig as saveOnboardingConfig, } from './core/onboarding.js';
 import { startWebServer } from './web/server.js';
 import { startACPServer } from './core/acp-server.js';
@@ -89,6 +93,12 @@ program
         try {
             const sockPath = await approvalBus.start();
             console.log(`✅ Approval bus listening on ${sockPath}`);
+            // Expose the path through env so long-lived child processes
+            // (notably `opencode serve`, which spawns the MCP sidecar with
+            // `env: process.env`) can connect without per-spawn config.
+            // claude-code and opencode stdio still set this per-spawn via
+            // extraEnv — that override wins inside their spawn scope.
+            process.env.IMHUB_APPROVAL_SOCK = sockPath;
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
@@ -116,6 +126,20 @@ program
         console.warn(`⚠️ Agent workspace bootstrap failed: ${msg}`);
         console.warn('   Agents will fall back to im-hub-pro cwd ("/" under systemd)');
     }
+    // Register the imhub MCP server in opencode's global config so opencode
+    // (stdio mode) can see the reminder tools. Idempotent; quietly skips if
+    // opencode isn't installed / no config dir / write fails. HTTP mode
+    // can't use this — see ensure-mcp-config.ts comments.
+    try {
+        const { ensureOpencodeMcpRegistered } = await import('./plugins/agents/opencode/ensure-mcp-config.js');
+        const wrote = await ensureOpencodeMcpRegistered();
+        if (wrote)
+            console.log('🔧 Registered imhub MCP in opencode global config');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`⚠️ opencode MCP registration skipped: ${msg}`);
+    }
     // Load ACP (remote) agents from config
     if (config.acpAgents?.length) {
         await registry.loadACPAgents(config.acpAgents);
@@ -128,6 +152,9 @@ program
     // Start the scheduler (runs cron-due schedules every 30s)
     const { startScheduler } = await import('./core/schedule.js');
     startScheduler();
+    // Start the reminder engine (one-shot lightweight timers, 5s tick)
+    const { startReminderEngine } = await import('./core/reminders.js');
+    startReminderEngine();
     // ============================================
     // ONBOARDING CHECKS (before default fill!)
     // ============================================
@@ -166,8 +193,15 @@ program
     // ============================================
     // Get messengers to start (now config.messengers is populated)
     const messengersToStart = config.messengers.length > 0
-        ? config.messengers
+        ? [...config.messengers]
         : ['wechat-ilink']; // Fallback default
+    // Auto-include the email adapter so /remind email ... works without
+    // explicit `im-hub-pro config email`. The adapter's start() is fail-soft
+    // when SMTP env vars are missing — it stays "registered but disabled"
+    // and any actual send call throws a clear "not configured" error.
+    if (!messengersToStart.includes('email')) {
+        messengersToStart.push('email');
+    }
     // Start messenger adapters
     for (const name of messengersToStart) {
         const messenger = registry.getMessenger(name);
@@ -190,6 +224,67 @@ program
                 ctx.logger.info({ event: 'message.consumed_by_approval' });
                 return;
             }
+            // Reminder-intent confirmation reply ("y"/"n" to a previously-
+            // proposed reminder card). Must come BEFORE the detector so a
+            // user replying "y" doesn't get re-detected as another reminder.
+            const tk = `${ctx.platform}:${ctx.channelId}:${ctx.message.threadId}`;
+            const replyDecision = tryConsumePendingReminderReply(tk, ctx.message.text);
+            if (replyDecision) {
+                if (replyDecision.decision === 'cancel') {
+                    await messenger.sendMessage(ctx.message.threadId, '✅ 已忽略这条提醒建议');
+                }
+                else {
+                    const p = replyDecision.pending;
+                    try {
+                        const id = createReminder({
+                            fireAt: p.fireAt,
+                            text: p.text,
+                            platform: ctx.platform,
+                            channelId: ctx.channelId,
+                            threadId: ctx.message.threadId,
+                            userId: ctx.message.userId || '',
+                            source: 'slash',
+                            recurrence: p.recurrence,
+                        });
+                        const recurLine = p.recurrence ? `\n   循环：${p.recurrence}` : '';
+                        await messenger.sendMessage(ctx.message.threadId, `✅ 已创建提醒 #${id}\n   触发：${p.fireAt.toLocaleString()}${recurLine}\n   内容：${p.text}`);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        await messenger.sendMessage(ctx.message.threadId, `❌ 创建失败：${msg}`);
+                    }
+                }
+                ctx.logger.info({ event: 'message.consumed_by_pending_reminder', decision: replyDecision.decision });
+                return;
+            }
+            // Reminder-intent detector: only on non-slash messages and only
+            // when the user has aiwatch on. Cheap regex pre-filter inside the
+            // detector skips most messages without a time hint, so the LLM
+            // call only fires on plausible candidates.
+            if (!ctx.message.text.trim().startsWith('/')) {
+                try {
+                    const detected = await tryDetectReminderIntent({
+                        platform: ctx.platform,
+                        channelId: ctx.channelId,
+                        threadId: ctx.message.threadId,
+                        userId: ctx.message.userId || '',
+                        text: ctx.message.text,
+                    });
+                    if (detected.handled && detected.reply) {
+                        await messenger.sendMessage(ctx.message.threadId, detected.reply);
+                        ctx.logger.info({ event: 'message.proposed_reminder' });
+                        return;
+                    }
+                }
+                catch (err) {
+                    // Detector must never break the message pipeline. Log and
+                    // fall through to normal agent dispatch.
+                    ctx.logger.warn({
+                        event: 'remind-intent.crashed',
+                        err: err instanceof Error ? err.message : String(err),
+                    }, 'detector crashed — falling through to normal agent flow');
+                }
+            }
             await handleMessage(ctx, config.defaultAgent);
         });
         try {
@@ -216,6 +311,19 @@ program
         });
         console.log('✅ Approval router wired to messengers');
     }
+    // Reminder confirm notifier — used by reminder-rpc.ts when an agent
+    // creates a high-frequency + LLM-polish reminder (those go through a
+    // y/n card before landing in the DB). Plain message via the same
+    // messenger the agent is talking on.
+    setReminderConfirmNotifier(async (ctx, message) => {
+        const messenger = registry.getMessenger(platformToMessengerName(ctx.platform))
+            ?? registry.getMessenger(ctx.platform);
+        if (!messenger) {
+            console.warn(`reminder-confirm: no messenger for platform "${ctx.platform}"`);
+            return;
+        }
+        await messenger.sendMessage(ctx.threadId, message);
+    });
     // ============================================
     // START WEB CHAT SERVER
     // ============================================
@@ -293,6 +401,12 @@ program
             closeScheduleDb();
         }
         catch { /* ignore */ }
+        try {
+            const { stopReminderEngine, closeReminderDb } = await import('./core/reminders.js');
+            stopReminderEngine();
+            closeReminderDb();
+        }
+        catch { /* ignore */ }
         process.exit(0);
     });
     // Wait forever