按理说，

DeepSeek 开源了一个名为 deepseek‑harness的项目。发布后迅速收获五万多 star。只是使用者在尝试使用时常常遇到的痛点包括：

• README 仅有一千七百字，缺少截图、功能列表和“到底是个啥”的说明。
• 安装流程需要多步确认或手动拉取源码，初学者容易卡住。
• 配置模型时接口不统一，添加提供方步骤繁琐。
• 缺乏直接的桌面客户端体验，只能在浏览器中打开本地服务。

下面以 macOS 为例。程序性梳理从安装到日常使用的完整流程，并针对上述痛点给出简化方案。

一、如何安装？

官方提供了三种安装方式：临时运行、全局安装还有源码一键安装。下面逐步演示并指出关键点。

1. 临时运行

# 临时运行
npx @deepseek-ai/dsh web

执行后会提示确认是否继续，输入 y 即可。完成后会在本地启动一个 Web UI。直接在浏览器中打开即可体验，无需任何额外配置。适合想快速尝鲜的同学，

2. 全局安装

# 安装至全局，可随时调用
npm install -g @deepseek-ai/dsh
# 启动 Web UI
dsh web

以后只需执行 dsh web 即可 开启服务。验证是否成功可以执行：

dsh --version

3. 源码一键安装

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

二、项目配置与使用流程

1. 启动并打开 UI

1. 在浏览器中访问 http://localhost:3000/。如果你之前更改过端口，请自行替换。
2. 首次进入会弹窗要求输入 DeepSeek API Key；若没有请前往 platform.deepseek.com/api_keys 生成并复制。
3. 切换语言这方面。左下角 Settings → Language → 中文，以便更好理解界面信息。说起来，
4. 添加工作区这方面。选择一个本地项目目录，接下来选择对应模型，根据任务需求切换即可。
5. 模型模式切换的观点是，默认标准模式；其他模式如 PTC、极简、创造模式可根据需求切换，以获得不同交互体验。
6. 插件 ：DSH-娱乐ter-sidebar 等插件可通过脚本一次性安装，在重启 DSH 并硬刷新后即可看到侧边栏 功能。

DHS-娱乐ter-sidebar 安装脚本：

curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-娱乐ter-sidebar/main/scripts/install.sh | bash
# 重启 DSH 并 Cmd/Ctrl+Shift+R 强制刷新页面即可看到新侧边栏。

三、模型配置细节

A. 官方预设供应商快速添加

• GLM CodePlan： Settings → Models → Add Provider → Provider = zai-coding-cn → 输入 API-KEY  → Save.
• 阿里千问 token-plan： Settings → Models → Add Provider → Provider = qwen-token-plan-cn → 输入 API-KEY  → Save.
• Xiaomi API-Key： Settings → Models → Add Provider → Provider = xiaomi → 输入 API-KEY  → Save.

注：官方预设已内置模型列表。只要有效的 API Key 就能自动拉取对应供应商的所有模型，无需手动配置每个模型名称。

B. 自定义模型供应商

1. 协议选择： 兼容 OpenAI 接口协议工具
2. API 地址： ark.cn-beijing.volces.com/api/coding/… ​ ​
3. User Token / API Key： 填入你自己的火山方舟 Token，并点击「获取可用模型」。若能成功拉取到列表，则说明配置正确；否则请检查地址与 Token 是否准确。
4. Select & Create Provider： 从列表中挑选你常用的几个模型。取消不必要的大批量选择，接下来点击「创建提供方」。建议先只保留10–20个常用模型，以免页面卡顿。

再看提示，火山方舟等大厂往往一次性返回上百个模型。一键全选功能暂未实现，这一步骤相对繁琐，但通过过滤常用名称可以大幅节省时间。

四、第三方桌面客户端

If you prefer a native experience without keeping a browser tab open and without needing Node.js environment:

• DHS Desktop 是社区基于 DeepSeek Harness 建立的开源桌面客户端，目前已获近两万颗星 ⭐️⭐️⭐️⭐️⭐️⭐️⭐️⭐️⭐️⭐️.
• Makes dsh run as a standalone application with system tray support and multiple windows.

. Download pre-built installers for macOS and Windows – one-click install and launch directly without any CLI commands. After installation。app will automatically start local dsh web service and open UI in a native window. This is ideal for users who want a lightweight local LLM workspace without juggling terminal sessions. If you prefer to stay in browser but want an auto-refresh shortcut,simply use Cmd/Ctrl+Shift+R after any plugin installation.

五、小结与接下来建议

• 已成功配置了 5 种主要国产 AI 模型供应商：
  • "DeepSeek" 与 "Xiaomi" 使用按量付费 APK Key；怎么说呢，“阿里千问” 与 “智谱” 使用 Coding Plan 标准模板 APK Key；“火山引擎” 则通过自定义 OpenAI 协议 APK Key 完成接入。※ 所有配置均在 Settings → Models 中完成，可随时增删修改。这里提醒**：** 在切换或新增提供方后请 刷新页面或重启 DSH 服务，以确保最新设置生效。

  
  安全提示
  ⚠ 请勿将私钥泄露给他人或上传至公共仓库。⚠ 确认插件来源可信后再安装。其实，⚠ 在生产环境使用前，请先进行小规模测试以评估成本与响应性能。🔐 采用 HTTPS + VPN 的网络环境可以降低网络传输风险。✅ 定期更新 DeepSeek Harness 与插件到最新版，以获得最佳兼容性与安全补丁。

  小结&接下来建议:-> - 已经完成对深度学习多家国产 LLM 的集成，可根据业务场景灵活切换；- 若对响应速度或成本敏感。可在 Settings 中调节请求参数，如温度、top_p 等；怎么说呢，- 如果想进一步自定义工作流，例如编写专属 Agent preset。可参考~/.dsh/.agent-presets/ 下文档操作；- 如遇到任何错误日志，请先查看终端输出，再结合官方文档定位问题；- 对于持续使用者，可以考虑将 DSH Desktop 部署为公司内部工具。配合程序托盘实现随叫随到；

  最终，你可以愉快地探索 DeepSeek Harness 的无限可能——Everything is a Plugin！祝玩得开心 🚀，

  今天分享就到此为止，下期再见👋。