0 Fork 0

Files

T

TooonyChen c0e838b780 feat: replace provider-specific AI clients with unified callProvider()

- Remove callGemini() / callOpenAI() and all Gemini/OpenAI-specific env
    vars (GoogleAPIKey, GeminiModel, OpenAIAPIKey, OpenAIBaseUrl, OpenAIModel)
  - Add callProvider() supporting three API formats:
      openai      → POST /v1/chat/completions
      responses   → POST /v1/responses
      anthropic   → POST /v1/messages (x-api-key, anthropic-version header)
  - New env vars: AI_BASE_URL, AI_API_KEY, AI_API_FORMAT, AI_MODEL
  - Optional fallback provider via AI_FALLBACK_* (all four or none);
    primary retries 3×, fallback attempts 1×
  - Update wrangler.toml.example* to new var schema (default: Gemini OpenAI-compat)
  - Update README, README_CN, AGENTS.md, CLAUDE.md accordingly

2026-03-15 03:29:29 +13:00

1.8 KiB

Raw Blame History

CLAUDE.md

Stack

Cloudflare Worker (TypeScript) + React 18 + Vite + Tailwind + shadcn/ui + Cloudflare D1.

Package manager: pnpm. Never use npm commands.

Key Commands

pnpm run dev             # Worker backend :8787
pnpm -C web run dev      # React frontend :5173 (proxy /api → :8787)
pnpm run dev:remote      # backend with live D1
pnpm run deploy          # build:web + wrangler deploy
pnpm run test

Architecture Boundaries — Never Violate

isPromotionalEmail() must run before any LLM call in email() handler.
Every incoming email → raw_mails. Only AI-extracted results → code_mails. Never skip raw_mails.
src/index.html is a live fallback. Do not delete.
DOMPurify + sandboxed iframe on all email HTML rendering. Do not relax.
Basic Auth gate is first in WorkerEntrypoint.fetch(). Do not move or bypass.
All AI calls go through callProvider(). Do not add per-provider methods alongside it.

AI Provider Env Vars

Required: AI_BASE_URL, AI_API_KEY, AI_API_FORMAT (openai|responses|anthropic), AI_MODEL. Optional fallback: AI_FALLBACK_BASE_URL, AI_FALLBACK_API_KEY, AI_FALLBACK_API_FORMAT, AI_FALLBACK_MODEL (all four or none).

Frontend Component Rules

UI components: shadcn/ui only. No new UI libraries without discussion.
Colors: CSS variables in web/src/index.css. No hardcoded hex except table hover states.
Use text-muted-foreground for secondary text. text-muted is a background color — never use as text.
All grid children need min-w-0 to prevent overflow.

Compact Instructions

When compressing, preserve in priority order:

Architecture decisions (NEVER summarize)
Modified files and their key changes
Current verification status (pass/fail)
Open TODOs and rollback notes
Tool outputs (can delete, keep pass/fail only)

1.8 KiB Raw Blame History