dsh-password-gate

为 DeepSeek Harness Web 提供密码登录网关的插件。

dsh web 本身没有任何认证机制——只要能路由到 Web 端口，任何人都可以调用全部 /api RPC（创建 agent、执行 bash、读写文件系统）。本插件在每一个请求（HTTP 与 WebSocket，包括直接 POST 到后端接口）之前加一道最小密码门禁。

设计与可行性分析见 docs/PROPOSAL.md。

功能

• 首次打开（尚未设置密码） → 显示"设置密码"页面。设置密码之前，任何功能都不可用。
• 已设置密码 → 显示登录页面。登录成功前，每一个请求都被拦截：
  • /api/* → 401
  • 页面类路径 → 302 /login
  • WebSocket 升级（/api/events.mux、/api/events.host）→ 拒绝连接
• 设置/登录成功 → 直接跳转 dsh 首页（/）。
• 修改密码 → 校验旧密码后更新，并吊销全部会话（所有端下线）。

这是真正的服务端门禁，不是仅限前端的 UI 锁：未认证的客户端根本到不了后端。

非安全上下文兼容：通过 http://（而非 localhost）访问时，浏览器 Web Crypto 的 crypto.randomUUID 不可用，会导致 dsh 前端报"crypto.randomUUID is not a function"。 插件通过 ctx.webServer.tapIndex() 向每个 index.html 注入基于 crypto.getRandomValues （始终可用）的 polyfill，明文 LAN 部署无需任何额外配置。

工作原理

浏览器 ──> dsh-password-gate 网关（0.0.0.0:3080，运行在 dsh 进程内）
               │  每个请求都做认证检查（内存会话表，O(1)）
               ├─ 通过 ──> 转发（Host/Origin 改写为回环）──> dsh webserver（127.0.0.1:3081）
               └─ 未通过 ─> 401 / 302 / 拒绝 upgrade

本插件是标准的 Cordis 插件，运行在 dsh 进程内：随 dsh 启动而启动、随 dsh 退出而退出，不需要额外的服务进程，也不 fork 核心。它的 bundle patch 会把真实的 webserver 移到仅回环（loopback）的内部端口，使内部端口无法从远程访问，网关成为唯一入口。

关于转发时的 Host/Origin 改写：dsh 内部 /api trust fence 的 LAN 信任列表是根据 webserver 的监听地址（0.0.0.0）采样的；插件把 webserver 钉在 127.0.0.1 后该列表恒为空，外部地址（LAN IP）的请求会被内部 fence 以 403 拒绝。网关因此在转发时把 Host/Origin 改写为回环地址——安全上成立，因为 fence 的"远程可达性防护"已由网关认证层接管：跨站/DNS-rebinding 请求没有会话 cookie（HttpOnly + SameSite=Strict），在网关层即被拒绝，到不了内部。

• 密码：scrypt 哈希（node:crypto），存于 $DSH_HOME/login-plugin/password.json（仅属主可读写）。
• 密码策略：至少 8 位，且包含大小写字母或特殊字符（服务端强制 + 登录页即时反馈；可通过配置调整，见下）。
• 失败锁定：同一来源连续输错 5 次密码后锁定 5 分钟（期间正确密码也拒绝），登录成功即清零计数；按客户端 socket 地址计数， 伪造无效。