保险箱隐私锁 robbin810130/dsh-vault-plugin

dsh-vault-plugin

Listed on dsh-plugin.org

DSH Web / Desktop 配置档的隐私锁：在侧边栏直接锁定 Workspace 或 Session，自动创建并绑定密码组，再在主区域用密码解锁受保护内容。

这是社区插件，不隶属于 DeepSeek AI 或 DeepSeek Harness 官方团队。

安全边界（一期）：插件只控制 DSH 前台访问，不加密原始 Workspace、Session 或项目源文件的持久化数据。落盘加密属于二期，别把本插件当作磁盘加密或数据防泄漏产品。

DSH Desktop 0.2.1-rc.3 升级修复

v0.2.13 修复桌面版升级到 0.2.1-rc.3 后的窗口空白（web boot: 33 entries did not activate，全是 pending 无 failed）。根因是 0.2.1-rc.3 新增插件 peer 版本门禁：profile 行的 peerDependencies 精确锁在旧版本上就会被静默禁用，不报错也不进崩溃日志，只表现为服务缺失。0.2.12 的 overlay 带着 version: 0.2.1-rc.2 与 31 个锁定 rc.2 的 peer，因此 vault-compat-session-controller 整行被丢弃，sessions 无人提供，界面全挂。

修法不是 dsh plugin allow-version，而是用已安装版本的 fixture 重新生成 overlay——prepare-overlay.mjs 会复制 fixture 的 package.json，版本与 peers 自动对齐。用法见 版本限定适配层，排查过程见 诊断记录。compat/probe-dsh.mjs 现在查两道门禁（bundle 字节 + overlay 版本），新增 L1-O 判定专门拦这一类问题。

DSH Desktop 0.2.1-rc.2 升级修复（v0.2.12）

v0.2.12 修复桌面版升级到 0.2.1-rc.2 后的插件激活失败（web boot: 1 entry did not activate / dsh-vault-plugin: failed）。根因是新版客户端不再暴露 sessions.openingAccess，且标题/遮罩所需的插槽仍未声明。

新版适配层改为对已安装的 0.2.1-rc.2 客户端产物原址打补丁（不再复用 0.2.0-rc.2 快照），因此 ui-skill / ui-reference / ui-secret-mask / ui-goal 也恢复正常。用法见 版本限定适配层；0.2.0-rc.2 桌面版仍用 旧适配层。适配层放在应用外部，不修改签名应用；单独安装 Vault 不会自动完成桌面适配。

DSH Desktop 0.2.0-rc.2 升级修复

v0.2.11 修复桌面版升级后的插件启动错误、API 离线和解锁后会话加载问题。macOS 官方桌面版需要配套的 版本限定适配层，Release 提供 dsh-vault-compat-dsh-v0.2.0-rc.2.tgz。保留现有密码组、保护绑定和策略。

命令行一键安装器仍面向 web 配置档；桌面用户请按上面的适配说明操作。未知版本及 Windows/Linux 桌面版尚未验证。

DSH 0.1.7-rc.1 本机兼容修复

版本限定补丁、构建入口和验证/回滚说明见 兼容说明。补丁为 Workspace 与 Session 行、对话标题、浏览器标题和受保护会话遮罩提供所需插槽；GitHub Release 随附补丁及匹配的 DSH 客户端 bundle。

从旧 scoped 包迁移

0.2.7 的实际包名改为 dsh-vault-plugin，GitHub 仓库地址不变；本次不是 npm 注册表发布。

已安装 @robbin810130/dsh-vault-plugin 时，不能直接覆盖安装或同时加载新旧两份插件。 先停止 DSH，备份整个 web 配置档和插件状态目录，再按顺序执行：

dsh plugin --profile web remove @robbin810130/dsh-vault-plugin
dsh plugin --profile web add github:robbin810130/dsh-vault-plugin#v0.2.11

