DeepSeek Harness: 工具使用

// Agent 调用 file_edit 的参数
{
  action: "read",
  path: "src/config.ts",
  encoding: "utf-8"
}

🤖 Agent:
🔍 Using tool: file_edit (read)
  → Path: src/config.ts
  → Size: 1.2KB

这个配置文件导出了三个配置项：
- DATABASE_URL：数据库连接字符串
- PORT：服务端口（默认 3000）
- LOG_LEVEL：日志级别（默认 info）

// Agent 调用 file_edit 创建文件
{
  action: "create",
  path: "src/utils/logger.ts",
  content: "export function log(level: string, msg: string) {\n  const ts = new Date().toISOString();\n  console.log(`[${ts}] [${level}] ${msg}`);\n}"
}

// Agent 调用 file_edit 编辑文件
{
  action: "edit",
  path: "src/app.ts",
  changes: [
    {
      type: "insert",
      line: 5,
      content: "import { log } from './utils/logger';"
    },
    {
      type: "replace",
      line: 23,
      oldContent: "console.log('Server started');",
      newContent: "log('info', 'Server started');"
    }
  ]
}

⚠️ Approval Required: Edit file src/app.ts

  +5 | import { log } from './utils/logger';
  
  -23| console.log('Server started');
  +23| log('info', 'Server started');

  [Allow] [Always] [Deny]

// Agent 执行 ls 命令
{
  command: "ls -la src/",
  cwd: "/home/alice/project",
  timeout: 30000
}

// Agent 执行 npm view（查看包信息，中等风险）
{
  command: "npm view jsonwebtoken",
  cwd: "/home/alice/project",
  timeout: 120000
}

⚠️ Approval Required: Execute shell command

  Command: npm view jsonwebtoken
  Working directory: /home/alice/project
  Estimated packages: 1

  [Allow] [Always for npm] [Deny]

// shell 工具参数
interface ShellParams {
  command: string;
  cwd?: string;
  timeout?: number;      // 超时毫秒数，默认 30000
  env?: Record<string, string>;  // 额外环境变量
}

🤖 Agent:
🔧 Using tool: shell
  → Command: npm run build
  → Timeout: 120000ms

⏱️ Build completed in 45s
  → Output: Build successful. 15 files generated.

// 搜索所有测试文件
{
  pattern: "*.test.ts",
  type: "file",
  maxResults: 50
}

// 搜索所有 import 语句
{
  pattern: "import.*from 'express'",
  type: "content",
  filePattern: "*.ts",
  maxResults: 100
}

🤖 Agent:
🔍 Using tool: search
  → Pattern: import.*from 'express'
  → Type: content
  → Results: 8 matches

Found in:
  src/app.ts:1         — import express from 'express';
  src/routes/users.ts:3 — import express from 'express';
  src/routes/auth.ts:2  — import express from 'express';
  ...

// 调用 add-test skill
{
  skill: "add-test",
  params: {
    target: "src/utils/format.ts::formatDate",
    framework: "jest"
  }
}

// 创建计划
{
  action: "create",
  steps: [
    { id: 1, desc: "Install dependencies", tool: "shell" },
    { id: 2, desc: "Create auth module", tool: "file_edit" },
    { id: 3, desc: "Update app.ts", tool: "file_edit" },
    { id: 4, desc: "Write tests", tool: "file_edit" },
    { id: 5, desc: "Run tests", tool: "shell" }
  ]
}

// 标记步骤完成
{
  action: "update",
  stepId: 1,
  status: "completed",
  result: "Installed jsonwebtoken, bcryptjs"
}

async function executeToolPipeline(tool: Tool, params: Params): Promise<Result> {
  // Stage 1: pre-execute
  const preResult = await preExecute(tool, params);
  if (preResult.denied) {
    throw new ToolDeniedError(preResult.reason);
  }

  // Stage 2: execute
  const result = await tool.execute(params);

  // Stage 3: post-execute
  await postExecute(tool, params, result);
  ctx.emit('tool.executed', { tool: tool.name, params, result });

  return result;
}

interface PreExecuteResult {
  allowed: boolean;
  reason?: string;
  modifiedParams?: Params;
}

interface PostExecuteAction {
  log: boolean;           // 记录到会话日志
  emit: boolean;          // 触发事件
  updateTrajectory: boolean;  // 更新 Trajectory
  notifyUI: boolean;      // 通知 Web UI 更新
}

# dsh.config.yaml
approval:
  # 全局默认策略
  default: ask

  # 按工具设置
  tools:
    file_edit:
      read: always          # 读取始终允许
      create: ask           # 创建需要审批
      edit: ask             # 编辑需要审批
      delete: ask_with_confirm  # 删除需要二次确认
    
    shell:
      safe: always          # 安全命令始终允许
      moderate: ask         # 中等命令需要审批
      dangerous: deny       # 危险命令自动拒绝
    
    search:
      default: always       # 搜索始终允许
    
    skills:
      default: ask          # 技能调用需要审批
    
    plan:
      default: always       # 计划始终允许

import { definePlugin } from '@deepseek-ai/dsh';

export default definePlugin({
  name: 'tool-http-request',
  version: '1.0.0',
  contribute(ctx) {
    ctx.registerTool({
      name: 'http_request',
      description: 'Make HTTP requests to external APIs',
      parameters: {
        type: 'object',
        properties: {
          url: { type: 'string', description: 'Request URL' },
          method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'DELETE'] },
          headers: { type: 'object', description: 'Request headers' },
          body: { type: 'string', description: 'Request body' }
        },
        required: ['url', 'method']
      },
      async execute(params) {
        const response = await fetch(params.url, {
          method: params.method,
          headers: params.headers,
          body: params.body
        });
        return {
          status: response.status,
          body: await response.text()
        };
      }
    });
  }
});

.dsh/
└── plugins/
    └── tool-http-request/
        ├── index.ts
        └── package.json

# dsh.config.yaml
plugins:
  - path: "./custom-tools/http-request"
  - path: "./custom-tools/database-query"

ctx.registerTool({
  name: 'http_request',
  // ...
  approval: {
    level: 'ask',     // 默认需要审批
    rules: [
      { match: { method: 'GET' }, level: 'always' },     // GET 请求自动允许
      { match: { method: 'POST' }, level: 'ask' },       // POST 需要审批
      { match: { method: 'DELETE' }, level: 'deny' }     // DELETE 自动拒绝
    ]
  }
});