agim-cli 1.0.1

package/README.zh-CN.md

@@ -0,0 +1,414 @@
+# Agim · 阿吉姆
+
+[English](README.md)
+
+**IM 到 AI Agent 的万能桥梁** — 将微信 / 飞书 / 钉钉 / Telegram / Discord 接入 Claude Code / Codex / Copilot / OpenCode，或通过 ACP 接入任意自定义 Agent。单 Node.js 进程，无需 Docker / Redis。
+
+> **品牌**：英文名 **Agim**（取自 Agent + IM，也有 agile 敏捷的感觉），中文名 **阿吉姆**。
+> npm 包名 **`agim-cli`**（短名 `agim` 被 npm 反 typo-squat 保留），装完后**命令**还是 **`agim`**，
+> 日常打的就是这个。老命令 `im-hub-pro` 也保留为别名，老的 systemd 单元和 shell 别名不会断。
+> 配置目录新装默认 **`~/.agim/`**，已有 **`~/.im-hub/`** 的老用户会被自动识别继续沿用。
+> 环境变量（`IMHUB_*`）、HTTP 头（`X-IM-Hub-Token`）、systemd 单元 `im-hub.service` 都保留
+> 原名以兼容 0.x 部署——详见 [迁移](#迁移)。
+
+## 亮点
+
+- **5 种 IM + 邮件，4+ 种 Agent** — 微信（图片 / 文件 / 语音）、飞书、钉钉（图片 / 语音，自带服务端 ASR）、Telegram、Discord、Email（SMTP）；Claude Code、Codex、Copilot、OpenCode，以及任意 ACP 端点
+- **`/remind` 提醒子系统** — 一次性 + 定期（`每天8点喝水`）；非 slash 消息 LLM 自动识别意图；LLM 润色投递文本；Agent MCP 工具直接创建；Web `/reminders` 管理页；邮件 + IM 双通道投递
+- **`/memo` 5W1H 持久记忆库** — 通用「what / who / when / where / how / why」记事本，可选 GPS（浏览器地理定位 H5 + 百度地理编码）；默认永久保存，临时类（停车、当天会议）单独走 24h 桶；Agent 通过 MCP 工具自动落库 + 检索，闲聊里提到的地点 / 生日 / 待办都能记下
+- **浏览器控制台** — 对话界面、任务面板（Jobs / 调度 / 审批 / 健康 / 文件 / 审计）、提醒面板、设置页含工作区 CRUD
+- **工具调用人审（HITL）** — Claude 调用工具时暂停，IM 回复 `y`/`n` 或在页面点卡片审批；全平台一致
+- **微信 / Telegram / 钉钉 富媒体** — 接收图片、文件、视频；语音消息按平台走最佳转写链路：微信 STT、钉钉服务端 ASR、OpenAI Whisper、whisper.cpp
+- **智能路由** — 意图分类（中英文）、Sticky 会话、断路器、限流器
+- **多租户工作区** — 按工作区隔离 Agent 白名单、限流、命令级 ACL
+- **持久化任务与定时** — SQLite 落地，重启不丢，30 天自动修剪
+- **可观测** — 结构化日志（pino + traceId）、Prometheus 指标、审计日志
+- **安全** — 常量时鉴权、SSRF 防护、凭证文件权限、审批 socket 熵值
+
+完整版本历史见 [CHANGELOG.md](CHANGELOG.md)。
+
+## 快速开始
+
+```bash
+npm install -g agim-cli      # 需要 Node.js ≥ 18（推荐 ≥ 22 LTS）
+
+# 配置至少一个 IM
+agim                            # 交互式向导（推荐）—— 双语，方向键选语言后逐项配置
+                                # 也可以走老的子命令：
+agim config wechat              # 扫码登录
+agim config feishu              # 飞书 App ID + Secret，无需 webhook
+agim config dingtalk            # 钉钉 ClientID + ClientSecret（Stream 模式机器人）
+agim config telegram            # @BotFather 拿 Token
+agim config discord             # Bot Token，详见 docs/discord-setup.md
+
+# （可选）通过 ACP 接入远端自定义 Agent
+agim config agent
+
+# 启动
+agim start
+```
+
+浏览器访问 `http://localhost:3000` — 对话 `/`、任务 `/tasks`、设置 `/settings`。
+
+### 迁移
+
+#### 从原 `im-hub` 迁移
+```bash
+npm uninstall -g im-hub
+npm install -g agim-cli
+agim start            # 配置、环境变量、Header 全部不变
+```
+
+#### 从 `im-hub-pro`（0.x → 1.0）迁移
+```bash
+npm uninstall -g im-hub-pro
+npm install -g agim-cli
+agim start            # 配置目录、环境变量、Header 全部不变
+```
+
+npm 包名是 `agim-cli`（短名 `agim` 被 npm 反 typo-squat 保留了）；安装后**命令**还是 `agim`，
+日常打命令就是 `agim …`。`im-hub-pro` 命令也保留为别名，原有的 systemd 单元和别名脚本不用动。
+
+## 功能一览
+
+| 分类 | 内容 |
+|------|------|
+| **IM 通道** | 微信（iLink — 图片 / 文件 / 语音 / 视频）、飞书（WebSocket）、钉钉（Stream 模式 — 图片 / 语音，自带服务端 ASR）、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 调度；批量操作；后台任务读取 |
+| **路由** | 意图分类、断路器、限流、Sticky 会话、LLM 兜底 |
+| **工作区** | 多租户；Agent 白名单 + 限流；命令级 ACL |
+| **可观测** | pino 结构化日志、traceId、Prometheus `/api/metrics`、SQLite 审计 |
+| **ACP** | 客户端（连接远端 Agent）+ 服务端（阿吉姆自身作为 ACP Agent） |
+
+## CLI 命令
+
+```
+agim                       # 交互式向导（双语，推荐入口）
+agim start                 # 启动桥接 + Web 界面（前台）
+agim start --bg            # 后台守护进程模式
+agim status                # 查看服务状态（systemd / bg / fg）
+agim restart               # 重启正在运行的服务
+agim stop                  # 停止服务
+agim uninstall             # 卸载（保留 ~/.im-hub-workspaces/）
+agim config wechat         # 配置微信
+agim config feishu         # 配置飞书
+agim config dingtalk       # 配置钉钉（Stream 模式企业内部应用）
+agim config telegram       # 配置 Telegram
+agim config discord        # 配置 Discord
+agim config claude         # 配置 Claude Code
+agim config agent          # 接入自定义 ACP Agent
+agim agents                # 列出可用 Agent
+agim messengers            # 列出可用 IM
+# （`im-hub-pro …` 作为别名继续可用）
+```
+
+## 聊天命令
+
+| 命令 | 含义 |
+|------|------|
+| 任意文本 | 路由到 Agent（Sticky 会话 + 意图分类） |
+| `/<agent> <内容>` | 切换 Agent — `/cc`、`/oc`、`/cx`、`/co` |
+| `/new` | 开新会话（清空历史） |
+| `/model [provider/model]` | 查看或切换模型 |
+| `/think on\|off` | 切换深度思考模式 |
+| `/remind …` | 提醒子系统 — 详见 [提醒](#提醒) |
+| `/memo …` | 5W1H 持久记忆库 — 详见 [备忘](#备忘)（别名 `/记`、`/note`）|
+| `/job`、`/cron`、`/audit`、`/stats` | 管理任务、定时、审计、统计（`/schedule` 仍是 `/cron` 别名，v0.4.0 移除） |
+| `/router status\|explain` | 查看路由策略 |
+| `y` / `n` / `批准` / `拒绝` | 同意 / 拒绝（工具调用 或 提醒确认卡片） |
+
+## 工具调用人审
+
+当 Claude 尝试调用工具时，阿吉姆会暂停并发送审批卡：
+
+```
+🔐 工具调用审批请求
+工具：Bash
+入参：{"command":"rm -rf node_modules"}
+回复 y 批准 / n 拒绝（5 分钟内未操作将自动拒绝）
+```
+
+在 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)。
+
+## 备忘
+
+`/memo` 是一个 5W1H 持久记忆库。每条 memo 都可以挂上 `what` / `who` / `when_at` / `where (lat/lng/label)` / `how` / `why` 任意子集，外加可选的 `expires_at` 生命周期。位置只是其中一个轴 —— 同一个工具也能记「我爸生日 5月8日」「苹果发了 AVP2」。
+
+```bash
+# Slash
+/memo                          # 搜索提示 + 最近的 memo
+/memo list                     # 最近 10 条
+/memo show <id>
+/memo delete <id>
+/memo search 茶馆
+/memo here [备注]              # 一次性 HTTPS 链接 → 浏览器抓 GPS
+/memo 39.9,116.4 家            # 直接给坐标 + label
+
+# 别名：/记、/note
+```
+
+Agent（claude-code / opencode）能看到 5 个 MCP 工具，遇到值得记的内容**自动调用**——不用打 slash：
+
+- `save_memo` —— 从自然语言里抽 5W1H 落库；`address` 参数走百度地理编码补全坐标
+- `request_location_capture` —— 返回一次性 H5 链接让用户在 IM 内置浏览器授权 GPS
+- `search_memos` —— 多字段 AND-combined 检索（"我的车在哪"）
+- `update_memo` —— patch 已有 memo（比如后补 `where_*`，或传 `address` 让后端 geocode）
+- `delete_memo`
+
+**生命周期分层**：默认所有 memo 永久；agent 判定为临时性内容（"我把车停这了" / "今天下午3点开会"）才 set `expires_in_hours`，后台每 5 分钟跑一次 sweep 删掉到期行。
+
+**时区**：所有时间按 Asia/Shanghai (UTC+8) 解读，存为不带 `Z` / 偏移的 `YYYY-MM-DD HH:MM:SS`。其他时区部署设 `IMHUB_TZ_OFFSET_HOURS` 即可。
+
+**浏览器 GPS 抓取**：`/memo here` 和 `request_location_capture` 都会发一个 10 分钟有效的一次性 HTTPS 链接，默认 base 是 `https://agent.iclaw.host`（公共托管入口）。自己有 HTTPS 域名的用户设 `IMHUB_LOC_BASE_URL=https://your-host` 让链接走自己的域。
+
+**地址转坐标（可选）**：设 `IMHUB_BAIDU_MAP_AK` 一个百度地图 AK 之后，agent 在 `save_memo` / `update_memo` 里就能直接传 `address: "中关村大街27号"` 让后端 geocode 出坐标。不设的话该路径返回「geocoding not configured」，但**直接传坐标 + 浏览器抓 GPS 这两条路径都不受影响**。免费申请：[lbsyun.baidu.com](https://lbsyun.baidu.com/) → 控制台 → 应用管理 → 创建应用 → 服务端 API。默认无需 SN 签名；如启用 SN校验，详见 `src/core/locations.ts` 头注释。
+
+## 配置
+
+### 配置文件
+`~/.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 转写（不走云） |
+| `IMHUB_BAIDU_MAP_AK` | 未设 | 百度地图 AK；启用 `/memo` 地址→坐标 geocoding 路径。不设置时直接给坐标和浏览器抓 GPS 不受影响。 |
+| `IMHUB_LOC_BASE_URL` | `https://agent.iclaw.host` | `/memo here` H5 抓 GPS 链接的公开 HTTPS 域名。自托管时改成自己的域。 |
+| `IMHUB_TZ_OFFSET_HOURS` | `8` | memo 时间戳的 UTC 偏移（默认 Asia/Shanghai）。仅当部署在其他时区时调整。 |
+| `IMHUB_TELEGRAM_COORDS_GCJ02` | 未设 | 设 `1` 对 Telegram 原生位置/venue 消息做 GCJ-02 → WGS-84 转换。默认关（直通），适合 Telegram Desktop / Android-without-China-GMS / 海外用户。如果你的 Telegram 客户端是国内 iOS 设备（Core Location 会加 GCJ 偏移），打开它。 |
+| `IMHUB_H5_COORDS_GCJ02` | 未设 | 设 `1` 对 `/memo here` H5 抓 GPS 的坐标做 GCJ-02 → WGS-84 转换。默认关（直通），匹配微信 X5 / Android Chrome 直给 WGS-84 的常见情况。如果你的用户主要在 iOS Safari / iOS WebKit 国内打开 H5 链接（Apple 会加 GCJ 偏移），打开它。完整每平台策略见 [`src/core/coord-systems.ts`](src/core/coord-systems.ts)。 |
+| `AGIM_HOME` | 自动 | 用户级配置/数据目录。全新安装默认 `~/.agim/`；从 0.x 升级则自动用现有的 `~/.im-hub/`。如果想固定到具体位置（多机共享、测试场景），显式设置即可。也认旧的 `IMHUB_HOME`。 |
+| `AGIM_WORKSPACES` | 自动 | per-agent 工作区目录。与 `AGIM_HOME` 一样的双探测（优先 `~/.agim-workspaces/`，存在 `~/.im-hub-workspaces/` 时用它）。也认 `IMHUB_WORKSPACES`。 |
+
+## 架构
+
+```
+┌─ IM 入口 ────────────────────────────────────────┐
+│ 微信 iLink     （长轮询 + 图片/语音/文件）        │
+│ Telegram       （grammy + 图片/语音/音频）        │
+│ 飞书           （Lark SDK WebSocket）             │
+│ 钉钉           （Stream WebSocket + 服务端 ASR）  │
+│ Discord        （discord.js Gateway）             │
+│ Web Chat       （浏览器 WebSocket）               │
+└───────────────────────┬──────────────────────────┘
+                        │ MessageContext
+                        ▼
+          ┌── 路由前置 gates ─────────────────┐
+          │ workspace · 限流器 · traceId      │
+          └────────────────┬──────────────────┘
+                           ▼
+          ┌── 意图路由 ───────────────────────┐
+          │ 命令 → 内置处理                    │
+          │ /agent → 显式切换                  │
+          │ 默认 → 分类（正则/关键词/          │
+          │         Sticky/LLM 兜底）          │
+          └────────────────┬──────────────────┘
+                           ▼
+          ┌── Agent 调用 ─────────────────────┐
+          │ 断路器 + spawn stream              │
+          └───┬──────┬──────┬──────┬──────┬───┘
+              ▼      ▼      ▼      ▼      ▼
+          claude  opencode codex copilot  ACP
+              │
+              ▼ （工具审批）
+        MCP sidecar → approvalBus → IM 会话
+
+┌─ Cross-cutting ──────────────────────────────────┐
+│ SQLite（审计 · 任务 · 调度）                      │
+│ 会话（append-only JSONL）                         │
+│ Prometheus 指标 · pino 结构化日志                  │
+└──────────────────────────────────────────────────┘
+```
+
+单进程，零外部依赖——SQLite + 会话文件就是全部持久化层。
+
+深入架构详见 [`docs/architecture/current.md`](docs/architecture/current.md)。
+
+## 环境要求
+
+- **Node.js ≥ 18**（推荐 ≥ 22 LTS）
+- 至少一个 Agent CLI 或 ACP 端点：
+  - `npm i -g @anthropic-ai/claude-code`
+  - `npm i -g @openai/codex`
+  - `npm i -g @github/copilot`
+  - `npm i -g opencode-ai`
+
+## 开发
+
+```bash
+git clone https://github.com/benking007/imhub.git && cd imhub
+npm install
+npm run build      # tsc + 拷贝 public/
+npm run dev        # tsc --watch
+npm test           # bun test
+npm run lint       # biome lint
+npm run typecheck  # tsc --noEmit
+```
+
+## 部署
+
+systemd、Docker、nginx、监控与升级详见 [`docs/deployment.md`](docs/deployment.md)。
+
+## 路线图
+
+### 已完成
+
+| 版本 | 主题 |
+|------|------|
+| v0.1.x | MVP — 微信 + 4 种 Agent + 命令路由 |
+| v0.2.0 | 多 IM — 飞书、Telegram、会话持久化、ACP |
+| v0.2.13 | 基础设施 — 日志、审计、意图、任务、指标、工作区 |
+| v0.2.14 | 工具调用人审（HITL） |
+| v0.2.15 | Discord 适配器 + 任务面板 |
+| v0.2.16–17 | 安全收口 + 可观测 |
+| v0.2.18–19 | IM 重连退避、Codex sandbox、仪表盘过滤 |
+| 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 | `/memo` 5W1H 持久记忆库 — `/location` → `/memo` 改名、地址 geocoding 接百度地图、opencode HTTP driver SSE 修复 |
+| v0.3.1 | Telegram + 飞书原生位置消息接入、所有渠道 GCJ-02 → WGS-84 修正、`memo` 列保存原话 + LLM/启发式 `what` 提取 |
+| v0.4.0 | codex 接入完整 imhub MCP 工具表（reminder + memo）；Telegram + 飞书位置消息改走 agent-driven 决策（对齐微信 H5 架构） |
+| v0.5.0–0.5.2 | `agim` 双语方向键向导（当时叫 `im-hub-pro`）；按渠道独立配置（微信扫码、飞书 / Telegram / Discord 凭据输入；agent CLI 安装态实时探测）；systemd unit env fallback；完整服务生命周期命令（`status / start --bg / restart / stop / uninstall`） |
+| v0.6.0 | 钉钉 Stream 模式适配器——WebSocket 双向桥、图片消息（`messageFiles/download` → claude-code 多模态 Read）、语音消息（钉钉服务端 ASR `recognition`，whisper.cpp 兜底） |
+| v0.6.3 | 各平台原生位置消息的坐标系按来源处理（Telegram 改为 WGS 直通；H5 改为 WGS 直通解决微信 X5 的偏移；钉钉 link 中的百度地图 URL 走 BD-09→WGS） |
+| **v1.0.0** | 品牌升级为 **Agim · 阿吉姆**。新主命令 `agim`，老命令 `im-hub-pro` 保留为废弃别名。配置目录 / 环境变量 / HTTP 头 / systemd 单元名都保留以兼容 0.x 部署。 |
+
+### v1.1.0（下一版）
+
+- [ ] Slack 适配器
+- [ ] 飞书 / 钉钉 / Discord 卡片按钮版审批
+- [ ] 多实例事件总线（Redis Streams / NATS）
+- [ ] 工作区成员选择 UI
+
+## 社区
+
+<p align="center">
+  <a href="https://deepseek.club/community/imhub">
+    <img src="https://deepseek.club/assets/logo-DH6LfKkF.png" style="width: 150px; height: auto;" alt="DeepSeek">
+  </a>
+</p>
+
+## 许可证
+
+MIT

package/dist/cli-ui/cmd-handlers.d.ts

@@ -0,0 +1,11 @@
+export declare function cmdStatus(): void;
+/**
+ * Foreground start is the legacy `program.command('start').action(...)`
+ * path in cli.ts — we DON'T re-implement it here, just delegate. For
+ * background, we re-spawn ourselves detached.
+ */
+export declare function cmdStart(bg: boolean, runForegroundStart: () => Promise<void>): Promise<void>;
+export declare function cmdStop(): Promise<void>;
+export declare function cmdRestart(): Promise<void>;
+export declare function cmdUninstall(): Promise<void>;
+//# sourceMappingURL=cmd-handlers.d.ts.map

package/dist/cli-ui/cmd-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-handlers.d.ts","sourceRoot":"","sources":["../../src/cli-ui/cmd-handlers.ts"],"names":[],"mappings":"AA0DA,wBAAgB,SAAS,IAAI,IAAI,CA+BhC;AAID;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiClG;AAID,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB7C;AAID,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBhD;AAID,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAoDlD"}

package/dist/cli-ui/cmd-handlers.js

@@ -0,0 +1,240 @@
+// cli-ui/cmd-handlers.ts — implementations of the 5 service-management
+// commands. Each handler reads the persisted language preference, prints
+// status / outcomes in that language, and shells out to systemctl / npm /
+// rm where appropriate.
+import { execSync, spawn } from 'node:child_process';
+import { unlinkSync, existsSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { detectService, spawnBackground, stopService, formatUptime, readWebEndpoint, PID_FILE, LOG_FILE, } from './service.js';
+import { yesNo } from './prompts.js';
+import { pickLang } from './lang-picker.js';
+import { readSavedLang, t } from './i18n.js';
+import { CONFIG_FILE, WORKSPACES_DIR } from './paths.js';
+import { ENV_FILE, removeEnvFile } from './env-file.js';
+/** Candidate paths for the systemd unit; v1.0 prefers `agim.service`,
+ *  pre-v1.0 wrote `im-hub.service`. Resolved at runtime by `findSystemdUnit()`
+ *  so we operate on whichever exists. */
+const SYSTEMD_UNIT_CANDIDATES = [
+    '/etc/systemd/system/agim.service',
+    '/etc/systemd/system/im-hub.service',
+];
+function findSystemdUnit() {
+    for (const path of SYSTEMD_UNIT_CANDIDATES) {
+        if (existsSync(path)) {
+            return { path, name: path.split('/').pop() ?? '' };
+        }
+    }
+    return null;
+}
+/** Path of the unit file, if any exists, for compat with code that
+ *  references this constant. Resolved lazily so cleanup can drop it. */
+function systemdUnitPath() {
+    return findSystemdUnit()?.path ?? null;
+}
+/** Pick whichever language is already saved, falling back to 'zh'. We
+ *  don't re-prompt for language inside per-command handlers — they
+ *  shouldn't disrupt scripted flows. */
+function quietLang() {
+    return readSavedLang() ?? 'zh';
+}
+// ─── status ──────────────────────────────────────────────────────────
+export function cmdStatus() {
+    const lang = quietLang();
+    console.log();
+    console.log(t(lang, 'svc.status.title'));
+    console.log('─'.repeat(50));
+    const st = detectService();
+    switch (st.mode) {
+        case 'systemd':
+            console.log('  ' + t(lang, 'svc.status.systemd_active', { pid: st.pid ?? '?' }));
+            break;
+        case 'background':
+            console.log('  ' + t(lang, 'svc.status.bg_running', { pid: st.pid ?? '?', log: LOG_FILE }));
+            break;
+        case 'foreground':
+            console.log('  ' + t(lang, 'svc.status.fg_running', { pid: st.pid ?? '?' }));
+            break;
+        case 'none':
+            console.log('  ' + t(lang, 'svc.status.not_running'));
+            if (systemdUnitPath()) {
+                console.log('  ' + t(lang, 'svc.status.systemd_inactive'));
+            }
+            return;
+    }
+    if (typeof st.uptimeSec === 'number') {
+        console.log('  ' + t(lang, 'svc.status.uptime', { duration: formatUptime(st.uptimeSec) }));
+    }
+    const web = readWebEndpoint();
+    if (web) {
+        console.log('  ' + t(lang, 'svc.status.web', { bind: web.bind, port: web.port }));
+    }
+    console.log();
+}
+// ─── start ───────────────────────────────────────────────────────────
+/**
+ * Foreground start is the legacy `program.command('start').action(...)`
+ * path in cli.ts — we DON'T re-implement it here, just delegate. For
+ * background, we re-spawn ourselves detached.
+ */
+export async function cmdStart(bg, runForegroundStart) {
+    const lang = quietLang();
+    const st = detectService();
+    if (st.mode === 'systemd') {
+        console.log(t(lang, 'svc.start.systemd_managed'));
+        return;
+    }
+    if (st.mode !== 'none') {
+        console.log(t(lang, 'svc.start.already_running', { pid: st.pid ?? '?' }));
+        return;
+    }
+    if (bg) {
+        console.log(t(lang, 'svc.start.starting_bg'));
+        // Re-exec self detached. Use the same node + cli.js paths so global vs
+        // local install both work.
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const cliJs = join(__dirname, '..', 'cli.js');
+        const { pid } = spawnBackground(process.execPath, [cliJs, 'start']);
+        // Tiny wait so the child has a chance to either bind ports or crash;
+        // status check picks up the latter.
+        await new Promise(r => setTimeout(r, 1500));
+        const after = detectService();
+        if (after.mode === 'background' && after.pid === pid) {
+            console.log(t(lang, 'svc.start.bg_ready', { pid, log: LOG_FILE }));
+            console.log(t(lang, 'svc.start.bg_hint'));
+        }
+        else {
+            console.log('⚠️ Background daemon may have failed to bind ports — check log:');
+            console.log(`   tail -n 40 ${LOG_FILE}`);
+        }
+        return;
+    }
+    console.log(t(lang, 'svc.start.starting_fg'));
+    await runForegroundStart();
+}
+// ─── stop ────────────────────────────────────────────────────────────
+export async function cmdStop() {
+    const lang = quietLang();
+    const st = detectService();
+    if (st.mode === 'none') {
+        console.log(t(lang, 'svc.stop.not_running'));
+        return;
+    }
+    if (st.mode === 'systemd') {
+        console.log(t(lang, 'svc.stop.stopping_systemd'));
+    }
+    else if (st.mode === 'background') {
+        console.log(t(lang, 'svc.stop.stopping_bg', { pid: st.pid ?? '?' }));
+    }
+    else if (st.mode === 'foreground') {
+        console.log('⚠️ ' + (lang === 'zh'
+            ? '检测到前台进程在跑。会发 SIGTERM，但建议你回那个 shell 里 Ctrl-C。'
+            : 'Foreground process detected. Sending SIGTERM — but Ctrl-C in the owning shell is cleaner.'));
+    }
+    await stopService();
+    console.log(t(lang, 'svc.stop.stopped'));
+}
+// ─── restart ─────────────────────────────────────────────────────────
+export async function cmdRestart() {
+    const lang = quietLang();
+    const st = detectService();
+    if (st.mode === 'systemd') {
+        console.log(t(lang, 'svc.restart.systemd'));
+        const unit = findSystemdUnit();
+        if (unit)
+            execSync(`systemctl restart ${unit.name}`, { stdio: 'inherit' });
+        console.log(t(lang, 'svc.restart.done'));
+        return;
+    }
+    if (st.mode === 'foreground') {
+        console.log(t(lang, 'svc.restart.fg_warning'));
+        return;
+    }
+    if (st.mode === 'background' || st.mode === 'none') {
+        console.log(t(lang, 'svc.restart.bg'));
+        if (st.mode === 'background')
+            await stopService();
+        // Re-spawn detached.
+        const __dirname = dirname(fileURLToPath(import.meta.url));
+        const cliJs = join(__dirname, '..', 'cli.js');
+        const { pid } = spawnBackground(process.execPath, [cliJs, 'start']);
+        await new Promise(r => setTimeout(r, 1500));
+        console.log(t(lang, 'svc.start.bg_ready', { pid, log: LOG_FILE }));
+        console.log(t(lang, 'svc.restart.done'));
+    }
+}
+// ─── uninstall ───────────────────────────────────────────────────────
+export async function cmdUninstall() {
+    const lang = await pickLang();
+    // Path interpolations — match whatever AGIM_HOME / AGIM_WORKSPACES
+    // resolved to so the prompts reflect the actual on-disk layout (the
+    // legacy ~/.im-hub/ on upgraded systems, the new ~/.agim/ on fresh).
+    const pathVars = { config: CONFIG_FILE, workspaces: WORKSPACES_DIR };
+    console.log();
+    console.log(t(lang, 'svc.uninstall.confirm', pathVars));
+    console.log();
+    const ok = await yesNo({ message: t(lang, 'confirm'), default: false });
+    if (!ok) {
+        console.log(t(lang, 'svc.uninstall.cancelled'));
+        return;
+    }
+    // 1. Stop any running instance.
+    console.log(t(lang, 'svc.uninstall.stopping'));
+    await stopService();
+    // 2. Remove systemd unit if present (requires root). Both `agim.service`
+    //    (v1.0+) and the legacy `im-hub.service` are cleaned up so an upgrade
+    //    across the rename doesn't leave a stale unit behind.
+    for (const unitPath of SYSTEMD_UNIT_CANDIDATES) {
+        if (!existsSync(unitPath))
+            continue;
+        const unitName = unitPath.split('/').pop() ?? '';
+        console.log(t(lang, 'svc.uninstall.removing_unit'));
+        try {
+            execSync(`systemctl disable ${unitName}`, { stdio: 'ignore' });
+        }
+        catch { /* ok if not enabled */ }
+        try {
+            unlinkSync(unitPath);
+        }
+        catch (err) {
+            console.warn(`⚠️ Could not remove ${unitPath}: ${err instanceof Error ? err.message : String(err)} — try \`sudo rm ${unitPath}\` manually.`);
+        }
+    }
+    try {
+        execSync('systemctl daemon-reload', { stdio: 'ignore' });
+    }
+    catch { /* ok */ }
+    // 3. Remove config + env (but KEEP workspaces).
+    console.log(t(lang, 'svc.uninstall.removing_config', pathVars));
+    try {
+        unlinkSync(CONFIG_FILE);
+    }
+    catch { /* missing is fine */ }
+    removeEnvFile();
+    try {
+        unlinkSync(PID_FILE);
+    }
+    catch { /* missing is fine */ }
+    // 4. Uninstall npm package globally.
+    console.log(t(lang, 'svc.uninstall.removing_npm'));
+    try {
+        // Best-effort uninstall the current package `agim-cli` plus the
+        // legacy npm names `im-hub-pro` and `im-hub` so a user who upgraded
+        // across the rename(s) doesn't end up with stale dangling bins.
+        execSync('npm uninstall -g agim-cli im-hub-pro im-hub', { stdio: 'inherit' });
+    }
+    catch (err) {
+        console.warn(`⚠️ npm uninstall failed: ${err instanceof Error ? err.message : String(err)} — run \`npm uninstall -g agim-cli\` manually.`);
+    }
+    console.log();
+    console.log(t(lang, 'svc.uninstall.workspaces_kept', pathVars));
+    console.log(t(lang, 'svc.uninstall.done'));
+}
+// Suppress unused imports linters for now — spawn is referenced via spawnBackground.
+void spawn;
+void readFileSync;
+void homedir;
+void ENV_FILE;
+//# sourceMappingURL=cmd-handlers.js.map