DeepSeek GUIDeepSeek GUI 0.2.8

告别命令行黑框和零散代码片段，DeepSeek GUI 让 Kun 运行时带着三大工作台，直接把 AI 搬进桌面——选一个文件夹，剩下的交给它。

过去很长一段时间里，想在本地用 AI 深度参与项目开发或文档写作，无非两种选择：要么在终端里盯着黑底白字的命令行，忍受不直观的信息展示；要么把代码片段复制到网页上问一圈，再手动粘贴回来。前者信息准确但门槛高，后者方便却割裂。

DeepSeek GUI 提供了一个新的选项——它不是网页版 DeepSeek 的桌面包装壳，也不是一个功能有限的聊天应用。它是一个真正的本地智能体桌面工作台，直接把 DeepSeek 模型搬进了桌面窗口，能读你的项目文件、写代码、改文档、连接手机消息，甚至执行定时任务。目前项目在 GitHub 上已获得 1300+ Star，提供 macOS、Windows、Linux 三端预构建安装包。

DeepSeek GUI 重要提示
DeepSeek GUI 是一个开源社区项目，不是 DeepSeek 官方的桌面客户端。它需要你自己准备 DeepSeek API Key，所有数据在你的本地运行和管理，不经过第三方服务器。

01 为什么需要 DeepSeek GUI？从“聊天”到“做项目”

大多数AI辅助工具停留在“你问我答”的对话模式，与真实的开发写作场景之间存在两道明显的鸿沟。

第一道鸿沟：项目语境。你很难让一个聊天 AI 真正理解一个完整代码库的上下文依赖关系，它只能看到你复制过去的片段，缺乏对全局的判断。第二道鸿沟：操作闭环。即使 AI 给出了正确的修改建议，你仍然需要在编辑器和聊天窗口之间来回手动复制粘贴，效率大打折扣。

DeepSeek GUI 的核心理念是让 AI Agent 真正进入你的本地工作区。它的设计逻辑不是“再造一个聊天壳”，而是让 AI 成为一个可以稳定参与真实项目工作的桌面伙伴。它会把你自己选定的本地项目文件夹交给 AI，让模型能够完整感知项目结构、文件内容和代码依赖，在工具调用后进行文件修改时，GUI 会清晰展示每一次改动的 diff，支持审批和回退。这样就从“提问—回复—手动操作”的碎片化循环，变成了“设定目标—自动推进—可视审查”的完整工作闭环。

02 三大工作台：把 AI 能力放进真实场景

DeepSeek GUI 把复杂工作拆成三个独立入口，每个模式都有专属的界面和交互，底层共享 Kun 运行时。

🧑‍💻 Code工作台——项目开发的得力助手

Code 模式是 DeepSeek GUI 最核心的功能入口，专门面向软件开发场景。选择一个本地项目文件夹后，AI 就能围绕整个代码库展开工作。

任务开始时，左侧聊天面板展示 AI 的推理过程和工具调用，你可以实时看到 AI 在思考什么、执行了什么命令；右侧文件浏览区展示工作区文件树和代码编辑预览。在 AI 做出修改前，你可以用右侧变更审查面板查看每一次改动的内联 diff，确认无误后再接受。权限控制上，提供只读、工作区可写、完全访问三个等级，关键操作支持人工审批，可以随时中断或调整 AI 的执行方向。

Code 模式还内置了一套 SDD 需求流：从需求草稿到计划再到执行。可以先写需求背景、目标和验收标准，让需求 AI 补全和检索项目相关信息，确认后再生成可执行的实施计划和 Todo 列表，让整个项目推进过程有迹可循。

✍️ Write工作台——专注内容的写作空间

Write 模式是一个独立的 Markdown 写作工作台，左侧是文件树，中间是 Live 编辑器，右侧是 AI 写作助手。编辑器有一个巧妙的设计：当前输入行保留 Markdown 源码方便编辑，其他行实时渲染成标题、加粗、列表等样式，在纯文本编辑和可视化预览之间找到了平衡。

写作补全是 Write 模式的一大亮点，分为短补全和灵感长补全两套独立机制：

• 短补全（约 650ms 触发）：响应速度快，适合实时输入辅助，用于补全当前单词或短句。
• 灵感长补全（约 2800ms 触发）：在停顿足够长或行尾/段落边界时触发，生成更大篇幅的续写内容，帮你接住写作灵感。

在写长文档时，你还可以选中某段文本，点击浮动按钮输入“润色”“总结”或“扩写”等指令，AI 会直接根据上下文改造这段文字，不需要切换到聊天窗口重新说明需求。写完之后，Markdown 文件可以直接导出成 Word、PDF、HTML 等多种格式。

📱 Claw工作台——手机操控桌面 AI

Claw 模式是三个模式中最令人耳目一新的功能。它把你的 AI Agent 接入了飞书、Lark、微信等 IM 工具，让你可以用手机随时操控电脑上的 AI。

在 DeepSeek GUI 设置中配置好连接后，你可以在手机上通过 IM 发送指令给电脑上的 AI，让它执行新建文件、删除文件、打开浏览器搜索等操作，基本上都是秒执行。它还支持强大的定时任务功能：创建一次性、每天或间隔周期任务，比如设置每天早上 9 点自动跑数据检查脚本，或者每周五下午自动备份项目文件。即使你不在电脑前，也能让 AI 替你完成例行工作。

03 上手教程：从安装到第一次成功运行

DeepSeek GUI 的上手门槛不高，整个过程大约 5 分钟。按照以下步骤即可完成首次运行。

🔧 Step 1 — 下载与安装

