前言¶
单用户 DeepSeek Harness 若直接暴露在浏览器或公网,常见缺口是:缺少统一的锁屏与登录边界、重启或关机只能 SSH 进服务器操作、验证方式分散在环境变量或反向代理层。下面介绍社区插件 dsh-lifecycle(维护者 floatDreamWithSong,分类 admin-security),在 DSH Web 内提供 Windows 风格锁屏、密码 / OTP / Passkey 认证,以及侧边栏电源与「登录与安全」集中配置。
这是什么¶
dsh-lifecycle 面向单用户 DeepSeek Harness,解决锁屏、登录验证和服务电源管理三类问题。插件通过 Cordis patch 注入 Web 客户端,并依赖独立电源控制服务完成锁定、重启、关机及检测到新版时的更新并重启。当前 npm 版本为 0.1.6,许可证 MIT,源码仓库:https://github.com/floatDreamWithSong/dsh-lifecycle。社区目录页:https://www.skillhub.cn/plugins/floatDreamWithSong/dsh-lifecycle(独立站点,与 DeepSeek / 幻方无官方从属关系)。
核心功能¶
锁屏与首次引导¶
- Windows 风格锁屏与首次设置引导,支持自定义壁纸(PNG、JPEG、WebP,单张最多 5 MB,最多 12 张,可恢复内置壁纸)。
- 点击锁屏或按 Enter 进入登录;「锁定」仅退出当前浏览器会话。
认证方式¶
- 支持密码、OTP、Passkey,可配置单步或两步验证;两步验证须先验证密码,再验证 OTP / Passkey。
- 已完成的登录可在服务重启后保留(默认有效期 30 天);锁定、改密、变更验证策略或绑定/移除因素会撤销相应登录。
- DSH 内「登录与安全」页面分区管理密码、验证方式、壁纸和登录会话。
电源与更新¶
- 侧边栏「电源」菜单:锁定、重启、关机,以及检测到新版时的更新并重启。
- 「关机」停止 Harness 服务,不会关闭操作系统;之后需在服务器上重新启动服务。
- 电源操作需安装仓库提供的独立控制服务:Linux 使用 systemd,macOS 使用 launchd,Windows 使用当前用户任务计划程序(Windows 为实验实现,暂未实机验证)。
安装与启用¶
环境要求:Node.js ≥ 22.18、DSH Web,以及 package.json 中声明的 dsh ≥ 0.2.0-rc.1。请使用运行 Harness 的账户,以及相同的 HOME / DSH_HOME 安装。
dsh plugin --profile web add dsh-lifecycle
安装后按仓库 docs/DEPLOYMENT.md 安装对应平台的电源控制服务,再重启 Harness。公网部署还需配置 HTTPS。源码构建支持重启和停止;自动更新适用于 npm 管理的 Harness 安装。
插件以当前 dsh 进程权限运行,安装前应阅读源码与 MIT 许可证,确认电源脚本与认证逻辑符合你的安全策略。
典型用法¶
- 首次访问时,从 Harness 服务日志取得初始密码,完成改密和验证方式设置。
- 登录后,从侧边栏或「电源 → 登录与安全」进入设置;在「锁屏壁纸」上传、选择或删除背景。
- 服务停止后,在服务器上启动 Harness(服务名按实际部署替换):
sudo journalctl -u deepseek-harness.service -n 100 --no-pager
sudo systemctl start deepseek-harness.service
忘记密码时的恢复、详细配置与卸载见部署说明;数据目录可定期备份,备份文件不要上传到 Git。仓库提供 dsh-lifecycle-reset 入口(见 package.json 的 bin 字段),具体步骤以 DEPLOYMENT 文档为准。
适用场景与注意¶
适合谁: 自托管单用户 DSH Web、希望在前端统一锁屏与多因素登录、并需要从 UI 执行重启 / 关机 / 更新重启的部署者。
公网与安全:
- 公网部署使用 HTTPS;网关放在反向代理之后,内部 Harness 端口仅监听回环地址;会话 Cookie 启用 Secure。
- Passkey 需要稳定的 HTTPS 域名,公网 IP 不支持;可先用密码或 OTP,之后在 Passkey 标签页保存域名后绑定。
- 忘记密码时第二因素不能跳过第一步;保留服务器管理入口和 OTP 备份代码。
- 当前壁纸对未登录访客可见,图库管理需要登录;不要用含隐私信息的图片作锁屏背景。
- 中国内地服务器使用域名前,需完成所需的备案及接入手续。
结尾¶
dsh-lifecycle 把锁屏、持久化登录与 Harness 生命周期控制收进同一套 Web 体验,与「一切皆插件」的 DSH 扩展方式一致。进一步细节与截图见 GitHub README 与 screenshots.json。
- 目录页:https://www.skillhub.cn/plugins/floatDreamWithSong/dsh-lifecycle
- GitHub:https://github.com/floatDreamWithSong/dsh-lifecycle