DSHCode 是什么
DSHCode 是一款面向 macOS 与 Windows 的免费、开源桌面 AI Agent 应用。它把 DeepSeek 官方开源项目 DeepSeek Harness 的 Web UI 与插件运行时打包成一个像普通程序一样安装的 Electron 应用：安装发行版的用户不需要 Node.js、不需要终端，也不需要命令行。它是 Harness 的一种桌面发行形态，而不是另写一套实现。
README 特别强调了一件读者容易想当然的事：DSHCode 是独立的社区项目。它刻意保留上游的包名、版权、架构、文档以及 upstream Git 远程地址，以便正确标明来源并持续合并上游变更；但除非 DeepSeek 明确授权，它不代表 DeepSeek 官方发行、背书或认证。
DSHCode 能做什么
因为应用是把 Harness 嵌进去，而不是重新实现一遍，所以它的能力清单就是 Harness 的能力清单，外面套了一层桌面外壳。README 的归类如下：
- Agent 核心 —— 插件化框架，内置 bash、文件系统、网页搜索与抓取、终端、LSP 与子进程工具，并支持沙箱隔离与逐操作审批提示。
- 交互式 UI —— 内联渲染的 GenUI 卡片：图表、表格、测验、3D 场景、示意图、表单与进度视图。
- Skills 技能 —— 可安装的技能目录，为 Agent 提供研究、文档写作、视觉工具等专项工作流。
- 编排能力 —— Subagent 并行委派，以及可跨多个 Agent 分阶段并行展开的 Workflow。
- 长任务 —— 先审查再批准的 Plan 模式、跨轮次持续推进的 Goal 目标，以及可恢复的会话。
- 模型体验与控制 —— 通过官方 API 使用 DeepSeek 模型，按供应商调节推理强度（可从关闭调到最高）、设置最大输出 token、切换多模态能力；会话日志完整到任何一次运行都可以被重建。
- 个性化 —— 主题与皮肤合集、选区批注工作流、命令快捷键，以及中英双语界面。
- 插件管理 —— 从 npm 或 Git 仓库安装插件、检查更新，并逐个启用或禁用。
- 故障恢复 —— 加载失败的插件会连同诊断信息一起报告，你可以禁用它、以安全模式启动，或让 Agent 携带失败上下文自动修复。
- 归档管理 —— 搜索已归档会话，然后恢复或彻底删除。
- 桌面集成 —— 托盘图标、系统通知、单实例运行，以及加固过的 Electron 窗口。
其中有三个能力值得单独说明来源：README 明确致谢 dsh-genui、dsh-annotation 与 dsh-web-ui，它们分别是内置生成式 UI、文本批注流程，以及 Web UI 与皮肤合集的插件实现。这里的「内置」指的是随桌面发行版一起提供，并不意味着由桌面外壳自己编写。
窗口背后的本地服务
应用每次启动时，都会在 Electron 主进程内启动一个 HTTP 服务。README 对这个服务的绑定方式说得很具体，而如果你本机已经跑着别的本地服务，这些细节就很重要：
- 它只绑定
127.0.0.1，因此从网络侧不可达。 - 端口由操作系统分配一个可用的临时端口，所以它不占用固定端口，通常也不会与其他本地服务冲突。
- 只允许一个应用实例运行，并且只加载它自己那个精确的回环地址。
- 进程退出前会先释放 Harness 树，因此关闭应用同时也会停止服务并释放端口。
最后一条决定了这个产品的形态：它是一个你打开、用完后关闭的桌面应用，而不是一个长期驻留的后台服务。
外壳本身刻意保持精简。产品行为与 Web UI 依旧由上游包提供，这也是 README 说「后续可以继续集成上游更新，而不必维护第二套界面」的原因。请把 DSHCode 理解为一个打包与集成层，而不是一个自带独立功能路线的分支。
下载与安装
发行资产以安装包形式提供：
| 平台 | 安装包 |
|---|---|
| macOS Apple Silicon | .dmg |
| macOS Intel | .dmg |
| Windows x64 | .exe |
每个版本还会随安装包发布 SHA-256 校验和（SHA256SUMS.txt），因此下载完成后可以对照已发布的值做校验。
安装之后，从 macOS 的「应用程序」文件夹或 Windows 的「开始」菜单打开 DSHCode 即可。应用会自行启动和停止它内置的 Web profile，README 也明确说明：安装版用户无需运行任何终端命令。
此外还有从源码运行的路径：克隆仓库、构建，并可用仓库自带的桌面打包脚本为维护者产出安装包，构建产物写入 .artifacts/desktop/release/。README 描述了一个名为 Desktop 的 GitHub Actions 工作流，负责构建 macOS Apple Silicon、macOS Intel 与 Windows x64 三种安装包，并说明 desktop-v* tag 会把完整构建矩阵连同 SHA-256 校验和发布到 GitHub Releases。
运行要求
使用安装版时，你需要 macOS（Apple Silicon 或 Intel）或 Windows x64、一个 DeepSeek API Key，以及网络访问——因为 DSHCode 是通过官方 API 运行 DeepSeek 模型的。README 说这个 Key 只需在应用设置里配置一次。
如果要自己运行源码或构建，要求则是常规的 JavaScript 工具链。仓库的 package.json 声明了 Node.js ^22.19.0 || >=24.0.0、包管理器 pnpm@11.7.0，以及 MIT 许可证。README 也说明：Node.js、CLI 与终端只在从源码运行或自行构建安装包时才需要。
来源没有给出最低操作系统版本、磁盘空间占用，也没有提出 API Key 之外的账号要求。
已知限制与来源没有说明的部分
- 签名与公证。 README 说明预览版安装包尚未进行代码签名或公证，因此 macOS Gatekeeper 与 Windows SmartScreen 可能在首次启动前发出警告；文中给出了一次性的放行步骤，并把警告归因于缺少付费签名证书。来源没有承诺已签名或已公证的版本，也没有给出时间表，所以当前状态应当理解为「未签名的预览版」。
- 平台。 下载表只覆盖 macOS Apple Silicon、macOS Intel 与 Windows x64。来源中没有任何地方提到 Linux 构建，因此不要假定它存在。
- 遥测、凭证存储与数据处理均未描述。 README 没有说明应用会上报什么（如果有的话）、你的 API Key 存在哪里、会话数据在磁盘上如何处理。这些是未解的问题，而不是已记录的「不存在」，本条目也不替它们下结论。
- 它不是服务器。 由于进程退出前会释放 Harness 树，本地服务会随应用一起停止。来源没有描述任何无界面运行、后台守护进程或部署到远程机器上的用法。
- 没有说明自动更新通道。 README 描述了版本如何发布，但没有描述桌面应用自身的应用内更新器。
- 功能清单属于 Harness，而不是外壳。 本文中归给 DSHCode 的能力都继承自上游包；桌面外壳贡献的是窗口、本地服务、托盘图标、系统通知与单实例行为。
- 许可证与品牌是两件事。 源码继续采用上游 MIT 许可证，再次分发时必须保留 DeepSeek 的版权与许可声明，并同时附带第三方软件声明。README 还补充说：MIT 许可证本身不等于获得 DeepSeek 商标或 Logo 的使用许可，且 DSHCode 发行版使用自己的应用图标。
什么时候用 DSHCode、什么时候不要用
当你就是想把 Harness 当成一个应用来用时，选它。如果你对 Harness 的抵触一直是「我不想装 Node.js、不想待在终端里」，那么这个发行版恰好拿掉了这一步：安装、打开、配置一次 API Key，然后在一个带托盘与通知集成的桌面窗口里工作。当你想要图形化的插件管理——从 npm 或 Git 安装、检查更新、逐个启停——以及插件出问题时的安全模式恢复通道时，它也是一个合理的选择。
但如果下面任何一条才是你的真实需求，就不要用它。你需要 Linux：来源没有记录这样的构建。你需要一个跑在自己指定端口、长期驻留的后台服务：这个形态不合适——应用只允许单实例、占用操作系统分配的临时回环端口，并且在你关闭它时停止服务。你需要一个能在组织内分发、不会触发操作系统安全警告的安装包：README 说明预览版尚未签名、尚未公证。你需要官方厂商支持或来自 DeepSeek 的产品保证：这是一个独立的社区项目。而如果你在终端里、在远程主机上、或在自动化流程中工作，来源为那种场景描述的仍然是 CLI 路径；DSHCode 并不会在所有用途上取代它。
FAQ
DSHCode 是 DeepSeek 官方软件吗？
不是。README 明确说明 DSHCode 是独立的社区项目。它刻意保留上游的包名、版权、架构、文档与 upstream Git 远程地址，以便正确归属来源并继续合并上游变更；但除非 DeepSeek 明确授权，它不代表 DeepSeek 官方发行、背书或认证。
需要 Node.js、终端或命令行吗？
安装版不需要。README 说安装版用户得到的是普通应用，Node.js、CLI 与终端只在从源码运行或自行构建安装包时才需要。仓库自己的 package.json 为这条源码路径声明了 Node.js ^22.19.0 || >=24.0.0 与 pnpm@11.7.0。
需要 API Key 吗？
需要。DSHCode 通过官方 API 运行 DeepSeek 模型，README 说只需在应用设置中配置一次。
它会占用固定端口吗？会不会和我本机其他服务冲突？
它只绑定 127.0.0.1，并让操作系统分配一个临时端口，因此不占用固定端口，通常也不会与其他本地服务冲突。它只允许一个实例运行，且只加载自身那个回环地址。进程退出前会先释放 Harness 树，所以关闭应用就会停止服务并释放端口。
它有代码签名和公证吗？会上报遥测吗？
README 说明预览版安装包尚未进行代码签名或公证，这也是 macOS 与 Windows 可能弹出首次启动警告的原因，文中给出了一次性放行步骤。至于遥测，来源完全没有提及——既没说会收集数据，也没说不会；它同样没有描述凭证存储或会话数据的处理方式。这些都应当视为未说明。