前言¶

DeepSeek Harness（dsh）把模型、工具、技能、会话和界面都做成可替换插件。官方仓库的说法是「一切皆插件」：开发者不必改 Harness 源码，就能在配置层组合 Agent 能力。实际用起来，会话、项目文件、网页资料、Git 工作区和 Word / Excel 产物往往还是散落在浏览器标签、终端和外部编辑器里。

社区项目 deepseek-harness-desktop-app 走的是另一条路：不另写一套 Agent 运行时，而是在 DSH 同一条运行链上加一层 Electron 桌面外壳，把 Session、项目、文件、联网研究、插件和 Office 产物收进同一个本地应用。

本文按社区目录页、GitHub 仓库 README / package.json / PRIVACY.md，以及 DeepSeek Harness 官方仓库核对后整理：它是什么、现在能做什么、目录页怎么装、仓库推荐怎么启动，以及平台和功能边界。社区目录站点与 DeepSeek / 幻方没有官方从属关系，不要把它当成官方应用商店。

这是什么¶

deepseek-harness-desktop-app 是一款由 vibeinging 维护的开源项目，社区目录把它归在「会话与消息」分类，许可证为 MIT，主要语言是 JavaScript。产品名是 DeepSeek Harness Desktop App，根目录 package.json 里的包名是 dsh-desktop，版本号为 0.0.1，入口是 electron/main.js。截至 2026-08-17，目录页和 GitHub 仓库的星标均为 216。仓库默认分支是 dev，最近一次推送时间为 2026-08-15。

README 的定位很明确：它是建立在 DeepSeek Harness 之上的本地 AI 工作桌面，把 DSH 的 Session、Agent、Tool、Skill、MCP 和 Profile Bundle，与项目、文件、网页、Git Worktree、Canvas、Site 和 Office 产物组织在同一个桌面应用中。

它不是 DSH Web 的 iframe，也没有复制一套 Agent 运行时。Electron 启动 DSH Web Profile，继续使用同一套 Session、Agent、Tool、Skill、MCP、Settings、Profile Bundle 和 Client Loader。桌面外壳负责项目管理、文件授权、Browser Workspace、Git Worktree、Canvas、Site 和 Office 产物；需要模型参与的能力仍通过绑定的 Session 和 DSH Tool 接入。当前项目使用 DSH 0.1.0-rc.6。

核心功能¶

README 用一张功能表列出当前能力，下面按工作流归并。下列内容均来自仓库 README，不是使用评价。

对话、权限与轨迹¶

一个项目对话对应一个 DSH Session。对话侧支持流式回答、思考过程、工具调用、停止、继续、重试、消息分支和重启恢复。模型侧可以选 Provider、模型和推理强度，并管理凭据引用、Session 权限、工具审批和模型提问。当前 Profile 里的工具、技能、MCP、Hook、子 Agent 和 Workflow 都可以直接用。

右侧「结果与证据」直接读取当前绑定 Session 的 session.history。用户消息、请求上下文、模型输出、工具调用、工具结果、权限变化和最终回答都在同一条可回放轨迹里，仓库明确写了：不另维护第二套运行中心。

输入时可以用 @ 引用文件、用 # 引用对话，也可以粘贴图片和大段文本附件。项目上下文包括应用指令、项目指令、授权源码目录、写入目标，以及全局或项目记忆。

三列工作台与项目文件¶

桌面外壳是三列工作台，左右栏可折叠，带全局搜索、缩放快捷键和更新检查。设置项覆盖语言、网络、通知、终端和隐私。

项目侧可以创建项目，以及全局或临时对话，并支持置顶、排序、重命名、归档、恢复和删除。右侧工作台可以挂上结果与证据、浏览器、文件、产物和 Site 标签。项目文件树、Agent 工作目录、当前 Diff 和行编辑都跟随当前项目权限与活动 Worktree。

编码工作区可以查看 Diff、逐行评论和编辑、在外部编辑器打开、发起 AI Review，并安全撤销模型产生的文件修改。文件面板能浏览项目文件、任务和产物，预览文本、代码、图片和 Office 内容，也可以按文件名或正文搜索。

Git Worktree、浏览器与产物¶

Git Worktree 用来隔离开发：为项目创建独立分支和工作目录，同一时间只启用一个。启用后，新建对话的 Agent、DSH Session、Diff 和行编辑走这个 Worktree，主检出保持不变。切换工作目录不会迁移已有对话；删除前必须切回主检出，删除工作目录后仍保留 Git 分支。非 Git 目录、重复分支、越界路径和异常符号链接会被拒绝。

Browser Workspace 提供多标签浏览、历史、页内查找、缩放、下载、打印、开发者工具、站点权限、网页快照和「使用此页」。

Canvas 保存不可变版本，支持正文编辑、版本比较、精确行内建议和冲突处理。Site 使用同一套版本能力，并在隔离沙箱中提供桌面、平板和手机预览。Office 产物覆盖 Markdown、DOCX、XLSX、PPTX 和 PDF 的创建、查看、定点编辑和版本保留。

