dsh-lock 0.1.6 · 锁屏 / Touch ID

dsh-lock 0.1.6 · DSH 锁屏 / Touch ID 验证

给 DeepSeek Harness Desktop 用的本地锁屏插件（macOS，建议 MacBook 且支持 Touch ID）。

功能

• 每次启动 DSH 重新锁定；已解锁状态超过 48 小时自动重新锁定；
• 一键锁定：会话头部右上角锁形按钮（设置 → 安全锁定 → 立即锁定 也可）；
• 首次访问强制设置密码：至少 4 位，内容不限；
• 忘记密码：终端执行 bin/reset-password → 恢复默认密码 4396 → 重新打开 DSH
  输入 4396 解锁 → 到设置里改密码；
• Touch ID：使用 macOS LocalAuthentication 原生小助手（bin/dsh-auth-helper），
  支持指纹，系统层面可回退到 Mac 登录密码；

  遵守 macOS 安全惯例，锁屏不会自动弹系统验证面板：轻触锁屏空白处 / 按 Enter /
  点 Touch ID 后，系统面板出现，把手指放上去即解锁。
  （macOS 不允许第三方应用后台监听 Touch ID 传感器，指纹必须经系统面板完成。）

• Liquid Glass 视觉：macOS 26 风格胶囊输入框/按钮、半透明玻璃材质、细高光边、
  柔和内阴影、仅主操作使用系统蓝 #0A84FF；深浅色主题自适应；
• 解锁动画：指纹 = 系统绿柔光 + 指纹淡出 + 对勾描边；密码 = 系统蓝柔光 + 锁扣弹开 +
  对勾描边，随后玻璃面板淡出。

安全设计

• 密码 scrypt（随机盐）+ 常数时间比较，长度 4–256；连续错误 5 次进入 30 秒起逐级翻倍冷却；
• 状态文件 ~/.dsh/dsh-lock/state.json 权限 0600，只存哈希/时间戳，不含密码与会话内容；
• 所有写接口要求同源 Origin + JSON + x-dsh-lock-client: 1 请求头，拒绝跨站请求；
• Touch ID 唤起节流：1.5 秒内最多一次、每分钟最多 5 次；插件不联网、不读会话内容。

环境要求

• macOS（已在 macOS 27 / Apple Silicon 验证）；
• DeepSeek Harness Desktop ≥ 0.2.0-rc.1；
• 指纹解锁需要本机已录入 Touch ID（无 Touch ID 可只用密码）。

安装

1. 下载 dsh-lock-0.1.6.zip 并解压到固定目录（或 git clone https://github.com/SeyanaA/dsh-lock.git）；

2. 在 DSH 里让 Agent 安装该目录：

   把 /路径/dsh-lock 作为本地插件安装到当前 profile。

   Agent 会调用 plugin_manager 的 install_bundle（target 为绝对路径）；

3. 若界面没有变化，完全退出并重新打开 DSH；首次打开会要求设置解锁密码。

手动安装、更新/卸载、安全设计与 FAQ 见仓库
README。

校验

SHA256: b3189fe6548d6b3c71f29a73afd22c9dec69dd0aa96d3cdef459dd6691af1aa2

License

MIT © 2026 SeyanaA