dsh

约 1233 字大约 4 分钟

2026-08-13

新闻

使用

npx @deepseek-ai/dsh web

或

# 全局安装
npm -g install @deepseek-ai/dsh
# 运行
dsh web

重要

启动报错：--expose-internals 问题，使用以下命令启动：

node --expose-internals $(which dsh) web

四个模式

标准模式提供完整的工具组合；
PTC 模式通过模型生成的一段代码组合多轮工具调用；
极简模式仅保留一个 shell 工具与一个文件编辑工具，用于最小化环境下的模型基准测试；
创造模式可以检查当前运行时、在内存中试验 Cordis 插件，并据此组合和创作新的模式。

链接

url	description	remarks
DeepSeek Harness 开发者预览版：一切皆插件	DeepSeek Harness 官网	官方简称 `dsh`
https://github.com/deepseek-ai/deepseek-harness	dsh 官方Github仓库
cordiverse/cordis: Meta-Framework of Spatiotemporal Composability	cordis 官方Github仓库
Cordis 入门 DeepSeek Harness	cordis 官方Github仓库项目简介中所挂的链接	指向 DeepSeek 的 github.io 文档页由 DeepSeek 编写的最小 Harness 插件开发示例
dsh-plugin · GitHub Topics	社区插件

DeepSeek Harness 开发指南：deepseek-harness/docs/development.zh.md
DeepSeek Harness 架构指南：deepseek-harness/docs/architecture.zh.md
Cordis 入门：Cordis 入门 | DeepSeek Harness
Cordis 教程：Cordis 教程 | DeepSeek Harness

每一次运行都有迹可循

模型看到的一切都会写入仅追加设计的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度，以及每一次上下文注入。在 Trajectory 视图中，你可以按来源查看这些信息。恢复、分叉、检索与回放也共享同一份事件流。

pdf

LaplaceYoung/dsh-book-deepseek-harness: 《深入理解 DeepSeek Harness：一切皆插件的 Agent 架构》——源码级架构拆解科普书：37 个章节文件、PDF、Mermaid 图与写作规范

Electricitysheep/dsh-handbook: DeepSeek Harness (dsh) 新手教程白皮书——从 0 到 1 上手DSH：安装/插件开发/性能调优/同模型多Agent实测对比（中英双语 + PDF + Demo）

插件

安装

# 已经安装了 dsh
dsh plugin --profile web add <package-name>[@version]
# 未安装 dsh 时
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add <package-name>[@version]

package-name: 包名
version: 版本号（可选）

提示

插件安装在： C:\Users\pc\.dsh\profiles\web\node_modules

其他命令

# 已安装插件列表（第三方）
dsh plugin --profile web list

# 卸载
dsh plugin --profile web remove <package-name>

# 查看当前所有的插件（包括官方）
dsh web --dump-config [ | grep <关键字>]
dsh web --dump-config [ | findstr <关键字>]

WebUI 美化

鲸鱼娘皮肤系列(深海女仆工坊)：Small-tailqwq/dsh-deep-whale

手绘悬浮鲸鱼：lhh010/dsh-ui-whale

QQ2006：LaplaceYoung/dsh-qq2006

gov网站风格，不过插件是另起3081端口和dsh web的3080进行交互，可以使用这个项目来研究另起端口的方式：ExElectron/dsh-gov-portal

工具

基于md文件的工作流编辑器（并不是工作流运行器）：kanghelyu/dsh-deepseek-flow

可撤销 write / edit 两个工具所做的更改：QinLuza/dsh-file-undo

在规划与实现的过程中，agent 会先主动检索 AIGC Radar 精选项目库：Kaixxrua/dsh-aigc-radar

余额监控与提醒 + 充值入口：feibi-mochi/deepseek-harness-control-center

自定义API厂商

如果需要模型支持图片输入，自定义厂商之后，需要更改 ~/.dsh/settings.yaml 添加 input：

llm-pi-ai:
  providers:
    deepseek:
      baseURL: https://api.commandcode.ai/provider/v1
      models:
        - id: deepseek/deepseek-v4.1-flash
          name: V4.1 Flash
          maxTokens: 256000
          contextWindow: 1000000
          input:
            - text
            - image
      apiKeyEnv: DEEPSEEK_API_KEY

更新0.1.7-rc.2：~/.dsh/cordis.patch.yml

注意

有一个问题是：使用 command-go-goat 提供商，使用 openai-responses 端点的时候，选取思考强度会报错。但是手动添加一个 deepseek 提供商，使用相同 apikey ，使用思考强度就不会报错。

~/.dsh/cordis.patch.yml
- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      command-go-goat:
        displayName: Command Go GOAT
        apiKeyEnv: COMMAND_GO_GOAT_API_KEY
        api: openai-responses
        baseURL: https://api.commandcode.ai/provider/v1
        models:
          - id: deepseek/deepseek-v4.1-flash
            name: DeepSeek V4.1 Flash
            contextWindow: 1000000
            maxTokens: 32000
            input:
              - text
              - image
            reasoningEfforts:
              low: low
              high: high
              max: max
      deepseek:
        baseURL: https://api.commandcode.ai/provider/v1
        apiKeyEnv: COMMAND_GO_GOAT_API_KEY
        models:
          - id: deepseek/deepseek-v4.1-flash
            name: V4.1 Flash
            input:
              - text
              - image
            contextWindow: 1000000
            maxTokens: 32000
            reasoningEfforts:
              low: low
              high: high
              max: max

TEMP

cd D:\WorkSpace\AI\deepseek-harness
$env:DSH_HOME = "D:\WorkSpace\AI\deepseek-harness-plugins\.dsh-test"
pnpm dsh web --port 3199

OpenCode

这里示例定义了两个提供商

opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "RawChat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "RawChat",
      "options": {
        "baseURL": "https://new.sharedchat.cc/codex",
        "apiKey": "sk-xxx"
      },
      "models": {
        "gpt-5.5": {
          "name": "gpt-5.5"
        }
      }
    },
    "commandcode-goat": {
      "npm": "@ai-sdk/openai",
      "name": "Command Code GOAT",
      "options": {
        "baseURL": "https://api.commandcode.ai/provider/v1",
        "apiKey": "user_xxx"
      },
      "models": {
        "deepseek/deepseek-v4.1-flash": {
          "name": "DeepSeek V4.1 Flash",
          // 思考
          "reasoning": true,
          "interleaved": {
            "field": "reasoning_content"
          },
          // 支持的输入输出类型
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          // 上下文、单次输出长度
          "limit": {
            "context": 1048576,
            "output": 384000
          }
        }
      }
    }
  },
  "model": "commandcode-goat/deepseek/deepseek-v4.1-flash"
}