访问 DeepSeek GUI 官网（deepseek-gui.com）或 GitHub Releases 页面，下载对应你操作系统的安装包：

• Windows：下载 .exe 安装程序（NSIS 安装器）
• macOS：下载 .dmg 文件
• Linux：下载 .AppImage 文件

安装过程与其他桌面应用一致：双击运行、拖入 Applications 文件夹（macOS）或执行安装向导（Windows）。约 150 MB，过程很快。

🔑 Step 2 — 首次启动与 API Key 配置

首次打开 DeepSeek GUI 会进入引导界面：

1. 选择界面语言——简体中文 / English。
2. 输入 DeepSeek API Key——登录 platform.deepseek.com/api_keys 获取。DeepSeek GUI 调用的是官方 API，按实际 Token 使用量计费，没有额外的订阅或订阅费用。
3. 设置 Base URL（可选）——如果你使用兼容 DeepSeek / OpenAI 格式的其他服务，可在此修改。
4. 选择默认工作目录——这是 AI 将要访问的文件夹根路径。建议专门创建一个 ~/deepseek-workspace 目录用于试验。

如果配置不成功，可以在 GUI 右上角进入设置页随时修改 API Key 和 Base URL。

🚀 Step 3 — 开始第一次任务（推荐从 Code 模式入门）

推荐从 Code 模式开始体验，因为这是最能体现 DeepSeek GUI 核心能力的使用场景：

1. 在左侧 工作区面板 选择一个本地项目目录（可以是任意包含代码文件的文件夹）。
2. 在聊天框中输入一个简单任务，例如：“帮我整理这个项目的目录结构，并生成一个 README 文档。”
3. 观察右侧面板中 AI 的推理过程、工具调用和文件操作。你会看到 AI 读取了项目文件、分析了结构、创建或修改了文件。
4. 对于标记为 需要审批 的操作，系统会弹出审批请求，你可以选择接受或拒绝。
5. 任务完成后，在 变更审查面板 中查看 AI 产生的所有文件改动，确认无误后即可继续使用。

如果你是写作用户，可以直接切换到 Write 模式，用默认写作空间写一篇 Markdown 文档，尝试用选中文本 + 右侧写作助手触发润色或续写。如果你想体验用手机远程操控 AI，可以在设置页进入“连接手机”配置，添加飞书或微信的 webhook 连接。

04 四个实用建议，让你用得更趁手

建议一：用 /goal 和 /plan 推进长期任务

DeepSeek GUI 内置了一套任务管理机制，通过 斜杠命令 可以把模糊的想法变成可执行的步骤。在聊天框中：

• 输入 /goal 开发一个 React 组件库，让 AI 围绕这个长期目标展开工作。
• 输入 /plan 创建计划文件，右侧计划面板会同步生成 Todo 列表，任务进度一目了然。

建议先把任务拆成 /goal 和 /plan 两层结构，让 AI 理解长期目标，再按 Todo 分步推进。完成一个阶段后，用 /review 做复盘，AI 会输出 findings 卡片并展示内联 diff。

建议二：把 AI 的“可见性”开到最大

DeepSeek GUI 提供了丰富的可视化工具，建议充分利用：

• 文件变更审查：每次 AI 修改文件前，右侧面板会展示内联 diff，比在终端查看差异直观很多。
• Token 用量监控：运行时窗口会展示缓存命中率和 Token 用量，可以直观看到 Kun 的 cache-first 策略帮你省了多少 API 成本。
• 工具调用审批：对于文件删除、网络请求等敏感操作，建议保持审批开启，把控制权握在自己手里。

建议三：先从小项目开始试探能力边界

首次使用 DeepSeek GUI 时，不要在大型生产项目上直接试水。建议创建一个小的测试项目文件夹，放几个简单的代码文件和 Markdown 文档，让 AI 帮忙改几行代码、整理文档结构，感受它的推理粒度、代码生成风格和操作规范。在这个过程中，也可以顺便测试不同权限等级（只读/工作区可写/完全访问）的实际效果，找到最适合自己的安全边界。

建议四：用 Skill 和 MCP 图形化管理扩展能力

DeepSeek GUI 内置了 Skill 和 MCP 的图形化管理界面，不需要手写配置也能扩展智能体能力。在设置页中，你可以创建新 Skill 定义 AI 的专项能力（比如“代码审查 Skill”），也可以用 MCP 配置让 AI 接入更多第三方工具。这些扩展能力会让 AI 在不同任务场景下表现得更专业，建议有精力时逐步探索。

05 值得注意的“边界”

任何工具都有它的适用边界，以下三点需要客观了解：

• 仅支持 DeepSeek API：目前 DeepSeek GUI 仅支持 DeepSeek 官方 API 及其兼容服务，不能直接接入 OpenAI、Claude 等其他模型。
• 非官方项目：DeepSeek GUI 是个人开发者 XingYu-Zhong 的作品，并非 DeepSeek 官方产品，稳定性和更新周期依赖社区维护。
• 偶发卡顿与反爬限制：实测中偶尔出现卡顿，重启后可恢复；让 AI 读取百度搜索结果时，有时会被反爬机制挡住。

写在最后

DeepSeek GUI 把 Kun 的高 Token ROI 智能体能力带进了桌面窗口，通过 Code、Write、Claw 三大工作台对应不同的工作场景。它没有试图取代任何现有工具，而是在 AI Agent 和本地工作之间架设了一个更可控的桥梁。

对于日常深度使用 DeepSeek 模型的开发者和写作者来说，它可能正好解决了那个最让人头疼的问题——AI 知道你写了什么，却不知道你身处怎样的项目里。现在，把这个文件夹交给它，它开始看见了。