xxxsirrrr/dsh-deepsleep

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.randomUUID polyfill：纯 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

装好后重启 dsh web（插件集合变更需重启才生效），移动插件即进入
window.__DSH_BOOT__ 启动图。桌面宽度下它不产生任何可见改动。

手机访问（密码门）

交互式：首次运行依次提示「设置访问密码（必填）」「设置代理端口（可选，回车用 3082）」，
然后启动代理并打印手机地址
powershell -ExecutionPolicy Bypass -File start-mobile-link.ps1

或手动（密码从 proxy-password.txt 读取，端口默认 3082）：
node lan-proxy-3080.mjs

手机打开 http://:，先输密码，之后正常使用。电脑端仍用
http://127.0.0.1:3080。手机与电脑此时连的是同一台服务器，状态实时同步。

安全须知

- dsh 自身没有鉴权层；本代理只补了一道密码门，且走的是明文 HTTP——
密码在局域网内传输不加密。它能挡住随手访问的人，但挡不住抓包。
- 需要更强保护时，请置于 Tailscale 等加密覆盖网络之后，或改用 HTTPS。
- 只在可信网络（家庭 Wi-Fi）使用；公共网络不要跑这个代理。
- proxy-password.txt 已被 .gitignore 排除，切勿提交。

License

MIT，见 LICENSE。