确认配置档仅有一个新包及一个 bundle 后再启动。保留原节点 ID、设置和状态/备份目录；Vault 密码、策略和绑定不重置。安装失败时保持停服并还原配置档备份，不删除 Vault 数据。Vault 一键安装器不自动移除旧包。如果当前安装的是旧版 scoped 包，先按上面流程迁移。DSH 0.1.7-rc.1 的 Workspace 行扩展属于宿主客户端兼容包；只在 DSH 界面里重装 Vault 插件不会更新宿主客户端，兼容说明中列有配套补丁与客户端 bundle。

依赖管理器可能重新生成其他插件的目录。若其他插件把运行数据写在 node_modules 下，须在停服备份后、启动前从备份恢复该数据目录，并校验其余插件文件未变。

一条命令安装

适用于 macOS / Linux。要求已安装 DSH，并且 dsh 在 PATH 中：

curl -fsSL https://raw.githubusercontent.com/robbin810130/dsh-vault-plugin/main/install.sh | bash

Windows PowerShell：

irm https://raw.githubusercontent.com/robbin810130/dsh-vault-plugin/main/install.ps1 | iex
安装器从 GitHub Releases 下载最新插件包和 SHA-256 校验文件，校验通过后调用 DSH 原生命令：

dsh plugin --profile web add <downloaded-package>

安装完成后重启 DSH Web profile。DSH 0.1.7-rc.1 还须按 兼容说明部署随版本发布的宿主客户端 bundle；单独安装插件不会改写 DSH 全局客户端。安装器不会上传密码、恢复密钥或 Vault 状态。

也可以直接使用 DSH 原生安装命令安装 GitHub 仓库：

dsh plugin --profile web add github:robbin810130/dsh-vault-plugin#v0.2.11

功能概览

- 在 Workspace 或 Session 行内点击锁按钮即可上锁；首次上锁时输入密码，插件会自动创建密码组并完成绑定。
- Workspace 锁定后立即收起会话列表；已保护的会话名称显示为“已加密对话”，不会把原始标题泄露到侧边栏或无障碍文本。
- 解锁只从主区域的“解锁”按钮发起，不因点击列表条目自动弹出密码框；解锁状态仅保留在当前运行时。
- 支持自动锁定、系统休眠上锁、失败尝试保护与暂停时间。
- 密码策略可配置最小长度，以及大写、小写、数字和符号要求；创建和修改密码都会按当前策略校验。
- 创建或恢复成功时只显示一次恢复密钥；恢复密钥不会写入设置、日志或浏览器存储。
- 工作区重新上锁会立即使当前会话失效，避免继续浏览已打开的受保护内容。

使用流程

1. 在侧边栏找到 Workspace 或 Session，点击行内锁按钮。
2. 输入并确认密码，点击“保存并上锁”。密码组会自动生成并绑定，无需先到设置页手动创建。
3. 之后点击受保护条目可查看锁定占位页；需要访问时，在主区域点击“解锁”并输入密码。
4. 在设置 → 插件 → 保险箱中调整锁定策略或管理已经自动生成的密码组。

兼容性

- macOS Desktop：v0.2.1-rc.3（当前适配目标）、v0.2.1-rc.2、v0.2.0-rc.2（旧适配层）——每个版本都必须同时应用该版本的精确客户端适配层
- Web：v0.1.7-rc.1（保留原精确宿主补丁和客户端 bundle）
- Node.js：^22.19.0 || >=24.0.0（由插件包声明）
- 运行 profile：Web 使用 web；官方桌面版使用 desktop

历史 DSH v0.1.2-rc.1 补丁 保留供旧版参考，不代表当前发布已重新完整验证该组合。补丁只针对记录的上游提交，未知 DSH 版本不得直接套用。

权限、隐私与风险边界

