Files

anghunk 73bbe44fbc refactor(cors): 简化CORS配置并移除未使用的参数

feat(email): 提取邮箱验证逻辑到共享模块并增强验证

docs: 更新文档移除不再使用的ALLOW_ORIGIN配置

style(admin): 为设置页面添加加载状态和样式优化

fix(comments): 在邮件发送前增加邮箱格式验证

2026-01-19 17:02:19 +08:00

2.5 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个基于 Cloudflare Workers 的轻量级评论系统后端（Momo Backend Worker），使用 Hono 框架构建，数据存储使用 Cloudflare D1（SQLite）和 KV。

常用命令

# 开发
npm run dev          # 本地开发服务器
npm run deploy       # 部署到 Cloudflare Workers

# 测试
npm run test         # 运行 Vitest 测试

# 类型生成
npm run cf-typegen   # 生成 Cloudflare Workers 类型定义

# 数据库操作
npm wrangler d1 execute CWD_DB --remote --file=./schemas/comment.sql  # 初始化数据库表

架构概览

src/
├── index.ts          # 应用入口，路由定义
├── bindings.ts       # TypeScript 类型定义（Env 绑定）
├── api/
│   ├── admin/        # 管理员 API（需认证）
│   │   ├── login.ts, listComments.ts, deleteComment.ts, updateStatus.ts
│   └── public/       # 公开 API
│       ├── getComments.ts, postComment.ts
├── utils/
│   ├── auth.ts       # 管理员认证中间件
│   ├── cors.ts       # CORS 配置
│   ├── email.ts      # Resend 邮件通知
│   └── getAvatar.ts  # Gravatar 头像生成
└── views/
    └── html.ts       # 管理后台 HTML 页面（内嵌 Vue 3）

API 路由

方法	路径	功能	认证
GET	`/`	管理后台页面	否
GET	`/api/comments`	获取评论列表	否
POST	`/api/comments`	提交评论	否
POST	`/admin/login`	管理员登录	否
GET	`/admin/comments/list`	评论管理列表	Bearer Token
PUT	`/admin/comments/status`	更新评论状态	Bearer Token
DELETE	`/admin/comments/delete`	删除评论	Bearer Token

关键绑定

CWD_DB: D1 数据库绑定
CWD_AUTH_KV: KV 存储（用于认证 Token）

环境变量

变量名	说明	必填
`ADMIN_NAME`	管理员用户名	是
`ADMIN_PASSWORD`	管理员密码	是
`RESEND_API_KEY`	Resend API 密钥	否
`RESEND_FROM_EMAIL`	发件邮箱	否
`EMAIL_ADDRESS`	站长接收邮箱	否

本地开发

复制 .dev.vars.example 为 .dev.vars 并配置环境变量
运行 npm run dev 启动本地开发服务器

2.5 KiB Raw Blame History Unescape Escape