docs: 更新 add-trending 命令文档并启用代理配置

- 更新 add-trending 命令描述为英文，强调使用 Agent 工作流
- 文档中明确所有数据处理由专用 Agent 完成，主窗口仅负责协调
- 启用 Claude Code 代理设置（HTTP_PROXY/HTTPS_PROXY）
- 添加 .trending-workspace/ 到 .gitignore
- 完善 CLAUDE.md 文档：数据库约束、级联删除、tag 处理逻辑、新增组件等

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

CLAUDE.md

@@ -52,28 +52,40 @@ src/app/
 ```
 
 ### Database (Prisma + PostgreSQL)
-- **Schema**: `prisma/schema.prisma` defines models: `Project`, `Tag`, `ExternalLink`
+- **Schema**: `prisma/schema.prisma` defines models: `Project`, `Tag`, `ExternalLink`, `ProjectTag`
 - **Enums**: `ProjectStatus` (ACTIVE/ARCHIVED), `LinkType` (WEBSITE/GITHUB/HUGGINGFACE/PAPER)
 - **Client singleton**: `src/lib/prisma.ts` exports Prisma client instance
 - **Multilingual fields**: Most models have `name`/`nameEn`, `description`/`descriptionEn`, `content`/`contentEn` pairs
-- **Indexes**: `idx_project_status_createdAt`, `idx_project_slug`, `idx_tag_slug`, `idx_link_projectId`, `idx_link_type`
+- **Cascade deletions**: `ExternalLink` and `ProjectTag` use `onDelete: Cascade` - deleting a project automatically cleans up its links and tag connections
+- **Key constraints**:
+  - `Project.slug`: Unique
+  - `Tag.name`: Unique (tag names are globally unique)
+  - `Tag.slug`: Unique
+  - `ExternalLink`: `@@unique([projectId, url])` (each project can't have duplicate URLs)
+- **Indexes**: `idx_project_status_createdAt`, `idx_project_slug`, `idx_tag_slug`, `idx_link_projectId`, `idx_link_type`, `idx_link_type_url` (composite for efficient URL-based deduplication)
 
 ### Webhook Deduplication Strategy
 The webhook at `src/app/api/webhook/projects/route.ts` implements a **multi-level deduplication** strategy to prevent duplicate projects:
-1. **GitHub URL exact match** (highest priority) - via `ExternalLink` table
-2. **Website URL exact match** - via `ExternalLink` table
+1. **GitHub URL exact match** (highest priority) - via `ExternalLink` table using `idx_link_type_url` index
+2. **Website URL exact match** - via `ExternalLink` table using `idx_link_type_url` index
 3. **slug match** (fallback) - via `Project.slug` field
 
 When updating an existing project, the webhook:
 - Updates all project fields (name, description, content, status, source)
-- Replaces all tags (deletes old connections, creates new ones)
-- Replaces all links (deletes old links, creates new ones)
+- Replaces all tags (deletes old `ProjectTag` connections via `ProjectTag` table, creates new ones)
+- Replaces all links (deletes old `ExternalLink` entries, creates new ones)
+
+**Tag handling special case**: Due to `Tag.name` unique constraint, tag upsert follows:
+1. First try to find existing tag by name
+2. If not found, try upsert by slug
+3. If slug conflicts, use the existing tag with that slug
 
 ### Data Fetching (Server-Side)
 - **Location**: `src/hooks/useProjects.ts` (server functions, not React hooks)
 - **Functions**: `getProjects()`, `getProjectBySlug()`, `getAllTags()`, `getTagsWithProjectCounts()`
 - **Usage**: Directly called in Server Components and route handlers
-- **ISR**: Project detail pages use `export const revalidate = 300` (5 minutes)
+- **Query transformation**: `getProjects()` and `getProjectBySlug()` flatten the `ProjectTag` junction table structure to return tags directly
+- **ISR**: Project detail pages use `export const revalidate = 300` (5 minutes) at `src/app/[locale]/projects/[id]/page.tsx`
 
 ### Validation (Zod)
 - **Schemas**: `src/lib/validations.ts` defines all Zod schemas
@@ -101,9 +113,9 @@ When updating an existing project, the webhook:
 - **Radix UI primitives**: `@radix-ui/react-slot`, `@radix-ui/react-navigation-menu`, `@radix-ui/react-dropdown-menu`, `@radix-ui/react-separator`
 - **Lucide React icons**: Used throughout the app (package imports optimized via `experimental.optimizePackageImports`)
 - **Custom components**: `src/components/` organized by domain
-  - `layout/`: Header, Footer
+  - `layout/`: Header, Footer, AnnouncementBar
   - `locale/`: LocaleSwitcher
-  - `project/`: ProjectCard, ProjectList, ProjectDetail, ProjectSidebar, RelatedProjects, TagCloud, ExternalLinkCard
+  - `project/`: ProjectCard, ProjectList, ProjectDetail, ProjectSidebar, RelatedProjects, TagCloud, ExternalLinkCard, ShareButtons, MarkdownContent, GitHubBadges, GitHubTextStatsCard
   - `search/`: SearchBar
   - `ui/`: Base UI components (buttons, cards, etc.)
 
@@ -113,18 +125,23 @@ When updating an existing project, the webhook:
   - Image domains: localhost, *.anthropic.com
   - Lucide-react package import optimization
 - **tsconfig.json**: ES2022 target, strict mode enabled
+- **Testing**: Vitest for unit tests, Playwright for E2E tests (configured but not extensively used yet)
 
 ## MCP Servers Usage (按需使用)
 
 1. **context7**: 不确定 API 用法时查阅最新文档
 2. **chrome-devtools-mcp**: 查看页面效果、调试 UI 修复 BUG
-3. **dbhub mcp**: 查询数据库数据（PostgreSQL）
-4. **shadcn mcp**: 确认 shadcn/ui 组件用法
-5. **web-search-prime**: 默认联网搜索工具
-6. **vision-mcp-server**: 图片/视频理解
+3. **web-search-prime**: 默认联网搜索工具
+4. **vision-mcp-server**: 图片/视频理解
 
 ## Git Commits
 
 提交信息主要使用中文，使用描述性的提交格式。
 
-如果你需要查看页面 请不要直接启动项目 而是应该先检查是否已经有启动好的项目在localhost:3000运行。如果有的话请直接访问，如果没有的话再执行相关命令启动项目。
+## Development Workflow
+
+- Before viewing the page, check if there's already a project running at localhost:3000. If yes, access it directly; if no, then run `pnpm dev`
+- The dev server runs with hot-reload enabled for fast iteration
+- The middleware handles locale detection and routing automatically - no manual locale configuration needed
+- When adding new translations, update both `src/messages/zh.json` and `src/messages/en.json`
+- Database changes require running `pnpm prisma migrate dev` to update the schema