局域网文件共享 WODE25500/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