Deeptop

把复杂的工作，交给深处。

基于 DeepSeek Harness（DSH） 的原生桌面工作台。

快速开始 · 文档 · 下载发布版 · 报告问题

这是什么

Deeptop 将 DSH 的 Agent 能力带到一个面向深度工作的原生桌面环境中：用会话组织任务、用工作区提供上下文，并在运行时直接处理工具调用、审批、追问与诊断。

它不是把 dsh web 放进桌面窗口，也不在应用内重写一套 Agent。DSH 仍然负责 Agent、Session、Tool、Model、Workspace、Skill、Goal、Provider、持久化与事件语义；Tauri/Rust 负责原生窗口、进程监管与系统能力，React 只负责清晰、可操作的桌面交互界面。

桌面优先。 目录选择、文件保存与日志导出通过 Tauri/Bridge 的原生能力完成；界面不依赖浏览器下载、浏览器弹窗或内部 URL 来完成系统操作。

核心体验

原生运行模型

┌─────────────────────────────────────────────────┐
│  Deeptop Desktop UI · Tauri + React              │
│  会话 · 工作区 · 设置 · 运行台 · 交互面板        │
└───────────────────────┬─────────────────────────┘
                        │ Tauri commands / events
┌───────────────────────▼─────────────────────────┐
│  Rust Bridge Manager                             │
│  Profile 物化 · DSH 子进程监管 · JSONL 传输       │
└───────────────────────┬─────────────────────────┘
                        │ deeptop/1 JSONL
┌───────────────────────▼─────────────────────────┐
│  DeepSeek Harness · 一棵 Cordis 运行时树          │
│  Agent · Session · Tool · Model · Storage · Host │
└─────────────────────────────────────────────────┘

这种边界让桌面端复用 DSH 的领域契约，而不是把 WebUI 的浏览器生命周期、下载机制或客户端插件运行时带入桌面应用。

快速开始

环境要求

• Node.js 22.19+ 或 24+，且 node、npm 已加入 PATH；
• Rust/Cargo 与 Tauri 桌面开发环境；
• Windows 需要可用的 WebView2；
• 首次启动 DSH 时需要访问已配置的 npm registry。

在本地运行

git clone https://github.com/Sparrived/DSH-Deeptop.git
cd DSH-Deeptop
npm ci
npm run tauri:dev

启动后等待 DSH 运行时就绪，再选择或创建工作区、配置 Provider 与凭据，然后新建会话开始工作。Deeptop 会优先复用本机可用的 DSH；没有可用运行时时，才通过本机 npm 安装 @deepseek-ai/dsh@latest 到 DSH_HOME。

npm run dev 仅启动 Vite 预览，缺少 Tauri Bridge 和 DSH 子进程。它适合调整布局，不应用于验证会话、文件或系统集成功能。

构建与验证

文档

为 Deeptop 扩展能力

优先把用户自定义能力加入 DSH desktop Profile，而不是直接复制到 Rust 或 React。持久化补丁位于：

$DSH_HOME/profiles/desktop/cordis.patch.yml

推荐顺序：

1. 先寻找 DSH 已有的 Host/Cordis 服务、ApiProxy 方法、Remote 契约或 Projection；
2. 在 Profile 中挂载并验证该能力；
3. 需要桌面入口时，在 deeptop-bridge 添加最小、显式校验的 allowlist 路由；
4. 在 Tauri 层处理目录、文件保存、系统通知等原生边界；
5. 最后让 React 映射状态和触发语义化操作，并补足成功、取消、失败与缺失能力路径。

请不要直接修改 $DSH_HOME/profiles/node_modules/deeptop-bridge 下的生成文件；应用启动时会重新物化它们。更多示例见项目说明手册。

贡献

欢迎提交 Issue 和 Pull Request。提交前请：

• 保持 DSH 作为 Agent、权限、会话和插件领域语义的权威来源；
• 不引入 Web 原生下载、浏览器弹窗或散落在 React 组件内的平台判断；
• 为新增 Bridge 命令覆盖协议、取消和失败路径；
• 运行与变更相关的测试；修改前端时至少运行 npm run build，提交前运行 npm test；
• 使用 Conventional Commits，例如 feat(workspace): 支持工作区模板。

完整的开发与发布约定见项目说明手册和CI/CD 与发布。

发布

推送符合 SemVer 的 Tag（例如 v0.2.0）会触发 GitHub Actions，构建 Windows、Linux 和 macOS 安装包，生成 SHA-256 校验和，并以自动归类的中文说明创建或更新 GitHub Release。发布前请先运行：

npm run version:check
npm run build
npm test

请从 Releases 获取安装包与升级说明。