Method generateToolDocs

src/agent/ToolComponent.ts:322–364

* 生成工具文档

()

   * 生成工具文档
   */
  public generateToolDocs(): string {
    const tools = this.getTools();
    const categories = this.getToolsByCategory();

    let docs = '# 工具文档\n\n';
    docs += `总计 ${tools.length} 个工具\n\n`;

    for (const [category, categoryTools] of Object.entries(categories)) {
      docs += `## ${category.toUpperCase()} (${categoryTools.length})\n\n`;

      for (const tool of categoryTools) {
        docs += `### ${tool.name}\n`;
        docs += `${tool.description}\n\n`;

        if (tool.version) {
          docs += `**版本:** ${tool.version}\n`;
        }

        if (tool.tags && tool.tags.length > 0) {
          docs += `**标签:** ${tool.tags.join(', ')}\n`;
        }

        docs += '\n**参数:**\n';
        docs += '```\n';

        for (const [paramName, paramSchema] of Object.entries(tool.parameters)) {
          const required = tool.required?.includes(paramName) ? ' (必需)' : '';
          const defaultValue =
            paramSchema.default !== undefined ? ` (默认: ${paramSchema.default})` : '';

          docs += `${paramName}: ${paramSchema.type}${required}${defaultValue}\n`;
          if (paramSchema.description) {
            docs += `  ${paramSchema.description}\n`;
          }
        }

        docs += '```\n\n';
        docs += '---\n\n';
      }
    }

    return docs;
  }

  /**
   * 记录日志