前言¶
在多臺機器上跑 DeepSeek Harness 時，常見做法是 U 盤、網盤或臨時 HTTP 服務傳文件和一段文字。這些方式要麼多一步拷貝，要麼要自己搭服務、記地址。DSH 社區插件 dsh-lan-share（維護者 Endless-zby，分類：聯網工具）把「同網段發現設備、定向收發文字與文件、接收策略與進度」收進 Harness 右側欄的 局域網服務 標籤，也可通過對話裏的模型工具完成同樣操作。
下面介紹它做什麼、如何安裝，以及日常使用裏需要注意的點。
這是什麼¶
dsh-lan-share 是面向 DeepSeek Harness 的局域網共享插件：在同一本地網絡中發現同樣安裝了該插件的設備，向選定設備發送文字或文件，並按策略接收對方發來的內容。簡介中的 accept-or-ask policy 指總開關、未知設備默認策略，以及按設備覆蓋的接收方式。
插件以 MIT 許可證發佈，源碼與說明見 GitHub 倉庫；社區目錄頁爲 SkillHub 插件頁。DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
以下能力均來自插件 README 與 package.json 描述，安裝後可在側欄 局域網服務 中使用，或通過七個模型工具由智能體調用：lan_share_devices、lan_share_send_text、lan_share_send_file、lan_share_inbox、lan_share_respond、lan_share_rename_device、lan_share_settings。
發現與設備管理¶
- 通過 UDP 組播與廣播發現同網段設備；若網絡過濾組播/廣播，可 手動添加設備 IP。
- 可重命名：本機在局域網中的顯示名，或對他人設備的本地別名。
- 可見性：可完全隱藏本機，或要求對方持有 共享口令 才能建立連接。
發送與接收¶
- 向選定設備發送文字或文件；發文件時需填寫 本機絕對路徑（面板無法從瀏覽器文件選擇器得到真實路徑）。
- 接收文字與文件；文件保存位置可在 當前工作區目錄 與 指定目錄 之間選擇，面板頂部會顯示解析後的絕對路徑。
- 接收策略：全部默認接收 總開關、未知設備回退策略、按設備單獨設置；另有體積上限與擴展名過濾，決定哪些文件可跳過確認。
- 到達通知：標籤未讀數、需決策時的全頁提示、帶本地路徑的接收歷史。
- 每次收發顯示進度（字節、速率、預計剩餘時間、取消）；中斷後可從接收端已保留的字節處 續傳。
網絡與面板¶
- 默認 UDP 48900（發現，組播
239.255.77.88及廣播）、TCP 48901（傳輸，綁定0.0.0.0）；可在 composition patch 中改discoveryPort、transferPort等。 - 傳輸平面獨立於 DSH Web 服務器（對端經 LAN 訪問）；側欄面板走同源 API，由宿主信任邊界保護。
安全相關（README 摘要）¶
- 信標僅用於 advertisement，不授權數據傳輸；數據請求需握手 token；設置 共享口令 後，改口令會使已有 token 失效。
- 發送方顯示名取自接收方本地設備表；文件名消毒並校驗寫入路徑；默認拒絕多種可執行擴展名。
安裝與啓用¶
DSH Desktop 使用 web profile；安裝後須重啓應用，宿主側僅在啓動時加載。
在已配置 dsh 命令行的環境中：
dsh plugin --profile web add dsh-lan-share
若 dsh 不在 PATH，可用 Desktop 內置二進制（將 <INSTALL_DIR> 換成實際安裝目錄）：
$app = "<INSTALL_DIR>\DSH Desktop\resources\app"
node "$app\node_modules\@deepseek-ai\dsh\lib\bin.js" plugin --profile web add dsh-lan-share
驗證是否裝好¶
profiles\web\package.json的dependencies與dsh.profile.bundles中均包含dsh-lan-share。profiles\web\node_modules\dsh-lan-share\lib\存在index.js與client.js。- 重啓後，對話右側「添加標籤」引導中出現 局域網服務，對話標題欄出現對應按鈕。
另一臺機器需 各自安裝一次，並非裝一臺全網可用。除上述 registry 安裝外，README 還說明可用 npm pack 得到 .tgz 在目標機離線添加，或 npm publish 後各機仍用同一條 dsh plugin --profile web add dsh-lan-share。目標機可用 curl 探測 http://127.0.0.1:48901/lan-share/v1/info 等（端口以實際日誌或面板爲準）。
package.json 要求 dsh >= 0.1.5，Node ^22.19.0 || >= 24.0.0；當前包版本爲 0.1.1。
典型用法¶
先做發現，再發送或處理收件箱。
- 打開側欄添加標籤中的 局域網服務，或在對話中讓智能體調用上述工具。
- 同一局域網 下，一般數秒內可互相發現；若不能，用 手動添加設備 填入對方 IP（訪客 Wi‑Fi、管控交換機常丟棄組播）。
- 首次在可信網絡：共享口令 留空，或兩臺機器設相同口令；設口令後，不知道口令的設備無法連接。
- 發送：選設備後點 發文字 或 發文件；文件路徑必須是本機絕對路徑。
- 接收：默認會在寫入前詢問；開啓 全部默認接收 可跳過；可爲單臺設備單獨選手動或自動。
未完成的大文件暫存於 <保存目錄>/.dsh-lan-share-incoming，完成後移入目標目錄。
適用場景與注意¶
適合：同一辦公室或家庭 LAN 內，多臺 DSH Desktop / dsh web 之間傳日誌片段、配置、小中型文件，且希望留在 Harness 界面內完成。
務必注意：
- 插件以 當前 dsh 進程權限 運行，可讀寫你配置的保存目錄及你指定的發送路徑；安裝前應閱讀源碼與 MIT 許可證，自行評估是否用於生產或敏感網絡。
- 傳輸監聽在
0.0.0.0，需在防火牆中放行相應 TCP/UDP 端口（默認可在 patch 中查看）。 - 安裝或更新
lib/client.js後必須 重啓 Harness；面板路由註冊可能略晚於端口監聽，瞬時404不等於未安裝。 - 發文件依賴本機路徑，遠程桌面或權限受限目錄可能無法發送。
結尾¶
dsh-lan-share 把局域網內的設備發現、定向文字/文件傳輸、接收策略與進度展示集成進 DeepSeek Harness，減少在 Harness 與外部傳文件工具之間來回切換。
