题库主人只配置一次 · 访客无需登录
开通像论坛一样的站内评论
官方主站已经完成这项配置。模板副本不会继承主站的 Worker、D1 或仓库变量，因此评论区会保持隐藏；只有希望自己的访客也能评论时，题库主人才需要完成本页配置。
完成后，访客只需填写评论内容，昵称可以留空；评论会直接显示在当前题目下面。每道题有独立楼层，支持回复、举报和本机编辑 / 删除；正常评论立即公开，不进入“待审核”。
GitHub Pages 本身不能保存所有人共享的评论，所以本项目把评论服务独立部署到你的 Cloudflare 账号：Worker 负责接口，D1 保存评论，Turnstile 负责防刷。每个题库副本使用自己的数据库，不会连接原作者的数据。
如果你已经按“共享题目服务设置”部署过 comments-worker，不要再建第二个 Worker 或 D1。先把现有 Worker 更新到当前版本，然后让 QUESTIONS_API_URL 和 COMMENTS_API_URL 填写同一个根网址；这样使用者公开题的可见状态和评论楼层才会在同一数据库中正确关联。
第一步：创建无感人机验证
- 登录 Cloudflare Dashboard，打开 Turnstile → Add widget。
- Widget name 可以填写“题库评论”，模式选择 Managed。
- Hostname 填写题库网站域名，例如
your-name.github.io；使用自定义域名时也要加入。 - 创建后保存 Site key 和 Secret key。Site key 可以公开，Secret key 只能放在 Worker 的加密变量中。
第二步：还没有共享服务时再部署
Cloudflare 会把仓库里的 comments-worker 当成独立项目，读取其中的 wrangler.jsonc，自动创建并绑定 D1 数据库。部署界面的命令保持项目给出的默认值，它会先执行数据库迁移，再发布 Worker。
部署完成后，进入这个 Worker 的 Settings → Variables and Secrets，填写：
| 名称 | 类型 | 填写内容 |
|---|---|---|
SITE_URL |
Text | 题库完整网址，不带末尾 /，例如 https://your-name.github.io/llm |
SITE_ID |
Text | 下方生成的随机站点标识 |
TURNSTILE_SITE_KEY |
Text | 第一步得到的 Site key |
TURNSTILE_SECRET_KEY |
Secret | 第一步得到的 Secret key |
HASH_SECRET |
Secret | 下方生成的限流密钥 |
ADMIN_TOKEN |
Secret | 下方生成的管理员口令 |
保存变量后，在 Worker 页面点击 Deploy 重新部署一次。打开 你的 Worker 网址/v1/config，看到 siteId 和 turnstileSiteKey 即表示后端已经就绪。
第三步：把网站连到 Worker
- 复制 Cloudflare 给出的 Worker 根网址，例如
https://llm-interview-comments.your-name.workers.dev；已经配置公开题服务时直接使用它的现有网址。 - 进入 GitHub 仓库 Settings → Secrets and variables → Actions → Variables。
- 新建变量
COMMENTS_API_URL，值只填写 Worker 根网址，不要附加/v1/config、Token 或查询参数。若已有QUESTIONS_API_URL，两者必须指向同一个当前版本 Worker。 - 打开 Actions → 内容检查与网站发布 → Run workflow。
- 在 Pages CMS 的“站点设置”确认“在正式题目下方显示站内评论”已经开启。
构建时只会把公开的 Worker 网址写入网页。Turnstile Secret、限流密钥和管理员口令始终留在 Cloudflare，不会进入 GitHub、网页源码或 Pages CMS。
管理评论
打开 你的 Worker 网址/admin，输入 ADMIN_TOKEN 即可查看最近评论和举报，并执行隐藏、恢复、删除、导出，以及直接锁定或重新开放某道题的评论区。管理员口令只保存在当前标签页的 sessionStorage；不要把它发给访客，也不要填写到 GitHub 仓库变量中。
访客发布后会在本机保存该评论的随机修改凭据，因此可以在原题下编辑或删除自己的评论。清理浏览器数据或换设备后，这个能力会丢失，但仍可使用“举报”请管理员处理。
为什么不能完全省掉这次配置
纯静态网页没有公共数据库。把数据库密码或管理员 Token 写进前端，任何访客都能拿到并删除全部评论；只用浏览器本地存储，则别人根本看不到。这里的一次部署就是在“真正共享”和“安全”之间不可省略的边界。
只在当前页面生成，不会上传或保存。复制后请放进 Cloudflare；页面关闭后无法找回。