前言¶
在 DeepSeek Harness (DSH) 的插件生態中，直接處理本地文件分發通常需要依賴外部工具或手動操作。dsh-localsend 插件通過集成 LocalSend 協議、HTTP 臨時服務器和 SMB 共享機制，讓智能體能夠在同一局域網內直接完成文件推送、生成下載鏈接以及指定目錄的自動化分發。
核心功能¶
本插件提供以下核心能力：
- LocalSend 傳輸：通過 LocalSend v2 協議發送文件或自動打包的文件夾。
- 瀏覽器下載鏈接：生成臨時 HTTP 下載鏈接，接收方使用瀏覽器即可下載，無需安裝軟件。
- SMB 指定目錄推送：通過 SMB 共享自動推送到目標機器的指定目錄。
- 設備掃描：掃描局域網並列出 LocalSend 設備。
- 插件分發：將 DSH 插件打包成 zip 進行分發。
- 配置管理：提供 GUI 配置卡片，支持別名、端口、超時等設置，以及目標機檔案以簡化 SMB 推送。
安裝與依賴¶
安裝前請確保系統已安裝 Node.js >= 22.19。
使用官方推薦的安裝命令：
dsh plugin --profile web add git+https://github.com/huangfuren/dsh-localsend.git#v0.5.0
安裝後重啓 DSH，在“設置 → 插件配置”中會出現對應的配置卡片。
典型用法¶
插件包含以下工具：
- localsend_list_devices：掃描局域網，列出 LocalSend 設備。
- localsend_send_files：通過 LocalSend 協議發送文件或文件夾。
- localsend_share：生成臨時 LAN HTTP 下載鏈接，支持密碼保護。
- localsend_send_plugin：將 DSH 插件打包成 zip 進行分發。
- localsend_smb_push：通過 SMB 共享自動推送到目標機器的指定目錄。
注意事項¶
- 網絡環境：僅限局域網傳輸，掃描不越出本機活動子網。
- 接收方要求：LocalSend 模式下，接收方需要安裝 LocalSend 或僅瀏覽器；SMB 模式下，接收方需要預先開啓共享並賦予寫入權限。
- 安全約定：SMB 檔案中的憑據以明文保存在本機 DSH settings 文件中，請勿在共享賬號或多人共用的機器上啓用。
- 版本兼容：兼容 DeepSeek Harness 0.1.x 與 0.2.0-rc.1。
總結¶
dsh-localsend 提供了從簡單的鏈接分享到複雜的 SMB 自動推送的一整套解決方案，其零依賴、開箱即用的特性降低了集成難度。
