dsh-lan-share

dsh-lan-share

DeepSeek Harness 的局域网文件共享插件 —— 把工作区通过 HTTP 共享到同一局域网：手机 / 平板 / 其他电脑用浏览器直接浏览、下载、上传文件，不需要登录 DSH。零依赖（node:http）。

和现有方案的区别：

• dsh-lan-gate / dsh-plugin-remote-access：代理整个 DSH 网页（要登录/批准设备）；
• dsh-ssh：远程服务器上的执行与 SFTP；
• dsh-webfile：S3/FTP 等远程存储；
• 本插件：本机工作区文件的纯局域网 HTTP 共享——临时传个文件给手机、让同事浏览器拉取产物，开箱即用。

注册工具

工具	功能
lan_share_start	启动共享服务器（可指定端口/token/只读模式/子目录），返回访问地址
lan_share_status	查看共享状态（运行中/根目录/只读/URL/token/文件统计）
lan_share_stop	停止共享

快速开始

lan_share_start → {
  "ok": true,
  "running": true,
  "port": 3980,
  "root": "F:/work",
  "readOnly": false,
  "urls": ["http://192.168.1.5:3980/?token=9f2c...", "..."],
  "token": "9f2c..."
}

手机/其他电脑浏览器打开 http://192.168.1.5:3980/?token=9f2c... 即可：

• 📂 浏览目录树（面包屑导航）
• 📄 点击文件名下载
• ✏️ 读写模式：拖拽/点击上传到当前目录、删除文件
• 🛡️ 只读模式：仅浏览 + 下载

安全模型

• token 门禁：启动时生成随机 token；访问需带 ?token= 或 X-Token 头；无 token 访问首页显示输入框；
• 路径边界：所有路径解析后必须位于共享根内，../ 与绝对路径越界拒绝（HTTP 400）；
• 只读模式：readOnly: true 时上传/删除/移动全部拒绝；
• 限流：每 IP 每分钟默认 120 请求，超限 429；
• 敏感文件隐藏：默认隐藏 .env、凭据类（credentials.yaml、.netrc）、密钥（*.pem/*.key/*.pfx）、node_modules、.git 等；
• 监听地址可收紧：settings 里 host: 127.0.0.1 可只让本机代理接入。

访问控制（口令 / 到期 / 权限）

除了启动时生成的随机 token（长期 + 最高权限），可额外设置固定口令，每个口令独立控制：

字段	说明
password	口令，允许弱口令（不做强度校验）
role	read（仅浏览/下载）或 write（最高：可上传/删除/移动）
expiresIn	到期：8h / 3d / 2mo / long（缺省=长期）

在 lan_share_start 传入 passwords，或用 settings lan-share.passwords 预设：

lan_share_start → { passwords: [
  { password: "family", role: "read",  expiresIn: "3d" },
  { password: "admin",  role: "write", expiresIn: "long" },
] }

浏览器访问时输入对应口令即可（?password= 或 X-Password 头）。

免口令全开（明确授权）：allowOpenAccess: true（或 lan_share_start 的 open: true）时豁免口令门禁——局域网内任何设备免口令访问。默认关闭，仅在明确授权时开启。

安装

# cordis.yml / dsh.profile 引用
plugins:
  - id: tool-lan-share
    name: 'dsh-lan-share'

或本地路径：

plugins:
  ./src/index.ts: {}

settings（可选）

命名空间 lan-share：

lan-share:
  port: 3980            # 监听端口
  host: 0.0.0.0         # 0.0.0.0=全局域网；127.0.0.1=仅本机
  readOnly: false       # 默认只读模式
  rateLimitPerMin: 120  # 每 IP 限流
  hideSensitive: true   # 隐藏敏感文件

开发

npm install
npm run check   # typecheck + test + build

• Node 要求：^22.19.0 || >=24.0.0。
• 核心在 src/lan-share-core.ts（纯函数 + HTTP 处理，可单测），插件入口 src/index.ts。
• 测试覆盖：路径越界、token 门禁（query/header/错误 token）、敏感文件隐藏、列表/下载/上传/删除/移动、只读模式拒绝、目录排序。

许可

MIT