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

DeepSeek Harness Web UI使用教程配置模型、选择工作区、让AI替你改代码的3步实操【免费下载链接】deepseek-harnessDeepSeek Harness: Everything is a Plugin.项目地址: https://gitcode.com/gh_mirrors/de/deepseek-harnessDeepSeek 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 的每一步操作记录不满意直接让它继续修正即可。常见问题速查现象解决办法提示MISSING_CREDENTIAL去 Models 页重新保存密钥或配置对应环境变量提示UNKNOWN_MODEL在自定义提供方中补上缺失的模型 ID拉取模型列表返回 401检查 API key不支持GET /models的端点请手工录入模型输入框一直不可用确认已选中工作区且已选择有效模型继续探索Web UI 官方使用指南docs/user/guide/index.zh.md模型配置进阶docs/user/guide/providers.zh.mdWeb 服务端源码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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考