dsh-password-gate 网吧式挂机锁屏：一键锁定界面、空闲自动挂机、重启后首次免密登录，忘记密码也不会把自己锁死。

[steamfeifei]

dsh-password-gate

DeepSeek Harness (DSH) Web GUI 的临时门禁插件 —— 网吧式挂机锁屏：一键锁定界面、空闲自动挂机、重启后首次免密登录，忘记密码也不会把自己锁死。

A temporary lock (internet-cafe style) for the DSH web GUI: lock the screen with a password, optional idle auto-lock, and a free first login after every service restart.

功能特性

• 🔒 侧边栏入口：设置上方的「临时门禁」按钮，点击弹出配置面板
• ⏱️ 挂机模式：空闲 N 分钟后自动锁屏（1–1440 分钟可配），可随时关闭
• 🔑 挂机密码：设置/修改无需当前密码；留空保存即清除密码并停用门禁
• 🖥️ 全屏锁屏：密码解锁；连续输错 5 次锁定 30 秒（防暴力尝试）
• 🧩 多标签页联动：任一标签页锁定，其余同步锁定；刷新页面无法绕过（F5 无效）
• ♻️ 重启后首次免密登录：宿主每次启动更换 bootId，自动丢弃锁定标记
• 🌗 跟随主题：使用 DSH 的 --dsw-alias-* 主题变量，自动适配亮/暗色
• 🔐 密码安全：磁盘上只存 SHA-256 哈希，明文永不落盘；状态文件与安装位置解耦

安装

要求 DSH ≥ 0.1.0-rc.6（与 dsh-* ABI 及 @deepseek-ai/cordis ^4.0.1 对齐）。

方式一：Git 仓库（推荐）

git clone https://github.com/steamfeifei/dsh-password-gate
cp -r dsh-password-gate ~/.dsh/profiles/web/node_modules/

方式二：npm（可选）

cd ~/.dsh/profiles/web
pnpm add dsh-password-gate

声明插件行

在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: password-gate
      name: 'dsh-password-gate'
      config:
        passwordHash: '<你的密码的 sha256 十六进制>'
        maxAttempts: 5        # 可选：锁定前允许的连续错误次数
        lockSeconds: 30       # 可选：锁定秒数
        idleMinutes: 0        # 可选：空闲自动挂机分钟数（0 = 关闭）

生成 passwordHash：

node -e "console.log(require('crypto').createHash('sha256').update('你的密码').digest('hex'))"

重启 Harness（dsh web）并刷新页面，侧边栏即出现「临时门禁」。

使用

1. 点击侧边栏 🔒 临时门禁 打开配置面板；
2. 挂机模式：选择「关闭 / 空闲自动挂机」，启用时填写空闲分钟数 → 保存设置；
3. 挂机密码：输入新密码 → 保存密码（无需当前密码；留空保存 = 清除密码）；
4. 立即挂机锁屏：马上锁定整个界面；锁屏后输入挂机密码解锁。

状态胶囊会显示当前配置：已设密码 · 空闲 X 分钟自动挂机 / 未设置密码。

配置项（cordis.patch.yml 行 config）

键	默认	说明
passwordHash	（必填）	启动密码的 SHA-256 十六进制（小写）
maxAttempts	5	锁定前允许的连续错误次数
lockSeconds	30	达到上限后的锁定秒数
idleMinutes	0	空闲自动挂机分钟数（0 = 关闭）

面板中的修改会持久化到 <DSH_HOME>/password-gate.json（默认 ~/.dsh/password-gate.json），优先于上述行配置。

工作原理

• 宿主端 lib/index.js：在 Harness 自带的 HTTP 服务上注册 JSON API
  • GET /__dsh/password-gate/state → { bootId, hasPassword, idleMinutes }
  • POST /__dsh/password-gate/verify → 解锁校验（SHA-256 比对 + 频率限制）
  • POST /__dsh/password-gate/change → { next } 设置/清除密码（明文不落盘）
  • POST /__dsh/password-gate/config → { idleMinutes } 持久化挂机配置
• 浏览器端 lib/client.js：通过 sidebar.footer.action / shell.overlay 槽位渲染侧边栏按钮、配置弹窗与锁屏；监听空闲活动触发自动挂机；依据 bootId 实现重启免密。
• 持久化：状态原子写入 <DSH_HOME>/password-gate.json，与包安装位置无关（npm/pnpm 安装的只读 store 也能正常工作）。

忘记密码怎么办

重启 Harness —— 首次登录自动免密。随后打开「临时门禁」直接设置新密码即可（无需旧密码）。或删除 <DSH_HOME>/password-gate.json（并/或修改 cordis.patch.yml 的 passwordHash）后重启。

开发

dsh-password-gate/
├── lib/
│   ├── index.js     # 宿主端（node 半）
│   └── client.js    # 浏览器端（window.__ModuleLoader__ 闭包，无构建步骤）
├── package.json     # dsh.client 声明 + exports["./client"]
├── README.md
└── LICENSE

回归验证（需在已安装该插件的 profile 环境执行）：

node verify-password-gate.mjs   # 位于本仓库工作副本旁的验证脚本

浏览器端为手写 ModuleLoader 包，仅依赖 shell 提供的 react seed；宿主端仅依赖 Node 内置模块与 webServer 服务。

安全说明

• 这是界面级门禁：能有效挡住随手打开页面的人；DSH 自带 Web 服务无服务端鉴权，精通浏览器调试的本地用户理论上可绕过。
• 改密刻意不校验当前密码（网吧式便利），请自行权衡使用场景。

License

MIT

[leenkcool]

#1728 可以自己提PR收录 。记得互相赞赏。 来回复一下。我合并的更快。

你这个挺好。

[steamfeifei]

已收到   谢谢!!

[zoahdev]

Indexed in the community registry (dsh-subscribe). Good honest security note in the README (UI-level gate, not server auth) — that framing is exactly what maintainers and users need.