https://time-friend.com/zh/tags/disussions/Recent content in Disussions on Time FriendHugozh-CNTue, 06 May 2025 10:30:00 +0000https://time-friend.com/zh/archive/blog-architecture-giscus/Tue, 06 May 2025 10:30:00 +0000https://time-friend.com/zh/archive/blog-architecture-giscus/<p>博客不能没有评论. 但又不想为了一个评论功能去搞数据库和 moderation. Giscus 是一个折中方案.</p> <p>这个博客的评论系统用的是 Giscus. 它基于 GitHub Discussions. 所有评论都直接存在 GitHub 仓库里, 不需要自建数据库, 不需要第三方服务.</p> <h1 id="整体流程">整体流程</h1> <pre tabindex="0"><code>用户打开文章页 ↓ 加载 giscus.app/client.js ↓ Giscus 脚本读取 data- 属性配置 ↓ 根据 mapping=&#34;pathname&#34; 取当前 URL 路径 ↓ 用 GitHub Discussions API 查询匹配的 Discussion ↓ 找到 → 渲染评论框和已有评论 未找到 → 显示&#34;留个评论吧&#34;输入框 ↓ 用户写评论 → 点击发布 ↓ 跳转 GitHub OAuth 授权 (首次需要) ↓ 评论通过 API 写入仓库的 Discussions ↓ Giscus WebSocket 监听变更 → 实时更新评论区 </code></pre><p>整个过程用户无感知, 不需要离开页面.</p> <h1 id="哪里对接">哪里对接</h1> <p>评论系统以 script 标签嵌入页面. 在 <code>layouts/partials/comments.html</code> 里:</p>