前言¶
在 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 自动推送的一整套解决方案，其零依赖、开箱即用的特性降低了集成难度。
