Pular para o conteúdo principal
Z

dsh-imessage

zhou200310/dsh-imessage

DSH 0.2.2 adaptation of photon-hq/dsh-imessage: the same Photon-hosted two-way iMessage channel, fixed for the 0.2.2 host line — settings registration, session-persistence reads, message source kind, listener auto-restart after a cold boot, and workspace attachment for plugin-created sessions — with attachments carried both ways: inbound images land in the model context as ImageBlocks, and images or files the agent produces are sent back to the phone as native iMessage attachments. Installs prebuilt from the release tarball.

Instalar

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 同步遵守其原始许可。

Plugins relacionados