前言¶
在使用 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
