用 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)。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- 别把 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 的
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










