企业官网建设流程全解析

DeepSeek Harness Web UI使用教程：配置模型、选择工作区、让AI替你改代码的3步实操

【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness

DeepSeek Harness（简称dsh）是 DeepSeek 开源的 Agent 框架，主打"Everything is a Plugin"（一切皆插件）架构。它的 Web UI 让你在浏览器里就能完成配置模型、选择工作区、让 AI 修改代码这三件事。本教程面向新手，带你在 3 步内跑通 DeepSeek Harness Web UI 的完整实操流程。

一键启动 Web UI：只需一条命令

启动前只需安装 Node.js，然后在终端运行：

npx @deepseek-ai/dsh web

命令默认在http://127.0.0.1:3080启动 Web UI，并自动打开浏览器；加--no-open可只启动服务、不弹浏览器。如果你是从源码运行，流程见根目录 README.md：克隆仓库后依次执行pnpm install、pnpm run build、pnpm dsh web即可。

提示：dsh进程会把启动时所在的目录作为默认文件系统位置，所以建议先cd到你的项目目录再启动。

第1步：配置模型——填入 DeepSeek API 密钥

打开设置 → 模型（Settings → Models）。你会看到内置的 DeepSeek 卡片，只需填入 API 密钥并保存，模型路由立即生效，无需重启服务器：

几个新手友好的细节：

• 密钥是"只写"的——保存后页面只回显脱敏描述，不会明文回显；
• 密钥存储在$DSH_HOME/.credentials.yaml，设置文件里只保留凭据引用；
• 已配置的成功方会自动出现在会话输入框上方的模型选择器中，选中的模型同时成为新会话的默认模型。

不想用 DeepSeek？添加自定义模型提供方

页面下方的Add a custom provider按钮可以接入任意 OpenAI 兼容网关（公司网关、自建服务等）。表单需要填写 Provider ID（小写、永久不可改）、显示名称、Base URL、API 协议和 API key：

在Model catalog中点击Fetch available models可自动拉取端点下的模型列表，省去手工录入。完整的模型配置指南（含图像输入、请求兼容性等进阶内容）见 providers.zh.md，常见错误如MISSING_CREDENTIAL、UNKNOWN_MODEL都有对应排查建议。

第2步：选择工作区——告诉 AI 改哪个项目

点击选择工作区，添加你启动dsh时所在的项目目录，然后选中它。⚠️ 注意：选中工作区之前，会话输入框是不可用的。这一步相当于给 Agent 划定"活动范围"——它后续读写文件、运行命令都会发生在这个目录内。

第3步：让 AI 替你改代码——发送第一条指令

新建会话，直接输入自然语言需求，例如：

总结这个仓库，找出主要包并说明各自职责

Agent 可以读取和编辑工作区文件、运行命令、委派子任务并维护计划。如果按当前权限策略某项操作（比如写文件）需要审批，Web UI 会先弹出一张审批卡片询问你，确认后才执行——安全可控是它的设计底线。改完代码后，你可以逐条查看 AI 的每一步操作记录，不满意直接让它继续修正即可。

常见问题速查

继续探索

• Web UI 官方使用指南：docs/user/guide/index.zh.md
• 模型配置进阶：docs/user/guide/providers.zh.md
• Web 服务端源码：packages/web/
• 架构总览（了解"一切皆插件"的设计）：docs/architecture.zh.md

至此，你已经用 DeepSeek Harness Web UI 完成了从配置模型到 AI 改代码的完整闭环。接下来不妨挑一个真实项目，让 Agent 帮你修复一个 bug 或补一组测试，感受"插件化 Agent 框架"的实际威力 🚀

【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harness