DeepSeek GUI:DeepSeek 模型的桌面 Agent 工作台
DeepSeek 有终端客户端,有网页聊天。两者对一次性问答来说都够用。但它们都不是为长期项目工作设计的——跨多个代码库管理多个会话、审查 agent 改动的文件、规划多步骤任务、跨天保持上下文。
DeepSeek GUI 补上了这个缺口。它是一个 Electron 桌面应用,把 DeepSeek 模型封装进一个真正的工作台:Code 模式绑定本地项目目录,Write 模式独立管理文档,连接手机接入 IM,以及一个叫 Kun 的本地 Agent 运行时,专门优化 token 效率。
两个工作台
应用分为两种主要模式。
Code 模式是核心功能。选择一个项目目录,启动会话,agent 针对你的实际代码库工作——读文件、改代码、跑命令、提交改动。变更审查面板跟踪每个文件修改,以内联 diff 可视化。你在应用内批准或拒绝。会话管理支持分叉、归档、压缩,适合长期对话。
Code 模式关键功能:
- 按工作区管理会话,每个工作区有独立目录
- 内联 diff 和侧边栏文件变更审查
- 权限策略:只读、工作区可写、完全访问
- 工具调用审批工作流——可逐工具配置
- 通过
/review做代码审查、/btw开旁支对话、/goal跟踪长期目标 /plan计划和右侧待办面板,把长任务拆成可追踪的步骤- 快捷任务卡片:结构梳理、排错、实现方案等
Write 模式是一个独立的 Markdown 写作工作台。管理 ~/.deepseekgui/write_workspace 和自定义写作空间。Live 编辑器原地渲染 Markdown——当前行保留源码,其他行实时预览。内置 DeepSeek FIM 补全,支持短补全和灵感长补全,通过 BM25 + 关键词检索保持术语和风格一致性。支持导出为 HTML、PDF、DOC、DOCX。
Agent 运行时:Kun
Kun 是驱动 DeepSeek GUI 的本地运行时。它通过 HTTP/SSE 服务运行——Electron UI 和 agent loop 之间的唯一边界。它的设计哲学:最大化 token ROI。
标准 agent loop 浪费 token 在重复前缀、庞大工具目录和低价值输出上。Kun 通过几个机制解决这个问题:
缓存优先 agent loop。 系统 prompt、工具 schema 和不可变前缀被稳定化,使 DeepSeek 的原生缓存更容易命中。长会话不需要反复为同一段上下文付费。
渐进式工具发现。 当 MCP 暴露很多工具时,Kun 不会把整个目录塞进每轮 prompt。它用 mcp_search 查找相关工具,再 mcp_describe 和 mcp_call 只使用需要的工具。完整工具目录不进上下文,直到需要时才接入。
上下文卫生。 超长工具结果、大参数、base64 payload、重复工具循环和低价值历史被边界压缩或抑制。路径、代码、错误、决策和未解决事项被保留。
可视化用量统计。 缓存命中/未命中率和 token 节省额在 GUI 中显示。你能看到 Kun 省了多少 token。
Kun 通过功能开关管理能力:MCP 服务器、web fetch/search、skills、图片附件、跨会话记忆和子 agent 委派都有独立开关,在设置面板中配置和查看状态。
连接手机
“连接手机”界面让 Kun 作为后台 agent 接入 IM 平台。目前支持飞书、Lark 和微信。每个 IM 渠道有独立的 agent 人设、模型偏好和工作目录。会话线程独立,可在 GUI 中调试。
定时任务——一次性、每日、间隔或手动——创建独立 Kun 线程在预定时间执行。这使 DeepSeek 从一个聊天回复模型变得更接近一个持久的自动化助手。
适合谁
- 想用 DeepSeek 处理真实代码库但不想留在终端里的开发者
- 需要看到 agent 做了什么——文件改动、工具调用、权限审批——的团队
- 管理多个项目和会话,希望沉淀 Skill 和 MCP 配置的用户
- 想把 DeepSeek 接入 IM 工作流并设置定时自动化的用户
应用需要 DeepSeek API Key(或兼容 OpenAI 的端点)。它不属于 DeepSeek Inc.——它是一个社区构建的工作台。
安装
从 releases 页面 下载——macOS .dmg、Windows .exe、Linux .AppImage。首次启动引导你选择语言和设置 API Key。
从源码运行:
git clone https://github.com/XingYu-Zhong/DeepSeek-GUI.git
cd DeepSeek-GUI
npm install
npm run dev
需要 Node.js 20+。
试试看
DeepSeek GUI 是 MIT 协议开源项目,1.5k star,134 fork,作者 XingYu-Zhong。当一个社区工具开始成为某个模型的桌面默认界面时,值得关注一下。