DeepSeek Harness 从安装到定制全攻略：打造你的专属 AI 生产力平台
作为普通用户，你可能对命令行望而生畏，但 DeepSeek Harness 恰恰能通过一个简单的浏览器界面，让你像使用 ChatGPT 一样轻松调用 DeepSeek 模型。这篇文章将用最“小白”的方式，带你一步步从零开始，安装、运行、甚至定制属于你自己的 AI 平台。
一、DeepSeek Harness 是什么？
简单说，它是一个由 DeepSeek 官方开源的“AI 工作台”。你可以在浏览器里和 DeepSeek 对话、管理历史记录、调整模型参数，甚至把它作为一个集成到日常工作的生产力工具。对于普通用户，你只需要掌握一个命令，就能启动它。
二、准备工作：安装 Node.js
DeepSeek Harness 跑在 Node.js 环境中，所以第一步是安装 Node.js。
- 打开浏览器，访问 Node.js 官网。
- 点击页面上的 “LTS” 版本下载按钮（推荐大多数用户选择）。
- 双击下载好的安装包，一路点“Next”，直到安装完成。
- 验证是否安装成功：按下
Win + R，输入cmd回车，打开命令提示符，输入：
node -v
如果看到类似 v20.x.x 的版本号，说明 Node.js 装好了。
提示：如果提示找不到命令，请重启命令提示符，或者重新安装 Node.js 并勾选“Add to PATH”。
三、快速启动：一条命令搞定（Run from npm）
官方提供了超简单的一键启动方式。在命令提示符（或 PowerShell）中输入：
npx @deepseek-ai/dsh web
注意：npx 是 Node.js 自带的工具，它会临时下载并执行命令。第一次运行时，系统会从 npm 仓库下载安装包，需要等待几分钟。
执行成功后，屏幕上会出现类似下面这样的信息：
Web UI is running at: http://127.0.0.1:3080
这时，打开你的浏览器（Chrome、Edge 都行），在地址栏输入 http://127.0.0.1:3080，回车！恭喜，DeepSeek Harness 的 Web 界面就出现了。
常见问题与解决办法
-
问题 1：提示“无法加载 @deepseek-ai/dsh”或网络超时
这通常是因为 npm 官方源在国内访问较慢。但别急，我们可以更换为淘宝镜像源（一次性使用）：
npx --registry=https://registry.npmmirror.com @deepseek-ai/dsh web
-
问题 2：提示
npx不是内部或外部命令说明 Node.js 没有正确安装，请重新安装并确保勾选了 PATH 选项。
-
问题 3：端口被占用（3080 端口无法访问）
可以给命令指定其他端口，比如：
npx @deepseek-ai/dsh web --port 3090
修改后，访问地址就变为 http://127.0.0.1:3090。
想要全局命令？
如果你不想每次都用 npx 下载，可以全局安装：
npm install -g @deepseek-ai/dsh
安装完成后，以后直接输入：
dsh web
四、进阶：从源码运行（Run from source）
如果你希望紧跟官方更新，或者想修改源码“魔改”功能，可以按下面步骤从 GitHub 下载源码运行。这需要安装另一个工具 Git（用于下载代码）。没有 Git 也没关系，可以直接在 GitHub 页面下载 ZIP 压缩包。
方式一：使用 Git（推荐，方便后续更新）
- 安装 Git：下载地址，一路默认安装。
- 打开命令提示符，输入：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
- 安装依赖并构建。官方使用
pnpm（一种更快的包管理器），如果你没有装过，先执行：
npm install -g pnpm
然后运行：
pnpm install
pnpm run build
pnpm dsh web
方式二：不用 Git，直接下 ZIP
- 打开 DeepSeek Harness GitHub 仓库。
- 点击绿色按钮 Code ▼，选择 Download ZIP。
- 解压到某个文件夹，例如
D:\deepseek-harness。 - 打开命令提示符，进入该文件夹：
cd /d D:\deepseek-harness
（注意 Windows 下要用 /d 切换盘符。）
- 然后同样执行：
npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web
源码运行可能遇到的问题
pnpm install卡住或报错：同样换源：
pnpm config set registry https://registry.npmmirror.com
-
pnpm run build报错找不到模块：尝试先执行pnpm install再pnpm run build，或者删掉node_modules文件夹后重新安装。 -
Windows 用户提示
pnpm不是内部或外部命令：请关闭命令提示符后重新打开；如果还不行，手动添加 npm 全局 bin 目录到 PATH。
五、定制你的 AI 生产力平台
DeepSeek Harness 不只是“开箱即用”，它还允许你进行个性化设置。比如：
1. 更换默认端口
如果你想把默认端口改成 8080：
npx @deepseek-ai/dsh web --port 8080
2. 设置 API 密钥（如果想连接远程模型服务）
有些功能需要 DeepSeek API Key。你可以在 Web UI 的“设置”面板中填入，或者通过环境变量方式设置：
# Windows PowerShell
$env:DEEPSEEK_API_KEY="你的密钥"
# macOS / Linux
export DEEPSEEK_API_KEY="你的密钥"
3. 更换主题、布局
Web UI 界面的右上角通常有设置按钮，可以切换浅色/深色主题，调整文字大小，甚至改变对话布局。如果还不够，可以修改源码中的 web 目录下的样式文件，但普通用户建议直接用界面设置即可。
4. 保存对话记录到本地
Harness 默认会将历史对话保存在本地文件中。你可以通过环境变量 DSH_DATA_DIR 指定数据目录，方便备份：
set DSH_DATA_DIR=D:\my-ai-data
npx @deepseek-ai/dsh web
这样，你的所有对话记录都会存到 D:\my-ai-data 下，重装系统也不怕。
5. 自定义模型参数（适合进阶玩家）
如果你在界面的“高级”设置中看到 temperature、top_p 等参数，可以按需调整。温度越低，回答越确定；温度越高，回答越有创造力。普通用户保持默认即可。
六、从 Web 界面到“生产力平台”
部署好之后，你可以：
- 日常问答：把浏览器书签固定到收藏夹，一个点击即可唤起。
- 写作助手：让平台帮你写邮件、文案、博客。
- 代码片段生成：虽然是给普通用户的攻略，但如果你写代码，也能用它快速生成小工具。
- 本机知识问答：后续可接入本地向量数据库，变成你的个人知识库。
其实，DeepSeek Harness 的本质是一个本地运行的“AI 网关”，你完全可以把它和 VS Code、Obsidian 等工具结合，让 AI 无处不在。
七、总结与下一步
以下是快速回顾：
| 操作 | 命令 | 说明 |
|---|---|---|
| 一键启动 | npx @deepseek-ai/dsh web | 最省事，适合大多数用户 |
| 全局安装 | npm install -g @deepseek-ai/dsh | 装一次，永久使用 |
| 从源码运行 | git clone ... && pnpm install && pnpm build && pnpm dsh web | 适合二次开发 |
| 更换端口 | --port 自定义端口 | 解决端口冲突 |
现在，你已经拥有一个专属的 AI 生产力平台。每次启动只需要敲一行命令，或者制作一个 .bat 或 .command 快捷脚本，双击即可运行——下一篇文章，我将教你怎么制作一键启动脚本。
如果在安装过程中遇到其他问题，欢迎在评论区留言，我会尽力解答。觉得有用的话，请点赞收藏，让更多人踏上 AI 生产力快车！
评论 0
暂无评论。