前言¶
在使用 DeepSeek Harness（DSH）开发或运行智能体时，有时需要从手机取图作为输入，或者将调试好的截图回传到 PC。直接传云盘存在隐私风险，通过 IM 软件传输又容易混杂在其他消息中。
dsh-photo2dsh-by-lan 专注于解决这个场景：手机端无需安装任何 App，只需通过快捷指令或 HTTP 工具一键 POST 照片到 PC 的指定端口，PC 端插件接收并写入文件夹，同时弹出 Windows 通知。
插件介绍¶
这是一个专注于局域网（LAN）传输的 DSH 插件。它不依赖云服务，不干扰 IM 软件，也不需要修改系统的 app.asar 文件。
核心能力：
* 手机一键发送：支持 iOS Shortcuts 和 Android HTTP Shortcuts。
* 可控落地目录：在插件面板配置目标文件夹，支持按日期自动建子目录。
* Agent 可读：落地文件为普通目录，DSH Agent 可直接读写分析。
* 无侵入通知：文件到达时触发 Windows Toast。
* 安全校验：默认开启 Token 校验，监听范围仅限局域网。
安装与启用¶
在终端执行以下命令安装插件：
dsh plugin --profile desktop add dsh-photo2dsh-by-lan
安装后，插件会在 DSH 启动时加载。由于它需要在局域网端口监听，必须配置一次防火墙规则（这是唯一需要管理员权限的步骤）：
netsh advfirewall firewall add rule name="DSH Photo2DSH" dir=in action=allow protocol=TCP localport=8787 profile=any
注意： 规则中必须包含 profile=any。如果在 private 网络环境下只配置了 public 规则，Windows 会静默丢弃数据包，导致手机端提示“服务器停止响应”。
配置完成后，重启 DSH 以加载插件客户端。
配置面板¶
在 DSH 侧边栏进入 Plugins，找到 dsh-photo2dsh-by-lan 包，点击配置卡片。主要字段说明如下：
| 字段 | 说明 |
|---|---|
| Landing directory | 照片落地目录。插件会自动在目录下创建 <日期> 子文件夹。 |
| Port | 默认 8787。修改端口需要同步更新防火墙规则。 |
| Max file size (MB) | 默认 64MB，超过此大小将拒绝上传。 |
| Toast on arrival | 默认开启，文件落地时弹出通知。 |
| Require token | 默认开启。开启时必须在 URL 中包含 Token，关闭则局域网内任何人可传文件。 |
建议将落地目录设置在当前 Session Workspace 内，以确保 Agent 有权限读取。
典型用法¶
iOS Shortcuts¶
- 选择照片：添加 “Select Photos” 或 “Take Photo”。
- 转 JPEG：添加 “Convert Image”，输出格式设为 JPEG，质量 80%。这是关键，否则大图会变成高压缩的 PNG，占用空间大且格式判断可能出错。
- 发送请求：添加 “Get Contents of URL”。
- URL 填入插件配置页面的地址。
- Method 设为
POST。 - Request Body 设为
File。 - ⚠️ 关键步骤：File 字段必须指向上一步生成的 “Converted Image”，而不是原始照片。
- 执行：点击运行。成功后会返回文本提示，告知文件已存入 PC。
首次在局域网访问时，iPadOS 会弹窗询问是否允许访问本地网络设备，必须点击允许。
Android¶
使用 Android 端的 HTTP Shortcuts 或类似工具。
URL 与 iOS 相同，设置 Method 为 POST，Body 类型为 File，选择本地图片文件即可。
文件落地格式¶
照片落地后的目录结构如下：
<你的落地目录>\
└─ 2026-10-03\
├─ 20261003232612-4d2b993e-image.jpg
└─ 20261003232612-4d2b993e-image.json
- 文件名：本地时间戳 + SHA256 前8位 + 清洗后的文件名。
- 同名覆盖：同一秒上传同名文件不会覆盖，会自动添加
-1、-2后缀。 - 格式判断：文件格式由魔法字节决定，而非
Content-Type头。
注意事项¶
- Windows Only：插件仅支持 Windows 系统。
- Toast 显示名称：Windows 通知中应用名称显示为 “Windows PowerShell”，除非手动注册 AUMID。
- 卸载不删数据：卸载插件不会删除已接收的本地照片文件。
- 默认 Token：
Require token默认开启，请勿随意关闭，否则局域网内的恶意请求可写入文件。 - 安全边界：插件仅监听本地网络，未暴露到公网，但若关闭 Token 校验，局域网内任何设备均可访问。
总结¶
dsh-photo2dsh-by-lan 提供了一种本地化、轻量级的照片传输方案。对于需要频繁从手机取图的 DSH 智能体开发者，它是绕过云服务、保持数据本地化且无需复杂配置的高效工具。
- 目录页：https://www.skillhub.cn/plugins/apherchin/dsh-photo2dsh-by-lan
- 源码：https://github.com/apherchin/dsh-photo2dsh-by-lan
