桌面 AI 工作台 MichengAI/dsh-codex-desktop

DSH Codex Desktop

下载安装，打开就是可用的本地 AI 工作台。

English · 下载 · 更新日志 · 反馈问题

DSH Codex Desktop 是 DeepSeek Harness 的社区维护桌面发行版，并非 DeepSeek AI 官方产品。

DSH Codex Desktop 将 DeepSeek Harness 封装为原生桌面工作台。安装包已经包含 Node.js 和本地 DSH 运行时：下载安装、打开应用，即可开始使用；不需要自行配置 Node.js 环境，也不必从终端启动 DSH。

下载后即可开始

请从 GitHub Releases 下载最新安装包。

| 平台 | 安装包 | 开始方式 |
| Windows x64 | .exe 安装器或 .zip 压缩包 | 运行安装器，然后从开始菜单打开 DSH Codex Desktop。 |
| macOS Apple Silicon / Intel | .dmg 安装器 | 打开磁盘映像，将应用拖入“应用程序”后启动。 |
| Linux x64 / ARM64 | .AppImage 或 Debian / Ubuntu .deb | 下载与 CPU 架构匹配的 AppImage，或安装对应的 deb 包后启动应用。 |

1. 下载对应平台的安装包。
2. 安装并打开 DSH Codex Desktop。
3. 等待内置的本地 DSH 服务启动完成。
4. 新建任务，选择模型和权限模式，在项目中开始工作。

应用沿用当前用户的 DSH 数据目录（Windows 为 %USERPROFILE%\.dsh），升级桌面客户端后，已有会话和配置仍会保留。

开箱即用的完整工作台

| 能力 | 你可以直接使用 |
| 桌面会话工作区 | 项目和任务导航、会话对话、模型选择、权限模式、会话日志，以及专注的原生桌面窗口。 |
| 专家预设 | 按当前任务启用代码审查、架构、前端、后端、运维等不同专业角色。 |
| 技能中心 | 在设置中查看、启用、停用、上传和管理本地与共享 Agent 技能。 |
| 归档管理 | 搜索已归档会话、按需恢复，或永久清理归档记录。 |
| IM 助理 | 在一个界面中配置钉钉、飞书、Lark、微信、企业微信、QQ、Telegram 等可用频道。 |
| 插件市场 | 无需离开桌面客户端，即可发现、安装、更新、启用和诊断 DSH 插件。 |
| 定时自动化 | 使用内置 DSH 定时能力，在同一工作台管理周期任务。 |
| 安全的本地运行时 | 应用只在经过校验的本机回环地址启动 DSH，并将 Web 界面承载在桌面壳中。 |

产品预览

以下展示桌面工作区、浅色设置及插件管理页面。首页及 11 张设置、插件截图来自本次提供的实机截图；会话、上下文和侧边栏沿用此前截图。各图中的插件版本、数量和状态以拍摄时为准，点击图片可查看原始分辨率大图。

首页：项目导航、任务入口与输入区。

会话页面：对话、轨迹、上下文与任务输入区。

外观与桌面宠物（2 张）

浅色常规设置：权限、语言、外观与编辑器偏好。

宠物设置：选择伙伴、管理自定义宠物与调整大小。

自研插件页面（6 张）

专家预设：分类筛选、搜索与启停专业角色。

技能管理：统一管理不同来源的本机 Agent Skills。

定时任务：推荐案例、任务计划与执行记录入口。

IM 助理：统一管理消息渠道、账号与接收状态。

归档会话：按项目筛选，搜索并恢复历史对话。

Codex UI 设置：功能说明与配套插件安装状态。

社区插件页面（4 张）

上下文设置

侧边栏设置

插件市场：发现社区插件并查看安装与更新状态。

首次启动已包含的能力

安装包随附启动 DSH 所需的本地运行时。首次启动时，桌面客户端会为 Web profile 准备以下面向桌面工作流的社区插件：

| 随附能力 | npm 包 |
| Codex 风格工作区界面 | @michengai/dsh-codex-ui |
| 原生桌面宠物与会话提醒 | @michengai/dsh-codex-pet |
| 专家预设管理 | @michengai/dsh-agency-agents |
| 技能管理 | @michengai/dsh-skills-manager |
| 归档会话管理 | @michengai/dsh-archive-manager |
| IM 助理 | @michengai/dsh-im-connect |
| 定时自动化 | @michengai/dsh-automation |
| 可扩展工作区侧边栏 | dsh-better-sidebar |
| 一次性只读旁问 | @michengai/dsh-btw |
| Git 变更范围内的代码简化 | @michengai/dsh-simplify |
| 失败后换方法并验证结果 | @michengai/dsh-pua |
| 独立 Agent 代码审查 | @michengai/dsh-code-review |
| 插件市场 | dshmarket |

后续可以在插件市场管理更多插件。桌面应用的运行时与 profile 中安装的社区插件保持隔离，插件变更不会覆盖应用运行时。

