随身控制台 tomppi/webviewdp

webviewdp

一个极简的 Android WebView 应用，通过 Tailscale tailnet 打开你的 DeepSeek Harness Web UI，让你用上专用应用，不必再开手机浏览器。

首次启动会显示设置页，你在那里粘贴 harness URL（Tailscale 的 https://<machine>.<tailnet>.ts.net/ 地址）。URL 存在设备上，之后启动直接进入 harness。

环境要求

- 手机上已安装并连接 Tailscale 应用。WebView 依赖 Tailscale VPN 提供 MagicDNS 和 tailnet 路由，不需要 exit node。
- 设备运行 Android 8.0（API 26）或更高版本。

下载构建

每次推送到 main（以及手动触发 workflow_dispatch）时，GitHub Actions 都会构建一个 debug APK：

1. 打开仓库的 Actions 标签页，打开最新的 Build APK 运行记录。
2. 下载 webviewdp-apk 产物。
3. 解压后把 app-release.apk 侧载到手机上。

发布的 APK 是 release 变体，用仓库里提交的 signing/debug.keystore 签名：不是 android:debuggable，签名身份与之前的构建相同，所以能直接覆盖安装。

本地构建（可选）

1. 用 Android Studio 打开这个文件夹，等 Gradle 同步完成。
2. Build > Build App Bundle(s) / APK(s) > Build APK(s)。

修改或重置 URL

- 清除应用数据（Settings > Apps > WebView DP > Clear data），设置页会重新出现。
- 保存的 URL 加载失败时，应用也会回到设置页。

认证（harness 0.1.2-alpha.1 及更新版本）

harness 的浏览器会话门禁会返回 401，直到浏览器用服务商每次启动生成的 token 完成交换。这个 token 相当于一台机器的登录凭证，而 harness 能在这台机器上跑代码，所以谁都不会公开它：你只需粘贴一次启动 URL。

1. dsh-launch.ps1 启动服务，并捕获它打印的 ?token= URL，每个 authority（tailnet 名称、loopback）各一个。
2. 把该 URL 粘贴进本应用。加载它会返回 303，其 Set-Cookie 是一个 30 天有效的签名会话，WebView 会保存下来：此后应用打开普通地址即可，不再需要 token——harness 重启后也一样。
3. cookie 失效后（30 天到期，或应用数据被清除），应用会显示设置页并说明原因，而不是给你一个莫名其妙的 401 页面。

早期版本从 harness 所服务 dist 里的 auth.json 读取 token。每个静态资源都是公开的，所以那个文件对任何能访问端口的东西来说都是一份可用的登录凭证；启动器不再写它，本应用也不再读它。-PublishAuthJson 可恢复旧行为，WebView DP 1.4 及更早版本仍然需要它。

运行 harness

harness 本体是 deepseek-ai/deepseek-harness。构建一份 checkout，然后通过启动器启动，它会打印启动 URL：

powershell
powershell -ExecutionPolicy Bypass -File dsh-launch.ps1
- -TailHost 是客户端访问 harness 所用的地址，同时也会成为服务器的 --trusted-host。请使用 tailnet 名称，这样 TLS 和 MagicDNS 才能对应上；本地测试用裸地址即可。
- -Repo 是已构建的检出目录（apps/cli/lib/bin.js 必须存在）。node 从 PATH 中获取。
- 如果端口上已经有服务在运行，它会拒绝再启动第二个服务器；它会最多等待十分钟以获取 token，超时后放弃并输出日志尾部。
- -PublishAuthJson 还会额外写入 <Repo>\apps\web\dist\auth.json —— 一个公开的登录文件 —— 供版本太旧、无法粘贴 URL 的客户端使用。-DistRoot 和 -Port 用来指定一个临时实例。
- dsh-url.ps1 会再次打印当前的启动 URL，从启动器的日志中读取，适用于控制台内容已经滚走、或服务器作为计划任务运行的情况。它不需要参数；当发现 token 已过期时会给出警告。

在 Debian（或任何 POSIX shell）上，dsh-launch.sh 是功能相同的包装脚本，做同样的事，只是从环境变量而不是参数读取设置 —— DSH_REPO、DSH_PORT、DSH_TAIL_HOST、DSH_PUBLISH_AUTH_JSON、DSH_FOREGROUND —— 并打印同样的三个 URL，之后可以用 dsh-url.sh 再次打印它们。它的日志是 $XDG_STATE_HOME/dsh/web.<port>.out.log，两个脚本都会读取该文件；当服务器以 root 身份在 systemd 单元下运行时，该文件仅 root 可读，dsh-url.sh 必须用 sudo 运行。
- 它与服务器一同保持运行，因此可以用作计划任务。

说明

- 所有导航都保持在 WebView 内，并支持文件上传。
- 无依赖、无分析统计；它就是一个普通的 WebView，启用了 JavaScript 和 DOM 存储。
- 后台恢复： Android 可能在应用处于后台时回收 WebView 的渲染进程（内存压力；较重的 harness 页面更容易触发）。应用通过 onRenderProcessGone 感知到这一点，会自动重新加载当前页面，而不是留下白屏；在连续多次快速失败后，它会返回设置界面。Logcat（标签 WebViewDP）会记录每次重新加载及其原因。

许可证

MIT —— 见 LICENSE。