前言¶

在 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 插件頁。