dsh-pocket

<h1 align="center">DSH Pocket</h1> <p align="center"><a href="README.en.md">English</a> | <a href="README.md">中文</a></p>

把 DeepSeek Harness 装进你的口袋：一个包、一个设置页，手机扫二维码就实时看到电脑上的同一个界面——人在外面也能用。

⭐ 顺手留颗 Star，作者能高兴一整天  ·  <a href="https://github.com/shaobeichen/dsh-pocket">行，给你一颗 Star</a>

这是什么

你不在电脑前，也想用电脑上的 DeepSeek Harness。

• 下班路上，agent 在电脑上跑任务，你想掏出手机看看它干到哪了、结果如何
• 出门在外，突然想让电脑上的 agent 查点资料、写段代码，但没有远程桌面、没有 SSH
• 电脑在宿舍/办公室，你人在外面，想随时"操控你的 DeepSeek Harness"——发任务、看输出、点审批

DSH Pocket 就是干这个的：装上它，手机扫个码，就能实时看到并操控电脑上的 DeepSeek Harness 界面——人在外面也能用。

实际效果——手机上的界面就是电脑上的界面，实时同步：

✨ 特性

特性	说明
📶 局域网扫码	装好即用：设置 → 手机访问，打开就有局域网二维码，手机连同一 WiFi 扫码即开（自动识别本机局域网 IP，WSL 环境自动取 Windows 物理网卡 IP）
🚪 局域网开关	设置页可一键关闭/开启局域网访问（切换时弹窗提醒）：关闭后局域网二维码/链接立即失效，仅公网可用
🌐 公网扫码（人在外面）	点「开启公网访问」→ cloudflared 隧道 → 出公网二维码，4G/任何网络都能访问
🏷️ 公网固定域名	可选「命名隧道」模式：填 Cloudflare Tunnel Token + 自己的域名，公网地址固定不变（重启不再变；见下方说明）
🔐 访问密码	公网链接默认使用 8 位随机密码（每次开启公网自动换新；可自定义固定密码——自定义后不再换新）；局域网有独立的默认 8 位随机密码（默认开启，设置页可一键关闭——关闭后局域网扫码直连）
🔑 自定义密码	公网/局域网密码都可在设置页设成自己固定的 8–64 位密码（英文字母大小写或数字）（自定义后公网不再自动换新）
🧘 会话保持	手机输一次密码后长期免输（登录状态绑定电脑上的 dsh web 进程：只要它不重启，手机不用再输；dsh web 重启/更新后需重新输入一次）
⚡ 实时同步	流式输出走 WebSocket 全透传——电脑上在输出，手机上同步在滚，可双向操作；内置心跳保活（防路由器 NAT/省电机制静默断链，断线自动重连）
📱 移动端适配	窄屏自动变抽屉布局（移植 dsh-web-mobile，MIT）：侧栏抽屉、会话全宽、状态栏安全区、触控优化
🧭 可选右边栏	手机端显示原生右边栏入口；普通手机可在设置中关闭以保持紧凑，折叠屏展开后可更方便地同时使用终端底栏和右边栏
📁 文件浏览	移动端「文件浏览」入口需要宿主提供 explorer 面板（dsh-web-ui 组件）；官方 DSH 未内置时入口自动隐藏，不会出现"点了没反应"
🗜️ 传输压缩	大 JSON 响应自动 gzip/brotli（长会话 17MB → ~1MB，brotli 质量 6：快且省流量），手机加载更快、更省流量
🔁 隧道自动恢复	DSH 重启后自动重新拉起之前开着的公网隧道，无需手动重开
🧩 零依赖安装	一个 npm 包、一个设置页，没有核心/适配器要分开装；无需账号、无需服务器

🚀 怎么用

入口在哪：安装完成并重启 dsh web 后，打开 设置，左侧边栏就能看到 「手机访问」 入口（和「通用设置」「模型」同级）：

前提：电脑上已装好 DeepSeek Harness。如果终端提示 dsh: command not found（找不到 dsh 命令），先安装：

…