开发一个 Tool

┌─────────────────────────────────────────────────────────────┐
│                 DeepSeek 工具调用执行流水线                  │
├─────────────────────────────────────────────────────────────┤
│  1. 大模型发起 Tool Call：{ name: 'inspect_code', args: ... }│
│                         ▼                                   │
│  2. defineTool 参数校验：按 JSON Schema 进行类型与边界截断  │
│                         ▼                                   │
│  3. execute(args)：执行具体业务逻辑并返回结构化数据对象     │
│                         ▼                                   │
│  4. output.render：将结果转换为标准模型消息块 [{ type: 'text'}]│
│                         ▼                                   │
│  5. 结构化观测数据（Observation）注入上下文，进入下一轮推理 │
└─────────────────────────────────────────────────────────────┘

import type { Context } from '@deepseek-ai/cordis';
import { defineTool } from '@deepseek-ai/dsh-tools';

// 1. 声明插件标识与服务依赖
export const name = 'code-inspector-plugin';
export const inject = ['tools'];

export function apply(ctx: Context) {
    // 2. 向 Harness 全局工具库注册自定义 Tool
    ctx.tools.register(defineTool({
        // 工具唯一标识（与模型 Tool Call 协议中的 name 字段严格对齐）
        name: 'inspect_code_quality',

        // 语义描述：明确告知模型“何时调用该工具”以及“预期的输入输出”
        description: '静态分析指定代码片段的圈复杂度、代码行数及潜在安全隐患（如硬编码密钥或高危函数）。',

        // 输入参数模式定义
        parameters: {
            code: {
                type: 'string',
                required: true,
                description: '待检测的源码文本内容（支持 TypeScript / JavaScript / Python）'
            },
            maxAllowedLines: {
                type: 'number',
                required: false,
                description: '单函数建议最大行数阈值，默认为 50'
            },
            strictSecurityCheck: {
                type: 'boolean',
                required: false,
                description: '是否开启严格的安全规范检查，默认为 true'
            }
        },

        // 输出协议定义与模型消息渲染器
        output: {
            schema: { type: 'object' },
            // render 函数将 execute 返回的 raw 数据转换为模型上下文消息
            render: (_args, result) => [
                {
                    type: 'text',
                    text: `[代码扫描报告]
` +
                          `• 总行数: ${result.totalLines}
` +
                          `• 疑似高危关键词: ${result.vulnerabilities.length > 0 ? result.vulnerabilities.join(', ') : '无'}
` +
                          `• 规范评估: ${result.passed ? ' 检查通过' : ' 存在需要重构的潜在风险'}`
                }
            ]
        },

        // 具体执行逻辑
        async execute(args) {
            const lines = args.code.split('\n');
            const vulnerabilities: string[] = [];

            if (args.strictSecurityCheck !== false) {
                if (args.code.includes('eval(')) vulnerabilities.push('禁止使用 eval() 执行动态脚本');
                if (args.code.includes('password =') || args.code.includes('api_key =')) {
                    vulnerabilities.push('检测到疑似硬编码凭证');
                }
            }

            const maxLines = args.maxAllowedLines || 50;
            const passed = vulnerabilities.length === 0 && lines.length <= maxLines;

            return {
                totalLines: lines.length,
                vulnerabilities,
                passed
            };
        }
    }));
}

mode: standard

plugins:
  # 挂载本地代码质量扫描工具
  - name: "./custom-plugins/lint-tool"

  # 基础操作系统工具集
  - name: "@deepseek-ai/dsh-plugin-bash"
  - name: "@deepseek-ai/dsh-plugin-str-replace"

pnpm dsh web --patch ./cordis.yml