DeadLink233/dsh-file-bridge ↗★ 0

dsh-file-bridge

Phone photo and file bridge for DSH: transfer photos or arbitrary files from a phone into the current conversation draft attachment bar over the local network.

Package
dsh-file-bridge
Compatibility
Unverified
Harness peer range
>=0.2.1-rc.2 <0.3.0
Version
1.2.0
License
MIT
Last updated
Oct 26, 2026

Other repositories with this package name

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:DeadLink233/dsh-file-bridge

配对与使用

  1. 点开 📎 手机传文件(普通会话在输入框下方;新对话在 Hero 顶部)。
  2. 手机与电脑连同一个 Wi-Fi,用手机相机扫描面板里的二维码(打不开时再点“复制链接”)。
  3. iOS 建议「分享 → 添加到主屏幕」,Android 建议「添加到主屏幕」,下次点图标即可。
  4. 在手机上点 拍照,或点 文件 选择任意文件(支持多选),看到 ✓ 电脑已收到 即可。
  5. 回到电脑:图片/文件已经出现在输入框上方的附件栏,直接输入问题发送。

第一句话之前

新建对话还没发送第一句时,输入框下方的 dock 不会渲染,所以插件额外提供了 Hero 顶部入口。

如果文件先到、页面还没选 Workspace/Session,内容会先在 Host 队列里等待;出现空白 Session 后自动进入草稿附件栏,可以先确认附件再发第一句。发送第一句后,输入框下方的 dock 恢复。

配对链接里带着 token。token 只保存在本机 DSH home 里,卸载插件不会自动删除;想换 token,删除 /photo-bridge/state.json 后重启 DSH(旧链接立即失效)。

配置

插件行在 cordis.patch.yml 里,所有字段都可选:

- insert:
    - id: photo-bridge
      name: 'dsh-file-bridge'
      config:
        port: 8787
        # bind: 192.168.1.5        # 默认自动取第一个非回环 IPv4
        # maxBytes: 20971520       # 单个文件上限,默认 20 MB
        # keepFiles: true          # ack 后是否保留 inbox 原文件
        # retentionHours: 72       # inbox 清理周期
        # token: '0123456789abcdef0123456789abcdef'  # 固定 token(默认自动生成并持久化)
字段默认说明
port8787传输端口;被占用时插件启用失败并给出明确报错
bind自动探测只接受具体网卡地址;拒绝 0.0.0.0 / ::
token自动生成16–64 位十六进制;生成后会写进 state.json
maxBytes20971520单个文件上限,流式累计,超限立即拒绝;可调到 200 MB
keepFilestrueack 后是否保留原文件(保留时移到 kept/,不会再次入队)
retentionHours72超过即从队列与 inbox 清理