说实话第一次看到 DSH Desktop 的时候我第一反应是这不就是把 DeepSeek Harness 的命令行换了个皮吗用了一周之后我承认这个判断有点肤浅。作为 DeepSeek Harness 官方推出的跨平台桌面客户端DSH Desktop 真正把“本地 Agent 一键运行”这件事变成了双击图标就能完成的日常操作。这篇文章我就把自己从下载、安装到配置本地 Agent 的完整过程记录下来给正在折腾 DeepSeek Harness 桌面端的朋友一份可以直接照做的教程。不管你是刚接触本地 Agent 的小白还是长期在命令行里摸爬滚打的老手只要想把 DeepSeek Harness 这把“好工具”真正用起来这篇 DSH Desktop 下载与安装教程都值得你花十分钟看完。我会把环境准备、下载安装、模型配置、插件安装和问题排查这些环节全部掰开揉碎尽量让你照着操作就能跑通。1. DSH Desktop 到底是什么解决什么问题1.1 本地 Agent 部署的“命令行地狱”该结束了在 DSH Desktop 出现之前本地部署 Agent 是怎么个体验拿我自己的经历来说最早玩 DeepSeek Harness 时装完 JDK 和 Git 之后光是配置文件就改了快两个小时。config.yaml里要写模型端点、API Key、工具链路径跑起来之后还得盯着终端日志看有没有报错。说白了这些开源工具的能力没问题但上手门槛实在不低。很多想尝试本地 Agent 的朋友不是卡在“不想折腾”而是卡在“不知道从哪里开始”。DSH Desktop 的出现恰恰是把这套东西收口到了桌面应用里。你不用再去记忆一长串命令也不需要反复修改 YAML 语法。安装完成后打开软件左侧导航栏能直观看到模型、插件、会话、日志这些模块。所有操作都变成了“点一下”“选一下”的事。对我来说它最大的价值不是把复杂功能变简单而是把所有需要记忆的上下文都变成了可见的界面元素。1.2 DeepSeek Harness 和 DSH Desktop 的分工这里要理清一个概念DeepSeek Harness 是一个用于承载本地 Agent 的运行时框架负责模型调度、工具调用、上下文管理这些底层能力而 DSH Desktop 是它的桌面客户端外壳负责把框架能力图形化呈现给你。我经常用一个类比来解释DeepSeek Harness 像是汽车的发动机和变速箱DSH Desktop 则是驾驶舱。你不一定要懂发动机怎么点火但你会踩油门、看仪表盘就够了。DSH Desktop 在后台会默认拉取对应版本的 DeepSeek Harness 核心库你只管在前台做配置。之所以叫“2026 年跨平台桌面客户端”是因为这一版在跨平台一致性上做了很大改进。Windows、macOS、Linux 三端共用了同一套底层运行时界面和配置格式也完全对齐。比过去那种“Linux 下命令行配置、Windows 下还得另外装模拟环境”的体验要省心太多了。2. 装 DSH Desktop 前环境准备工作不能省2.1 为什么必须装 JDK 17而不是 JDK 8 或 JDK 11DSH Desktop 本身是用 Java 生态构建的所以它对你的机器有一个硬性要求必须装 JDK 17 或更高版本。我知道很多老项目还在用 JDK 8但这里千万别图省事用旧版本因为 DeepSeek Harness 的核心库在编译时就直接用了 JDK 17 的语法结构比如record、sealed class这些特性旧版本根本跑不起来。JDK 的安装过程其实很简单关键在于环境变量要配对。Windows 用户如果是装 OpenJDK 17 或 Eclipse Temurin 17安装时直接勾选“设置 JAVA_HOME 环境变量”就能省掉后面一堆手动配置。macOS 用户建议直接用 Homebrew 安装brew install openjdk17装完之后要确认一下版本是否真的切换到了 JDK 17java -version echo $JAVA_HOME我见过不少人在这步翻车明明装了 JDK 17但java -version显示的还是旧版本。原因往往是系统 PATH 里旧版本的 java 路径排在了前面。Linux 用户可以用update-alternatives --config java手动切换Windows 用户去“系统环境变量”里把 JAVA_HOME 对应的 Path 条目往前移就好。2.2 Git 和 Maven 是 Agent 工具链的重要支撑DSH Desktop 安装时会自动把必须用的运行时组件内置到工作目录里但很多 Agent 的插件和工作流仍然需要依赖 Git 和 Maven。Git 的作用是什么DeepSeek Harness 里面的很多 Agent 插件会通过 Git 拉取工具仓库、更新技能模板甚至把会话上下文保存到 Git 仓库里做版本管理。如果你机器上没有 Git很多插件初始化会直接失败。Maven 则主要承担构建和依赖管理的职责。DSH Desktop 在安装插件时有些插件是纯脚本不需要编译但另一些需要调用 Maven 把 Java 代码构建成可执行的 jar 包。建议你提前把这两样都装上# Ubuntu / Debian sudo apt install git maven # macOS brew install git maven装完后的验证命令也建议跑一下git --version mvn -version确保输出正常再继续。2.3 跨平台环境差异Windows、macOS、Linux 各自要注意什么虽然 DSH Desktop 是跨平台客户端但三个系统的准备侧重点不完全一样。Windows 上最容易遇到的是杀毒软件误报。DSH Desktop 安装时会释放几个可执行文件到工作目录用来启动本地 Agent 进程某些杀毒软件会把这种“程序调用程序”的行为判定为可疑操作。建议安装时先临时关闭实时保护装完后再恢复同时把 DSH 的工作目录加进白名单。macOS 上要留意 Gatekeeper 策略。官网下载的 dmg 如果打不开提示“无法验证开发者”可以在 Finder 里右键点击安装包选择“打开”然后在弹出的窗口里再点一次“打开”。这不是什么破解手段只是把系统对未签名应用的拦截放行一次。Linux 上如果下载的是 AppImage 格式需要先给可执行权限chmod x DSH-Desktop-*.AppImage如果运行时报缺少 FUSE 库安装对应依赖即可。三个系统的环境变量配置方式不同但检查核心的思路还是一样的JDK 17 在 PATH 中Git 和 Maven 能被命令行直接找到。3. DSH Desktop 下载与安装实操全流程3.1 下载渠道别从乱七八糟的站点下关于下载我只推荐去 DeepSeek Harness 的官方发布渠道。因为 DSH Desktop 会直接运行本地 Agent 代码一旦安装包被篡改后果比普通软件严重得多。官方一般会提供 GitHub Releases 页面和官网下载中心两个入口你尽量选官网标记为“当前版本”的那个链接。下载时注意选择对应系统格式的安装包Windows 对应.exe或.zipmacOS 对应.dmgLinux 对应.AppImage或.tar.gz。文件名里通常会带上版本号比如DSH-Desktop-2.3.0-windows-x64.exe。建议顺手把校验值SHA-256 哈希也对一下相当于给安装包验明正身。3.2 Windows 安装双击安装并放在 D 盘更安心Windows 安装没什么特殊难点按照安装向导的指示点“下一步”就行。但有两点我从自己的使用经验里总结出来值得特别说一下。第一安装路径尽量避免默认的C:\Program Files\DSH Desktop倒不是说程序不能装在 C 盘而是 DSH Desktop 在工作时会缓存大量模型数据和索引文件。如果你 C 盘空间比较紧张之后就会遇到磁盘爆满然后 Agent 直接挂掉的情况。建议手动指定到 D 盘比如D:\Tools\DSH Desktop。官网倒是不会提醒你这些但实际跑起来差很多。第二安装完成后第一次启动会提示你选择“工作目录”。这个目录用来存 Agent 的会话记录、模型配置、插件数据。一定不要选在系统盘临时目录下给它一个固定的路径比如D:\DSHWorkspace。以后备份和迁移都会方便很多。首次启动进主界面后建议先进入“设置 - 运行时”确认它检测到的 JDK 路径是 JDK 17。如果检测不到手动指定到你安装 JDK 的根目录。Windows 的安装流程图大概是下载 exe - 双击运行 - 选安装路径 - 等进度条跑完 - 启动并设置工作目录。整个过程大概三五分钟。3.3 macOS 与 Linux 安装细节藏在权限和依赖里macOS 安装相对直观打开 dmg把 DSH Desktop 图标拖进 Applications 文件夹即可。首次打开如果被 Gatekeeper 拦右键选择“打开”的那一套前面已经提过这里不重复。打开后同样需要指定工作目录。Linux 的安装方式我更推荐 tar.gz 版本因为它不依赖 AppImage 的 FUSE 机制兼容性更好。解压到固定位置mkdir -p ~/apps/dsh-desktop tar -xzf DSH-Desktop-2.3.0-linux-x64.tar.gz -C ~/apps/dsh-desktop cd ~/apps/dsh-desktop ./bin/dsh-desktop如果是新装的系统可能缺少一些运行库。Debian/Ubuntu 用户建议先把基础依赖装上sudo apt install libgl1 libglib2.0-0 libxrender1 libxtst6运行后界面会和 Windows 版保持一致不用重新学习。Linux 下如果希望开机自启可以自己写一个 systemd service但这属于进阶操作不是必需。3.4 首次启动后的初始化检查无论哪个平台首次启动成功后会进入一个“初始化向导”大致做三件事选择模型后端、配置本地 Agent 入口、加载基础插件。这一步不用太紧张全部可以先选择默认后续随时可以修改。初始化完成以后主界面通常有四个核心区域会话列表、Agent 配置面板、模型状态栏、日志输出窗口。模型状态栏如果能显示“已就绪”说明 DSH Desktop 本身已经跑通了。这时候你还不能直接开始和 Agent 对话因为还没给它指定模型下一步就是配置模型。4. 一键运行本地 Agent模型、插件与验证4.1 模型接入本地模型还是云端 APIDSH Desktop 支持两种模型接入方式我先帮你把适用场景捋清楚。第一种是接入本地模型适合追求隐私和数据不出本机的场景。本地模型一般通过 Ollama、llama.cpp 这类工具启一个本地服务DSH Desktop 只要填写服务地址和模型名就能对接上。比如你用 Ollama 跑起了一个qwen2.5:7b在 DSH Desktop 的“模型设置”里选择“OpenAI 兼容接口”然后填写{ base_url: http://127.0.0.1:11434/v1, api_key: ollama, model: qwen2.5:7b }没错Ollama 内置了 OpenAI 兼容 APIDSH Desktop 可以直接复用这套协议。这种方式最大的好处是模型文件跑在你自己的机器上不产生额外的 API 费用但缺点是响应速度受限于你的显卡和内存。第二种是接入云端 API比如各种大模型的官方接口或中转服务。这种方式不需要本地强算力配置时只需要填入 API Key 和接口地址。DSH Desktop 同样走 OpenAI 兼容协议所以只要你的服务商支持这种协议基本都能直接连上。缺点自然是数据会经过外部服务器需要你自己权衡。从热搜词里的“怎样下载安装。有可以免费使用的大模型吗”能看出来很多人第一步想找免费模型。我的建议是先跑通流程优先用本地小模型7B 或更小足够验证 DSH Desktop 的所有功能之后再根据实际硬件条件升级模型。4.2 插件市场先装这几个常用插件DSH Desktop 的插件体系是 DeepSeek Harness 的一大亮点。主界面侧边栏里一般有“插件市场”入口里面按分类列出官方推荐和社区提交的插件。常见的有RAG 检索插件、图像识别插件、Web 搜索插件、代码执行插件和安全测试类插件。如果你只是想让 Agent 能回答日常问题、偶尔分析文本那么先装这两类就够基础工具集包含代码执行、Shell 执行、URL 请求这些通用能力。没有这些Agent 就是一个“只会聊天但动不了手”的模型。RAG 知识库插件把本地文档切块嵌入到向量库之后提问就能基于你的文档内容回答。安装插件不需要重启点击“安装”后等待状态变为“已启用”即可。注意一点插件市场里的版本和 DSH Desktop 主版本有对应关系不要强行安装兼容性标红的那类插件容易导致 Agent 启动时报错。对于热搜词里提到的“渗透模式”我提醒一句如果你搜到的是安全测试类插件请务必只在你自己拥有授权的测试环境里使用。本地 Agent 调用这类工具的风险比普通聊天大很多做好隔离和记录是基本底线。4.3 验证 Agent 是否真正跑起来了配置完成后你就可以直接体验“一键运行本地 Agent”了。在主界面点击“新建会话”输入第一句指令比如“帮我总结当前目录下notes.md文件的内容”。如果 Agent 正确调用了检索工具并给出了结构化回复说明整条链路已经打通。我通常还会做更严格一点的三步验证模型状态是否正常观察模型状态栏有没有从“未连接”变为“已就绪”。工具调用是否生效在日志窗口看有没有出现“调用工具 - 读取文件”之类的记录。会话是否持久化关掉 DSH Desktop 再重新打开刚才的会话记录应该还在。这三步全部通过你就可以认为 DSH Desktop 的基本功能已经稳定。后续真正需要花心思的地方反而是如何调 Agent 的提示词系统和插件组合策略这是另一个话题了。5. 安装和日常使用中的高频问题排查5.1 启动失败别急着卸载先看日志新手遇到 DSH Desktop 打不开或启动中途退出第一反应往往是卸载重装。我的经验是先花三分钟看日志大部分问题都能定位。日志文件在启动时会有明确的路径提示一般在工作目录的logs/子目录下文件名类似dsh-desktop.log。常见报错和处理方式我给你列一个简表报错信息可能的根因处理办法UnsupportedClassVersionErrorJDK 版本低于 17重装 JDK 17确认 JAVA_HOME 指向正确Port already in use: 8080端口被占用常见是本地服务修改 DSH Desktop 的端口配置或结束占用进程No such file or directory工作目录权限不足给工作目录添加当前用户的读写权限OOM killed内存不足调大 JVM 的-Xmx参数或减少同时加载的模型数量如果你在日志里看到的是Error invoking command一类信息先别急着查 DSH Desktop优先查你机器上的 Git、Maven 等外部依赖是否正常。我之前就遇到过因为 Maven 没装好安装插件时总是报错排查了一圈最后发现是 PATH 里指向了一个不存在的目录。5.2 内存和路径问题两个最容易忽略的坑本地 Agent 跑起来以后吃内存是真的毫不客气。默认配置下DSH Desktop 的 JVM 堆内存可能只给了 2GB而本地模型程序比如 Ollama也会占用几个 GB 的内存。如果你的机器是 16GB 内存同时开浏览器 IDE DSH Desktop很容易触发内存不足。解决思路有两个方向一是调整 DSH Desktop 的 JVM 参数在启动脚本或设置里把-Xmx从默认值调高到 4GB 或者 6GB二是如果你只是用一个小模型做测试可以把模型的上下文长度调低一些减小显存和内存占用。另一个非常值得说的问题是路径。DSH Desktop 工作目录、模型文件路径、插件缓存目录这三者最好都不要包含中文、空格或特殊字符。我不是故意制造洁癖而是这些路径如果在程序内部被拼接成命令行参数空格和中文很容易导致引号匹配错误最后杀进程都找不到原因。都放到纯英文路径下兼容性会好一个数量级。5.3 插件不生效与版本冲突检查这三个位置安装插件后不生效的情况也挺常见。我的排查顺序是先看插件是否真的启用了。有些插件安装成功后还需要在“插件管理”里再点一次“启用”而且启用后要求重启 Agent 会话。如果你没有重启插件只是处于“已安装、未加载”状态。再看插件版本。DeepSeek Harness 的插件市场里会有“兼容 DSH Desktop 版本”的标签。你要是强制装了给旧版 Harness 准备的插件运行起来大概率会报 API 不匹配。此时把插件卸载换个带“DSH 2.x”标签的版本。最后看插件运维依赖。比如图像识别插件往往需要 Python 环境或者 OpenCV 的库RAG 插件需要配置向量数据库。界面会提示“插件依赖缺失”按提示安装对应的外部依赖就可以。我在自己的项目里通常只安装不超过五个插件因为每个插件都会在 Agent 执行任务时增加上下文长度和决策分支。插件太多不仅拖慢响应时间还会让 Agent 在工具选择上犯迷糊明明该调用搜索工具却偏偏去调了文件读取工具。保持精简才能真正发挥 DSH Desktop 的能力。5.4 日志归档与备份给 DSH 工作目录提个建议“归档”这个热搜词让我想到长期维护的问题。DSH Desktop 的工作目录里包含了会话记录、插件配置、模型连接信息等所有关键数据强烈建议你把它纳入备份体系。Windows 下用微软的“文件历史记录”或者第三方备份工具把D:\DSHWorkspace这个目录定期备份到外部磁盘。macOS 下直接用 Time Machine 就能覆盖到。如果哪一天你换电脑只需要在新机器上装好 JDK 17、Git、Maven再安装 DSH Desktop指定工作目录到备份出来的文件夹等它重新加载完之前所有会话和配置就都回来了。这也是我为什么强调安装时把工作目录放到一个独立的、方便备份的位置而不是随手选在默认应用数据目录里。我在实际使用中还有一个习惯每隔两个小版本更新 DSH Desktop 前先手动把工作目录里的config和plugins两个子目录打包压缩一次。因为跨版本升级时虽然官方承诺配置会自动迁移但谁也保不齐边角参数会报错有备份在手至少不会让自己陷入想回滚却回不去的尴尬。写在最后的小提醒如果你下载安装过程中一切顺利那我先恭喜你你已经拥有了一个可以在本地运行 Agent 的桌面环境。别急着去装各种花哨插件先花半天时间和 Agent 在默认配置下多聊几轮理解它的回答风格、工具调用习惯和出错方式。我自己的经验是把基础跑稳之后再做扩展效率远比一上来就堆功能高得多。遇到问题的时候不管提示信息多吓人先拆开来看是环境问题、配置问题还是插件冲突。大多数情况下日志里已经把答案写得很清楚了只是你还没习惯去读它而已。 
长河君 · 2026/9/8 17:40:57 · 阅读 1.2k DSH Desktop 安装教程：一键运行本地 Agent 的跨平台桌面客户端
说实话第一次看到 DSH Desktop 的时候我第一反应是这不就是把 DeepSeek Harness 的命令行换了个皮吗用了一周之后我承认这个判断有点肤浅。作为 DeepSeek Harness 官方推出的跨平台桌面客户端DSH Desktop 真正把“本地 Agent 一键运行”这件事变成了双击图标就能完成的日常操作。这篇文章我就把自己从下载、安装到配置本地 Agent 的完整过程记录下来给正在折腾 DeepSeek Harness 桌面端的朋友一份可以直接照做的教程。不管你是刚接触本地 Agent 的小白还是长期在命令行里摸爬滚打的老手只要想把 DeepSeek Harness 这把“好工具”真正用起来这篇 DSH Desktop 下载与安装教程都值得你花十分钟看完。我会把环境准备、下载安装、模型配置、插件安装和问题排查这些环节全部掰开揉碎尽量让你照着操作就能跑通。1. DSH Desktop 到底是什么解决什么问题1.1 本地 Agent 部署的“命令行地狱”该结束了在 DSH Desktop 出现之前本地部署 Agent 是怎么个体验拿我自己的经历来说最早玩 DeepSeek Harness 时装完 JDK 和 Git 之后光是配置文件就改了快两个小时。config.yaml里要写模型端点、API Key、工具链路径跑起来之后还得盯着终端日志看有没有报错。说白了这些开源工具的能力没问题但上手门槛实在不低。很多想尝试本地 Agent 的朋友不是卡在“不想折腾”而是卡在“不知道从哪里开始”。DSH Desktop 的出现恰恰是把这套东西收口到了桌面应用里。你不用再去记忆一长串命令也不需要反复修改 YAML 语法。安装完成后打开软件左侧导航栏能直观看到模型、插件、会话、日志这些模块。所有操作都变成了“点一下”“选一下”的事。对我来说它最大的价值不是把复杂功能变简单而是把所有需要记忆的上下文都变成了可见的界面元素。1.2 DeepSeek Harness 和 DSH Desktop 的分工这里要理清一个概念DeepSeek Harness 是一个用于承载本地 Agent 的运行时框架负责模型调度、工具调用、上下文管理这些底层能力而 DSH Desktop 是它的桌面客户端外壳负责把框架能力图形化呈现给你。我经常用一个类比来解释DeepSeek Harness 像是汽车的发动机和变速箱DSH Desktop 则是驾驶舱。你不一定要懂发动机怎么点火但你会踩油门、看仪表盘就够了。DSH Desktop 在后台会默认拉取对应版本的 DeepSeek Harness 核心库你只管在前台做配置。之所以叫“2026 年跨平台桌面客户端”是因为这一版在跨平台一致性上做了很大改进。Windows、macOS、Linux 三端共用了同一套底层运行时界面和配置格式也完全对齐。比过去那种“Linux 下命令行配置、Windows 下还得另外装模拟环境”的体验要省心太多了。2. 装 DSH Desktop 前环境准备工作不能省2.1 为什么必须装 JDK 17而不是 JDK 8 或 JDK 11DSH Desktop 本身是用 Java 生态构建的所以它对你的机器有一个硬性要求必须装 JDK 17 或更高版本。我知道很多老项目还在用 JDK 8但这里千万别图省事用旧版本因为 DeepSeek Harness 的核心库在编译时就直接用了 JDK 17 的语法结构比如record、sealed class这些特性旧版本根本跑不起来。JDK 的安装过程其实很简单关键在于环境变量要配对。Windows 用户如果是装 OpenJDK 17 或 Eclipse Temurin 17安装时直接勾选“设置 JAVA_HOME 环境变量”就能省掉后面一堆手动配置。macOS 用户建议直接用 Homebrew 安装brew install openjdk17装完之后要确认一下版本是否真的切换到了 JDK 17java -version echo $JAVA_HOME我见过不少人在这步翻车明明装了 JDK 17但java -version显示的还是旧版本。原因往往是系统 PATH 里旧版本的 java 路径排在了前面。Linux 用户可以用update-alternatives --config java手动切换Windows 用户去“系统环境变量”里把 JAVA_HOME 对应的 Path 条目往前移就好。2.2 Git 和 Maven 是 Agent 工具链的重要支撑DSH Desktop 安装时会自动把必须用的运行时组件内置到工作目录里但很多 Agent 的插件和工作流仍然需要依赖 Git 和 Maven。Git 的作用是什么DeepSeek Harness 里面的很多 Agent 插件会通过 Git 拉取工具仓库、更新技能模板甚至把会话上下文保存到 Git 仓库里做版本管理。如果你机器上没有 Git很多插件初始化会直接失败。Maven 则主要承担构建和依赖管理的职责。DSH Desktop 在安装插件时有些插件是纯脚本不需要编译但另一些需要调用 Maven 把 Java 代码构建成可执行的 jar 包。建议你提前把这两样都装上# Ubuntu / Debian sudo apt install git maven # macOS brew install git maven装完后的验证命令也建议跑一下git --version mvn -version确保输出正常再继续。2.3 跨平台环境差异Windows、macOS、Linux 各自要注意什么虽然 DSH Desktop 是跨平台客户端但三个系统的准备侧重点不完全一样。Windows 上最容易遇到的是杀毒软件误报。DSH Desktop 安装时会释放几个可执行文件到工作目录用来启动本地 Agent 进程某些杀毒软件会把这种“程序调用程序”的行为判定为可疑操作。建议安装时先临时关闭实时保护装完后再恢复同时把 DSH 的工作目录加进白名单。macOS 上要留意 Gatekeeper 策略。官网下载的 dmg 如果打不开提示“无法验证开发者”可以在 Finder 里右键点击安装包选择“打开”然后在弹出的窗口里再点一次“打开”。这不是什么破解手段只是把系统对未签名应用的拦截放行一次。Linux 上如果下载的是 AppImage 格式需要先给可执行权限chmod x DSH-Desktop-*.AppImage如果运行时报缺少 FUSE 库安装对应依赖即可。三个系统的环境变量配置方式不同但检查核心的思路还是一样的JDK 17 在 PATH 中Git 和 Maven 能被命令行直接找到。3. DSH Desktop 下载与安装实操全流程3.1 下载渠道别从乱七八糟的站点下关于下载我只推荐去 DeepSeek Harness 的官方发布渠道。因为 DSH Desktop 会直接运行本地 Agent 代码一旦安装包被篡改后果比普通软件严重得多。官方一般会提供 GitHub Releases 页面和官网下载中心两个入口你尽量选官网标记为“当前版本”的那个链接。下载时注意选择对应系统格式的安装包Windows 对应.exe或.zipmacOS 对应.dmgLinux 对应.AppImage或.tar.gz。文件名里通常会带上版本号比如DSH-Desktop-2.3.0-windows-x64.exe。建议顺手把校验值SHA-256 哈希也对一下相当于给安装包验明正身。3.2 Windows 安装双击安装并放在 D 盘更安心Windows 安装没什么特殊难点按照安装向导的指示点“下一步”就行。但有两点我从自己的使用经验里总结出来值得特别说一下。第一安装路径尽量避免默认的C:\Program Files\DSH Desktop倒不是说程序不能装在 C 盘而是 DSH Desktop 在工作时会缓存大量模型数据和索引文件。如果你 C 盘空间比较紧张之后就会遇到磁盘爆满然后 Agent 直接挂掉的情况。建议手动指定到 D 盘比如D:\Tools\DSH Desktop。官网倒是不会提醒你这些但实际跑起来差很多。第二安装完成后第一次启动会提示你选择“工作目录”。这个目录用来存 Agent 的会话记录、模型配置、插件数据。一定不要选在系统盘临时目录下给它一个固定的路径比如D:\DSHWorkspace。以后备份和迁移都会方便很多。首次启动进主界面后建议先进入“设置 - 运行时”确认它检测到的 JDK 路径是 JDK 17。如果检测不到手动指定到你安装 JDK 的根目录。Windows 的安装流程图大概是下载 exe - 双击运行 - 选安装路径 - 等进度条跑完 - 启动并设置工作目录。整个过程大概三五分钟。3.3 macOS 与 Linux 安装细节藏在权限和依赖里macOS 安装相对直观打开 dmg把 DSH Desktop 图标拖进 Applications 文件夹即可。首次打开如果被 Gatekeeper 拦右键选择“打开”的那一套前面已经提过这里不重复。打开后同样需要指定工作目录。Linux 的安装方式我更推荐 tar.gz 版本因为它不依赖 AppImage 的 FUSE 机制兼容性更好。解压到固定位置mkdir -p ~/apps/dsh-desktop tar -xzf DSH-Desktop-2.3.0-linux-x64.tar.gz -C ~/apps/dsh-desktop cd ~/apps/dsh-desktop ./bin/dsh-desktop如果是新装的系统可能缺少一些运行库。Debian/Ubuntu 用户建议先把基础依赖装上sudo apt install libgl1 libglib2.0-0 libxrender1 libxtst6运行后界面会和 Windows 版保持一致不用重新学习。Linux 下如果希望开机自启可以自己写一个 systemd service但这属于进阶操作不是必需。3.4 首次启动后的初始化检查无论哪个平台首次启动成功后会进入一个“初始化向导”大致做三件事选择模型后端、配置本地 Agent 入口、加载基础插件。这一步不用太紧张全部可以先选择默认后续随时可以修改。初始化完成以后主界面通常有四个核心区域会话列表、Agent 配置面板、模型状态栏、日志输出窗口。模型状态栏如果能显示“已就绪”说明 DSH Desktop 本身已经跑通了。这时候你还不能直接开始和 Agent 对话因为还没给它指定模型下一步就是配置模型。4. 一键运行本地 Agent模型、插件与验证4.1 模型接入本地模型还是云端 APIDSH Desktop 支持两种模型接入方式我先帮你把适用场景捋清楚。第一种是接入本地模型适合追求隐私和数据不出本机的场景。本地模型一般通过 Ollama、llama.cpp 这类工具启一个本地服务DSH Desktop 只要填写服务地址和模型名就能对接上。比如你用 Ollama 跑起了一个qwen2.5:7b在 DSH Desktop 的“模型设置”里选择“OpenAI 兼容接口”然后填写{ base_url: http://127.0.0.1:11434/v1, api_key: ollama, model: qwen2.5:7b }没错Ollama 内置了 OpenAI 兼容 APIDSH Desktop 可以直接复用这套协议。这种方式最大的好处是模型文件跑在你自己的机器上不产生额外的 API 费用但缺点是响应速度受限于你的显卡和内存。第二种是接入云端 API比如各种大模型的官方接口或中转服务。这种方式不需要本地强算力配置时只需要填入 API Key 和接口地址。DSH Desktop 同样走 OpenAI 兼容协议所以只要你的服务商支持这种协议基本都能直接连上。缺点自然是数据会经过外部服务器需要你自己权衡。从热搜词里的“怎样下载安装。有可以免费使用的大模型吗”能看出来很多人第一步想找免费模型。我的建议是先跑通流程优先用本地小模型7B 或更小足够验证 DSH Desktop 的所有功能之后再根据实际硬件条件升级模型。4.2 插件市场先装这几个常用插件DSH Desktop 的插件体系是 DeepSeek Harness 的一大亮点。主界面侧边栏里一般有“插件市场”入口里面按分类列出官方推荐和社区提交的插件。常见的有RAG 检索插件、图像识别插件、Web 搜索插件、代码执行插件和安全测试类插件。如果你只是想让 Agent 能回答日常问题、偶尔分析文本那么先装这两类就够基础工具集包含代码执行、Shell 执行、URL 请求这些通用能力。没有这些Agent 就是一个“只会聊天但动不了手”的模型。RAG 知识库插件把本地文档切块嵌入到向量库之后提问就能基于你的文档内容回答。安装插件不需要重启点击“安装”后等待状态变为“已启用”即可。注意一点插件市场里的版本和 DSH Desktop 主版本有对应关系不要强行安装兼容性标红的那类插件容易导致 Agent 启动时报错。对于热搜词里提到的“渗透模式”我提醒一句如果你搜到的是安全测试类插件请务必只在你自己拥有授权的测试环境里使用。本地 Agent 调用这类工具的风险比普通聊天大很多做好隔离和记录是基本底线。4.3 验证 Agent 是否真正跑起来了配置完成后你就可以直接体验“一键运行本地 Agent”了。在主界面点击“新建会话”输入第一句指令比如“帮我总结当前目录下notes.md文件的内容”。如果 Agent 正确调用了检索工具并给出了结构化回复说明整条链路已经打通。我通常还会做更严格一点的三步验证模型状态是否正常观察模型状态栏有没有从“未连接”变为“已就绪”。工具调用是否生效在日志窗口看有没有出现“调用工具 - 读取文件”之类的记录。会话是否持久化关掉 DSH Desktop 再重新打开刚才的会话记录应该还在。这三步全部通过你就可以认为 DSH Desktop 的基本功能已经稳定。后续真正需要花心思的地方反而是如何调 Agent 的提示词系统和插件组合策略这是另一个话题了。5. 安装和日常使用中的高频问题排查5.1 启动失败别急着卸载先看日志新手遇到 DSH Desktop 打不开或启动中途退出第一反应往往是卸载重装。我的经验是先花三分钟看日志大部分问题都能定位。日志文件在启动时会有明确的路径提示一般在工作目录的logs/子目录下文件名类似dsh-desktop.log。常见报错和处理方式我给你列一个简表报错信息可能的根因处理办法UnsupportedClassVersionErrorJDK 版本低于 17重装 JDK 17确认 JAVA_HOME 指向正确Port already in use: 8080端口被占用常见是本地服务修改 DSH Desktop 的端口配置或结束占用进程No such file or directory工作目录权限不足给工作目录添加当前用户的读写权限OOM killed内存不足调大 JVM 的-Xmx参数或减少同时加载的模型数量如果你在日志里看到的是Error invoking command一类信息先别急着查 DSH Desktop优先查你机器上的 Git、Maven 等外部依赖是否正常。我之前就遇到过因为 Maven 没装好安装插件时总是报错排查了一圈最后发现是 PATH 里指向了一个不存在的目录。5.2 内存和路径问题两个最容易忽略的坑本地 Agent 跑起来以后吃内存是真的毫不客气。默认配置下DSH Desktop 的 JVM 堆内存可能只给了 2GB而本地模型程序比如 Ollama也会占用几个 GB 的内存。如果你的机器是 16GB 内存同时开浏览器 IDE DSH Desktop很容易触发内存不足。解决思路有两个方向一是调整 DSH Desktop 的 JVM 参数在启动脚本或设置里把-Xmx从默认值调高到 4GB 或者 6GB二是如果你只是用一个小模型做测试可以把模型的上下文长度调低一些减小显存和内存占用。另一个非常值得说的问题是路径。DSH Desktop 工作目录、模型文件路径、插件缓存目录这三者最好都不要包含中文、空格或特殊字符。我不是故意制造洁癖而是这些路径如果在程序内部被拼接成命令行参数空格和中文很容易导致引号匹配错误最后杀进程都找不到原因。都放到纯英文路径下兼容性会好一个数量级。5.3 插件不生效与版本冲突检查这三个位置安装插件后不生效的情况也挺常见。我的排查顺序是先看插件是否真的启用了。有些插件安装成功后还需要在“插件管理”里再点一次“启用”而且启用后要求重启 Agent 会话。如果你没有重启插件只是处于“已安装、未加载”状态。再看插件版本。DeepSeek Harness 的插件市场里会有“兼容 DSH Desktop 版本”的标签。你要是强制装了给旧版 Harness 准备的插件运行起来大概率会报 API 不匹配。此时把插件卸载换个带“DSH 2.x”标签的版本。最后看插件运维依赖。比如图像识别插件往往需要 Python 环境或者 OpenCV 的库RAG 插件需要配置向量数据库。界面会提示“插件依赖缺失”按提示安装对应的外部依赖就可以。我在自己的项目里通常只安装不超过五个插件因为每个插件都会在 Agent 执行任务时增加上下文长度和决策分支。插件太多不仅拖慢响应时间还会让 Agent 在工具选择上犯迷糊明明该调用搜索工具却偏偏去调了文件读取工具。保持精简才能真正发挥 DSH Desktop 的能力。5.4 日志归档与备份给 DSH 工作目录提个建议“归档”这个热搜词让我想到长期维护的问题。DSH Desktop 的工作目录里包含了会话记录、插件配置、模型连接信息等所有关键数据强烈建议你把它纳入备份体系。Windows 下用微软的“文件历史记录”或者第三方备份工具把D:\DSHWorkspace这个目录定期备份到外部磁盘。macOS 下直接用 Time Machine 就能覆盖到。如果哪一天你换电脑只需要在新机器上装好 JDK 17、Git、Maven再安装 DSH Desktop指定工作目录到备份出来的文件夹等它重新加载完之前所有会话和配置就都回来了。这也是我为什么强调安装时把工作目录放到一个独立的、方便备份的位置而不是随手选在默认应用数据目录里。我在实际使用中还有一个习惯每隔两个小版本更新 DSH Desktop 前先手动把工作目录里的config和plugins两个子目录打包压缩一次。因为跨版本升级时虽然官方承诺配置会自动迁移但谁也保不齐边角参数会报错有备份在手至少不会让自己陷入想回滚却回不去的尴尬。写在最后的小提醒如果你下载安装过程中一切顺利那我先恭喜你你已经拥有了一个可以在本地运行 Agent 的桌面环境。别急着去装各种花哨插件先花半天时间和 Agent 在默认配置下多聊几轮理解它的回答风格、工具调用习惯和出错方式。我自己的经验是把基础跑稳之后再做扩展效率远比一上来就堆功能高得多。遇到问题的时候不管提示信息多吓人先拆开来看是环境问题、配置问题还是插件冲突。大多数情况下日志里已经把答案写得很清楚了只是你还没习惯去读它而已。