普通人也能用的写代码神器——Deepseek Harness 详细使用指南

发布时间:2026/8/29 4:43:40
普通人也能用的写代码神器——Deepseek Harness 详细使用指南 Deepseek Harness比work Buddy在长代码、任务方面占很多优势hairyf‑deepseek‑harness‑desktopTauri 轻量桌面版完整详细使用教程项目社区第三方桌面外壳底层完全使用原版 DeepSeek‑Harness 内核UI 界面和网页版一模一样无需手动安装 Node.js、Git、pnpm内置全部运行环境。至于为什么用第三方因为官方的对普通人来说门槛很高一、下载 安装打开发布页https://github.com/hairfy/deepseek‑harness‑desktop/releases/latestWindows 下载deepseek‑harness‑desktop‑xxx‑x64‑setup.exe安装包版本⚠️开源软件无微软数字签名 Windows 弹出【Windows 已保护你的电脑】→点击更多信息 → 仍要运行一路下一步安装不需要修改任何安装路径默认位置即可。二、第一次启动最关键避开插件卡死双击桌面图标启动程序。首次启动向导弹窗重点程序第一次打开会弹出推荐插件安装列表 插件清单DSH Win Terminal Inspector✅Windows 终端修复强烈勾选DSH Tauri✅桌面通信桥DSH Market✅可视化插件市场DSH‑better‑sidebar✅侧边栏美化安装插件时请打开加速器加速GitHub因为插件来源是GitHub如果不想装任何插件直接点【跳过全部】直接进入主界面零卡顿。等待程序自动下载 Harness 核心引擎然后就会打开「探索未至之境」主界面。三、第一步切换 Agent 运行模式针对 8G 内存页面上方下拉框默认标准模式 直接改成极简模式 (Windows)但是复杂任务我建议开默认模式优势仅开启 Git‑Bash 终端 文件读写关闭联网检索、子代理等高负载功能内存占用最低稳定性最好适合本地 GGUF 模型跑代码任务。标准模式全套工具、联网搜索内存开销大PTC 模式进阶 TS 脚本编排普通用户不用创造模式自定义插件高级调试用修改模式不需要重启页面立刻生效。四、第二步核心引擎版本选择打开右上角设置 →【核心引擎】 列表0.1.1‑rc.2最新0.1.1‑rc.1 旧版本 ✅优先选中0.1.1‑rc.2rc 数字越大越新修复 bug 越多如果后续出现闪退、推理异常回来切换旧版本 rc.1。底部提示文字「未检测本地核心」可以忽略桌面版自带运行环境无需手动用 npm 安装 dsh。五、两种模型接入方式在线 API / 本地 GGUF 模型方案 A在线 DeepSeek API云端模型不用下载 GGUF 文件设置 →【模型】添加官方 DeepSeek 服务商填入你从 DeepSeek 开放平台拿到的 API‑Key保存验证即可。方案 B本地 GGUF 模型不需要 API 密钥Harness 本身不能直接读取 GGUF 文件你需要先用 llama.cpp/ LM‑Studio / Ollama开启 OpenAI 兼容本地推理服务器再接入 Harness。 完整步骤启动 LM‑Studio加载你的 GGUF 模型开启本地服务器监听地址127.0.0.1端口1234回到 Harness 桌面版 → 设置 →模型 →【添加自定义 OpenAI 兼容服务商】服务商 IDlocal‑gguf显示名称本地 DeepSeek 模型基础 URLhttp://127.0.0.1:1234/v1API 密钥随便填一串字符例如xxx添加模型 ID填入 LM Studio 显示的模型 id保存然后顶部会话选择刚刚建好的本地模型即可本地推理。内存优化建议上下文窗口设置1024温度0.5关闭 MTP 推测解码减少内存暴涨。六、工作区Workspace选择左下角【选择工作区】 选择一个本地文件夹AI Agent 就只能读写这个文件夹里面的文件执行命令非常重要不要直接选 C 盘根目录建议新建文件夹D:\ai_work作为工作目录。七、插件可视化管理侧边栏【插件市场】 你以后想要美化侧边栏DSH‑better‑sidebar在这里一键点击安装不会再出现启动时卡死。 已经安装插件在这里启用 / 关闭 / 卸载。八、托盘后台运行关闭主窗口程序最小化右下角系统托盘Agent 任务不会中断继续后台运行。 右键托盘图标可以重新打开 UI 窗口重启后端服务完全退出终止所有 AI 任务九、基础对话使用流程选定【极简模式 Windows】选定工作文件夹选定你的模型云端 API / 本地 GGUF在输入框输入你的任务例如用C写一个局域网聊天小程序保存到当前文件夹AI 自动执行任务读写文件、运行终端编译代码。文件修改、终端执行高危操作的时候会弹出确认窗口需要你手动点击允许。十、常见故障排查清单对应你之前踩过的坑启动卡在下载插件直接关闭程序重启向导选择跳过插件内存占用太高、推理被截断切换极简模式调低上下文长度关闭推测解码Windows 终端命令执行失败确认勾选安装了「DSH Win Terminal Inspector」修复插件本地 GGUF 模型无响应检查 LM‑Studio 推理服务器有没有打开、端口号填写正确想彻底重置所有配置右键托盘退出程序删除文件夹C:\Users\你的用户名\.dsh所有会话和插件配置清空。