dsh-app

dsh-app

⭐ 搭配 dsh-LAN 体验最佳

本项目与 dsh-LAN 结合使用可获得最佳体验，建议搭配部署使用。

DeepSeek Harness 客户端：在 App 内打开局域网内指定地址的 DeepSeek Harness 页面。

基于 Tauri 2 + React 19 + TypeScript + Vite。

打包完全依赖 GitHub Actions，本机不进行打包（本机只用于编写和调试代码）。

功能

• 地址中枢（主窗口）：提示"请选择或输入您的 DeepSeek Harness 地址，如 192.168.1.1:3080"； 下方列出所有输入过的地址（按钮，可单个移除，已打开的地址带「已打开」标记）， 列表下方输入框可添加新地址；无历史地址时不显示按钮区。
• 桌面端：每个地址一个独立顶层窗口：点击地址在新的顶层窗口中打开该 DeepSeek Harness 页面 （同一地址再次点击只聚焦已打开的窗口，不重复打开、不重载页面）。
• 不使用 iframe：iframe 里页面属于「第三方上下文」，DSH 的登录状态会被 WebView 的跟踪防护拦截，dsh-LAN 的局域网口令页会反复闪烁、无法输入口令。 桌面端改用独立顶层窗口、移动端改用本窗口顶层导航后，口令只需输入一次，行为与系统浏览器一致。
• Cookie 与存储：由系统 WebView 原生管理并持久化 （Windows WebView2、Android WebView、iOS WKWebView）：重启 App 后保留，与系统浏览器数据隔离； 桌面端每个地址窗口（源）各自独立。
• 页面实例常驻：桌面端窗口存活期间页面不会自动重载（SPA 状态/滚动位置不丢）； 需要重新加载时关闭该地址窗口再打开即可。
• Android（移动端）：系统不支持在一个 App 内开多个窗口，点击地址直接在本应用内 打开该页面（本窗口内顶层导航，Cookie / 登录状态同样是第一方，行为与系统浏览器一致）； 页面顶部有原生工具条（← 返回地址中枢、⟳ 刷新、点中间地址可切换历史地址）， 按系统返回键同样回到地址中枢。
• Android 状态栏：App 内容不侵占状态栏（CI 构建时自动配置 edge-to-edge opt-out）。
• Android 软键盘：点输入框、输入法弹出时，页面自动让出键盘高度，输入框不会被键盘盖住 （构建时给 Manifest 注入 adjustResize，原生层再按键盘 insets 让位， Android 15+ 强制 edge-to-edge 的机型同样生效）。

目录结构

├── src/                          # 前端（React）
│   ├── lib/
│   │   ├── addresses.ts          # 地址规范化 + 地址历史持久化（localStorage）
│   │   └── windows.ts            # 打开地址（桌面：顶层窗口 / 移动：本窗口导航）
│   ├── components/
│   │   ├── Welcome.tsx           # 地址中枢：地址按钮列表 + 新地址输入 + 移除
│   │   └── AddressHub.tsx        # 中枢逻辑：打开窗口、跟踪已打开地址
│   └── App.tsx                   # 主窗口 = 地址中枢
├── src-tauri/                    # Tauri 壳（Rust）
│   ├── src/                      # Rust 代码
│   ├── capabilities/default.json # 窗口能力（创建/显示/聚焦窗口所需权限）
│   └── tauri.conf.json           # 应用配置（名称 / 标识符 / 窗口 / 图标）
└── .github/
    ├── android/MainActivity.kt   # 安卓原生顶部工具条（CI 覆盖模板生成的 MainActivity）
    ├── scripts/bump-version.mjs  # CI 版本递增（patch +1）
    └── workflows/
        └── build-android.yml     # 推送自动：递增版本 → 各架构 APK → GitHub Release

安卓顶部工具条（应用内，原生实现）

安卓上每个 Activity 只有一个 WebView，远程 DeepSeek Harness 页面又不能放进 iframe （第三方上下文会让登录 Cookie 被丢弃、局域网口令页反复闪烁），所以「页面顶部的功能栏」 只能由原生 Android View 实现：

