跳过主要内容
Z

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-imessage

README

dsh-imessage

在 iPhone 的「信息」里直接跟 DeepSeek Harness 对话。 发一条 iMessage,Harness 在服务器上跑,回答沿原路回到你的收件箱——图片、语音、文件都能双向走。

Release DSH License Node

本仓库是 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 / gifattachments.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:

  1. Authorize → 完成 Photon 设备登录
  2. 填发送号码(哪个号发消息给 Harness)
  3. 拿到托管号码(Harness 的号,加到通讯录)
  4. 若状态不是 Listening,点一次 Retry listener

装过 npm 上同名 dsh-imessage@0.2.0 的,先移除再装——包名相同,pnpm 会用后装的覆盖。 宿主低于 0.2.2-rc.1 时会被兼容性检查拦下,本包只针对 0.2.2 的 API 适配。

配置项

字段默认说明
photonApiOriginhttps://api.photon.codesPhoton API 源,必须 HTTPS(loopback 测试可 HTTP)
phoneNumber—你自己的发送号码(volatile,只存在本地)
assignedPhoneNumber—Photon 分配的托管号码
photonUserId—授权后的 Photon 用户 id
maxOutboundChars3500单条 iMessage 最大字符,超出切块
interactionTimeoutMs600000反问/确认等人工交互等待上限
sessionsPerPage5/sessions 每页会话数
dedupeEntries1024入站消息去重窗口
reconnectMinMs / reconnectMaxMs1000 / 60000Spectrum 重连退避区间

兼容性

  • 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)

#断层修复
1settingsNamespace() / settings.register() 被删;SettingsForms 只投影 volatile 字段用户配置合并进 cordis Config schema 并标 .volatile()(schemastery 须 3.19.0)
2sessionPersistence.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,分流图片/文件
6agents.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 同步遵守其原始许可。

相关插件