DeepSeekGUI

DeepSeekGUI v1.2.1

English | 中文

稳定不炸的 DeepSeek 本地工作台。

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

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

当前版本：v1.2.1。 内嵌 Harness 升至 0.2.1-rc.2。新增程序与数据整体搬家、归档会话时整理项目记忆；修复只读工作区的权限显示、非 Git 工作区的空状态，以及发行运行时里 fflate 与 fast-uri 的已知漏洞。开发者模式仍默认关闭；官方 0.2.1 的 V4.1 Flash 标识、Search/Fetch 接口开关与界面改进随版适配；Linux AppImage 同步为 v1.2.1（实验性）。

下载

平台 · 下载 · 要求 Windows · 下载安装包 · Windows 10/11，x64 Linux · 下载 AppImage · x64，AppImage；实验性支持

Windows 安装包安装到当前用户目录，自带运行时。Linux 使用独立的 AppImage 发行文件，下载与校验信息见 v1.2.1-linux.1 发布页。

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

校验 Windows 安装包

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

Get-FileHash .\DeepSeekGUI-Setup-1.2.1.exe -Algorithm SHA256

与 SHA256SUMS.txt 核对后再安装。遇到问题看故障排查指南。

快速开始

详细步骤见快速开始指南。

截图

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

深色主题 · 浅色主题 ·

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

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

*更新后兼容官方右侧文件栏，可与助手同时浏览工作区文件。*

*在统一设置中配置模型，支持最新v4.1并做好视觉提示词注入，设置面板内置自研插件与功能调试。*

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

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

*以 Markdown 阅读、可修改、也可让助手整理的项目级记忆*

*跨项目的个人偏好与全局记忆由用户编辑保存，助手读取；可同时编辑AGENTS.md*

工作台功能

本地项目与 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，由用户确认安装；可关闭自动下载。托管数据目录支持迁移，复制与校验完成后切换，旧副本经确认再清理。
• 首次使用与诊断 — 首次启动可用 DeepSeek 账号登录或添加 API Key，登录后的官方引导介绍额度与用法；提供中英双语、系统托盘、本地诊断导出和助手辅助的 BUG 排查。

完整版本变更见 v1.2.1 发布说明。

文档

指南 · 快速开始 · 账号登录或 API Key、模型配置、第一次会话 模型与视觉 · API key、V4.1 Flash、自定义模型、图片输入 工作区与会话 · 工作区、文件附件、归档、恢复与删除 工作台视图与 Git 工具 · 改动、Git 与 worktree、提交与 PR 记忆 · 全局记忆、项目记忆、规则模板 Profile 与插件 · Harness Profile 和插件管理 权限与批准 · 沙盒、权限、审批 桌面工具 · 内置浏览器、终端、自动更新、诊断反馈 数据与故障排查 · 数据目录迁移、卸载保留、隐私、故障排查

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

数据与隐私

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

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

从源码构建

从源码运行 DeepSeekGUI

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

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

构建 Windows 发行版：

pnpm run build:desktop-dist

打包细节见 DeepSeekGUI Desktop。

通过 npm 运行 Harness

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

npx @deepseek-ai/dsh web

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

从源码运行 Harness

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

pnpm install
pnpm run build
pnpm dsh web

参与贡献

• Bug 和反馈请提交到 DeepSeekGUI Issues。
• PR 之前请先阅读 CONTRIBUTING.md。
• 上游 Harness 问题去官方讨论区反馈 DeepSeek Harness Discussions。

许可证

两部分：

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

根目录 LICENSE 说明了两部分怎么划分。重新分发前请读 DeepSeekGUI 许可说明和第三方声明。