DeepSeek Harness Desktop快速上手3分钟教程：从下载安装到首次启动AI Agent

DeepSeek Harness Desktop快速上手3分钟教程：从下载安装到首次启动AI Agent

【免费下载链接】deepseek-harness-desktopDeepSeek Harness Tauri 桌面版 | Only 5mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.项目地址: https://gitcode.com/gh_mirrors/dee/deepseek-harness-desktop

DeepSeek Harness Desktop（DSH Desktop）是一款基于 Tauri 2 的 AI Agent 桌面客户端：安装包仅约 5MB，无需 Node.js、无需 pnpm、无需 Docker，下载即用。它会在本地自动完成 Harness 内核的运行环境安装，帮你一键启动 DeepSeek Harness AI Agent 界面，支持 Windows / macOS / Linux 三大平台。下面用 3 分钟带你从零跑通「下载 → 安装 → 首次启动 AI Agent」。

一、为什么选择 DeepSeek Harness Desktop？

对于新手来说，直接安装上游的dsh（DeepSeek Harness）需要手动配置 Node.js、pnpm 等开发环境，非常劝退。而DSH Desktop 桌面版把这些全部打包好了：

• 🪶原生轻量：基于 Tauri 2 外壳（非 Electron），安装包更小、内存占用更低；
• 🧩插件生态：内置 10+ 官方插件（插件市场、Worktree、定时任务、桌宠等），开箱即用；
• ⌨️命令行集成：安装后自动注册dsh命令，新开的终端直接可用；
• 🚀应用内自更新：不用反复下载安装包；
• 🐾桌宠：根据会话活动显示状态气泡的小宠物，让等待更有趣。

二、系统要求：30秒确认能否安装

开始之前先确认你的系统满足最低要求（📋 清单）：

💡 另外两条小贴士：首次运行需要联网（用于下载 Node 运行时与 Harness 内核）；Harness 内核需0.1.5-rc.1 或更高版本。之后即可完全离线运行。

三、一键下载安装：Windows / macOS / Linux

1. 打开项目的Releases 发布页，找到对应平台的安装包（.exe/.dmg/.AppImage/.deb）；
2. 双击安装包，按系统提示完成安装（macOS 若提示无法验证开发者，在「系统设置 → 隐私与安全性」中允许即可）；
3. 也可以走命令行安装。macOS 支持 Homebrew 一键安装：

brew install dsh-tauri/desktop/deepseek-harness

内网 / 白名单环境？Releases 里另有Deepseek.Harness.Desktop_Bundle_<版本>.<扩展名>离线安装包，Node 运行时与 Harness 内核随包分发，安装后首次启动无需联网，但预设与社区插件仍需联网。

四、首次启动：等待 AI Agent 就绪

双击桌面图标启动应用后，DSH Desktop 会完成以下事情（全自动，无需手动操作）：

1. 下载Node.js 运行时（约几十秒，视网络而定）；
2. 下载Harness 内核（如你已经全局安装过dsh，则优先使用你本地的版本）；
3. 在本地127.0.0.1:3080端口拉起 Harness 服务，并自动加载出 AI Agent 对话界面。

首次运行需要网络；此后完全本地运行，断网也能继续用。

首次启动时还可以勾选推荐预设插件（如插件市场、Better Sidebar 侧边栏、Rewind 对话回退等），也可跳过，之后随时在配置面板里补装：

五、第一次对话：向 AI Agent 问好

进入主界面后，左侧是工作区与会话列表，中间是 AI Agent 对话区：

按下面的步骤发起第一次对话：

1. 选择工作区：在左侧选择一个本地项目文件夹（AI Agent 会读取其中的代码与文档）；
2. 选择模型：在输入框右下角选择模型（如deepseek-v4-flash）；
3. 点击「新会话」，输入框中输入你好并发送。

几秒后，AI Agent 会自动注入AGENTS.md、技能目录等上下文并回复你。你还可以在输入框上方的模式下拉里切换到**「工作树」**模式——每个会话拥有隔离的 Git Worktree，多会话并行修改代码互不干扰：

六、常用配置速查：设置面板里的 4 个入口

点击左下角的⚙️ 设置按钮，会打开配置面板，包含 4 个标签页：

七、常见问题（FAQ）

• Q：启动后一直卡在下载进度？A：首次运行需联网下载运行时与内核，网络不佳时耐心等待即可；企业内网用户建议改用离线 Bundle 安装包。

• Q：Linux 上 AppImage 双击黑屏 / 崩溃？A：Wayland 环境（PikaOS / GNOME Wayland / Ubuntu 22.04+）建议改用.deb包；滚动发行版（Arch / Fedora 等）请使用修复后发布的版本，或改用.deb。详见 README.md 中的说明。

• Q：和上游dsh是什么关系？A：DSH Desktop 是上游 DeepSeek Harness 的桌面外壳：Tauri Rust 后端负责下载、进程管理与健康检查，Web 界面内嵌 Harness 原版 UI。架构说明见 README.md，后端源码位于 src-tauri/src/service/。

• Q：数据存在哪里？A：全部本地运行，数据目录默认为~/.dsh（见 src-tauri/src/config/constants.rs），数据始终由你掌控。

写在最后

3 分钟走完：下载 → 安装 → 首次启动 → 第一次 AI Agent 对话。现在你已拥有了一个零环境配置、完全本地运行的 AI Agent 工作台。下一步可以探索：

• 在「扩展」面板中浏览技能与 MCP 管理界面；
• 安装 DSH Market 等预设插件，打开社区插件市场；
• 阅读 docs/DEVELOPMENT.zh.md 参与开发。

⚠️安全提示：dsh具备本地代码执行能力，请在可信、隔离的环境中使用。

【免费下载链接】deepseek-harness-desktopDeepSeek Harness Tauri 桌面版 | Only 5mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.项目地址: https://gitcode.com/gh_mirrors/dee/deepseek-harness-desktop