- 插件会读取并写入本机 Vault 私有状态目录（默认 $DSH_HOME/vault-lock/，未设置 DSH_HOME 时为 ~/.dsh/vault-lock/），保存加盐 scrypt 密码／恢复密钥验证器，以及明文组名、绑定和审计元数据；这些元数据未加密。显式 stateDir 或 DSH_VAULT_STATE_DIR 优先。
- 插件会注入 DSH Web profile 的设置、Workspace、Session 和主内容区域 UI，以提供锁定/解锁交互。
- 不依赖外部服务，不主动联网，不上传密码、恢复密钥或会话内容。
- 当前版本保护的是 DSH 前台访问；不会加密原始 Workspace、Session 或项目源文件。不要把它当作磁盘加密或数据防泄漏产品。
- 兼容范围见下节；未知 DSH 版本不要直接套用兼容补丁。

密码、恢复密钥和 grant token 不应写入日志、配置文件、浏览器持久化存储或 issue。

威胁模型与安全边界说明

本节明确当前版本防什么、不防什么，以及三个有意为之的设计权衡：

- 防的是谁：防的是"借用你这台机器、打开 DSH 网页的人"（同事、家人、维修场景下的旁观者）。密码组密码仅保存加盐 scrypt 验证器，不保存可解密的密码；连续输错触发组级冷却。
- 不防的是谁：不防"已经能用你的系统账户执行代码的人"。本机同用户进程本来就能读取 Vault 状态文件（0600 权限只隔离其他系统用户），也能直接打开未加密的 Workspace/Session 源文件。这是 UI 层访问门禁，不是内容加密。
- 快照不要求密码组解锁：锁 UI 在渲染前必须知道"哪些 session/workspace 受保护"，因此快照暴露组 ID、组名、成员数、绑定拓扑及策略，不包含明文密码、恢复密钥或会话内容。历史组名可能包含用户自定义名称；前台按锁定状态隐藏，接口元数据不属于内容保密边界。DSH 自身的访问控制和本插件的密码组授权是两个不同层次。
- 限流计数是内存态：输错计数随 DSH 重启清零。持久化计数会让状态文件在每次尝试时都落盘（放大损坏与泄露面），而重启 DSH 本身就是需要物理或账户权限的操作，与威胁模型匹配。组级冷却保证攻击者轮换客户端标识无法绕过。

升级、卸载与回滚

再次执行安装命令即可通过 DSH 原生命令升级：

curl -fsSL https://raw.githubusercontent.com/robbin810130/dsh-vault-plugin/main/install.sh | bash

卸载：

dsh plugin --profile web remove dsh-vault-plugin

详细的本地打包、备份、回滚和紧急解除保护流程见 docs/install.md。卸载不会删除原始 DSH Workspace/Session；回滚前不要擅自删除 Vault 状态目录。

开发与验证

pnpm --dir plugin install --frozen-lockfile
pnpm --dir plugin run build
pnpm --dir plugin exec vitest run
pnpm --dir plugin exec tsc -p tsconfig.host.json --noEmit
pnpm --dir plugin exec tsc -p tsconfig.client.json --noEmit
node scripts/package-release.mjs
node --test tests/install-script.test.mjs tests/scripts/package-release.test.mjs
发布前，可用下面这套最小流程复现核心功能：新建测试会话 → 点击行内锁按钮 → 设置密码 → 确认侧边栏显示保护状态 → 在主区域点击「解锁」→ 输入密码恢复访问。

发布资产由 GitHub Actions 在 v* 标签上生成：

- dsh-vault-plugin.tgz
- dsh-vault-plugin.tgz.sha256
- DSH 0.1.2、0.1.5、0.1.7 的版本限定补丁
- DSH 0.1.5、0.1.7 兼容包及 DSH 0.1.7 客户端 bundle
- compatibility.sha256

项目文档

- 设计规格：docs/superpowers/specs/2026-08-24-dsh-vault-privacy-lock-design.md
- 安装与回滚：docs/install.md
- 安全边界：docs/security-boundary.md
- DSH 兼容补丁：compat/dsh-v0.1.2-rc.1/README.md