dsh-deepsleep
> 把 DSH 装进口袋 —— 趁你睡着，它还在电脑上干活。
DSH Web GUI 的手机适配 client-plugin，外加一套带密码保护的局域网访问链路。 纯原创、零第三方素材、MIT 协议。
> ⚠️ 安全提示：手机访问链路走的是 HTTP 明文，传输不加密， > 安全性无法得到保障。密码门只能挡住随手访问的人，挡不住抓包监听。 > 仅建议在安全、可信的网络（如家庭 Wi-Fi）内使用；公共网络、陌生网络 > 中请勿启用。需要更强保护请改用 Tailscale / HTTPS。
它能做什么
1. 手机布局插件
桌面三栏布局（sidebar | center | details，JS 计算的网格轨道）在手机宽度
（≤768px，或粗指针 ≤1180px）下自动切换为：
- 单栏对话流：中栏占满全宽，侧栏/详情栏退出文档流
- 抽屉式侧栏：左上角汉堡按钮开合，遮罩点击 / Esc / 选中会话后自动关闭
- 详情栏浮层：右侧滑出，沿用产品原生开合控件（
data-details-collapsed） - 移动端细节：
100dvh动态视口、safe-area 刘海适配、输入框 ≥16px 防 iOS
聚焦缩放、代码块/表格横向内滚动、44px 触控目标
crypto.randomUUIDpolyfill：纯 HTTP 来源（非 localhost）下浏览器不提供
该 API，DSH 客户端每次 RPC 都会调用它——补丁让它能在局域网 HTTP 上正常工作
纯 DOM/CSS 插件：无 cordis 服务依赖、无模型面、零外部运行时导入；所有 DOM/CSS/属性写入都由 apply() 返回的 disposer 还原。
2. 密码保护的手机访问代理
lan-proxy-3080.mjs：手机 → 0.0.0.0:3082（密码门）→ 127.0.0.1:3080 （appliance 的 dsh web）。
- 未登录访问只看到登录页，输对密码才发 HttpOnly 会话 cookie
- 通过后把 Host 头改写成回环地址，让
dsh web（裸启动、无--trusted-host）
的 /api 信任栏接受手机请求（含 WebSocket / SSE）
- 密码来源：环境变量
DSH_MOBILE_PASSWORD，或proxy-password.txt第一行 - 监听端口来源（可选，默认 3082）：环境变量
DSH_MOBILE_PORT，或
proxy-port.txt 第一行；上游 dsh 端口用 DSH_WEB_PORT（默认 3080）
文件
| 路径 | 作用 |
|---|---|
src/client/index.js | 客户端插件主体（布局状态机 + 抽屉 chrome + polyfill） |
src/client/mobile.css | 全部样式，锁在 html[data-dsh-mobile] 作用域 |
lib/index.js | host 侧入口（无行为，纯 ESM） |
lib/client.js | 构建产物：__ModuleLoader__.load CJS 工厂包 |
build.mjs | 无依赖构建器（纯 Node，内嵌 CSS） |
tests/smoke.mjs | vm 沙箱冒烟测试 |
lan-proxy-3080.mjs | 密码门 + Host 改写的手机访问代理 |
start-mobile-link.ps1 / .cmd | 一键：设密码（必填）+ 设端口（可选）+ 起代理 + 打印手机地址 |
构建与测试
node build.mjs # 重新生成 lib/client.js
node tests/smoke.mjs # 冒烟测试安装为 dsh 插件
# 把本目录作为 web profile 的 bundle 安装（pnpm 会在 profile 里建 link）
dsh plugin --profile web add -w <path-to-this-directory>装好后重启 dsh web（插件集合变更需重启才生效），移动插件即进入 window.__DSH_BOOT__ 启动图。桌面宽度下它不产生任何可见改动。
手机访问（密码门）
# 交互式：首次运行依次提示「设置访问密码（必填）」「设置代理端口（可选，回车用 3082）」，
# 然后启动代理并打印手机地址
powershell -ExecutionPolicy Bypass -File start-mobile-link.ps1
# 或手动（密码从 proxy-password.txt 读取，端口默认 3082）：
node lan-proxy-3080.mjs手机打开 http://<电脑局域网IP>:<代理端口>，先输密码，之后正常使用。电脑端仍用 http://127.0.0.1:3080。手机与电脑此时连的是同一台服务器，状态实时同步。
安全须知
- dsh 自身没有鉴权层；本代理只补了一道密码门，且走的是明文 HTTP——
密码在局域网内传输不加密。它能挡住随手访问的人，但挡不住抓包。
- 需要更强保护时，请置于 Tailscale 等加密覆盖网络之后，或改用 HTTPS。
- 只在可信网络（家庭 Wi-Fi）使用；公共网络不要跑这个代理。
proxy-password.txt已被.gitignore排除，切勿提交。
License
MIT，见 [LICENSE](LICENSE)。