用 GitHub Issues 当评论后端最省事，本质是将每篇文章映射为一个 Issue，用户评论即 Issue 评论，免运维、零成本、支持 GitHub 登录；需公开仓库、正确配置 issue-term（如 pathname）、避免 token 硬编码，并注意本地开发时 CORS 与 file:// 协议限制。
用 GitHub Issues 当评论后端最省事
直接对接 GitHub Issues 是目前零成本、免运维、支持登录态的主流方案。它本质是把每篇文章映射成一个 Issue，用户评论就变成 Issue 的评论，你不用搭服务、不存数据、不处理垃圾评论。
关键点在于：页面加载时根据 index.html 的路径或标题自动生成唯一 Issue 标题（比如 Page: /index.html），然后调用 GitHub REST API 拉取该 Issue 下的所有评论。你需要一个带 public_repo 权限的个人 Access Token（仅前端使用时必须配合代理避免暴露 token）。
- 别把 token 写死在 HTML 或 JS 里——哪怕只是测试，也会被爬走导致账号被盗
- GitHub 对未认证请求限流极严（60次/小时），必须用带 token 的请求，且建议加缓存（如 localStorage 存 10 分钟内的评论）
- Issue 标题要足够唯一又稳定：用页面
document.title+location.pathname拼接，避免空格和特殊字符，例如Page%20-%20index.html
用 utterances 嵌入只需两行代码
utterances 是基于 GitHub Issues 的开源评论组件，纯前端，CDN 直接引入，不需要自己写 API 调用逻辑。它自动处理 Issue 创建、评论渲染、登录授权（用 GitHub OAuth）和回复嵌套。
在 index.html 的 </body> 前插入：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
<script src="https://utteranc.es/client.js"
repo="your-username/your-repo"
issue-term="pathname"
theme="github-light"
crossorigin="anonymous"
async>
</script>
-
repo必须是公开仓库，且你有写入权限（用于创建 Issue） -
issue-term控制 Issue 匹配方式：pathname最稳妥（对应/index.html），url易因参数变动失效，title在多语言或动态标题下不可靠 - 首次访问会弹 GitHub 授权页，用户点“Authorize”后，utterances 自动创建 Issue 并挂载评论框；后续访问直接加载该 Issue 的评论
本地开发时 CORS 和预览问题怎么绕开
直接双击打开 index.html 或用 file:// 协议访问时，GitHub API 会因跨域被浏览器拦截；用 live-server 或 python3 -m http.server 启服务也默认不带 CORS 头，utterances 仍可能报错 “Failed to fetch issues”。
- 开发阶段最简单办法：用 Chrome 启动时加参数
--disable-web-security --user-data-dir=/tmp/chrome-dev（仅临时调试，勿长期启用） - 更安全的做法是起一个带代理的小服务，比如用
http-server -p 8080 --cors，或在webpack-dev-server中配置 proxy 将/api/issues转发到https://api.github.com/repos/... - utterances 在
file://下完全不工作——它依赖window.location获取当前页信息，而 file 协议下pathname是绝对路径（如/Users/xxx/index.html），无法匹配仓库中的 Issue
自建轻量后端只适合有特定需求的情况
如果你需要审核、敏感词过滤、邮箱通知、或与现有用户体系打通，才值得上后端。否则就是给自己加部署、备份、防刷、升级的负担。
真要自建，推荐用 Cloudflare Workers + KV：无服务器、免运维、天然抗刷、按请求计费。Worker 接收 POST 评论请求，校验字段后写入 KV；GET 请求读取并返回 JSON，前端用 fetch 渲染。KV 的 key 可设为 comment:index.html，value 是 JSON 数组。
- KV 不支持查询或分页，所以评论数超过 100 条就得自己切片或换 D1（Cloudflare 的 SQLite）
- 别用 localStorage 存评论——关掉页面就丢，且无法跨设备同步
- 任何自建方案都得处理 XSS：入库前必须转义
<>"，前端渲染用textContent而非innerHTML
