0 Fork 0

Files

T

- 增加了对前端开发服务器的代理支持
- 实现了静态资源请求的处理
- 更新了类型定义以支持新环境变量
- 新增了 wrangler.jsonc 配置文件，替换原有的模板文件

2026-04-09 09:39:40 +08:00

Repository Guidelines

Project Structure & Module Organization

src/: Cloudflare Workers backend (Hono + chanfana). Key areas:
- src/providers/: provider proxies (OpenAI, Azure OpenAI, Claude, Responses).
- src/admin/: admin APIs (channels, tokens, pricing, DB init).
- src/db/: D1 schema/init helpers.
public/: built admin UI assets served by Workers.
frontend/: React/Vite admin UI source (build outputs to public/).
wrangler.jsonc: production/deploy Wrangler config.
wrangler.local.jsonc: local Worker-first development config.
type.d.ts: shared types for bindings and data models.

bun run build: Type-checks and builds the admin UI into public/.
bun run --filter frontend build: Builds only the admin UI from the frontend workspace.
bun run dev: Starts the Vite frontend and Worker locally for integrated development.
bun run dev:worker: Runs only the Worker locally via wrangler dev --config wrangler.local.jsonc.
bun run deploy: Deploys the Worker to Cloudflare.
bun run cf-typegen: Generates Cloudflare bindings/types.

TypeScript throughout; follow existing patterns and file layout.
Indentation: 4 spaces in backend files, 2 spaces in frontend TSX (match existing).
API routes: src/admin/*_api.ts, provider files in src/providers/.
Channel types: use string literals (e.g., openai-responses, azure-openai-responses).

No dedicated test framework is currently configured.
Use bun run build as a basic safety check for UI changes.
For backend changes, run bun run dev or bun run dev:worker and validate with the API Test page.

No formal commit conventions are documented in-repo; use clear, imperative messages (e.g., "Add responses proxy").
PRs should include:
- Summary of changes.
- Notes on config changes (wrangler.jsonc, wrangler.local.jsonc, env vars).
- Screenshots for UI changes (from frontend/).

Admin endpoints require x-admin-token (ADMIN_TOKEN binding).
Tokens and channel configs are stored in D1; validate permissions and quotas.
For Azure Responses v1, leave api_version empty and set endpoint to the resource host.