什么是DSH Desktop？基于DeepSeek Harness的本地AI桌面工作台完整指南-开发者社区

什么是DSH Desktop？基于DeepSeek Harness的本地AI桌面工作台完整指南

【免费下载链接】dsh-desktopDeepSeek Harness Desktop App: a local AI desktop workspace for DSH Sessions, projects, files, web research, plugins, and Office artifacts.项目地址: https://gitcode.com/gh_mirrors/de/dsh-desktop

DSH Desktop 是一款基于 DeepSeek Harness（DSH）构建的本地 AI 桌面工作台：它用 Electron 把官方 DSH Web、Session 会话、Agent 智能体、插件市场和 Office 产物工具整合进一个桌面应用，让你无需手工配置，直接在本地电脑上拥有一个可组合、可复现、数据不出本地的 AI 工作区。

本文将带你快速了解：DSH Desktop 是什么、核心能力有哪些、如何下载安装，以及如何上手使用。

🖥️ DSH Desktop：一个插件化的本地 AI 桌面工作台

DSH Desktop 是社区维护的 Electron 桌面发行版。它固定运行官方 DeepSeek Harness npm 运行时，把dsh-web-app、Session、Agent、Tool、Skill、MCP 与 Profile Bundle 组合成开箱即用的本地桌面环境。

它的定位可以一句话概括：官方 Web 是唯一主界面，Profile 是插件状态的唯一权威。项目不修改 DSH 源码、不另存一套插件状态、也不用私有 Chat 替换官方 Web，而是做一个"桌面发行层"——精选社区 Bundle，固定来源、版本、依赖和权限，让普通用户不用碰命令行也能获得完整的 AI 工作台。

🎯 为什么选择 DSH Desktop：五大核心设计理念

设计原则	带来的直接收益
官方 Web 是唯一主界面	跟随 DSH 会话与设置演进，无需重写第二套界面
Profile 是插件状态的唯一权威	不会出现"页面说已安装、实际没加载"的双状态
社区实现优先	插件可同时服务官方 Web 与桌面版，不被锁定
默认组合可复现	固定 tarball + SHA-256 离线初始化，失败不会留下半个 Profile
原生能力最小权限开放	窗口、文件、浏览器只按 Session 绑定的白名单暴露

此外，当 Profile 或 Client 启动失败时，应用会进入本地恢复页而不是白屏死循环——你可以重试、切换到只含官方组件的安全 Profile，或确认后移除指定插件并导出诊断。

🧩 核心能力一览：任务看板、插件市场与 Git Worktree

DSH Desktop 默认安装 13 个经过审查的 Bundle，覆盖以下高频场景：

社区任务看板：五列（待规划 / 待办 / 进行中 / 已完成 / 已失败）看板，自动调度 AI 任务并记录执行历史；
默认插件市场（dshmarket）：在"设置 → 插件市场"中搜索、诊断兼容性、安装、更新和卸载插件；
Git Worktree：从当前 Session 工作目录识别主检出，为独立任务创建隔离工作区；
文件与文件夹附件：在官方输入区直接选择文件，发送时复制到当前 Session 工作区；
Office 产物与 Canvas/Site：把 AI 输出转成可编辑的文档、画布和站点，均带版本历史。

📥 DSH Desktop 下载安装：快速上手三步

方式一：下载 macOS 桌面版（推荐新手）

下载 macOS Apple Silicon 的.dmg安装包（已完成 Developer ID 签名与 Apple 公证）；
打开安装包，将DSH Desktop拖入"应用程序"；
启动即可，安装包已包含官方 DSH 运行时和默认 Bundle，无需额外安装。

💡 Windows x64 正式安装包尚在验收中，当前其他平台推荐从源码运行。

方式二：从源码运行（Windows / macOS Intel）

需要Node.js 24或更高版本，打开终端依次执行：

git clone https://gitcode.com/gh_mirrors/de/dsh-desktop cd dsh-desktop npm install npm run doctor npm run dev:electron

npm run doctor会先做一次环境自检，再启动 Electron 开发环境。构建本地 macOS 开发版则执行npm run package:mac:dir。

🛠️ DSH Desktop 使用指南：官方会话、审批与插件管理

日常使用只需要记住三件事：

开会话：点击"新会话"，选择模型（如 DeepSeek-V4-Flash），直接和 Agent 对话。会话、问题卡片、工具审批、消息排队和历史回放全部保留在官方 Session 中；
管插件：打开"设置 → 插件市场"，所有操作读写同一个 Profile。命令行用户也可以用dsh plugin --profile web add/remove完成同样的事，两边状态永远一致；
管工作区：Git Worktree Bundle 会为每个独立任务创建隔离目录，互不干扰。

插件作者则会关心两类 Bundle 的边界：portable类型只使用官方 DSH 服务，可装到任何兼容的 Web Profile；desktop-adapter类型依赖桌面的窄 Host 合同（文件对话框、窗口、内置浏览器），离开桌面宿主时会明确报告缺少能力，绝不伪装可用。参考实现位于packages/目录下的各个独立 Bundle 中。

🔒 数据与隐私：DSH Desktop 如何让数据留在本地

Profile、Session 和本地运行数据默认保存在~/.dsh，打开历史不会自动上传任何内容；
官方 Web 窗口没有 Node 或通用 IPC，第三方插件无法直接获取 Electron 能力；
应用不使用外部账户模型，只连接你在当前项目中配置的模型服务；
API Key、Token、密码等敏感字段在运行事实和日志中会做脱敏。

更多细节可查阅项目内的PRIVACY.md（隐私说明）与SECURITY.md（安全说明）。

📁 项目结构速览

如果你想深入阅读源码，几个关键入口：

桌面壳与窗口管理：electron/main.js、electron/browser-workspace.js
运行恢复逻辑：electron/runtime-recovery.js
本地服务与 Agent 运行时：server/src/engine/agent_kernel/
桌面能力插件（Host IPC、Profile、Office 等）：packages/
发行前验证与测试：electron/scripts/下的 smoke 脚本与eval/tests/

📝 总结

DSH Desktop 把"官方 DSH Web + 精选社区插件 + 桌面原生能力"打包成一个可复现的本地 AI 桌面工作台：官方界面保证体验与上游同步，单一 Profile 保证插件状态可信，最小权限与本地数据保证安全可控。如果你想在本地拥有一套开箱即用、可持续扩展的 DeepSeek Harness 工作区，不妨从下载安装一节开始，花几分钟把它跑起来。