主题与插件中心¶

主题来自 @deepseek-ai/dsh-theme-pack Profile Bundle，默认是 professional-blue，可选 anime-blue。应用也支持本地自定义主题的新建、导入、预览、编辑、导出和删除。本地主题只能改安全的颜色与外观，不能注入原始 CSS、远程图片或修改应用名称。明暗模式、背景和透明度可以单独调。

插件中心面向普通用户：在左侧「插件」页安装 DSH Profile Bundle。Host Bundle（Tool、Skill、MCP、Hook 等）可以进入 DSH 运行时；包含第三方 Client UI 的 Bundle 目前不会进入拥有 Electron 权限的主窗口，随应用提供并经过审核的 Client Bundle 不受此限制。

安装与启用¶

社区目录页给出的安装命令如下，在 DeepSeek Harness 终端中运行：

dsh plugin add github:vibeinging/deepseek-harness-desktop-app

需要可复现安装时，目录页要求固定 commit 哈希：

dsh plugin add github:vibeinging/deepseek-harness-desktop-app#commit

把 commit 换成实际哈希即可。目录页同时写明：插件以当前 dsh 进程的权限运行，安装时可能执行代码；安装前应检查源代码仓库和许可证。

仓库 README 的主路径不是把这段仓库当作普通 Web Profile 插件挂进去，而是在本地启动桌面应用。本地开发要求 Node.js 24 或更高版本（.node-version 也是 24）。克隆后执行：

npm install
npm run doctor
npm run dev

切换 Node.js 大版本、CPU 架构或操作系统后，需要再跑一次 npm run setup 重新准备依赖。要用完整的三列工作台、Browser Workspace 和 Office 产物，应按 README 这条路径启动，不要默认 dsh plugin add 就会弹出 Electron 窗口。

典型用法¶

下面几步都来自仓库 README，可以按同样顺序核对界面。

1. 用 npm run dev 打开桌面应用后，创建一个项目，再开一个项目对话。这个对话会绑定一个 DSH Session。
2. 在右侧工作台加上「结果与证据」。发一条会触发工具调用的消息，轨迹里应能看到用户消息、模型输出、工具输入输出、耗时、Token 和最终回答。
3. 需要改代码时，先在项目设置里创建并启用一个 Git Worktree，再新建对话。已有对话不会跟着切换工作目录迁过去。
4. 用 @ 引用项目文件，或在文件面板里预览文本、代码、图片和 Office 内容。项目源码目录默认只读，Agent 要写入，需要先明确授权。
5. 要装额外能力时，打开左侧「插件」页：输入带精确版本的 npm 包，或带完整 commit 的 dsh-external 仓库地址；先跑兼容性检查，只有结果为「可以安装」时才写入当前 Profile。装完后可以查看来源、版本、加载顺序和能力，用户安装的 Bundle 可以卸载。

适用场景与注意事项¶

适合已经在用 DeepSeek Harness，又希望把会话、项目文件、网页资料和 Office 产物放在同一个本地窗口里的人。也适合需要 Git Worktree 隔离实验、又想保留主检出不动的编码工作流。数据默认保存在本机 ~/.dsh，也可以用 DSH_DATA_ROOT 改根目录；PRIVACY.md 写明：打开应用或查看历史记录不会自动上传项目和会话。

平台状态以 README 表格为准：

• macOS Apple Silicon：开发与目录包已验证
• macOS Intel：Rosetta 检查通过，仍需 Intel 实机验收
• Windows x64：已接入构建流程，仍需安装包实机验收
• Windows arm64：暂不支持
• Linux：暂无桌面打包配置

当前明确没有的能力包括：五列任务看板、独立定时任务页面、Git 图谱、stage/unstage 面板、独立终端页；本地 Site 只提供预览和单文件导出，没有部署服务，公开分享目前只有只读查看；也没有移动端远程控制、二维码配对、公网隧道、SSH、SFTP 或端口转发。子 Agent 可以执行并出现在对话与轨迹中，但还没有完整的独立管理页。

无论是走目录页的 dsh plugin add，还是按 README 本地启动，安装和运行都会在本机执行代码。安装前应检查源码与 MIT 许可证，以及 THIRD_PARTY_NOTICES.md 里第三方依赖和二进制的分发限制。不要把社区目录或这个桌面应用写成 DeepSeek 官方产品。

小结¶

deepseek-harness-desktop-app 把 DSH 的 Session 和插件体系留在原处，额外提供项目管理、文件授权、浏览器工作区、Git Worktree 和 Office 产物。目录页按插件惯例给出了安装命令；要得到 README 里的完整工作台，需要 Node.js 24，并按仓库说明本地启动。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-desktop-app/

GitHub：https://github.com/vibeinging/deepseek-harness-desktop-app