DeepSeek Harness开源Agent框架深度解析：一切皆插件的架构革命

# Harness 配置文件示例 (dsh.config.yaml)
model:
  plugin: "@deepseek-ai/plugin-model-v4-flash"
  config:
    api_key: "${DEEPSEEK_API_KEY}"
    temperature: 0.3

sandbox:
  plugin: "@deepseek-ai/plugin-sandbox-docker"
  config:
    image: "node:20-slim"
    memory: "2g"

tools:
  - plugin: "@deepseek-ai/plugin-tool-file-editor"
  - plugin: "@deepseek-ai/plugin-tool-shell"
  - plugin: "@deepseek-ai/plugin-tool-web-search"
    config:
      engine: "google"

session:
  plugin: "@deepseek-ai/plugin-session-sqlite"
  config:
    path: "./.dsh/sessions.db"

// Code Mode SDK 示例：模型生成TypeScript代码来编排多步操作
import { tools } from '@deepseek-ai/dsh-code-sdk';

async function refactorComponent(filePath: string) {
    // 读取文件
    const content = await tools.file.read(filePath);
    
    // 分析依赖
    const deps = await tools.shell.exec(`grep -r "import.*from" ${filePath}`);
    
    // 搜索相关测试
    const tests = await tools.search.find(`**/*${filePath.split('/').pop().split('.')[0]}*test*`);
    
    // 重构代码
    const refactored = await tools.file.edit(filePath, {
        find: "class Component",
        replace: "function Component"
    });
    
    // 运行测试验证
    const result = await tools.shell.exec('npm test');
    
    return { refactored, testResult: result };
}

# 概念示例：分析Agent运行轨迹
# Harness记录的完整事件流可用于调试和优化

trajectory = {
    "run_id": "run_20260816_001",
    "events": [
        {"type": "system_prompt", "content": "你是代码审查Agent..."},
        {"type": "tool_call", "tool": "file.read", "args": {"path": "src/app.ts"}},
        {"type": "tool_result", "result": "import express from 'express'..."},
        {"type": "reasoning", "content": "分析到使用了express框架，需要检查路由定义..."},
        {"type": "tool_call", "tool": "shell.exec", "args": {"cmd": "grep -r 'app.get' src/"}},
        {"type": "tool_result", "result": "src/routes/user.ts: app.get('/users'..."},
        {"type": "subagent_schedule", "task": "审查src/routes/user.ts", "agent": "code-reviewer"},
        # ... 完整的执行轨迹
    ]
}

# 可以从任何事件点恢复或分叉
# replay_from(trajectory, event_index=3)
# fork_from(trajectory, event_index=5, new_config={...})

# 最快的方式：通过npx启动Web UI
npx @deepseek-ai/dsh web

# 默认在 http://127.0.0.1:3080 启动Web界面

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

// 自定义工具插件示例
import { definePlugin } from '@deepseek-ai/cordis';

export default definePlugin({
  name: 'my-custom-tool',
  type: 'tool',
  
  setup(ctx) {
    ctx.registerTool({
      name: 'database_query',
      description: '查询数据库并返回结果',
      parameters: {
        type: 'object',
        properties: {
          query: { type: 'string', description: 'SQL查询语句' }
        },
        required: ['query']
      },
      
      async execute({ query }) {
        const result = await db.execute(query);
        return JSON.stringify(result);
      }
    });
  }
});