DSHBox

DSHBox（包名 dsh-box）是 DeepSeek Harness（dsh）的跨平台桌面外壳，基于 Tauri v2、Rust 与原生 HTML/CSS/JavaScript。主界面直接加载官方 dsh web，外壳负责运行环境、窗口、托盘、更新与本地系统集成，不 fork 或 patch dsh。

当前发布产物未签名。Windows SmartScreen、macOS Gatekeeper 或 Linux 安全策略可能要求手动放行；详情见安全模型。

功能

能力	说明
开箱即用	自动检测 Node.js、安装 dsh，并在 Windows 缺少 WebView2 时引导安装
服务生命周期	单实例、端口冲突回退、进程树清理、服务看门狗和页面心跳恢复
桌面体验	自绘标题栏与状态栏、系统托盘、通知、窗口位置记忆、深浅色和中英双语
安全更新	dsh/Node 事务化更新和中断恢复；Windows 应用附件按精确 tag 与 SHA-256 校验
本地文件菜单	默认打开、VS Code/记事本打开、文件管理器定位、复制路径与 UTF-8 文本
插件管理	通过官方 `dsh plugin` 搜索、安装、卸载与更新；首次推荐插件可明确取消
模型配置	类型化校验并导入/导出 `llm-pi-ai` 自定义路由，凭据与设置分开保存
便携模式	Windows exe 同级放置 `portable.txt`，运行时与配置改存相邻 `data/`

平台

平台	架构	最低环境	发布形式
Windows	x64	Windows 10；WebView2 Runtime	单个 `DSHBox.exe`
macOS	arm64 / x64	macOS 13.5+	未签名 dmg
Linux	x64 / arm64	Ubuntu 22.04、Debian 12 或等价 WebKitGTK 4.1 环境	zip

Windows 是主要本地测试平台；五个目标由 GitHub Actions 构建。Linux 上 dsh 的 Landlock 需要内核 5.13+，不满足时由 dsh 自身降级。

安装与首次启动

从 Releases 下载对应产物：

Windows：运行 DSHBox.exe。
macOS：把应用拖入 Applications。若 Gatekeeper 拦截，按住 Control 点击应用并选择“打开”，或在“系统设置 → 隐私与安全性”中允许。
Linux：解压后运行 DSHBox；请先安装发行版要求的 WebKitGTK 4.1 依赖。

首次启动会准备运行时，然后显示可跳过的配置页：

API Key 写入 dsh 的 $DSH_HOME/.credentials.yaml，不会再复制到 DSHBox 的 config.json。
语言与主题写入 dsh 的 settings.yaml，与官方 CLI/Web 界面共享。
开机自启动使用各平台系统机制。
“安装推荐插件”默认勾选，但可取消；直接跳过首次配置视为不同意自动安装。

之后可在“桌面端设置 → DeepSeek 凭据”中替换或清除 API Key；若环境变量已提供密钥，该区域只读并明确显示由外部管理。

配置与数据

默认数据根目录：

平台	路径
Windows	`%LOCALAPPDATA%\DSHBox`
macOS	`~/Library/Application Support/com.deepseek.dsh-box`
Linux	`$XDG_DATA_HOME/com.deepseek.dsh-box`，未设置时为 `~/.local/share/com.deepseek.dsh-box`

主要内容：

config.json：用户可理解的外壳设置。
state.json：窗口位置、首次引导和后台维护标记；不建议手工编辑。
node/、dsh/、npm-cache/：DSHBox 管理的运行时。
logs/dshbox.log：UTC 日志，超过 2 MiB 轮转为 .old。
$DSH_HOME：默认 ~/.dsh，由官方 dsh 与 DSHBox 共享，不位于上述数据根目录。

config.json 支持：

{
  "port": 18080,
  "api_base": "https://api.deepseek.com",
  "language": "zh-CN",
  "hide_tool_calls": false,
  "hide_stats_line": true,
  "hide_statusbar": false,
  "hide_balance": false,
  "auto_update_plugins": true,
  "dsh_update_channel": "latest",
  "close_behavior": "tray",
  "launch_behavior": "window",
  "download_source": "auto"
}

dsh_update_channel 可取 latest 或风险更高的预览通道 next。close_behavior 可取 tray / quit，launch_behavior 可取 window / tray，download_source 可取 auto / official / mirror。config.json 与 state.json 职责严格分离，不读取旧文件中的跨界字段。

环境变量优先于 config.json：

