腾讯搜索代理

# 安装依赖
pnpm install

# 启动开发服务器（默认端口 5173，自动代理 /api 到后端 8080）
pnpm dev

# 生产构建（产物输出到 backend/dist）
pnpm build

# 类型检查
pnpm type-check

# 单元测试
pnpm test:unit

# 代码检查 + 自动修复
pnpm lint

# 代码格式化
pnpm format

cd backend

# 设置 API Key
# Windows:
set TENCENTCLOUD_WSA_APIKEY=your_api_key
# Linux/Mac:
export TENCENTCLOUD_WSA_APIKEY=your_api_key

# 启动 HTTP 服务（默认监听 8080 端口）
go run main.go

# 以 MCP stdio 模式启动（供本地 AI 客户端调用）
go run main.go -mcp-stdio

# 构建单二进制文件（需先执行前端 pnpm build）
go build -o tencent_search.exe .

tencent_search/
├── src/                    # 前端源码（Vue 3 + Vite + TypeScript）
│   ├── components/         # 公共组件（SearchTool、SearchFilter、文档组件）
│   ├── views/              # 页面视图（搜索页、文档页）
│   ├── stores/             # Pinia 状态管理（search、app）
│   ├── services/           # API 服务层（search.ts）
│   ├── types/              # TypeScript 类型定义
│   └── router/             # Vue Router 配置
├── backend/                # 后端源码（Go）
│   ├── main.go             # 入口：参数解析、路由注册、优雅关闭
│   ├── handler.go          # HTTP 处理函数
│   ├── service.go          # 公共搜索逻辑
│   ├── api.go              # 腾讯云 API 调用
│   ├── mcp_tool.go         # MCP 工具注册与处理
│   ├── model.go            # 数据结构定义
│   ├── middleware.go        # CORS 中间件
│   └── util.go             # 工具函数
└── dist/                   # 前端构建产物（嵌入后端）

{
  "mcpServers": {
    "tencent-search": {
      "command": "tencent_search.exe",
      "args": ["-mcp-stdio"]
    }
  }
}

{
  "mcpServers": {
    "tencent-search": {
      "url": "http://localhost:8080/api/mcp"
    }
  }
}