前言¶

在 DSH 里做智能体或本地工具链时，经常要把手机里的照片、截图弄进电脑工作目录：微信和 QQ 会压图、还要登录；云盘是上传再下载；若走 dsh web 自带的隧道，请求绕公网，单张图往往要等几秒。手机和电脑本来就在同一路由器下，更短的路径是局域网直连。下面介绍社区插件 dsh-phone-drop（维护者 SongZijianlove，分类：客户端）：电脑端起一个本地 HTTP 服务，屏幕出二维码，手机扫码后在浏览器里拍照或选图，文件直接写入指定文件夹，不经过任何隧道。

这是什么¶

dsh-phone-drop 是 DeepSeek Harness 的 bundle 插件，也可单独用 CLI 运行。核心能力：同一 Wi-Fi 下，手机浏览器打开服务地址，上传原图或勾选「文档模式」做前端裁边与二值化后再传，落盘到电脑目录；默认不勾选时字节原样保存（大小、格式、EXIF 不变）。许可为 MIT；当前 npm 版本为 0.4.3，要求 Node >=18，DSH >=0.2.1-rc.2。

核心功能¶

局域网直传¶

服务默认监听 0.0.0.0:9800，保存目录可在安装或配置中指定。启动后日志会提示手机应打开的局域网地址；也可在电脑浏览器打开 http://127.0.0.1:9800/qr 显示大二维码，手机相机或扫一扫进入，无需手敲 IP。

原图与文档模式¶

不开启文档模式时，点「上传图片」即原文件落盘，文件名带时间戳。开启「文档模式」后，页面在前端做去色、自适应二值化、去噪与裁边（可调墨色、旋转 90°），再上传处理结果；可选黑白扫描、灰度增强或原图。处理在浏览器完成，不上传原图再服务端处理。

DSH 集成¶

安装并重启宿主后，DSH 侧边栏底部（设置齿轮旁）会出现「手机直传」按钮，一点即打开二维码页（自 0.4.3 起；0.4.2 的 npm 包未包含 lib/client.js，侧边栏按钮不可用）。本机可访问 GET /api/phone-drop/info 查询 running、dir、port、deskUrl，仅接受回环地址，局域网手机不需要该接口。

插件注册 phone_drop 工具，助手可调用 url、qr、recent、setdir 等 action，便于在对话里给出地址或终端字符二维码。

安全与限制¶

单次上传上限 64 MB；可选 token 作为访问口令（二维码会带上）。/api/dir 换目录仅本机回环可 POST。插件以当前 DSH 进程权限监听网卡并在配置目录写文件，安装前宜自行查看 GitHub 源码 与许可证，仅在可信局域网使用；公共网络建议设 token。

安装与启用¶

官方在 DSH 中的安装方式：

dsh plugin install dsh-phone-drop

也可在 profile 的 package.json 里作为 bundle 依赖：

{
  "dependencies": { "dsh-phone-drop": "^0.4.1" },
  "dsh": { "profile": { "bundles": ["dsh-phone-drop"] } }
}

装完重启宿主。日志示例：

dsh-phone-drop: 服务已启动，监听 0.0.0.0:9800，保存到 C:\Users\你\Pictures\dsh-phone-drop
dsh-phone-drop: 手机请打开 http://192.168.1.23:9800

若全局 npm install -g dsh-phone-drop，Windows 上首次可能弹出设置窗口（存图路径、桌面快捷方式、是否立刻打开二维码页）；也可用 dsh-phone-drop --setup 重开。npm 11.16+ 可能拦截 postinstall，需 --allow-scripts=dsh-phone-drop 或装后首次运行 dsh-phone-drop 仍会走设置检查。

在 profile 的 cordis.patch.yml 可覆盖端口、目录、口令等：

- id: phone-drop
  config:
    port: 9800
    host: '0.0.0.0'
    dir: 'D:/手机图片'
    token: 'my-secret'
    title: '手机直传'
    enabled: true

用户级 ~/.dsh-phone-drop.json 中的 dir 优先于 patch 里的 dir。

典型用法¶

1. 手机与电脑连接同一 Wi-Fi（非蜂窝流量）。
2. 电脑打开 http://127.0.0.1:9800/qr，手机扫码进入；或按日志里的 http://192.168.x.x:9800 手动输入。
3. 点拍照或相册选图；需要扫描件则打开「文档模式」预览后再上传。
4. 在电脑接收目录查看带时间戳的文件。手机浏览器可「添加到主屏幕」便于下次直接进入。

不开 DSH 时也可单独跑同一服务：

npx dsh-phone-drop --port 9800 --dir ./收图 --open

--open 会在浏览器打开二维码页；Ctrl+C 停止。

适用场景与注意¶

适合在家或办公室同一局域网内，快速把手机照片、扫描件放进电脑文件夹，供 DSH 助手或本地脚本继续处理；不适合依赖公网隧道的大文件慢传场景（此处走最短 LAN 路径）。

DSH 生态理念是「一切皆插件」；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。插件不是 DSH 宿主 webserver，暴露的是有限上传路由，但仍会在 0.0.0.0 上接受局域网连接——使用前请确认网络环境与目录权限。

结尾¶

dsh-phone-drop 把「手机一拍，电脑就有」做成局域网直连：二维码进页、原图或文档模式上传、可选 DSH 侧边栏与 phone_drop 工具。进一步了解与 issue 见 GitHub：SongZijianlove/dsh-phone-drop，目录入口见 SkillHub 插件页。