前言¶
在本地或办公室开着 DeepSeek Harness（DSH）网页端时，界面里往往有对话、工具输出和项目上下文。人走开几秒，旁人仍可能直接看到屏幕上的内容。关掉标签页或最小化窗口能藏住界面，但回来还要重新找入口；系统级锁屏又太重。下面介绍的插件在 DSH 左侧栏加一个锁屏按钮：一键用当前 Windows 桌面壁纸盖住整个框架，需要时再连按两次 Esc 解锁，属于 admin-security 类、偏界面侧的轻量隐私手段。
这是什么¶
dsh-lock-screen 由维护者 HandsYe 发布，仓库为 HandsYe/dsh-lock-screen。它面向 DSH 网页 GUI：在左侧栏底部（「设置」旁）渲染锁形按钮，点击后全屏遮罩显示本机当前 Windows 壁纸（background-size: cover），并拦截点击、按键、滚轮与右键菜单。解锁方式为 2 秒内连按两次 Esc；第一次按下后底部提示「再按一次 Esc 退出锁屏」。插件不注册任何 agent 工具，宿主端只从本地路径读壁纸字节，不发起外网请求。
社区目录页：skillhub 上的 dsh-lock-screen。
核心功能¶
- 一键锁屏：遮罩挂在
shell.overlay槽位，z-index 置于所有列与面板之上，锁上后界面内容不可见、不可操作。 - 壁纸来源：宿主提供
GET /dsh-lock-screen/wallpaper，在 Windows 上按顺序尝试TranscodedWallpaper、CachedFiles下最新图片、注册表WallPaper路径；MIME 由文件魔数判断（jpeg/png/bmp/gif/webp）。 - 双击 Esc 解锁：超时重置计数；按住 Esc 的自动重复不计数，避免误触一次就解锁。
- 降级行为：找不到壁纸文件（例如纯色桌面）时，遮罩为黑色背景，提示行显示读取错误。非 Windows 或在探测路径中无图片时同样可能回退为黑色。
- 调试：
GET /dsh-lock-screen/ping返回实际选用的壁纸文件路径。
当前 package 版本为 0.1.0，许可证 MIT。
安装与启用¶
需要 dsh web（或 DSH Desktop）环境；客户端槽位要求 dsh web 0.1.0-rc.6 或更新（shell.overlay、sidebar.footer.action）。从插件市场安装要求 dsh 0.2.1+。
从插件市场（推荐，dsh 0.2.1+）
打开 插件 → 发现，搜索 dsh-lock-screen。列表来自 awesome-dsh-plugin 精选目录；尚未合并进目录前可用源码或 Release 安装。
从源码安装
需要 dsh web / DSH Desktop。将下面命令中的 desktop 换成你实际使用的 profile 名称；官方 DSH Desktop 请改用 设置 → 插件 安装（Desktop 自行管理 profile）。
dsh plugin --profile desktop add github:HandsYe/dsh-lock-screen
从 Release 包安装（无需构建，锁定 v0.1.0）
dsh plugin --profile desktop add https://github.com/HandsYe/dsh-lock-screen/releases/download/v0.1.0/dsh-lock-screen.tgz
目录里的 tarball: 字段指向 releases/latest/download/dsh-lock-screen.tgz，会跟随最新 Release。
多数安装无需重启；若左侧未出现锁按钮，刷新页面一次即可。
典型用法¶
- 在 DSH 网页端左侧栏底部找到锁形按钮，点击锁屏。
- 确认整个界面被桌面壁纸（或黑色回退）覆盖，无法点击原界面。
- 在 2 秒内连按两次 Esc 解锁；若只看到「再按一次 Esc 退出锁屏」，在窗口期内再按一次 Esc。
- 若壁纸异常，可在浏览器或桌面协议下访问
GET /dsh-lock-screen/ping核对宿主选中的文件路径（路由同时挂在旧版 web 服务器与 Connection/api通道，便于dsh-app:与普通浏览器共用）。
适用场景与注意¶
适合谁：在 Windows 上本地跑 DSH Web 或 Desktop、需要短时间离开工位又不想暴露对话与面板内容的用户；分类上属于 admin-security，侧重界面遮挡而非账号或权限体系。
权限与审阅：插件以当前 DSH 进程权限运行，宿主会读取 %APPDATA%\Microsoft\Windows\Themes\ 等路径及注册表壁纸配置。安装前建议浏览 GitHub 仓库 源码（lib/client.js、lib/index.js、lib/http-transport.js）并确认 MIT 许可证是否符合你的合规要求。锁屏不能替代操作系统会话锁或磁盘加密；纯色壁纸或无图片时仅显示黑屏遮罩。
兼容性：@deepseek-ai/* 相关包在 peerDependencies 中多为可选，渲染器或 web 服务器版本略有差异时通常仍可安装；壁纸解析逻辑主要针对 Windows，其他平台勿指望自动显示系统壁纸。
结尾¶
dsh-lock-screen 把「盖住 DSH 界面」收成侧栏一键操作，并用本机壁纸伪装成普通桌面，解锁流程固定在双击 Esc。需要安装与原理细节时，以 README 为准：GitHub：HandsYe/dsh-lock-screen；在生态目录中检索：skillhub：dsh-lock-screen。DSH 社区插件独立于 DeepSeek / 幻方官方应用商店，安装与审阅责任在使用方。
