# DeepSeekGUI

**Repository Path**: xuanding/DeepSeekGUI

## Basic Information

- **Project Name**: DeepSeekGUI
- **Description**: 基于 DeepSeek Harness（DSH）的桌面工作台，集成Git、内置浏览器与记忆功能 , 稳定不炸+持续更新，属于你的ds专用的codex
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-24
- **Last Updated**: 2026-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# <img src="./apps/deepseekgui/src/chrome/icon.png" width="38" alt="" align="absmiddle" /> DeepSeekGUI v1.1.1

</div>

<div align="right">

[English](README.en.md) | 中文

</div>

<p align="center">
  <em>稳定不炸的 DeepSeek 本地工作台。</em>
</p>

<p align="center">
  基于 <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>，面向 Windows 与 Linux 的本地桌面工作台。
</p>

<p align="center">
  <a href="https://github.com/See-Sol-Lab/DeepSeekGUI/releases/latest"><img alt="最新版本" src="https://img.shields.io/github/v/release/See-Sol-Lab/DeepSeekGUI?style=flat-square&label=release" /></a>
  <a href="https://github.com/See-Sol-Lab/DeepSeekGUI/releases"><img alt="下载量" src="https://img.shields.io/github/downloads/See-Sol-Lab/DeepSeekGUI/total?style=flat-square" /></a>
  <img alt="Windows 10 与 11 x64" src="https://img.shields.io/badge/Windows-10%20%7C%2011%20x64-0078D4?style=flat-square&logo=windows" />
  <a href="https://github.com/See-Sol-Lab/DeepSeekGUI/releases/tag/v1.1.1-linux.1"><img alt="Linux x64 AppImage" src="https://img.shields.io/badge/Linux-x64%20AppImage-FCC624?style=flat-square&logo=linux&logoColor=black" /></a>
  <a href="apps/deepseekgui/LICENSE"><img alt="DeepSeekGUI 产品层：PolyForm Perimeter 1.0.1" src="https://img.shields.io/badge/DeepSeekGUI-PolyForm%20Perimeter%201.0.1-6f42c1?style=flat-square" /></a>
  <a href="LICENSE-MIT-UPSTREAM"><img alt="上游 DeepSeek Harness：MIT" src="https://img.shields.io/badge/Upstream%20Harness-MIT-2ea44f?style=flat-square" /></a>
  <a href="https://doi.org/10.5281/zenodo.22205160"><img alt="DOI" src="https://zenodo.org/badge/DOI/10.5281/zenodo.22205160.svg" /></a>
</p>

<p align="center">
  <img alt="DeepSeekGUI —— 面向 agentic 编程的 harness-first 桌面工作台" src="docs/media/readme-hero.png" width="920" />
</p>

<!-- PRODUCT HUNT BADGE SLOT — 等 launch 有排名后恢复（在那之前 badge 显示 "???"）：
<p align="center">
  <a href="https://www.producthunt.com/products/deepseekgui?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-deepseekgui" target="_blank" rel="noopener noreferrer">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1235736&amp;theme=dark" />
      <img alt="DeepSeekGUI - DeepSeek's coding agent, on your desktop. | Product Hunt" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1235736&amp;theme=light" width="250" height="54" />
    </picture>
  </a>
</p>
-->

DeepSeekGUI 是基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的本地 AI 工作台，配置模型 API key 后即可开始。选择项目文件夹，在会话中让助手读取代码、修改文件、运行命令和浏览网页；通过「改动」「Git」视图随时检查项目状态，用专用工具完成提交、推送与 Pull Request，并通过全局记忆和项目记忆延续协作。

**非官方产品：** 基于 DeepSeek Harness 构建，由第三方独立开发，与 DeepSeek 无隶属关系，未获官方背书。

**分层许可：** DeepSeekGUI 原创产品层采用 [PolyForm Perimeter License 1.0.1](apps/deepseekgui/LICENSE)；上游 DeepSeek Harness 仍遵循 [MIT License](LICENSE-MIT-UPSTREAM)。