桌面桥接能力随应用内置，仅在 Desktop 启动 DSH 时动态注入，无需安装到共享 Web profile。手动运行 dsh web 时使用 Web 自身的插件管理通道；旧版遗留的桥接配置会在 Desktop 启动时迁移并备份。

DSH 产品生态

想使用桌面工作台，可下载 DSH Codex Desktop；已有 DeepSeek Harness 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。

| 插件 | 你可以用它做什么 |
| Codex UI | 整理项目与会话、搜索任务、跳转对话轮次 |
| Agency Agents | 按任务选择并召唤专业角色 |
| Skills Manager | 统一查找、启停、创建和导入本机技能 |
| Archive Manager | 搜索、恢复或清理已归档会话 |
| IM Connect | 从消息平台下任务、收回复 |
| Automation | 按计划执行任务，查看每次运行的结果 |
| BTW | 在当前上下文中临时旁问，不打断主任务 |
| Simplify | 用 /simplify 整理 Git 改动范围内的代码 |
| PUA | 引导 Agent 在失败时换方法、查原因，并在完成前验证结果 |
| Code Review | 用 /review 发起独立 Agent 代码审查，在当前会话接收报告 |
| Codex Pet | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |

桌面端还集成 DSH Better Sidebar 和 App Market 等第三方插件，提供文件导航及插件发现与安装。

更新与自修复

- 桌面端更新：安装包默认在启动完成后检查新版本并提醒；可在“设置 → 更新”中改为自动下载或仅手动检查。安装与重启始终需要你明确操作。压缩包只检查新版本，不会下载安装包；请到发布页下载新的 zip，退出后替换当前文件夹。
- 重新加载 DSH：修改插件或 profile 配置后，可从托盘菜单重新加载本地 DSH 服务，不需要重装桌面应用。
- 插件更新：仍在 DSH 设置和插件市场中完成；安装失败的插件不会被激活为运行 bundle。
- 启动自修复：启动时会移除磁盘上已不存在的社区插件登记，再重试启动本地 DSH。

系统要求

| 项目 | 要求 |
| 操作系统 | Windows 10/11、macOS 或 Linux |
| 架构 | Windows x64、macOS arm64/x64 或 Linux x64/arm64 |
| Node.js | 终端用户无需安装，应用已内置 |
| 网络 | 仅在使用你配置的模型供应商、插件下载和工具时需要 |

隐私与安全

- DSH 配置、会话和凭据保存在当前用户的 DSH 目录中；卸载桌面应用不会删除这些数据。
- 启动器只接受经过校验的 127.0.0.1 本地 HTTP 地址供内嵌窗口加载。
- 外部 HTTP(S) 链接由系统浏览器打开；文件、JavaScript 和 data URL 会被拦截。
- DSH 页面已禁用 Node.js 集成，并启用上下文隔离与沙箱。
- 你配置的模型供应商和 DSH 工具可能自行发起网络请求；使用前请核对其设置和隐私政策。

开发

交接文档：技术架构基线摘要 · 桌面启动器架构基线。

Windows 打包任务在上传制品前执行 pnpm smoke:upgrade <旧版 exe> <新版 exe>。这项回归固定使用 Desktop 1.0.51（归档插件 0.1.34）和当前构建的 Windows x64 可执行文件，两者均须保留完整 resources 目录。脚本在隔离 Profile 中依次离线启动两个版本，检查插件版本、原仓库与用户配置保留情况。因为需要两份应用产物，它不属于默认 pnpm test。

内置 Code Review 与 PUA

Code Review 和 PUA 已加入内置插件清单。PUA 在未保存过开关选择时默认全局关闭，可在“设置 → 插件 → PUA 配置”中开启；后续启动保留已保存的选择。插件本身仍加载，以便访问设置。

内置宠物集成

内置 @michengai/dsh-codex-pet 0.1.19，随离线资源分发并在首次启动时自动安装；在宠物设置中选择宠物并开启显示，即可启用原生桌面宠物。插件提供 window.dshPet v1 接口。Desktop 订阅状态、通过接口转发会话操作，并负责渲染、拖拽、位置存储、鼠标穿透、v2 空闲注视及窗口恢复。宠物插件仍可在浏览器独立使用，不依赖 Desktop；本适配器不支持仅提供旧 dshDesktopPet 桥接的版本。

运行 npm run smoke:pet 构建并验证真实 Electron 窗口、preload/IPC、多会话审批和问答、过期操作拦截、重载、隐藏及展示接管。测试使用协议与微型图片夹具，只依赖本仓库开发依赖，退出后清理临时用户目录；不能替代已安装插件联调或正式安装包验收。

开发环境需要 Windows、Node.js 24.21.0 和 pnpm 11.26.0。

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm install --frozen-lockfile
pnpm test
pnpm run dist

本地构建制品写入 release\，不会提交。推送 vX.Y.Z 标签后，工作流会打包 Windows x64、macOS arm64/x64，以及 Linux x64/arm64 的 AppImage / deb 制品。

许可证

本项目采用 Apache License 2.0。