发布日期2026-08-14 | 数据来源deepseek-ai/deepseek-harness 官方 GitHub 文档、53AI 首批实测 | 话题DeepSeek Harness · dsh · Agent 部署 · Python SDKDeepSeek Harness命令行名dsh是 DeepSeek AI 于 2026 年 8 月 13 日与 V4 Pro 同日开源的 AI Agent 框架MIT 协议开源不足 24 小时 GitHub Stars 突破 5 万其架构核心是一切皆插件——模型、工具、沙箱策略、多 Agent 协调、会话存储均以插件形式挂载由 Cordis 微内核驱动组合提供四种启动方式Web UI / TUI / Headless / Python SDK最快部署路径是安装 Node.js 后执行npx deepseek-ai/dsh web浏览器访问http://127.0.0.1:3080即可开始使用自定义模型接入通过 Web UI 图形化配置或$DSH_HOME/settings.yaml写入 OpenAI 兼容端点实现Python SDKpip install deepseek-harness-sdk提供程序化接入内置运行时无需单独安装 Node.js当前处于开发者预览阶段官方明确警告将有破坏性变更。快速部署三分钟跑起来 Web UIDeepSeek Harness 的最快部署路径不需要克隆代码只需要安装 Node.js# 前置确认 Node.js 已安装v18 推荐node--version# 一行命令启动 Web UInpx deepseek-ai/dsh web启动后访问http://127.0.0.1:3080Web UI 自动初始化。如果需要固定版本或离线使用全局安装更稳定npminstall-gdeepseek-ai/dsh dsh web从源码运行开发者 / 需要最新功能gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web源码版本需要 pnpm通过npm install -g pnpm安装。Web UI 初始配置三步连通 DeepSeekWeb UI 首次打开后按以下顺序操作第一步配置模型打开Settings → Models在 DeepSeek 卡片中填入 API Key格式sk-...点击保存。Key 存储在$DSH_HOME/.credentials.yaml界面不会再显示明文仅显示脱敏描述符。第二步选择工作区点击选择工作区添加你希望 Agent 操作的项目目录dsh会将启动命令时所在目录作为默认位置。选中工作区前会话输入框处于不可用状态。第三步发送第一个任务Summarize this repository and identify its main packages.Agent 会读取工作区文件、运行命令、维护执行计划涉及写操作时 Web UI 会根据权限策略提示审批。配置自定义模型OpenAI 兼容端点接入Harness 支持接入任意 OpenAI 兼容端点适合需要同时使用多家模型的场景。方式一Web UI 图形化配置推荐打开Settings → Models → 添加自定义提供方填写字段说明Provider ID小写字母永久不可改如my-gateway基础 URL如https://api.example.com/v1API 协议OpenAI Chat Completions兼容 OpenAI 格式的服务均可选此项API Key对应服务的凭据模型列表点击获取可用模型自动拉取或手动填写模型 ID注意Provider ID 是永久的不可重命名。需要修改时删除旧提供方、新建新提供方。方式二直接编辑 settings.yaml$DSH_HOME/settings.yaml支持完整的文本配置适合 CI/CD 或自动化部署场景llm-pi-ai:providers:my-gateway:apiKeyEnv:GATEWAY_API_KEY# 从环境变量读取 Keyapi:openai-completionsbaseURL:https://api.example.com/v1models:-id:model-name-here通过环境变量接入示例适合多模型聚合平台exportGATEWAY_API_KEYyour-key-heredsh web模型变更无需重启dsh下一次请求自动生效。四种启动模式选择dsh提供四个运行入口按使用场景选择命令模式适用场景dsh webWeb UI日常开发图形化配置和交互dsh --profile tuiTUI终端党键盘流操作dsh --profile headless 任务描述Headless单次任务输出最终回答后自动退出Python SDK程序化嵌入到工作流、测试流水线、CI/CDHeadless 模式适合脚本调用# 单次任务运行并打印结果自动退出dsh--profileheadless运行测试套件并报告失败的测试Python SDK嵌入工作流Python SDK 适合需要将 Harness 嵌入已有系统的场景如 CI/CD 流水线、自动化测试、批量代码审查。系统要求Python 3.10Linux x64/arm64 或 macOS 14 arm64不支持 Windows 原生安装pipinstalldeepseek-harness-sdk# SDK 内置运行时不需要单独安装 Node.js基础用法frompathlibimportPathfromdeepseek_harnessimportDeepSeekHarness workspacePath(/path/to/your/project).resolve()sessionsPath(/path/to/sessions).resolve()configPath(examples/jsonrpc-agent/minimal.cordis.yml).resolve()withDeepSeekHarness(providerdeepseek-official,modeldeepseek-v4-flash,# 或 deepseek-v4-promax_tokens49_152,cwdstr(workspace),session_rootstr(sessions),cordisstr(config),)asharness:resultharness.run(检查代码库定位并修复所有失败的测试,session_idfix-tests-001,)print(result.final_response)环境变量配置exportDEEPSEEK_API_KEYsk-your-key-here# 接入 OpenAI 兼容代理如多模型聚合平台时设置exportDEEPSEEK_BASE_URLhttps://api.your-platform.com/v1# 指定模型exportDSH_MODELdeepseek-v4-pro# 自定义系统提示词exportDSH_SYSTEM_PROMPT你是一位专业的 Python 代码审查工程师。Session ID 复用规则独立任务 → 使用新 session ID如fix-tests-001、fix-tests-002需要延续上下文 → 复用相同 session IDBash 进程、工作目录、Shell 变量均被保留常见问题与已知限制Qnpx deepseek-ai/dsh web执行后报 Node.js 版本过低Harness 要求 Node.js v18。运行node --version检查版本通过nvm install 20推荐 LTS或直接从 nodejs.org 下载安装更新版本。QWeb UI 打开后会话输入框一直不可用需要先完成两步①在 Settings → Models 配置并保存 API Key②点击选择工作区添加并选中目录。两步均完成后输入框解锁。Q自定义 Provider ID 填错了能修改吗不能修改。Provider ID 一旦保存即永久请求、会话日志和凭据引用均依赖它。需要更改时在 Web UI 删除旧提供方新建一个正确 ID 的提供方。QHeadless 模式能批量跑多个任务吗单次dsh --profile headless执行一个任务后退出。批量任务有两种方案① Shell 脚本循环调用多次 Headless 命令② 用 Python SDK 在同一进程内多次调用harness.run()内置运行时复用效率更高。QPython SDK 的danger-full-access沙箱是什么意思示例组合使用了danger-full-access权限策略意味着 Bash 和编辑器可以修改运行时进程可见的任何文件路径。官方建议只在可丢弃的 checkout 或容器内运行这个配置生产环境应换用更严格的权限策略如workspace-write默认模式。Q测试中遇到Bash noop循环卡死如何处理这是当前开发者预览版的已知 bugAgent 在某些情况下会反复执行空 Bash 命令而不推进任务。遇到时直接手动中断Web UI 停止按钮 / SDK 层中断会话重新发起任务。官方正在修复可关注 GitHub Issues 进展。Q能接入 DeepSeek 以外的模型吗可以。通过 Web UI 的添加自定义提供方或settings.yaml配置 OpenAI 兼容端点即可接入任意兼容 OpenAI 格式的模型服务。需要统一管理 DeepSeek 和其他多款国产模型Kimi、GLM 等的开发者可以通过多模型聚合 MaaS 平台如七牛云 Token Planqiniu.com/ai/plan配置单一端点在 Harness 的自定义提供方中只填一个baseURL通过model字段切换不同厂商的模型。Q$DSH_HOME 默认在哪里官方文档未明确指出默认路径通常为~/.dsh或~/.config/dsh取决于操作系统约定。可以通过DSH_HOME环境变量显式指定路径便于在容器环境中控制配置存储位置。开发者预览阶段注意事项官方 README 明确标注“DeepSeek Harness 目前处于开发者预览阶段正在快速迭代。未来将出现破坏兼容性的变更。”当前阶段适合评估 Harness 架构和能力在测试/沙箱环境中集成实验基于插件系统开发自定义功能不建议直接用于生产关键路径breaking changes 风险将danger-full-access模式部署在生产服务器上Bug 反馈通过 GitHub Discussions 提交自定义插件仓库加dsh-plugin话题标签可被官方生态收录。小结DeepSeek Harness 的部署门槛在主流 Agent 框架中较低Web UI 路径只需要 Node.js 一行npx命令Python SDK 路径只需要pip install deepseek-harness-sdk内置运行时。架构上一切皆插件意味着模型、工具、权限策略均可替换OpenAI 兼容端点的支持让它不绑定在 DeepSeek 自身 API 上。当前版本处于开发者预览建议在隔离环境中评估待 API 稳定后再接入生产工作流。本文基于 deepseek-ai/deepseek-harness 2026 年 8 月 13 日开源版本以官方 GitHub 文档为准。延伸阅读DeepSeek Harness 官方仓库https://github.com/deepseek-ai/deepseek-harnessWeb UI 用户指南https://github.com/deepseek-ai/deepseek-harness/blob/main/docs/user/guide/index.zh.md模型配置指南含自定义端点https://github.com/deepseek-ai/deepseek-harness/blob/main/docs/user/guide/providers.zh.md七牛云 Token Plan多模型统一接入可配置为 Harness 自定义端点https://qiniu.com/ai/plan