DeepSeek GUI 中文教程：桌面安装、Node 20 源码运行与 Code / Write / Claw
DeepSeek GUI 是把 Kun / DeepSeek 本地智能体能力放进桌面工作台的项目，提供 Code、Write、Claw 等工作模式。它不是只换皮的聊天窗口，安装时要注意版本、API key、工作目录和原生依赖。
1. 下载预构建包
从官方 release 下载对应平台资产。README 列出 macOS 的 DMG / ZIP、Windows 的 EXE；Linux 包是否提供要看具体 release，不要根据旧文章推断。
2. 从源码运行
git clone https://github.com/XingYu-Zhong/DeepSeek-GUI.git cd DeepSeek-GUI npm install npm run dev
官方 README 要求 Node.js 20+、DeepSeek API key，首次安装依赖需要联网；网络较慢时可按官方文档使用 npm 镜像。源码构建适合贡献者，普通用户优先用 release 包。
3. 首次配置
首次打开后选择工作目录，填写 DeepSeek API key；如果使用兼容 DeepSeek / OpenAI 的服务，在 Settings 中修改 Base URL。Code 适合项目工作，Write 适合文档，Claw 负责 IM 和自动化能力；权限和文件改动要在应用内逐项确认。
4. 与终端 Agent 的区别
DeepSeek GUI 把终端 Agent 的推理、工具调用和文件改动放到桌面界面，降低了第一次使用门槛；终端项目更适合脚本化、远程服务器和可复现 CI。需要稳定自动化时，先验证 GUI 版本是否支持你的工作流，再决定是否迁移。
验证边界
验证状态：official_repo_and_release_checked_not_locally_installed；核对日期 2026-09-22。核对官方 README 与 0.2.6 release；未在当前工作区安装桌面包或运行 npm dev。
观察结果：官方页面将 0.2.6 标为 Latest（2026-06-08），README 列出 Node 20+、macOS/Windows 包和自定义 Base URL。
限制：未验证各平台安装包、API key 计费和自定义 endpoint 的完整兼容性。 依据：官方仓库 README / release 页面，核对日期 2026-09-22。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
原教程未展开的系统信息
核心功能
Code/Write/Claw 与自定义 Base URL
Settings 可配置 DeepSeek/OpenAI-compatible Base URL，三个工作模式分别面向代码、文档和 IM/自动化。
架构与数据流
桌面应用提供工作区和 Agent 模式；模型调用通过配置的 DeepSeek 或 OpenAI-compatible provider 完成，源码开发入口使用 Node/npm。
常见问题
源码运行需要什么？
Node.js 20+、DeepSeek API key，并在首次安装依赖时联网；命令是 npm install 后 npm run dev。
能使用自定义 Base URL 吗？
README 说明 Settings 支持 DeepSeek / OpenAI 兼容服务的自定义 Base URL。
macOS 和 Windows 都有安装包吗？
README 列出 macOS DMG / ZIP 和 Windows EXE；Linux 包是否发布，以当前 release 的资产为准。
Code、Write、Claw 有什么区别？
Code 面向项目开发，Write 面向文档，Claw 面向 IM 和自动化；具体功能随版本变化。
这个项目是 DeepSeek 官方产品吗？
不是。README 明确说明项目与 DeepSeek Inc. 无隶属关系。