dsh-session-lock

Name: dsh-session-lock
Author: lmk2215

lmk2215/dsh-session-lock

Conversation lock for the DeepSeek Harness sidebar: every conversation row gets a lock button, and a locked conversation blurs only the conversation area behind a password box while the sidebar stays usable. Re-locks on window blur, tab hide, page hide, or whenever the open conversation changes, and never pauses a running turn - the veil reports that background work continues. The password digest, lock flags, and preferences live in <DSH_HOME>/session-lock/state.json behind two same-origin routes guarded by a custom header, so clearing the page localStorage unlocks nothing; PBKDF2-SHA256 with a random salt, and a 30-second input lockout after five wrong attempts. Recovery is opt-in per machine: a Windows login password (enabled only after a real .NET PrincipalContext ValidateCredentials check against the local machine, so Microsoft accounts and passwordless machines keep it off) and a cooling period chosen while creating or changing the password (1/6/24/72/168 hours; expiry clears the password and releases every lock, and the correct password cancels the countdown). A settings section covers status, changing the password, lock new conversations, hiding locked titles, a three-position archive-restore policy (all / locked only / off, switching needs the password), lock everything, and unlock everything. Dialogs use the native dialog top layer, so a dialog opened from Settings is never covered by it. Requires DSH 0.2.0-rc.1 or newer; no build step.

Instalar

dsh plugin --profile web add github:lmk2215/dsh-session-lock

README

dsh-session-lock · 对话锁

给 DeepSeek Harness 侧边栏的每个对话加一把锁。锁上之后只有对话区被磨砂遮罩盖住并弹出密码框，左侧侧边栏照常使用；离开对话、切到后台、窗口失焦都会重新锁定。

Lock any conversation in the DeepSeek Harness sidebar. Only the conversation area is covered — the sidebar keeps working, and locked work keeps running.

特性

每行一把锁：侧边栏对话行尾的锁按钮，点一下即锁；再点输入密码永久解锁。
只遮对话区：遮罩从侧边栏右边缘开始，标题栏、侧边栏、底部面板都不受影响。
自动重锁：窗口失焦、切到后台、页面隐藏、切换对话，都会立刻恢复锁定。
不打断任务：锁定只是界面层，正在跑的回合继续跑，token 照常计费，输出照常写进会话日志。遮罩上会显示「后台任务仍在运行」。
密码存 Host：密码摘要与锁状态落在 <DSH_HOME>/session-lock/state.json，页面上清 localStorage 解不开。
三种找回：Windows 登录密码（实机验证通过才启用）、强制冷静后清空、改密码。
默认策略：新对话默认上锁、锁定后隐藏侧边栏标题、从归档恢复的三档策略、一键上锁 / 一键解锁。

安装

插件市场：设置 → 插件 → 发现，搜索 dsh-session-lock。

命令行：

dsh plugin --profile desktop add github:lmk2215/dsh-session-lock

装完重启一次 DSH（Host 半需要加载），然后打开 设置 → 对话锁 设置密码。

要求 DSH >= 0.2.0-rc.1、Node >= 20。无需构建步骤，装的是源码本身。

用法

位置	行为
侧边栏对话行尾 🔒	锁定该对话；第一次会先让你设置解锁密码
侧边栏对话行尾 🔓（琥珀色）	输入密码后永久解锁该对话
锁定中的对话区	磨砂遮罩 + 密码框 + 「忘记密码？」入口 + 后台任务状态
设置 → 对话锁	状态、修改密码、找回通道、默认设置

临时查看会在这些时机失效并重新上锁：窗口失焦、pagehide、页面隐藏、切换到别的对话。

找回密码

三条路，各自独立，可在设置里启用：

通道	需要什么	说明
旧密码	记得它	这是「修改密码」，不是找回
Windows 登录密码	这台机器的 Windows 账户密码	启用时用 `.NET PrincipalContext('Machine').ValidateCredentials` 真实验证一次，通过才开。微软账户、无密码账户会验证失败——所以别人的机器有密码就能用，没有就用不了
强制冷静	时间	在设置密码 / 修改密码时选定 1 / 6 / 24 / 72 / 168 小时。到期自动清空密码并解除全部锁。冷静期间无法手动取消，但输入正确密码可以中止

三条都不启用时，设置页会红字警告：忘记密码只能删数据。

隐私与边界

这把锁挡的是旁人看到屏幕。

会话文件本身在 ~/.dsh/sessions/<workspace>/<sessionId>/session.v4.jsonl.zstd，zstd 是压缩不是加密；能登进你的系统账户、能读这些文件的人，本来就能直接读会话。
冷静期依赖系统时钟，把时钟往前调可以提前到期；插件会记录并在设置页提示时钟被调整过。
密码摘要用 PBKDF2-SHA256（随机 16 字节盐、120000 轮），连错 5 次锁定输入 30 秒。
两条本地路由（/session-lock/state、/session-lock/action）要求自定义请求头，跨站表单发不出来；它们只绑定在回环地址上。

数据与卸载

内容	位置
密码摘要、锁清单、偏好、找回状态	`<DSH_HOME>/session-lock/state.json`
旧版遗留的 localStorage 记录	首次读取时导入 Host 并删除

卸载：dsh plugin --profile desktop remove dsh-session-lock，或插件市场里停用。卸载不会删除 state.json；不需要就手动删掉那个目录。

实现

Slot	用途
`sidebar.workspaces.session.row.action`	对话行尾的锁 / 开锁按钮（`order: 150`）
`shell.overlay`	遮罩、密码框、全部对话框（`order: 1000`）
`settings.section`	设置页「对话锁」（`order: 26`）

遮罩用 position: fixed，左边界取自 frame 自身的 grid-template-columns 第一段，锚点用 layout 打的 data-shell-overlay。
对话框用原生 <dialog>.showModal()，落在浏览器 top layer，因此从设置页打开的弹窗不会被设置页压住。
Host 半只做三件事：读写 state.json、校验密码、调用 Windows 凭据校验。没有工具、没有会话事件、不发网络请求。

开发自测：python tests/api_probe.py <port> 跑一遍全部路由动作。