前言¶
在 DeepSeek Harness（DSH）日常開發裏，手機拍的照片、錄屏、文檔經常要落到本機項目目錄或下載文件夾。數據線、網盤或即時通訊「文件助手」都能做，但要麼要插線、要麼經過第三方雲端。Shuttle 是 DSH 社區插件，在 Host 上展示二維碼，手機與電腦在同一 WiFi 下掃碼即可上傳，數據不經過中轉服務器，手機端無需安裝 App。下面按定位、功能、安裝與使用說明。
這是什麼¶
Shuttle（文件穿梭機）由維護者 MC0571 發佈，歸類爲客戶端插件（dsh.client，Web 平臺）。它在 DSH 側邊欄提供「文件穿梭機」入口：電腦生成局域網訪問地址與二維碼，手機用系統相機（或瀏覽器）打開上傳頁，把照片、視頻和任意文件傳到本機指定目錄，並在 Web UI 裏瀏覽、搜索和管理已接收文件。當前 package.json 版本爲 0.5.1，許可證 MIT。
核心功能¶
依據倉庫 README，已覈實能力如下。
掃碼與上傳
- 手機與電腦連同一 WiFi，掃二維碼進入上傳頁；提供「相冊」「文件」入口（相冊含系統相冊與拍攝）；微信內置瀏覽器也可用，但 README 對微信內能力有單獨限制說明。
- 按文件逐個上傳，實時進度；失敗可重新選擇該文件重傳。
電腦端管理
- 「最近」按日期分組展示各子目錄下的接收文件；「瀏覽」以文件管理器風格操作保存目錄（麪包屑、新建/重命名/刪除文件與空目錄、在系統文件管理器中打開）。
- 文件名搜索；類型、目錄、時間篩選；宮格/列表與多種排序。
網絡與安全相關
- 多網卡時可手動選擇與手機同一 WiFi 的地址，二維碼隨之更新。
- 一鍵輪換一次性 token，舊二維碼立即失效。
- 二維碼在 Host 本地生成，不依賴外部服務；128-bit 一次性 token、僅監聽局域網；管理 API 掛在 DSH Web 服務器（默認迴環），不暴露給局域網。
當前不提供：電腦到手機的反向傳輸、剪貼板同步（README「已知限制」）。
安裝與啓用¶
從 GitHub 安裝（默認分支 main）：
plugin_manager install_bundle target=github:MC0571/Shuttle
本地目錄安裝（開發調試）：
plugin_manager install_bundle target=<本倉庫絕對路徑>
安裝後側邊欄會出現「文件穿梭機」。首次使用需允許系統防火牆「接受傳入連接」。插件隨 DSH 進程運行，安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。
典型用法¶
- 打開側邊欄「文件穿梭機」。
- 手機用系統相機掃描頁面二維碼（微信內置瀏覽器可打開，但相冊/相機相關能力受限時 README 建議用系統相機掃碼）。
- 在上傳頁選擇照片/文件，可選保存子目錄，等待上傳完成。
- 回到電腦頁面查看文件，可打開所在文件夾、重命名或刪除。
接收目錄默認在系統下載目錄下的 FileShuttle，文件默認落在其 默認/ 子目錄；界面修改會持久化到 $DSH_HOME/shuttle/settings.json。
配置要點¶
cordis.patch.yml 的 config 支持：
| 字段 | 含義 |
|---|---|
saveDir |
接收目錄；默認 <系統下載目錄>/FileShuttle。 |
運行期的保存目錄、網絡接口由界面寫入同一設置文件；二維碼 token 在每次 DSH 啓動或手動重置時輪換。
局域網側 HTTP 接口（端口隨機）包括上傳頁、子目錄列表、上傳與健康檢查等；同源管理 API 註冊在 DSH Web 的 /shuttle 前綴，供本機 Web UI 調用（詳見 README「接口」小節）。
適用場景與注意¶
適合：本機開發、素材整理、想在可信家庭/辦公室 WiFi 裏快速把手機文件落到電腦、且不希望走雲端的用戶。
使用限制（README 原文要點）
- iOS 網頁上傳可能將 HEIC 轉爲 JPEG，Live Photo 僅保留靜幀。
- 微信掃一掃對局域網 IP + 非標準端口可能被攔截或緩存；大視頻上傳時 iOS 切後臺會掛起頁面。
- 微信內爲穩定性僅保留「文件」入口；相冊路徑可能被系統回收導致頁面重置。
- 刪除目錄僅支持空目錄。
- 同一 WiFi 內他人理論上可嗅探風險時，請在可信網絡使用。
延伸閱讀¶
DSH 生態奉行「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。Shuttle 把「手機 → 本機」收斂爲掃碼與側邊欄一條路徑，適合作爲局域網文件投遞的輕量客戶端插件。
