桌面壳 BoxMiao007/dsharbor

[!IMPORTANT]
本仓库由 AI 开发与维护，所有代码变更均由 AI 执行。

DSHarbor

DSH（DeepSeek Harness）Web 版的轻量桌面壳轻量包体 · 关窗即释放界面内存 · 登录链接自动到手

它解决什么

- 一键启动：四种启动方式（官方 npx 命令 / 系统全局命令 / 指定二进制路径 / WSL 跨系统）；「启动 DSH / 停止」是同一个按钮（按状态换文案），旁边另配「重启 DSH」；
- 登录链接自动到手：壳以 DSH 插件（dsharbor-bridge）为第一通道现场铸造链接、启动日志解析兜底；「当前程序打开」弹出的窗口直接是登录态，不用手拼链接；
- 界面内存可释放：关闭窗口即销毁 WebView，DSH 后端与托盘常驻，托盘一点窗口原地重建；
- 不碰 DSH 配置：端口覆盖用一次性 launcher 层；桥接插件走官方 dsh plugin 安装。

功能一览

| 能力 | 说明 |
| 四种启动方式 | 官方 npx / 系统全局命令 / 指定二进制路径 / WSL 跨系统（在发行版内拉起 DSH） |
| 登录链接 | 桥接插件（首选）+ 启动日志解析（兜底）|
| 两种打开方式 | 「当前程序打开」（壳内 WebView2 窗口）/「浏览器打开」（系统默认浏览器）；两窗口相互独立 |
| 轻量模式 | 关闭窗口释放界面内存，DSH 与托盘常驻|
| 配置持久化 | 启动方式、附加参数、WSL 发行版、端口改完即存（%APPDATA%\DSHarbor）|
| 端口覆盖 | 默认跟随 DSH 配置（界面显示当前生效值），也可自定义；不改动任何 DSH 文件 |
| 桥接插件管理 | Windows / WSL 两侧一键安装 · 卸载 · 回滚（自动备份 profile 文件并附哈希清单，只保留最近 5 份，超出删最旧的）；卡片内可一键打开备份目录 |

功能计划与进度见需求单 #1。

快速使用

安装包未做代码签名，首次运行 Windows 可能提示 SmartScreen，选「仍要运行」即可。需要 Win10/11（自带 WebView2 运行时）。

1. 安装：双击 DSHarbor_0.3.2_x64-setup.exe 按向导完成（静默安装：命令后加 /S）。装到当前用户目录，不需要管理员权限。
2. 启动：打开 DSHarbor → 选启动方式（默认「官方 npx 命令」）→ 点「启动 DSH」。首次用 npx 会自动下载 DSH，稍慢。
3. 省内存：直接关闭窗口即可——界面内存立刻释放，DSH 继续运行；单击托盘图标随时回来（打开哪个窗口可在界面里配置）。
4. 卸载：只删安装目录；DSH 数据（%USERPROFILE%\.dsh）与壳配置、桥接备份（%APPDATA%\DSHarbor）都会保留。

开发

一次性准备（WSL2 / Ubuntu）

sudo apt-get install -y clang lld llvm nsis # LLVM 工具链 + NSIS
rustup target add x86_64-pc-windows-msvc # Windows 目标
cargo install --locked cargo-xwin # 交叉编译工具
pnpm install # 前端依赖

验证门（提交前必过）

cargo fmt --check
cargo test -p dsharbor-core
node --test plugins/dsharbor-bridge/test/bridge.test.js
pnpm build
cargo xwin clippy --workspace --all-targets --target x86_64-pc-windows-msvc -- -D warnings

一条命令出 Windows 安装包

pnpm exec tauri build --runner cargo-xwin --target x86_64-pc-windows-msvc
产物：target/x86_64-pc-windows-msvc/release/bundle/nsis/DSHarbor_<版本>_x64-setup.exe

仓库结构

| 目录 | 内容 |
| crates/dsharbor-core/ | 纯逻辑核心库（启动命令构造、token 解析、端口覆盖层、轻量模式状态机）——开发机可全自动测试 |
| plugins/dsharbor-bridge/ | DSH 桥接插件（随安装包以 tgz 分发） |
| src-tauri/ | Tauri 2 外壳（启动器、登录链接、轻量模式、托盘、桥接插件管理） |
| src/ | 前端界面（Vite 8 + TypeScript 7，无 UI 框架） |
| assets/ | 图标源：icon-source.png（主用）、icon-source.svg（备用）、logo.png |
| docs/decisions.md | 重大技术决策记录（每条含决策、原因、放弃了什么） |
| docs/manual-acceptance.md | 发布前 Windows 手动验收手册 |
| GLOSSARY.md | 项目与 DSH 生态术语表 |

技术栈

Tauri 2（Rust + 系统 WebView2）和 Vite 8 / TypeScript 7；在 WSL2 用 cargo-xwin 交叉编译、NSIS 打安装包。为什么这么选、放弃了什么，都记在 docs/decisions.md。

给 AI agent 的约定

本仓库由 AI 开发与维护：维护者只提需求与验收，实现、验证、文档、提交由 AI 完成。协作规则见 AGENTS.md。