• 外观沿用旧版顶栏：浅灰底 + 居中的地址胶囊 + 底部分隔线；左侧 ← 返回地址中枢， 右侧 ⟳ 刷新，点地址可下拉切换历史地址；深色模式跟随系统；
• 占位式布局：页面从工具条下沿开始渲染、高度自动让出，顶部内容不会被遮挡；
• 软键盘让位：点输入框时页面整体让出键盘高度（键盘收起时让出导航栏高度）， 底部的输入框 / 输入条会被顶到键盘之上，不会被输入法盖住；
• 系统返回键在浏览页面时同样回到地址中枢（不会直接退出 App）；
• 工具条与页面都避让状态栏（构建时已配置 edge-to-edge opt-out，工具条自身也按 insets 兜底）；
• 实现文件是 .github/android/MainActivity.kt，由 CI 在 tauri android init 之后覆盖模板生成的那份； 模板每次构建都会重新生成，所以改动请改仓库里这份，不要改 src-tauri/gen/。

本地开发（仅写代码，不打包）

npm install        # 安装依赖
npm run tauri dev  # 启动桌面开发模式（本机已具备 Rust + MSVC + WebView2）

移动端明文 HTTP（内网地址）说明

DeepSeek Harness 通常部署在局域网、以 http://192.168.1.1:3080 明文访问，而移动系统默认禁止：

• Android：CI 构建时把模板 Manifest 的 usesCleartextTraffic 占位符改写为 true（debug / release 均生效）， 局域网明文地址（http://192.168.1.1:3080）可直接访问。
• iOS：当前 CI 只打包 Android（见下），iOS 工作流已移除。

CI 打包（GitHub Actions）

推送到 GitHub 后全自动（无需手动打 tag）：

1. 推送 main / master 自动触发：先递增小版本号（patch +1，.github/scripts/bump-version.mjs） 并把改动提交回仓库（package.json / package-lock.json / src-tauri/tauri.conf.json）；
2. 初始化 Android 工程（tauri android init）→ 覆盖应用图标 → 放行局域网明文 HTTP → 状态栏 opt-out；
3. 构建按 CPU 架构拆分的签名 APK（--apk --split-per-abi，4 个 ABI 各一个包）；
4. 打 tag v<版本> 并创建 GitHub Release，资产为各架构 APK （文件名 dsh-app-<abi>-v<版本>.apk，直接从 Release 页下载 .apk 文件，不用 Artifact，避免 zip 压缩包）。

• 手动触发：仓库 Actions 页面 → build-android → Run workflow（同样递增版本并发布）。
• 版本号唯一来源是 package.json；src-tauri/tauri.conf.json 的 version 指向 ../package.json， Android 的 versionCode 由 Tauri 按 major*1000000 + minor*1000 + patch 推导，随 patch 递增，新包可直接覆盖安装。

Android 工程（src-tauri/gen/android）由 CI 自动生成，无需在本地生成或提交。

说明：tauri-action 的移动端支持从未发布（仅 dev 分支），因此 workflow 直接调用 tauri CLI 构建（android build --apk --split-per-abi）。

需要配置的 Secrets（仓库 Settings → Secrets and variables → Actions）

Android 未配置签名 Secrets 时，回退构建 debug 签名包（可安装测试，但体积大，约 400MB）； 配置后构建正式签名 release 包（--split-per-abi 按架构拆分，单包约 20–35MB）。 keystore 生成命令：keytool -genkey -v -keystore upload-keystore.jks -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias upload（JDK 自带 keytool）。

iOS 打包已移除（本 workflow 只出 Android 包）；如需恢复，可从 git 历史取回原 mobile-build.yml （macOS runner + tauri ios init + IPA 产物）。

应用标识

• bundle identifier：com.dsh.app（在 src-tauri/tauri.conf.json 中修改）
• productName：dsh-app（即安装包/可执行文件名）