dsh-imessage
zhou200310/dsh-imessage
photon-hq/dsh-imessage 的 DSH 0.2.2 适配版:同样是 Photon 托管的双向 iMessage 通道,修好了在 0.2.2 上的断层——settings 注册方式、会话持久化读取、消息 source kind、冷启动后 listener 自动恢复、插件新建会话的工作区挂载;附件双向打通:收到的图片以 ImageBlock 进模型上下文,agent 产出的图片与文件按原生 iMessage 附件发回手机。从 release 预构建包安装,无需自行构建。
安装
dsh plugin --profile web add github:zhou200310/dsh-imessageREADME
dsh-imessage
在 iPhone 的「信息」里直接跟 DeepSeek Harness 对话。 发一条 iMessage,Harness 在服务器上跑,回答沿原路回到你的收件箱——图片、语音、文件都能双向走。
本仓库是 photon-hq/dsh-imessage 的 DeepSeek Harness 0.2.2 兼容适配版:上游 peer 依赖锁死在
0.1.0-rc.6,在0.2.2-rc.1上装了也不激活、收到消息也不回。这里保留了上游全部功能,把断掉的 API 逐个接回来,并补上多模态与语音,现在是端到端可用的。
iPhone「信息」 → Photon → Spectrum → DSH 插件 → DSH 会话
↓
iPhone「信息」 ← Photon ← Spectrum ← DSH 插件 ← agent 回复
为什么用这个而不是上游
上游 dsh-imessage@0.2.0 | 本仓库 | |
|---|---|---|
DSH 0.1.0-rc.6 | ✅ 可用 | ✅ 可用 |
DSH 0.2.2-rc.1 | ❌ 装了不激活 | ✅ 端到端验证 |
| 图片进上下文 | ❌ 静默丢弃 | ✅ ImageBlock,模型直接看像素 |
| 图片/文件发出 | ❌ | ✅ 原生 iMessage 附件 |
| 语音进出 | ❌ | ✅ 转写 / TTS 语音条 |
| 会话归属 | ❌ 掉进 Ungrouped | ✅ 按 cwd 挂到对应工作区 |
功能
文字
手机发文字 → DSH 会话;长回答按 maxOutboundChars(默认 3500)切块发送,不截断 Unicode。
图片与文件(双向)
| 方向 | 类型 | 处理 |
|---|---|---|
| 收 | png / jpeg / webp / gif | attachments.saveImage() → ImageBlock,模型看到的是像素 |
| 收 | heic / heif(iPhone 默认) | 先用 ImageMagick 转 JPEG 再进上下文;没有转换器则存成文件并说明 |
| 收 | 语音 audio/* | faster-whisper 转写 → 文字进上下文 |
| 收 | 视频 / pdf / 文档 | attachments.saveFile() → FileBlock(句柄:文件名 + 字节数 + 只读路径) |
| 发 | 回答里的 image 块 | readImage() 读回字节 → Spectrum 附件 |
| 发 | 回答里的 file 块 | hostPath 直读,非宿主后端回落 readFileStream() |
单个附件失败只回一句提示或记日志,不会吞掉整个 turn。
语音(可选,默认关闭)
| 方向 | 触发 | 处理 |
|---|---|---|
| 收 | iPhone 语音 | 落临时文件 → 转写 → 文字进上下文 |
| 发 | 回答里写 [语音: 文本] | 合成 m4a → 作为语音条发出 |
语音需要一个你自己能访问的语音宿主(任何提供 GET /health、POST /tts、POST /stt 的 HTTP 服务),通过环境变量指过去:
DSH_VOICE_URL=http://127.0.0.1:8090 # 语音宿主地址
DSH_VOICE_NAME=zh-CN-XiaoxiaoNeural # 可选,默认中文女声
DSH_VOICE_TOOLS=/path/to/scripts # 可选,自定义合成脚本
不配置也能正常用:没有 DSH_VOICE_URL 时,[语音: …] 自动降级成普通文字消息发出,入站语音会得到一句"本机未配置语音识别"的说明——不会静默失败,也不会卡住会话。出站合成需要 ffmpeg(转 m4a),缺失只影响语音条。
能力边界:视频和文档在模型侧只呈现为句柄文本(知道文件存在与路径),不会被"看懂";图片是真进上下文;语音会被转写,所以内容听得懂,语气听不出来。
会话
新建会话自动 resolveByPath(cwd) 挂到匹配的工作区,不会掉进 Ungrouped;/sessions 可以翻页切换历史会话直接续聊。
安装前先确认
| 依赖 | 必需 | 用途 / 没有会怎样 |
|---|---|---|
DeepSeek Harness 0.2.2-rc.1 | ✅ | 低版本会被兼容性检查拦下 |
Node ^22.19 || >=24 | ✅ | 插件运行环境 |
| Photon 账号(设备授权) | ✅ | iMessage 线路出口,没有就收发不了 |
| ImageMagick(带 libheif) | 建议 | HEIC→JPEG;缺失时 iPhone 照片只能存成文件、进不了模型 |
| ffmpeg | 可选 | 语音条转 m4a;缺失只影响语音 |
语音宿主(DSH_VOICE_URL) | 可选 | /tts、/stt;没配则语音自动降级为文字 |
# Debian/Ubuntu 一次装齐
sudo apt install imagemagick ffmpeg
安装
预构建包(推荐)
dsh plugin --profile web add https://github.com/zhou200310/dsh-imessage/releases/latest/download/dsh-imessage-latest.tgz
从源码
dsh plugin --profile web add github:zhou200310/dsh-imessage
装完 冷启动 dsh(应用中心停一下再启动,不要热重载、不要 kill 主进程)。重启后到 设置 → iMessage:
- Authorize → 完成 Photon 设备登录
- 填发送号码(哪个号发消息给 Harness)
- 拿到托管号码(Harness 的号,加到通讯录)
- 若状态不是 Listening,点一次 Retry listener
装过 npm 上同名
dsh-imessage@0.2.0的,先移除再装——包名相同,pnpm 会用后装的覆盖。 宿主低于0.2.2-rc.1时会被兼容性检查拦下,本包只针对 0.2.2 的 API 适配。
配置项
| 字段 | 默认 | 说明 |
|---|---|---|
photonApiOrigin | https://api.photon.codes | Photon API 源,必须 HTTPS(loopback 测试可 HTTP) |
phoneNumber | — | 你自己的发送号码(volatile,只存在本地) |
assignedPhoneNumber | — | Photon 分配的托管号码 |
photonUserId | — | 授权后的 Photon 用户 id |
maxOutboundChars | 3500 | 单条 iMessage 最大字符,超出切块 |
interactionTimeoutMs | 600000 | 反问/确认等人工交互等待上限 |
sessionsPerPage | 5 | /sessions 每页会话数 |
dedupeEntries | 1024 | 入站消息去重窗口 |
reconnectMinMs / reconnectMaxMs | 1000 / 60000 | Spectrum 重连退避区间 |
兼容性
- DSH:
0.2.2-rc.1(peer 依赖全部锁定这个版本) - Node:
^22.19.0 || >=24.0.0 - 平台:Photon 托管线路,需要一个美国 iMessage 号作为出口(Photon 提供)
六个兼容坑(0.1.0-rc.6 → 0.2.2-rc.1)
| # | 断层 | 修复 |
|---|---|---|
| 1 | settingsNamespace() / settings.register() 被删;SettingsForms 只投影 volatile 字段 | 用户配置合并进 cordis Config schema 并标 .volatile()(schemastery 须 3.19.0) |
| 2 | sessionPersistence.inspect() 被删 | 改用 open(id, 'read') + read() + close() |
| 3 | 消息 source 的 'plugin' kind 被删(只剩 user/model/tool/system-prompt) | 改 source: { kind: 'user' },否则 agent 丢消息、turn 空转 |
| 4 | 重启后 Spectrum listener 不自动恢复 | init 改 scheduleRuntimeStart() 延迟重试,等 settings 就绪再 restart() |
| 5 | 只认 content.type === 'text',附件被静默丢弃 | 放宽到 attachment,分流图片/文件 |
| 6 | agents.create() 建的会话绕过工作区挂载 | 建完 resolveByPath(cwd) + attachSession() |
逐条复现过程、重建步骤、依赖锁定、排查技巧都在 ADAPTATION.md。
常见问题
装完设置页看不到 iMessage 入口?
插件没激活。确认 DSH 版本是 0.2.2-rc.1,并冷启动过一次(热重载不会重新加载 bundle 的 cordis patch)。
收不到消息 / 状态一直 Disconnected?
多半是网络:app.photon.codes、spectrum.photon.codes 在 Cloudflare 上,国内可直连。如果 Harness 被注入了指向机场的 HTTPS_PROXY,给 photon 域名加直连规则,否则节点一挂授权和监听一起失败。另外确认后台/熄屏时连接没被系统切断——0.2.2 起加了生命周期感知。
发了图但模型说没收到?
两个原因都已在插件里兜住:① iPhone 默认 HEIC,本版会用 ImageMagick 自动转 JPEG(apt install imagemagick,需带 libheif);② Spectrum 读附件经常中途断(Connection dropped),本版有 30s 超时 + stream() 兜底重试,彻底失败会回一句占位提示,而不是把消息吞掉。
转换器缺失时图不会进上下文模型,但会作为文件存盘并在会话里说明。
重启后要手动点 Retry listener? 已知问题(init 时 settings 未就绪导致自动 restart 被跳过)。已经在 init 里加延迟重试,若仍遇到点一次即可。
长回答被切成一堆气泡?
按 maxOutboundChars 切块是预期行为,调大即可(iMessage 单条上限约 4000 字符)。
开发
npm install --legacy-peer-deps
npm run build # 产物在 lib/
npm run test
npm run check # test + build + audit + pack
许可
Apache-2.0。上游 photon-hq/dsh-imessage 同步遵守其原始许可。