变量	作用
`DSH_BOX_ROOT`	覆盖数据根目录
`DSH_BOX_PORT`	覆盖监听端口
`DSH_BOX_API_KEY`	覆盖 DeepSeek API Key
`DSH_BOX_API_BASE`	覆盖 API 基地址
`DSH_HOME`	覆盖 dsh 官方主目录
`DSHD_LANG`	固定 `zh-CN` 或 `en`

API Key 解析顺序为：DSH_BOX_API_KEY → DEEPSEEK_API_KEY → $DSH_HOME/.credentials.yaml。

内置插件

首次引导可选择安装：

DSH Market（dshmarket）
DSH File Drop（dsh-file-drop）

同意后，未安装的推荐插件会在 dsh 就绪后安装；仍保持内置身份的已安装插件每 24 小时检查一次更新。用户主动卸载后不会自动重装。安装、更新和卸载都走 dsh plugin CLI；多个手动变更会合并为一次重启，自动维护只在会话空闲后应用。

插件是与 dsh 同环境执行的第三方代码。推荐、内置或市场收录都不构成安全背书；安装前应核实来源。清单维护规则见 resources/README.md。

开发

要求 Rust 1.85+、Node.js，以及对应平台的 Tauri 系统依赖。Windows 推荐 PowerShell 7。

npm install
npm run check
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
cargo test --manifest-path src-tauri/Cargo.toml --all-targets

Windows 构建与开发：

pwsh -NoLogo -NoProfile -File .\build.ps1
pwsh -NoLogo -NoProfile -File .\dev-build.ps1
pwsh -NoLogo -NoProfile -File .\dev-run.ps1

开发模式通过本地 4321 端口加载 ui/，只改 UI 不需要重编 Rust。完整环境、图标、版本和发布流程见开发指南。

项目结构

desktop/
├─ assets/brand/                   # 唯一品牌 SVG 源
├─ ui/                             # 无打包器的内置页面、共享样式与双语文案
│  ├─ index.html + startup.*       # 启动页与首次配置
│  ├─ control-center.*             # 余额/更新/插件/设置/关于
│  ├─ titlebar.* / statusbar.*     # 主窗口子 WebView
│  ├─ tray-menu.html + menu.js     # 托盘与菜单交互
│  └─ common.* + i18n.js           # 共享工具、设计 token、文案
├─ src-tauri/
│  ├─ resources/                   # 内置插件清单与页面注入资源
│  └─ src/
│     ├─ bootstrap.rs / lib.rs     # 应用装配与公共边界
│     ├─ app_state/                # 配置、状态、JSON/文本持久化
│     ├─ commands/                 # 仅做 IPC 来源校验与转发
│     ├─ runtime/                  # Node、dsh 包和服务启动
│     ├─ updater/                  # 检查、平台更新与事务恢复
│     ├─ plugins/                  # CLI 执行、维护策略与手动操作
│     ├─ model_config/             # 模型路由解析、导入与导出
│     ├─ webview/                  # 导航边界、自定义协议与注入
│     └─ platform/windows/         # Windows 专属 WebView2 预检
├─ scripts/                        # 一致性检查、图标、构建辅助
└─ .github/workflows/              # 三平台 CI 与 tag 发布

详细依赖方向和启动时序见架构文档。

项目边界

DSHBox 只通过三条通道与 dsh 协作：

向官方 Web 页面注入受限的初始化/菜单脚本。
读取会话日志，行级合并写入 $DSH_HOME/settings.yaml 与 .credentials.yaml。
调用 dsh web 和 dsh plugin ...。

不 fork dsh、不 patch npm 包、不修改会话格式、不重复实现官方 Web UI。更多取舍见为什么做 DSHBox。

参与与许可

提交前请阅读 CONTRIBUTING.md 和 SECURITY.md。项目代码采用 MIT License；依赖、运行时下载项和品牌资源说明见 THIRD_PARTY_NOTICES.md。

Name		Name	Last commit message	Last commit date
.github		.github
assets/brand		assets/brand
docs		docs
scripts		scripts
src-tauri		src-tauri
ui		ui
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.en.md		README.en.md
README.md		README.md
RELEASE_NOTES.md		RELEASE_NOTES.md
SECURITY.md		SECURITY.md
THIRD_PARTY_NOTICES.md		THIRD_PARTY_NOTICES.md
build.ps1		build.ps1
dev-build.ps1		dev-build.ps1
dev-run.ps1		dev-run.ps1
package-lock.json		package-lock.json
package.json		package.json

Navigation Menu

Repository files navigation

DSHBox

功能

平台

安装与首次启动

配置与数据

内置插件

开发

项目结构

项目边界

参与与许可

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

DSHBox

功能

平台

安装与首次启动

配置与数据

内置插件

开发

项目结构

项目边界

参与与许可

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages