DeepSeek Harness

DeepSeek Harness（命令 dsh）是 DeepSeek 开源的 AI Agent 运行时，带一个网页界面，可以添加自定义模型提供商接入本站。

• 协议：OpenAI 兼容，或 Anthropic
• 地址：OpenAI 兼容填 https://tokenfunc.com/v1，Anthropic 填 https://tokenfunc.com
• 模型：DeepSeek 等，例如 deepseek-chat

1. 启动网页界面

   需要先安装 Node.js。然后运行：

   npx @deepseek-ai/dsh web

   首次启动要下载依赖，可能需要两分钟左右，期间没有进度提示，请耐心等待。启动后浏览器打开 http://127.0.0.1:3080。

2. 添加模型提供商

   进入 设置 → 模型 → 添加模型提供商，把卡片切换到 自定义模型 API，填写：

   字段	填写
   Provider ID	tokenfunc（只能用小写，保存后不能修改）
   显示名称	tokenfunc
   基础 URL	https://tokenfunc.com/v1
   API 协议	OpenAI Chat Completions
   API 密钥	sk-xxxxxxxxxxxxxxxx

   截图待补充DeepSeek Harness「添加模型提供商」切换到「自定义模型 API」后的表单tools/dsh-provider.png

   一个提供商只能用一种协议。如果还想用 Claude 模型的 Anthropic 协议，再建一个提供商：Provider ID 换一个名字（例如 tokenfunc-claude），API 协议选 Anthropic Messages，基础 URL 填 https://tokenfunc.com。

3. 添加模型

   在 模型目录 中点击 获取可用模型，勾选要用的模型。拉取不到列表时，手动填写模型 ID，例如 deepseek-chat。

   截图待补充「获取可用模型」弹出的模型勾选列表tools/dsh-models.png

4. 验证

   保存后，在对话框的模型选择器中选择刚添加的模型，发一句话，能收到回复即接入成功。

用配置文件配置

也可以在 ~/.dsh/profiles/web/cordis.patch.yml 中写入提供商（想对所有配置档生效则写在 ~/.dsh/cordis.patch.yml）：

- id: llm-pi-ai
  config:
    providers:
      tokenfunc:
        apiKeyEnv: TOKENFUNC_API_KEY
        api: openai-completions
        baseURL: https://tokenfunc.com/v1
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
        models:
          - id: deepseek-chat

密钥从环境变量 TOKENFUNC_API_KEY 读取，必须在启动 dsh 之前设置：

export TOKENFUNC_API_KEY="sk-xxxxxxxxxxxxxxxx"

常见问题