Function generateToolDocs

src/commands/tools.ts:395–445

* 生成工具文档

(
  tools: ToolDefinition[],
  categories: Record<string, ToolDefinition[]>
)

 * 生成工具文档
 */
function generateToolDocs(
  tools: ToolDefinition[],
  categories: Record<string, ToolDefinition[]>
): string {
  let docs = '# 工具文档\n\n';
  docs += `> 总计 ${tools.length} 个工具\n\n`;
  docs += '## 目录\n\n';

  // 生成目录
  for (const [category, categoryTools] of Object.entries(categories)) {
    docs += `- [${category.toUpperCase()}](#${category.toLowerCase()}) (${categoryTools.length})\n`;
  }
  docs += '\n';

  // 生成详细文档
  for (const [category, categoryTools] of Object.entries(categories)) {
    docs += `## ${category.toUpperCase()}\n\n`;

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

      if (tool.version || tool.author) {
        docs += '**元信息:**\n';
        if (tool.version) docs += `- 版本: ${tool.version}\n`;
        if (tool.author) docs += `- 作者: ${tool.author}\n`;
        docs += '\n';
      }

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

      docs += '**参数:**\n\n';
      docs += '| 参数名 | 类型 | 必需 | 默认值 | 描述 |\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}\`` : '-';
        const description = paramSchema.description || '-';

        docs += `| \`${paramName}\` | \`${paramSchema.type}\` | ${required} | ${defaultValue} | ${description} |\n`;
      }

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

  return docs;
}

/**
 * 生成测试参数