DSH Desktop Codex
August 13, 2026 · View on GitHub
版本归属：这是由 OpenAI Codex 独立设计、实现和打包的版本，用于和 DSH 自己生成的桌面版本进行对比。
DSH Desktop Codex 是 DeepSeek Harness 的 Windows 桌面外壳。它完整承载 DSH 原生 Web UI、模型配置、Subagent 与 Workflow，同时增加窄侧栏、运行状态、日志、更新管理、托盘和桌面设置。
隔离关系
| 项目 | DSH 对照版 | Codex 版 |
|---|---|---|
| 源码目录 | D:\deepseek\dsh-desktop | D:\deepseek\dsh-desktop-codex |
| App ID | com.deepseek.dsh-desktop | com.codex.dsh-desktop |
| 应用数据 | %APPDATA%\DSH Desktop | %APPDATA%\DSH Desktop Codex |
| 私有 DSH 版本 | 对照版自己的 runtime | Codex 应用数据下 dsh-runtime\versions |
| DSH 用户配置 | 对照版独立目录 | 默认共享 ~/.dsh |
两版可以同时保留。Codex 版只按用户要求共享 ~/.dsh，因此可看到相同的 DSH 会话、凭据、模型和插件配置。
Codex 版功能
- 完整保留 DSH 原生 Web UI、会话、Subagent 和 Workflow
- 独立的 CX 窄侧栏、运行状态、日志、更新和桌面设置
- 通过 npm 将
@deepseek-ai/dsh安装到 Codex 版私有运行时目录 - 启动时检查 DSH 更新，安装前提示确认
- 新版本启动失败时自动回退到上一个可用版本
- 关闭窗口时进入托盘，完全退出时清理 DSH 与 npm 子进程
- 独立 App ID、应用数据目录、运行时目录和安装包名称
运行
前提：Windows 已安装 Node.js 和 npm。
npm install
npm start
首次启动时，Codex 版通过 npm 把 @deepseek-ai/dsh 安装到自己的应用数据目录，不修改全局 npm 安装。启动检查发现新版本时会先征求确认。
数据位置
- DSH 用户数据：
~/.dsh，可用环境变量DSH_HOME覆盖 - Codex 桌面设置：
%APPDATA%\DSH Desktop Codex\desktop-settings.json - 私有 DSH 版本：
%APPDATA%\DSH Desktop Codex\dsh-runtime\versions\ - 运行日志：
%APPDATA%\DSH Desktop Codex\dsh-server.log
打包
npm run dist
安装包不内置 Node.js 或 DSH。目标电脑需要已有 Node.js；DSH 在首次启动时通过 npm 安装。
版本说明
Codex 独立版本边界和对照说明见 CODEX-VERSION.md，首个 GitHub Release 的变更说明见 RELEASE_NOTES.md。