DeepSeek Harness MobileShare
English | 中文
dsh-mobileshare 是 DeepSeek Harness（dsh）的一个插件包（profile bundle）：以 PC 端为服务器，让 iPhone / Android / 平板 通过浏览器访问本机的 DSH WebUI（局域网或公网），并自动套用专为手机优化的移动端界面，PC 端 WebUI 的功能在手机上完整可用。
它采用一切皆插件的架构，由 Cordis 驱动。
功能
- 手机访问 WebUI：零依赖反向代理（Node.js 标准库实现，无第三方运行时依赖），局域网地址自动探测
- 注入式移动端 UI：服务端注入 viewport + CSS + JS，打开页面即有，无需安装、无需审批
- 顶部工具栏：☰ 侧边栏、⇄ 共享面板 - 输入框固定底部，键盘弹出自动上移，打字所见即所得 - 侧边栏内「选择工作区目录」入口（移动端目录选择器：盘符/桌面/上次工作区快捷入口、新建文件夹） - 隐藏桌面端冗余的"对话/轨迹"标签栏，保持单顶栏
- 共享管理：端口、访问账号密码、Windows 防火墙放行、本机/局域网自检、二维码
- 公网访问：一键启动 cloudflared 隧道（
winget install cloudflared），不要求同一局域网 - 自动恢复：重启后恢复上次共享配置，手机已登录会话 cookie 不过期（WebSocket 下行不中断）
- 目录选择器切换：自动把桌面弹窗式选择器切换为浏览器内浏览模式（手机可用）
运行
安装
需要本机已安装 DeepSeek Harness 并完成 Web profile 初始化（npx @deepseek-ai/dsh web 至少运行过一次）。
从 GitHub 安装（pnpm ≥10 会在首次安装时要求允许 prepare 构建脚本，按提示把包 key 加入 profile 的 pnpm-workspace.yaml 的 allowBuilds 后重试）：
dsh plugin --profile web add github:menghuanshiguang/dsh-mobileshare
dsh --profile web从本地 checkout 安装：
pnpm install
pnpm run build
dsh plugin --profile web add file:.
dsh --profile web安装即激活：包的 dsh.bundle 声明把 cordis.patch.yml 作为配置层插入 profile，浏览器半由 dsh-client-modules 依据 dsh.client 声明自动加载。
使用
1. 打开 DSH 设置页 → 移动共享 面板（或手机浏览器打开共享地址 → 顶栏 ⇄）。 2. 点击「启动共享」（可自定义端口/账号密码，留空自动生成随机密码）。 3. 手机连接同一 Wi-Fi，扫描二维码或打开显示的局域网地址。
| 位置 | 说明 |
|---|---|
| 顶栏 ☰ | 打开/关闭会话侧边栏 |
| 顶栏 ⇄ | 共享状态、二维码、防火墙、公网隧道 |
| 侧边栏「📁 选择工作区目录」 | 移动端目录选择器，切换当前工作区 |
| 输入框 | 始终贴底，键盘弹出自动上移 |
iPhone：Safari 打开后「分享 → 添加到主屏幕」。Android：Chrome 菜单「添加到主屏幕」。
配置
插件行支持以下 config 字段（在 profile 的 cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml 中按 id mobileshare 覆盖）：
| 字段 | 默认 | 说明 |
|---|---|---|
port | 3081 | 反向代理监听端口 |
社区与支持
- 欢迎通过 GitHub Issues 提交反馈或 bug 报告。
- 本仓库标记了
dsh-plugin话题，便于被发现。
参与贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
开发
请先阅读[开发指南](docs/development.md)与[架构文档](docs/architecture.md)。
面向 agent：请遵循 [AGENTS.md](AGENTS.md)。
许可证
[MIT](LICENSE)
第三方依赖及其许可证见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。