DeepSeek Harness 怎么用？超详细部署使用指南！
DeepSeek Harness（简称 DSH）是 DeepSeek 官方放出来的 agent 运行框架，装在自己电脑上，用一条命令启动，之后可以在浏览器里用，也可以纯命令行用。它和网页上的聊天工具不一样：它能读你指定目录里的文件、调用工具、按你给的规则把一件事分成好几步做完。 这篇按 Windows 环境把完整流程走一遍——装运行环境、打开技能开关启动网页版、配密钥和工作区，再用一个纯文本文件做出第一个技能，最后删掉它看它怎么失效。命令全部按 Windows PowerShell 重写，原始教程是 macOS 写法，那些命令在 Windows 上不能直接照抄。 DeepSeek Harness 是什么 DeepSeek Harness 是 DeepSeek 官方的开源 agent 框架，包名 @deepseek-ai/dsh，通常简称 DSH。它跑在你自己的电脑上，通过 API 调用 DeepSeek 的模型干活，本身不是一个网站，也不需要单独安装——有 Node.js 环境，一条 npx 命令就能拉起来。 harness 这个词在这里是「把模型套上去干活的那套东西」。模型只会输出文字，真正能读文件、能调工具、能一步步推进任务的，是外面这层框架。DSH 干的就是这件事。 几个词先分清 agent：能自己拆解任务、调用工具、多步推进的模型用法，区别于一问一答的聊天。 harness：把模型接进真实环境的那层框架，负责读写文件、调工具、管会话。 插件：DSH 的构造单位，从模型适配器到网页界面都是插件，可以禁用、替换、重写。 技能：一个叫 SKILL.md 的纯文本文件，用大白话告诉模型某类场景该怎么做，不用写代码。 它有两种用法：网页版启动后在浏览器里对话，界面上能看到模型每一步在干什么；纯命令行模式直接在终端里问一句答一句，适合塞进脚本。两种模式共用同一套配置，差别在后面几节会具体说——网页版有几个默认设置，是新手最容易卡住的地方。 「万物皆可插件」指的是哪件事 DSH 给自己的第一句介绍是「Everything is a Plugin」。这句话不是修辞：在 0.1.0-rc.6 版本里打开它的插件列表，能数出 133 个插件，而模型适配器、工具注册表、会话记录、网页服务器全在这份名单里，连 agent 的主循环本身也是其中一个。 所以「插件」在 DSH 里不是「主程序之外的附加功能」，而是这个产品的构造方式。插件列表里能看到的这几个，都是平时被当成「内核」的东西。 插件名它其实是什么 llm模型适配器，跟 DeepSeek 接口说话的那一层 agent-loopagent 的主循环，整个产品的心脏 tools工具注册表，管模型能调用哪些工具 session会话记录 webserver你正在用的这个网页服务 ui-sidebar网页左边那条侧边栏 133 这个数字会随版本变，本文实测的是 0.1.0-rc.6，时间是 2026 年 8 月 13 日。后面做出来的那个技能，同样以插件的身份被加载，走的是完全相同的一套机制。 第一步，把 Node.js 装上 DSH 用 JavaScript 写成，需要 Node.js 这个运行环境，版本要 v20 或更高。 先打开命令行：按 Win + X，在菜单里选「Windows PowerShell」或「终端」；也可以按 Win + R，输入 powershell 回车。 步骤1、查本机有没有装过 node --version 输出了版本号，比如 v22.11.0，说明已经装过，直接跳到下一节。提示 不是内部或外部命令 就是没装，继续往下走。 步骤2、下载 LTS 版安装包 打开 nodejs.org，点页面上标着 LTS 的那个绿色按钮，下载 .msi 文件。LTS 是长期支持版，也就是给普通用户用的稳定版本。 步骤3、双击安装包，一路下一步 安装路径保持默认即可，中间不需要改任何选项。 步骤4、关掉命令行窗口，重新开一个 这一步不能省。安装程序改的是系统环境变量 PATH，已经开着的那个窗口读的是启动时的旧变量，不重开就永远查不到 node。很多人卡在这里，以为是没装成功。 装好了的判断标准 重开窗口后再执行一次 node --version，看到 v20 或更高的版本号，才算这一节过了。 第二步，带着技能开关启动网页版 DSH 的网页版出厂时把技能功能关着，纯命令行模式则默认开着。 这个差异会带来一个很难查的现象：技能不生效，界面却不报任何错，模型只会按自己的理解编一段回答。所以开关要在启动命令里带上，不能等启动完再补。 步骤1、用记事本写一个配置文件 打开记事本，把下面这六行原样粘进去，注意每个 disabled: false 前面有两个空格。 enable-skills.yml 的内容 - id: skill-filesystem disabled: false - id: tool-skill disabled: false - id: skill-badge disabled: false 步骤2、存到用户目录下，名字叫 enable-skills.yml 点「文件」里的「另存为」，先把「保存类型」改成「所有文件」，地址栏填 %USERPROFILE%，文件名填 enable-skills.yml。 这个文件全是英文，编码选「ANSI」或「UTF-8」都行，但不要选「带有 BOM 的 UTF-8」——BOM 是文件开头的几个隐藏字节，解析 YAML 的一方可能把它连同第一行一起读进去。 步骤3、回读一遍，确认存对了 Get-Content "$env:USERPROFILE\enable-skills.yml" 应该看到六行，三个 - id: 各带一行 disabled: false。 习惯命令行的话，这三步也可以用一条命令代替，效果一样： "- id: skill-filesystem`n disabled: false`n- id: tool-skill`n disabled: false`n- id: skill-badge`n disabled: false" | Set-Content -Encoding ascii "$env:USERPROFILE\enable-skills.yml" 其中 `n 是 PowerShell 的换行写法，-Encoding ascii 是为了避开 PowerShell 5.1 的 -Encoding UTF8 会写 BOM 这个问题。 步骤4、带着 --patch 启动 npx @deepseek-ai/dsh web --patch "$env:USERPROFILE\enable-skills.yml" 末尾的 --patch 不能漏。漏掉之后 DSH 照样能跑、页面照样能打开，只是技能不生效，这是整个流程里最容易踩的一处。 第一次运行要下载几十兆的文件，屏幕上没动静是正常的，等一到几分钟。中途如果问 Ok to proceed? (y)，输入 y 回车。 起来了的判断标准 窗口里出现 dsh web: http://127.0.0.1:3080 这一行才算成功。这个窗口要一直开着，关掉 DSH 就停了。 步骤5、确认技能开关真的生效了 浏览器打开 http://127.0.0.1:3080，关掉首次启动的测试期提示。 进 Settings 里的 Plugins，在 Plugin list 标签下搜 skill，skill-filesystem 和 tool-skill 两项应该都标着 Enabled。标着 Disabled 就是启动时漏了 --patch，按 Ctrl + C 停掉重来。 页面打得开也可能是旧进程，先查 3080 端口 这一节单独拎出来，是因为它造成的现象最有迷惑性：页面能打开、界面一切正常，但你改的配置全都不生效。 真正的原因是上一次的 DSH 没关干净还占着 3080，新启动的那个报 EADDRINUSE 直接退出了，浏览器连上的一直是旧进程。 步骤1、看端口上有没有东西 netstat -ano | findstr ":3080" 没有任何输出就是干净的，可以直接启动。有状态为 LISTENING 的行，就记下那一行最后一列的进程号。 步骤2、结束占着端口的进程 taskkill /PID 进程号 /F 把「进程号」换成上一步记下的那个数字。 步骤3、确认清干净了再启动 再跑一次步骤 1，直到没有任何输出为止，然后重新启动 DSH。 Win8 及以上也可以用 Get-NetTCPConnection -LocalPort 3080 -State Listen 查，输出里的 OwningProcess 就是进程号，用 Stop-Process -Id 进程号 -Force 结束。两种写法效果一样，netstat 那套在 Win7 上也能用。 判断依据看启动输出，不看浏览器 启动之后先回头看那个 PowerShell 窗口：出现 dsh web: http://127.0.0.1:3080 才算成功，出现 EADDRINUSE 就是端口没清干净。浏览器能不能打开页面，在这件事上不构成证据。 第三步，配好 API 密钥 DSH 要调用 DeepSeek 的模型，得先有一个 API 密钥。这一步全程在网页上点，不用碰命令行。 步骤1、到开放平台创建密钥 打开 platform.deepseek.com 注册登录，找到「API keys」，创建一个新的，复制那串以 sk- 开头的字符。密钥只在创建时显示一次，页面关掉就看不到了。 步骤2、把密钥填进 DSH 第一次打开 DSH 会自己弹出填密钥的框，粘进去点 Save and continue。跳过了也没关系，之后从 Settings 的 Models 里找到 DeepSeek 那一行补填。 填好了的判断标准 Settings 的 Models 里，DeepSeek 右边会出现一个绿点。没有绿点就是没配上，多半是粘贴时带进了空格或换行。 密钥等于账户的钥匙 这串字符能直接消耗你账户的额度，不要发到聊天群、不要贴进代码文件、不要放进会同步到网上的笔记。怀疑泄露就回平台把它删掉重建一个，旧的立刻作废。 第四步，选一个工作区，发送按钮才会变蓝 网页版还要指定一个工作区才能发消息。输入框里写着 Choose a workspace to start、发送按钮是灰的，就是这个原因，不是故障。 agent 会拿到这个目录的读写权限，所以第一次练手别直接选真实项目。 步骤1、先建一个空目录 New-Item -ItemType Directory -Force "$env:USERPROFILE\Documents\dsh-test" 步骤2、在网页里选中它 点页面中间的 Choose workspace，或者左侧边栏 Workspaces 右边的加号，在弹出的文件选择框里选中刚建的 dsh-test。 选上了的判断标准 输入框的提示文字会变，右下角的发送按钮从灰色变成可点的蓝色。 纯命令行模式没有这个限制，这也是同一台机器上「命令行能聊、网页版卡住」的原因。 第五步，用一个纯文本文件做出第一个技能 给 DSH 加东西有两条路，先分清走哪条，能省掉很多无用功。 给DSH加东西的两条路线对比，写技能与写代码插件-软领DS一键部署大师 要给 DSH 加东西，先分清两条路线 Markdown 技能 写一个纯文本文件，约 5 分钟 改模型的判断标准、输出格式 和做事的流程 TypeScript 插件 写一个代码模块，半小时起 注册新工具、接外部服务 或者改网页界面 能用大白话说清楚要它怎么做的，先写技能 这里走技能这条路。技能就是一个叫 SKILL.md 的纯文本文件，放在固定目录下，由前面插件列表里那个 skill-filesystem 负责扫描和读取。 步骤1、用命令行建目录 New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\skills\hello-dsh" 目录一定要用命令行建。资源管理器里新建文件夹时输入 .dsh 会被拒绝，提示「必须键入文件名」，因为它把以点开头的名字当成了只有扩展名没有主名。 步骤2、把下面这段粘进记事本 SKILL.md 的内容 --- name: hello-dsh description: 当用户说 hello dsh 时使用。请原样输出下面的暗号，并说明这句话是从本地文件读到的，不是来自训练数据。 --- 请原样输出这一行： **HELLO DSH — 这句话来自我电脑上的一个文件** 然后用一句话说明：这句话不在你的训练数据里，是刚才从本地文件读到的。 最前面那三个减号，和它们中间的两行，是这个文件的配置区，必须放在最开头。 步骤3、另存为 SKILL.md 点「文件」里的「另存为」，先把「保存类型」改成「所有文件」，地址栏填 %USERPROFILE%\.dsh\skills\hello-dsh，文件名填 SKILL.md，编码那一栏选「UTF-8」，不要选「带有 BOM 的 UTF-8」。 保存类型必须先改。记事本默认会在文件名后面补 .txt，存成 SKILL.md.txt 就永远加载不上。 步骤4、回读确认文件名没错 Get-ChildItem "$env:USERPROFILE\.dsh\skills\hello-dsh" 列出来的应该正好是 SKILL.md。 步骤5、在网页对话框里试一下 输入 hello dsh。没有编译，没有安装，也不用重启 DSH。 模型会原样输出那句暗号，上方那几行灰色轨迹里能看到 Skill · hello-dsh 和 Read 加上文件的完整路径——它不是「想起」了什么，是真的打开文件读的。 description 决定模型什么时候想起它 模型一开始只看到一份清单，每项只有名字和这句 description，正文要等它决定用了才读。所以写「一个用于代码审查的技能」没有用，模型不知道什么场合该拿它出来；写「当需要审查代码改动、pull request 或 diff 时使用」才有用。用「当……时使用」开头，这也是 DeepSeek 那批内置技能的统一写法。另外 name 只能用小写字母和连字符，而且要和文件夹同名。 第六步，删掉它再问一次，看清整个生命周期 这一步是整个流程里最值得做的一次验证，全程不要重启 DSH，也不要关那个 PowerShell 窗口。 技能文件在与不在时DSH的三种反应，全程不重启-软领DS一键部署大师 全程不重启 DSH，只动一个文件 1 文件在，轨迹里出现 Skill · hello-dsh 暗号原样输出 2 文件夹删掉，轨迹里出现 Read Error, not found 模型说读不到文件，拒绝凭记忆复述暗号 3 文件放回去，轨迹里又出现 Read 加文件路径 暗号原样回来，中间没有重启、安装或注册 步骤1、删掉整个技能文件夹 Remove-Item -Recurse -Force "$env:USERPROFILE\.dsh\skills\hello-dsh" 步骤2、不重启，直接再问一次 回网页再说一次 hello dsh。轨迹里会出现读取失败的那一行，模型会明确说这次读不到那个文件，并且拒绝把上一轮见过的暗号再复述一遍——理由是暗号的来源是磁盘上的文件，而那个文件已经不在了。 步骤3、把文件放回去，再问一次 按上一节的步骤重新存回去，仍然不重启，暗号又回来了。 文件出现功能就在，文件消失功能就没了，中间没有任何重启、安装、注册的动作。对比一下平时熟悉的软件：装浏览器插件要重启浏览器，装编辑器扩展要重载窗口，这里都不需要。 删掉之后还能输出暗号，是怎么回事 那是它在照着这一轮对话里已经有的内容复述，不是真的读了文件。点左上角 New Session 开一个新会话再试一次，结果就准了。 不想把内容发到云端时，把 DeepSeek 装在本机 前面配密钥那一步，本质上是在说一件事：DSH 默认把你的问题和工作区里的内容发到云端接口去处理。写公开代码、查资料，这没什么问题；但如果打算让它读的是合同、客户资料、内部文档，很多人会希望这些内容根本不要离开这台电脑。 这是另一个层面的选择——DSH 决定 agent 怎么扩展，模型跑在哪是另一件事。想让模型跑在本机，「软领DS一键部署大师」的 DeepSeek本地部署 负责的就是这一步：把 DeepSeek 模型直接装到自己的 Windows 电脑上，不用申请密钥，也不用把对话内容交给别人的服务器，所有数据本地存储。 本地大模型 处理的是「该下哪个尺寸」这个决策。它会先识别本机的 CPU、内存和显卡，把能跑得动的模型档位标出来，省掉自己去查显存要求、下错了再删掉重来这一轮。 本地知识库 则对应上面说的资料场景，把自己的文档导入进去，让模型基于这些内容回答，而整个过程不需要联网把文件传出去。界面是中文的，Win7、Win10、Win11 都能装。 常见误区 以为页面能打开就说明启动成功了 3080 端口被上一次没关干净的进程占着时，新进程会直接退出，浏览器连的是旧的那个。判断依据只能是 PowerShell 窗口里那行 dsh web: http://127.0.0.1:3080，看到 EADDRINUSE 就是没起来。 以为技能不生效会报错 不会。网页版关着技能功能时，模型看不到那份技能清单，只会按自己的理解编一段听起来像模像样的回答，界面上一条警告都没有。所以这一项要靠 Plugin list 里的 Enabled 状态来确认，不能靠回答对不对来倒推。 把 name 写成大写或者驼峰 name 只能是小写字母加连字符，写成 Hello_DSH 这种加载不上。配置区里的字段名同理，把 user-invocable 写成 userInvocable 会导致整个文件被丢弃，只留一条警告，同样不报错。 把技能目录建得太深 技能目录只扫一层。.dsh\skills\hello-dsh\SKILL.md 是对的，再往里套一层文件夹就扫不到了。文件名也必须正好是 SKILL.md，记事本自动补上的 .txt 是这一项最常见的原因。 出问题时按这张表对 现象先查什么怎么处理 提示 node 不是内部或外部命令装完 Node 之后有没有重开窗口关掉 PowerShell 重新打开再试 启动时报 EADDRINUSE3080 端口有没有被占netstat -ano 查到进程号后 taskkill 改了配置怎么都不生效浏览器连的是不是旧进程杀干净 3080 上的进程，重新启动 发送按钮是灰的，打不了字有没有选工作区点 Choose workspace 选一个空目录 Models 里 DeepSeek 没有绿点密钥有没有粘完整重新复制，检查有没有混进空格或换行 命令行能用技能，网页版不能启动时有没有带 --patch停掉重启，用带 --patch 的完整命令 技能写了但模型看不到文件名、目录层级、name 写法确认是 SKILL.md、只嵌一层、name 全小写 大家常问 DSH 需要单独安装吗 不需要。npx 这条命令会自动下载并运行它，第一次跑要等下载完成，之后启动就快了。要装的只有 Node.js 这一样。 不用网页版，只用命令行行不行 行，而且命令行模式默认就开着技能功能，不用配 --patch，也不用选工作区。上面那些坑基本都是网页版特有的。 技能和插件到底差在哪 技能改的是模型的做事方式——判断标准、输出格式、流程；插件给的是新能力，比如调外部接口、加界面面板、挂生命周期钩子。能用大白话说清楚要它怎么做的，写技能就够了。 技能里的内容会不会被模型记住 不会当成记忆。每一轮之前 DSH 都会重新扫一遍技能目录，模型是当场把文件读进来用的。文件改了下一轮就是新的，文件删了下一轮就没有了。 用 DSH 就一定要联网调云端模型吗 DSH 本身是通过 API 调用模型的，所以要密钥、要联网。如果关心的是资料不外传，可以用「软领DS一键部署大师」把 DeepSeek 装在本机跑，对话和知识库都留在自己的电脑上，具体功能以软件界面显示为准。 这篇的版本和出处是什么 实测版本是 DSH 0.1.0-rc.6，时间 2026 年 8 月 13 日，原始流程出自开源教程仓库 pingfanfan/hello-dsh 的 docs/hello-dsh.md，本文按 Windows 环境重写了全部命令与操作路径。插件数量、界面文案会随版本变化，以你机器上实际显示的为准。
老师用本地DeepSeek备课出题怎么用？一键部署实操指南
备课出题是老师每周都绕不开的活。写教案框架、按知识点出练习题、再配答案和解析，一套下来经常比上课本身还费时间。想让 AI 搭把手，可校内讲义、单元测卷这些材料要贴进网页版 AI，不少老师心里犯嘀咕，赶上晚上高峰还得排队。 另一条路是把 DeepSeek 装进自己电脑。用「软领DS一键本地部署大师」，不用自己装 Ollama，也不用敲命令，在界面里装好模型服务、部署一个兼容模型，就能在对话页让它出教案框架和题目初稿。先说清楚一件事：模型给的是初稿，知识点和答案必须老师复核，这一步省不得。 本地模型能帮老师做哪几类事 拆开看，备课出题里适合交给模型的是三类体力活。一是教案框架：告诉它年级、学科、课时和教学目标，让它先列出教学环节和时间分配，老师在骨架上改，比对着空白文档硬想快得多。二是题目初稿：指定知识点、题型和数量，它能批量给出题干、选项和解析草稿。三是变式改编：把一道现成题改成不同难度、不同情境的版本，做分层练习正合适。 定位要摆正，它是助教，把关的还是老师。草稿它来写，对错老师来判，后面会专门讲怎么复核。 本地DeepSeek辅助备课出题的三类用法结构图-软领DS一键本地部署大师 备课里的体力活，先让模型打草稿 本地 DeepSeek 部署在自己电脑上 教案框架 按课时列环节大纲 题目初稿 按知识点批量出题 变式改编 同一题换难度情境 老师复核 改完才算定稿 模型出草稿，定稿前都要过老师这一关 从安装到出第一份题，照这个顺序走 整个过程在中文界面里点选完成，不用打开命令行敲 ollama run 这类命令，办公室电脑装一次就行。 备课出题上手步骤 下载安装「DS一键部署大师」并打开。 进入「模型」页面，按页面提示安装模型服务。 打开“仅兼容”筛选，从推荐模型里挑一个适合这台电脑的。 点击部署，等模型文件下载完成。 切到「对话」页面，选中刚部署好的模型。 输入出题要求，比如“八年级物理，浮力，出5道选择题并附解析”。 要求提得越具体，初稿越能用。年级、教材版本、知识点、题型、数量、难度尽量一次说全；生成后哪题不满意，接着追问“第3题换成实验情境”就行，不用整份重来。课程标准、教材目录这类常用资料可以放进本地知识库，文档保存在本机，出题时能贴得更近教材。 出完题先别用，复核这三样 模型有个老毛病：答案写得笃定，算错了也一样笃定。理科计算题的数值、文科知识点的表述，都可能一本正经地出错。本地部署改变的是资料存放的位置和使用方式，并不改变模型会犯错这件事。 定稿前过三遍 一查答案：理科题逐题验算，别只看解析写得顺不顺。二查表述：知识点说法对照教材和课标，模型可能混用其他版本教材的讲法。三查难度：模型不了解你的学生，题目深浅要按自己班的学情再调。 备课出题中交给模型和老师把关事项的分工对照表-软领DS一键本地部署大师 分工清楚，备课才省心 可以交给模型 题干和选项初稿 解析和评分点草稿 教案环节大纲 同知识点变式题 必须老师把关 答案是否算对 知识点表述是否合教材 难度是否匹配学情 课标表述和学时安排 模型管草稿，老师管对错 可以把模型初稿当成一位新来实习老师交的作业：确实省事，但签字之前你得亲自看过。 大家常问 学校配的办公电脑，跑得动吗 打开模型广场的“仅兼容”筛选，软件会按这台电脑的配置推荐能跑的模型。日常备课出题，参数小一些的模型也够用；但别指望普通办公机去跑超大参数的模型，量力选择就好。 出的题答案能直接印给学生吗 不建议。题干和解析初稿可以改着用，答案必须自己验算一遍，理科计算题尤其要逐题核对，确认无误再排版印刷。 教案和试卷资料放进去，会传到网上吗 本地知识库的文档和记录保存在本机数据库里。要注意，安装模型服务、下载模型、软件更新这些环节仍然需要联网，不是装完就再也不碰网络。 断网的教室里还能出题吗 已经部署好的模型可以在本机对话，出题、改教案都行。联网搜索、下载新模型这些功能没网就用不了，提前在有网的地方把模型部署好。 跟直接用网页版DeepSeek比，图什么 网页版打开就能用，不挑电脑；本地部署的好处是对话记录和备课资料留在自己电脑上，高峰期也不用排队。两边各有适合的场景，在意资料去向和使用稳定的老师，本地这条路值得试。
DeepSeek本地部署模型服务一直转圈启动不了怎么办
在本地部署 DeepSeek 的过程中，模型服务一直转圈、迟迟启动不了，大概是最让人心里没底的场景：界面不报错，也不知道它在等什么。不少人第一反应是卸载重装，折腾一晚上发现还是转圈。 这篇只讲怎么解决它。转圈多半和网速无关，真正常见的原因是三个：服务进程没退干净、端口被旧程序占用、防火墙拦住了通信。按先重启服务、再查端口、最后看防火墙的顺序排查，不行再用「软领DS一键本地部署大师」重装模型服务。 转圈的时候，软件到底在等什么 先把机制说清楚，排查才有方向。模型服务是跑在你电脑上的一个本地程序，启动后会监听一个本地端口，客户端界面通过这个端口和它通信。转圈的意思是：界面发了请求，一直没等到回应。 回应等不到，无非几种情况。服务进程压根没起来，比如上次退出时没退干净，残留进程把位置卡住了；或者端口被别的程序占了，新服务起不来；再或者服务起来了，防火墙和安全软件把这条通信拦在半路。首次安装模型服务确实要联网下载文件，那个阶段慢是网络问题；装好之后启动还转圈，基本就和网速没关系了。 客户端经本地端口连接模型服务的两处卡点-软领DS一键本地部署大师 一直转圈：请求卡在半路的两个位置 客户端界面 发出请求后等回应 本地端口 两边通信的通道 模型服务 负责加载和运行模型 卡点一：端口被旧程序占用 卡点二：防火墙拦住了通信 排查顺序：先重启，再查端口，最后看防火墙 第一步，彻底重启服务。注意“彻底”两个字。点右上角的叉常常只是把窗口收起来，软件还在托盘里挂着。正确做法是在任务栏托盘图标上右键退出，再打开任务管理器，搜一下 ollama，看到相关残留进程就结束掉，然后重新打开软件进「模型」页。还不行？重启一次电脑，卡死的进程会被清干净。 第二步，查端口占用。以前自己手动装过 Ollama 的电脑，这一步命中率很高。Ollama 默认监听 11434 端口，而且常被设成开机自启，旧服务在后台占着端口，新的模型服务自然起不来。按 Win+R 输入 cmd，执行 netstat -ano | findstr 11434，能看到占用端口的进程号，去任务管理器结束它，顺手把旧版 Ollama 的开机自启也关掉。 第三步，检查防火墙和安全软件。打开 Windows 安全中心，进「防火墙和网络保护」，在「允许应用通过防火墙」里确认软件没被拦。装了第三方安全软件的，去拦截记录里翻一遍，看到拦截就添加信任。 别急着反复重装 端口被占和防火墙拦截不是重装能解决的，装十次也还是转圈。先把这三步走完，确认环境没问题，重装才有意义。 重启服务查端口放行防火墙的三步排查流程-软领DS一键本地部署大师 三步排查，从成本最低的开始 1 重启服务 托盘右键彻底退出 结束残留进程 必要时重启电脑 2 查端口占用 旧 Ollama 常占端口 netstat 查看占用进程 结束进程并关自启 3 放行防火墙 允许应用通过防火墙 安全软件添加信任 查看拦截记录 按从易到难的顺序来，别一上来就卸载重装 环境查完还不行？重装一次模型服务 三步都过了一遍，端口没冲突、防火墙也放行了，服务还是起不来，那就要怀疑上次安装的文件本身有问题，比如下载中途断网，留下了不完整的文件。这种情况直接用「DS一键部署大师」重新装一遍模型服务，下载、解压、启动和连接检查都由软件处理，不用自己去折腾 Ollama 的安装包和配置。 重装模型服务的步骤 先按前面第一步，彻底退出软件并结束残留进程。 重新打开「DS一键部署大师」，进入「模型」页面。 页面出现模型服务提示时，按提示重新安装，等待下载和解压完成。 服务就绪后，打开“仅兼容”，从推荐模型里挑一个点部署。 切到「对话」页面发一句话测试，能正常回答就说明服务恢复了。 大家常问 转圈多久算不正常 首次安装模型服务要下载文件，网络一般的话等几分钟很正常。要是超过十来分钟一点变化没有，或者之前一直用得好好的、这次打开就转个不停，就按重启、端口、防火墙的顺序排查。 我以前自己装过 Ollama，冲突概率大吗 比较大。旧版 Ollama 常被设成开机自启，一直占着默认端口。把它退出或者关掉自启，再重启软件，不少转圈问题当场就好。 是不是我电脑配置太差才启动不了 服务启动和模型运行是两回事。配置不够的典型表现是部署后回答很慢，而服务本身起不来，多数和进程残留、端口、防火墙有关，和显卡强弱关系不大。 需要自己改端口号吗 一般不需要。「DS一键部署大师」会处理模型服务的安装和连接，用户要做的是把占用端口的旧程序退出，而不用去动配置文件。 关了防火墙还是不行怎么办 先把防火墙恢复开启，长期关着有安全风险。然后走重装路线：结束残留进程，重新安装模型服务。重装几次仍失败的话，通过软件内的客服反馈具体报错，比自己瞎猜快。
明明有显卡DeepSeek本地部署却用CPU跑？回退原因与解决
电脑里明明装着独立显卡，DeepSeek 部署完一开聊，CPU 占用直接顶满，GPU 那栏却几乎没动静，回答一个字一个字往外蹦。显卡没坏，多半是模型服务在启动时判断这块卡“不能用”，悄悄退回了 CPU，而且全程不报错。 回退不是随机发生的，常见原因就两个：驱动太旧，显卡压根没被识别；或者显存装不下你选的模型。这篇只讲一件事，怎么分清这两种情况，以及用「软领DS一键本地部署大师」在部署前就把坑避开。 先确认：真是CPU在硬扛吗 别急着重装软件，先看证据。打开任务管理器的性能页，让模型回答一个长问题，同时盯两处：CPU 占用是不是长时间接近满载，GPU 的专用 GPU 内存有没有随提问明显上涨。显存纹丝不动、CPU 却顶满，回退基本坐实。 有个细节容易骗人。GPU 页默认展示的是 3D 引擎的占用，本地模型做的是计算任务，走的不是那条曲线。把其中一个小图切换成 CUDA 或 Compute 再看才准。N 卡用户也可以在命令行输入 nvidia-smi，显存占用和进程列表一眼看清。 GPU在干活与CPU在硬扛的信号对照表-软领DS一键本地部署大师 同一台电脑，两种跑法的信号对照 GPU 在干活 CPU 在硬扛 出字速度 明显更快 一字一顿 专用GPU内存 提问时上涨 几乎不动 CPU 占用 中低水平 长时间接近满载 右边三个信号同时出现，基本可以确定回退到了 CPU 回退就两条路：驱动没过关，或显存装不下 模型服务启动时会先探测显卡。驱动版本太旧，CUDA 组件对不上号，探测直接失败，这块卡在它眼里等于不存在，所有计算全丢给 CPU。这种回退是全有或全无的，没有中间状态。 显存不够是另一种。显卡认出来了，但你选的模型太大，显存塞不下全部模型层，运行时会把装不下的那部分放进内存，交给 CPU 算。溢出的层越多，速度越接近纯 CPU，表面看 GPU 有点动静，体感还是慢。它不报错，悄无声息，最容易被当成显卡坏了。 两种情况怎么区分？看显存占用。nvidia-smi 里一点占用都没有，先怀疑驱动，去显卡官网把驱动升到较新版本再试；显存占了一截、内存同时涨了一大块，就是模型选大了，换小一号参数或更低量化的版本。 笔记本用户多看一眼 双显卡笔记本在省电模式下，程序可能被系统分给核显。到 Windows 的显示卡设置里，把模型服务程序指定为“高性能”显卡，重启软件再测一次。 驱动与显存两步回退判断路径-软领DS一键本地部署大师 显卡到底给不给用，就看这两道关 模型服务启动 驱动认得这块卡？ 是 显存装得下吗？ 是 显卡在跑 否 显卡直接被无视 去官网更新驱动 否 装不下的层给CPU 换小一号或低量化 两道关都过了，显卡才会真正接管计算 用DS一键部署大师，把判断放到部署之前 上面这套排查，手动部署时全得自己来。「软领DS一键本地部署大师」的思路是把判断前置：模型广场里打开“仅兼容”，软件会按当前电脑的配置过滤模型，显存带不动的不进推荐列表，从源头减少部署完才发现在用 CPU 硬扛的情况。用户不用自己装 Ollama，也不用敲命令，模型服务的安装和启动都在界面里完成。 让显卡真正干活的部署顺序 先去显卡官网把驱动更新到较新版本，这一步放在装软件之前做。 下载安装「DS一键部署大师」，打开进入「模型」页面。 页面提示模型服务未安装的话，按提示装好并等它启动。 在模型广场打开“仅兼容”，从推荐模型里挑一个。 点击部署，等模型下载完成。 切到「对话」页提问，顺手开着任务管理器，看专用 GPU 内存是否上涨。 部署完 GPU 还是没动静？回到上一节的判断路径，先查驱动再查显存，一次只改一个变量，好确认到底是谁起了作用。 大家常问 更新了驱动还是用CPU跑，接着查什么 查模型是不是选大了。显存装不下时会把一部分层丢给 CPU，速度照样慢。换小一号参数或更低量化的版本再测，多数情况就有明显变化。笔记本用户还要确认程序没被分到核显上。 “仅兼容”是按什么筛的 按当前电脑的硬件配置过滤模型广场里的模型，配置带不动的不会出现在推荐里。想看全部模型可以关掉筛选，但硬上大模型很容易触发回退，部署前最好心里有数。 没有独立显卡是不是就没法用 能用。小参数模型可以靠 CPU 跑，速度会慢一些。正因为有独显时体验好得多，才值得把回退问题解决掉，别让显卡闲着。 怎么确认部署后显卡真的在干活 任务管理器性能页看专用 GPU 内存，提问时明显上涨就是在用；N 卡也可以用 nvidia-smi 看进程列表。最直观的还是出字速度，从一字一顿变成成句往外出。 显存不大，模型怎么挑不容易回退 别按“能装多大装多大”来选。打开“仅兼容”按推荐挑，通常是参数小一些或量化更低的版本，先让显卡满速跑顺，之后想换大的再升级硬件也不迟。
DeepSeek本地部署，0.5B小模型能做什么？
看到 Qwen2.5 0.5B、Qwen3 0.6B 这类小模型，很多人会问：参数这么小，装到本地到底能做什么？尤其是老电脑、轻办公本、边缘小主机，大家更关心它是不是有实际用途。 比较稳的答案是：把它当成本地 AI 入门档和快速试用档。用软领DS一键本地部署大师做 DeepSeek本地部署时，可以顺手试这些 Qwen 小模型，用来验证环境、跑基础问答、做短文本处理，但不要把它想成全能助手。 小模型真正适合做什么 0.5B、0.6B 的优势不是“更聪明”，而是轻。它适合放在低配机器上做轻量任务：短句问答、固定格式改写、标题草稿、简单分类、关键词提取、客服话术初稿、表格字段解释。你给的问题越短、背景越明确，它越容易给出能用的回答。 这类模型还适合做边缘场景的原型验证。比如你想知道一台小主机能不能跑本地对话，或者想给内网资料做一个很基础的问答入口，先用 Qwen2.5 0.5B、Qwen3 0.6B 试通流程，比一上来下载大模型更省时间。 0.5B小模型用途分层-软领DS一键本地部署大师 适合 可试 谨慎 短问短答 改写提取 模板话术 轻量知识库 边缘原型 模型对比 复杂推理 长文档总结 大型代码改造 注意边界小模型的短板也很明显：长上下文、多步推理、严肃事实判断、复杂代码工程都容易不稳。模型服务安装、模型下载、更新、联网搜索和会员服务等环节可能需要联网；安装包可免费下载，收费项以软件界面显示为准。 低配电脑怎么判断值不值得试 如果你的目标是“先跑起来”，小模型比大模型友好很多。软领DS一键本地部署大师的模型广场会按推理、对话、代码、视觉等类型展示模型卡片，并标出推荐、兼容和显存要求，还能识别 CPU、内存、显卡，用“仅兼容”筛掉明显不合适的模型。 这不等于所有电脑都能流畅跑。没有独显也可以看兼容结果尝试轻量模型，但速度、响应长度和稳定性要看本机配置。家用电脑想做 DeepSeek本地部署，通常应先从 0.5B、0.6B、1.5B 这类小模型摸清边界，再考虑更大的 R1 或 Qwen 系列。 隐私方面，本地对话和知识库数据会保存在本机数据库，适合不想把草稿、内部 FAQ 随便上传的场景。但“本地运行”不应理解成全程永远不联网，下载模型和使用联网搜索时仍要按实际功能处理。 怎么用，步骤尽量简单 不想装 Ollama、配环境、敲命令，可以用软领DS一键本地部署大师走图形界面。它面向 Win10/11，默认模型目录是 C:\ds-deploy，支持后台下载和断点续传；可以部署多个模型，但同一时间只有一个模型处于活跃状态。 基础步骤安装后进入“模型”页，若提示模型服务未安装，按提示让软件处理下载、解压和启动。打开“模型广场”，搜索 Qwen 或按对话类型筛选，优先勾选“仅兼容”。选择 Qwen2.5 0.5B、Qwen3 0.6B 这类轻量模型，点击部署。模型启动后进入对话页，先用短问题、短材料测试基础问答，再决定是否切换更大的模型。 大家常问 Qwen2.5 0.5B、Qwen3 0.6B能离线用吗？模型服务和模型部署好后，普通本地对话可以在本机运行。安装服务、下载模型、更新、联网搜索等环节可能联网，不能写成全程永久离线。 0.5B小模型适合写代码吗？适合解释一小段代码、写简单函数或给命名建议。不适合接手大型项目改造，也不适合做高可靠代码审查。 低配电脑没有显卡还能试吗？可以先看软件里的兼容和推荐结果，轻量模型比大模型更适合试跑。但速度取决于 CPU、内存和模型大小，不能保证所有机器都流畅。 它和DeepSeek R1 1.5B该怎么选？Qwen 小模型偏快速问答和轻量文本处理；R1 类模型更适合推理任务。电脑配置一般时，先用小模型试通，再按需求切换。 用软领DS一键本地部署大师还要自己装Ollama吗？用户不用自己安装、配置 Ollama，也不用敲命令。软件会处理模型服务相关流程；底层实现以软件实际版本为准。
一键部署DeepSeek前要准备哪些条件？本地部署前先看这三样
一键部署 DeepSeek 前要准备哪些条件？说穿了就三样：磁盘上留够空间，网络能稳定下载，再弄清楚自己这台电脑能跑哪个档位的模型。前两样自己花一分钟就能查清，第三样最让人犯怵，也最常被教程一笔带过。 用「软领DS一键本地部署大师」的话，第三样可以直接交给软件：模型广场里打开兼容筛选，列表会按你这台电脑的情况把能跑的模型挑出来。这篇把三个条件逐个说清，照着核对完再装，基本不会中途卡住。 三个条件：磁盘、网络、配置心里有数 先说磁盘。DeepSeek 模型文件不是小东西，参数小的也有几个 GB，参数越大体积越大，模型服务本身还要占一块。装之前看一下目标磁盘的剩余空间，留出比模型体积多一截的余量，别等下载到九成才发现盘满了。 再说网络。本地部署不等于从头到尾不联网，模型服务安装和模型文件下载都要走网络。几个 GB 的文件，在慢网络下就是干等，挑个网络稳定的时段下载会省不少事。 配置这块，很多人卡在“我这显卡到底行不行”。手动部署要自己查显存、对参数表；DS一键部署大师把这一步做进了兼容筛选，后面细说。 部署前三项准备与结果的关系-软领DS一键本地部署大师 装之前，把三件事各看一眼 磁盘空间 模型文件几GB起步 目标盘留出富余 稳定网络 模型服务要下载 模型文件也要下载 兼容筛选 配置拿不准 让软件替你判断 三样都确认过，部署基本一次走完 磁盘和网络，栽跟头最多的两项 磁盘的坑，多数时候不是空间不够，是装错了地方。不少人 C 盘常年紧张，模型一下载直接顶满，系统跟着变卡。动手之前看一眼各分区的剩余空间，把富余最大的盘留给模型文件。 占用项 大概情况 建议 模型服务 本地运行环境，首次安装要下载 按页面提示装完，中途别关软件 模型文件 几 GB 起步，参数越大体积越大 部署前确认剩余空间明显大于模型体积 日常余量 模型加载、系统运行都要空间 别把磁盘用到只剩一点点 网络这边，最怕的是下载中断。好消息是内置指南说明支持断点续传，断了以后重新进入模型卡片能接着下，之前的进度不会白费。顺带一提，手动部署时你可能还要操心 ollama pull 拉取超时、11434 端口被占用这类问题；走一键部署，这些不用你管，模型服务由软件负责装好、跑起来。 一个容易误会的点 本地部署省的是部署完成之后的事：已部署模型可以在本机对话，知识库资料保存在本地。装的过程该联网还是要联网，模型服务和模型文件都得先下载到电脑里。 准备好了，照这个顺序装 三个条件核对完，剩下的交给软件。全程在中文界面里点选，不需要命令行。 部署顺序 下载并安装「DS一键部署大师」。 打开软件进入「模型」页面，按提示安装模型服务。 在模型广场打开“仅兼容”，看列表里筛出来的模型。 从推荐模型里挑一个，点击部署，等模型下载完成。 切到「对话」页面，选中已部署的模型开始用。 兼容筛选就是给“配置心里没数”的人准备的。打开“仅兼容”后，列表只留能在当前电脑上跑的模型，不用自己去查显存对照表。有一点要说实话：筛选保证的是能跑，跑得快慢是另一回事。参数越大的模型，对显存和磁盘的要求越高，加载和响应也更吃配置。老电脑从轻量档起步，够用了再考虑换大的。 模型参数分档与配置要求阶梯-软领DS一键本地部署大师 参数越大，磁盘和显存占用越高 轻量档 1.5B 左右 配置一般的电脑先试这档 中间档 7B / 8B 主流独显跑起来比较稳 体积和显存占用明显变大 大参数 14B 及以上 高配显卡再考虑 下载更久，占盘更多 自己这台能跑哪档？用模型广场的兼容筛选确认 大家常问 没有独立显卡，能装吗 软件可以装。模型能不能跑，要看兼容筛选给出的结果，部分轻量模型对配置要求低，在配置一般的电脑上也可能出现在推荐里。要提醒一句，参数小的模型能力有限，别拿它对标在线满血版的效果。 磁盘要留多少空间才够 没有固定数字，看你选哪个模型。模型文件几个 GB 起步，参数越大体积越大，模型服务本身也占空间。稳妥做法是让剩余空间明显大于模型体积，下载完还得留出系统正常运行的余量。 下载到一半网断了，要重来吗 不用。内置指南说明支持断点续传，网络恢复后重新进入模型卡片继续部署，之前下载的部分不会白费。 要不要先自己把 Ollama 装好 不用自己装。打开软件后按「模型」页面的提示安装模型服务就行，下载、解压、启动这些都由软件处理，全程不用碰命令行。 兼容筛选靠谱吗，会不会推荐跑不动的模型 筛选依据的是当前电脑的情况，目的就是把明显跑不动的挡在外面。当然能跑和跑得流畅是两回事，同样在列表里，参数大的响应更吃配置。拿不准就先部署推荐里最轻的那个试试，效果不够再换。
提示