dsh-imessage — iMessage 插件

把 iMessage 收发完整接入 DeepSeek Harness（dsh）：RPC 监听入站 → 按 handle 路由工作区 → agent 处理 → 自动回复。作为 web profile 的 host 插件随 dsh web 启停，零 dsh 框架改动。

架构

dsh web 进程（LaunchDaemon，KeepAlive）
└── dsh-imessage 插件
    ├── GatewayCore（lib/gateway-core.mjs）—— 消息接收核心
    │   ├── spawn imsg rpc --db chat.db --json   ← 入站监听
    │   ├── watch.subscribe 订阅 → 收到外部消息（过滤 is_from_me）
    │   ├── 按 sender handle 查路由表 → 定位工作区
    │   ├── agents.create/resume + followup 投递 → 取回复
    │   └── RPC send 回发  → 自动回复
    ├── Typert remote "imessageGateway"（getConfig/setConfig）→ 配置页
    └── 全局 message 工具（任何 agent 可主动发 iMessage）

• 入站：imsg rpc 订阅全部会话，流式推送新消息
• 路由：settings.yaml 的 imessage: 段 → routes（handle → 工作区路径）
• 固定会话：同一 sender 固定同一 session（id 按 handle 哈希稳定）；live 复用 / resume / create
• 归档迁移：原会话被 UI 归档后不再 resume，自动新建会话并持久化映射（~/.dsh/imessage-gateway-state.json），新消息延续新会话
• 已读回执：收到外部消息后立即发 read（imsg status --json 探测 read_receipts，支持才启用）
• typing（keepalive 机制，与 OpenClaw 一致）：收到消息即发 typing: true，此后每 3s 续发一次刷新 iOS 显示；deliver 完成（或同 sender 并发全部结束）时清除定时器并发一次 typing: false。经 _typingChain 串行保证 on/off 顺序；不再按 step/start|step/end 事件开关
• 出站：RPC send；网关以 root 运行时经 sudo -u <user> 降级执行
• 共存：与 OpenClaw 各自多读 chat.db，互不互斥（同一消息两边都可能回复）

目录

dsh-imessage/
├── index.js              # host 插件：Typert remote + GatewayCore 装配 + message 工具
├── client.js             # 浏览器 bundle：Settings → iMessage 网关 配置页
├── lib/gateway-core.mjs  # 消息接收核心（监听/路由/投递/出站/归档迁移）
├── cordis.patch.yml      # bundle patch（插入 host 插件行）
├── package.json
└── README.md

挂载：web profile（~/.dsh/profiles/web/）package.json → dependencies["dsh-imessage"] = "link:<project>/dsh-imessage"，bundles 列表含 dsh-imessage。

配置

$DSH_HOME/settings.yaml 的 imessage: 段（可在 web UI Settings → iMessage 网关 编辑）：

imessage:
  routes:
    "+8613800000000": "/Users/<you>/dsh/mayacode"   # handle → 工作区
  imsgCmd: "sudo -u <you> imsg"   # 网关以 root 运行需降级；不配置则直接执行 imsg
  autoReply: true                  # 收到外部消息是否自动回复

运行时状态（勿手改）：~/.dsh/imessage-gateway-state.json（sender → 当前会话 id）。

运行环境配置（环境变量）

所有个人路径均通过环境变量覆盖，代码不写死：

启动 & 测试

网关随 dsh web 自动启停，无需手工启动。

sudo launchctl kickstart -k system/com.dsh.web   # 重启生效
ps aux | grep "imsg rpc"                          # 验证监听进程
# 端到端：从手机发一条 iMessage → 网关自动路由 + 回复
# 观察网关会话：ls ~/.dsh/sessions/*/ | grep gateway-
# 日志：/var/log/dsh-web.log（[im] 前缀）

安全红线

• autoReply 默认 true；关闭后只监听不回复，避免误发
• 网关以 root 运行，iMessage 写操作经 sudo 降级到实际用户（imsgCmd 可改）
• 网关不碰其他工作区/session 私密上下文；回复内容只来自路由到的那个工作区

开发要点（web 进程 create agent 须知）

• web 进程 agents.create 必须用 agent-presets 组合 setup（presets.mount + 模型选择），否则 create 挂起
• create/resume 判断：先查 sessionPersistence.list() 是否有该 id，有则 resume，无则 create——避免 create 同 id 造成 id collision
• 改代码后重启 web 生效（web profile 的 HMR 已禁用）
• 新插件项目必须建依赖软链（否则 import @deepseek-ai/* 报 ERR_MODULE_NOT_FOUND）：

  mkdir -p node_modules && ln -sfn /usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai node_modules/@deepseek-ai