**当前版本：[v1.1.1](https://github.com/See-Sol-Lab/DeepSeekGUI/releases/tag/v1.1.1)。** 内嵌 Harness 升级到 0.1.5-rc.2，新增首次启动引导、就地更新、数据目录迁移和归档会话管理。工作台通过插件扩展官方 Harness 客户端，继续使用 Harness 的会话、工具与权限机制。

## 下载

| 平台 | 下载 | 要求 |
| --- | --- | --- |
| Windows | [下载安装包](https://github.com/See-Sol-Lab/DeepSeekGUI/releases/download/v1.1.1/DeepSeekGUI-Setup-1.1.1.exe) | Windows 10/11，x64 |
| Linux | [下载 AppImage](https://github.com/See-Sol-Lab/DeepSeekGUI/releases/download/v1.1.1-linux.1/DeepSeekGUI-1.1.1-x86_64.AppImage) | x64，AppImage；实验性支持 |

Windows 安装包安装到当前用户目录，自带运行时。Linux 使用独立的 AppImage 发行文件，下载与校验信息见 [v1.1.1-linux.1](https://github.com/See-Sol-Lab/DeepSeekGUI/releases/tag/v1.1.1-linux.1) 发布页。

> **Windows 安装提示：** 安装包尚未进行代码签名，SmartScreen 可能提示发布者未知。核对下载来源和 SHA256 后，可通过 **“更多信息” → “仍要运行”** 继续安装。

<details>
<summary>校验 Windows 安装包</summary>

下载安装包后，在 PowerShell 中计算 SHA256：

```powershell
Get-FileHash .\DeepSeekGUI-Setup-1.1.1.exe -Algorithm SHA256
```

与 [`SHA256SUMS.txt`](https://github.com/See-Sol-Lab/DeepSeekGUI/releases/download/v1.1.1/SHA256SUMS.txt) 核对后再安装。遇到问题看[故障排查指南](docs/user/deepseekgui/data-troubleshooting.zh.md#windows-smartscreen-blocks-the-installer)。

</details>

## 快速开始

详细步骤见[快速开始指南](docs/user/deepseekgui/quickstart.zh.md)。

## 截图

Git、文件栏、模型设置、浏览器及归档页面截图来自 v1.1.1；深浅主题总览与两张记忆截图沿用 v1.1.0。

| 深色主题 | 浅色主题 |
| --- | --- |
| [![深色主题工作台](docs/user/deepseekgui/assets/workbench-dark-1.1.0.png)](docs/user/deepseekgui/assets/workbench-dark-1.1.0.png) | [![浅色主题工作台](docs/user/deepseekgui/assets/workbench-light-1.1.0.png)](docs/user/deepseekgui/assets/workbench-light-1.1.0.png) |

*同一个本地工作台，两种主题。点击图片可查看原始尺寸。*

![内置浏览器与会话并列](docs/user/deepseekgui/assets/browser-1.1.1.png)

*在会话旁边打开网页，查看助手的浏览操作和结果，让对话与页面内容保持并列。*

![会话与右侧文件栏](docs/user/deepseekgui/assets/file-sidebar-1.1.1.png)

*对话与项目文件树并列，在会话中整理项目记忆，同时浏览工作区文件。*

![模型配置与桌面管理](docs/user/deepseekgui/assets/settings-1.1.1.png)

*在统一设置中配置模型，并访问 Harness 桌面控制、本地插件管理、诊断反馈与全局记忆。*

![Git 状态与会话提交记录](docs/user/deepseekgui/assets/git-1.1.1.png)

*查看当前分支、远端配置、最近提交，以及本会话的 Git 操作记录。*

![设置中的归档会话管理](docs/user/deepseekgui/assets/archived-sessions-1.1.1.png)

*在设置中集中查看归档会话，恢复并打开，或确认删除。*

![项目记忆](docs/user/deepseekgui/assets/project-memory-1.1.0.png)

*在项目中保留背景、已确认的决定和协作约定，以 Markdown 阅读，也可让助手整理。*

![全局记忆](docs/user/deepseekgui/assets/global-memory-1.1.0.png)

*跨项目的个人偏好由用户编辑和保存，助手读取；项目事实在单独的项目记忆中管理。*

## 工作台功能

### 本地项目与 Git 协作

- **改动视图** — 按将提交、已改动、新文件和冲突分组查看文件，打开单文件差异、复制路径或在文件管理器中定位。
- **Git 视图** — 查看分支、远端同步状态、最近提交，以及已加载会话记录中的提交、推送和 PR 结果。
- **并行工作区** — 集成在 Git 视图上方，查看已注册 worktree 的分支与改动，标出共同修改的路径，方便检查潜在冲突。
- **Git / PR 工具** — 通过会话查询差异、暂存、取消暂存、撤销已跟踪文件的未暂存改动、提交、预览推送、推送和创建 PR；结果以专用卡片展示。
- **本地状态检查** — 视图按需读取工作区状态，无需模型请求；工作区文件路径可点击定位，内置终端可跟随当前会话目录。

### 记忆与协作规则

- **全局记忆** — 用户在设置页编辑跨项目偏好与协作要求，助手只读；保存时检查原文和当前 Home，避免旧草稿覆盖外部修改。
- **项目记忆** — 助手在工作区的 `<文件夹名>.memory.md` 中维护项目事实；记忆视图支持 Markdown 阅读和「让助手整理」。
- **规则模板** — 托管目录首次启动时初始化全局 `AGENTS.md`，项目模板可按需生成；已有文件保留。
- **可追溯上下文** — 会话加载时读取两层记忆，实际使用的内容随 Harness 会话上下文记录保存。

### 模型与桌面工具

- **模型与附件** — 支持 DeepSeek V4.1 Flash，支持自定义模型服务、通用文件上传和图片附件；图片及网页截图交给支持视觉的模型。
- **会话与权限** — 在项目文件夹中开始和恢复会话，查看工具执行过程，通过 Harness 权限模式和审批控制操作；回复正文平滑显示，停止或结束后立即显示完整内容。
- **归档与删除** — 在「设置 → 归档的会话」恢复或确认删除。删除等待当前回复与工具执行结束，清理正文和搜索索引，保留最小删除记录；共享附件文件保留。
- **浏览器与终端** — 网页在应用内与会话并列，助手打开网页时自动展开；浏览器面板与文件侧栏交替显示。DSH Terminal 使用当前 Harness 环境，可跟随会话目录。
- **文件预览** — 右侧文件栏支持多标签、分栏、全屏及 Markdown、代码、HTML、PDF、图片预览，在对话旁检查助手交付的文件。
- **桌面通知** — 接收待审批、待回答及后台任务完成或失败的提示，点击跳转到对应会话。
- **Profile 与插件** — 切换 Harness Home 和 Profile，管理兼容插件，查看配置与运行状态。
- **更新与数据迁移** — 自动下载更新并校验 SHA256，由用户确认安装；可关闭自动下载。托管数据目录支持迁移，复制与校验完成后切换，旧副本经确认再清理。
- **首次使用与诊断** — 首次启动引导完成模型配置和第一条会话；提供中英双语、系统托盘、本地诊断导出和助手辅助的 BUG 排查。

完整版本变更见 [v1.1.1 发布说明](https://github.com/See-Sol-Lab/DeepSeekGUI/releases/tag/v1.1.1)。

## 文档

| 指南 | |
| --- | --- |
| [快速开始](docs/user/deepseekgui/quickstart.zh.md) | 首次启动引导、模型配置、第一次会话 |
| [模型与视觉](docs/user/deepseekgui/models.zh.md) | API key、V4.1 Flash、自定义模型、图片输入 |
| [工作区与会话](docs/user/deepseekgui/workspaces-sessions.zh.md) | 工作区、文件附件、归档、恢复与删除 |
| [工作台视图与 Git 工具](docs/user/deepseekgui/workbench.zh.md) | 改动、Git 与 worktree、提交与 PR |
| [记忆](docs/user/deepseekgui/memory.zh.md) | 全局记忆、项目记忆、规则模板 |
| [Profile 与插件](docs/user/deepseekgui/profiles-plugins.zh.md) | Harness Profile 和插件管理 |
| [权限与批准](docs/user/deepseekgui/permissions.zh.md) | 沙盒、权限、审批 |
| [桌面工具](docs/user/deepseekgui/desktop-tools.zh.md) | 内置浏览器、终端、自动更新、诊断反馈 |
| [数据与故障排查](docs/user/deepseekgui/data-troubleshooting.zh.md) | 数据目录迁移、卸载保留、隐私、故障排查 |

文档里也保留了上游 Harness 的开发教程和插件开发参考。

[产品自研workbench路线图](https://github.com/See-Sol-Lab/DeepSeekGUI/issues)

## 数据与隐私

托管环境中的凭据、设置、会话与全局记忆保存在应用本地数据目录；Windows 默认为 `%APPDATA%\DeepSeekGUI\dsh`。项目记忆保存在所选工作区的 `<文件夹名>.memory.md` 中。模型请求会将当前任务所需的上下文发送到你配置的模型服务；浏览网页、Git / PR、插件管理和更新检查也会访问相应网络服务。

日志对凭据类内容进行脱敏，诊断文件保存在本地。Windows 卸载程序会询问是否删除应用数据；覆盖升级保留数据。分享诊断或提交项目记忆文件前，请检查其中是否包含私密内容。

## 从源码构建

<a id="run-deepseekgui-from-source"></a>

### 从源码运行 DeepSeekGUI

需要仓库指定版本的 Node.js 和 pnpm：

```sh
git clone https://github.com/See-Sol-Lab/DeepSeekGUI.git
cd DeepSeekGUI
pnpm install
pnpm run build
pnpm run dev:deepseekgui
```

构建 Windows 发行版：

```sh
pnpm run build:desktop-dist
```

打包细节见 [DeepSeekGUI Desktop](apps/deepseekgui/README.zh.md)。

<a id="run"></a>

### 通过 npm 运行 Harness

装好 Node.js，启动上游 Web UI：

```sh
npx @deepseek-ai/dsh web
```

会在浏览器打开 `http://127.0.0.1:3080`。

<a id="run-deepseek-harness-from-source"></a>

### 从源码运行 Harness

公开代码树里有桌面版使用的上游 Harness 源码：

```sh
pnpm install
pnpm run build
pnpm dsh web
```

## 参与贡献

- Bug 和反馈请提交到 [DeepSeekGUI Issues](https://github.com/See-Sol-Lab/DeepSeekGUI/issues)。
- PR 之前请先阅读 [CONTRIBUTING.md](CONTRIBUTING.zh.md)。
- 上游 Harness 问题去官方讨论区反馈 [DeepSeek Harness Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions)。

## 许可证

两部分：

- **上游 Harness** 代码继续遵循 DeepSeek 的 [MIT License](LICENSE-MIT-UPSTREAM)。
- **DeepSeekGUI** 原创代码以 [PolyForm Perimeter License 1.0.1](apps/deepseekgui/LICENSE) 源码可见发布。个人、学习、研究、爱好、公司内部用都行；做竞品需要找 See-Sol-Lab 另外拿授权。

根目录 [`LICENSE`](LICENSE) 说明了两部分怎么划分。重新分发前请读 [DeepSeekGUI 许可说明](DEEPSEEKGUI-LICENSE.md)和[第三方声明](THIRD_PARTY_NOTICES.md)。