• 简体中文
  • DeepSeek Harness 接入

    DeepSeek 官方开源的 Agent 运行时(命令为 dsh),「一切皆插件」架构,一条命令在本机跑起图形界面(Web UI),MIT 许可。模型可自由更换——把 ByteSeek 配成 OpenAI 兼容服务商即可接入。

    开发者预览版

    DeepSeek Harness 目前处于开发者预览阶段,官方明确会有破坏兼容的变更。生产环境请锁定版本;文档与实际不符时以官方文档为准。

    下载安装

    要求 Node.js ^22.19.0>=24.0.0(奇数大版本如 Node 23 不受支持),先用 node --version 确认。

    npx 免安装(推荐)
    npm 全局安装
    cd 你的项目目录
    npx @deepseek-ai/dsh web

    官网见 deepseek.com/harness,官方文档见 deepseek-harness.github.io

    启动后 Web UI 默认运行在 http://127.0.0.1:3080 并自动打开浏览器;SSH 环境只打印地址,加 --no-open 可禁止自动打开。

    前置条件

    • dsh web 能正常启动并打开 Web UI
    • 已在API 密钥页面创建 OpenAI 格式分组的 Key

    配置

    1. 打开 Web UI,进入 Settings → Models
    2. 添加一个 OpenAI 兼容(OpenAI-compatible) 服务商,填写:
      • Base URL:https://tokens.byteseek.ai/v1
      • API Key:你的 sk- 密钥
      • 模型:模型广场上的精确 ID,例如 gpt-5.6-sol
    3. 保存后立即生效,无需重启服务。
    4. 回到会话页,先选择一个工作区目录(workspace),然后在模型选择器中切到刚配置的模型。
    配置要点
    字段填什么
    服务商类型OpenAI 兼容
    Base URLhttps://tokens.byteseek.ai/v1
    API Key你的 sk- 密钥
    模型 ID以模型广场为准,复合 Key 用户写带前缀的 ID

    API Key 与工作区都在浏览器界面里设置,不在命令行参数里。

    验证

    在 Web UI 里对配好的模型发一句话,正常回复即接入成功。扣费明细在使用记录页面可查。

    常见问题

    症状处理
    启动直接失败Node 版本不符:要求 ^22.19 || >=24,用 nvm install 24 && nvm use 24 升级后重开终端
    npx 卡住不动依赖解析问题,改用 npm i -g @deepseek-ai/dsh 后运行 dsh web
    端口被占用--port 换端口(默认 3080)
    401Key 填错,回 Settings → Models 重新粘贴
    403分组不含该模型或格式选错,见错误码清单
    升级后行为变化预览版破坏性变更正常,锁定版本或查官方更新说明
    © 2026 ByteSeek Limited. 保留所有权利。服务条款隐私政策免责声明