评论系统

PrimeEdge 集成 Twikoo 评论系统，一个简洁、安全、免费的静态网站评论解决方案。

什么是 Twikoo

Twikoo 是一个基于腾讯云开发的静态网站评论系统，特点：

• 免费使用（腾讯云开发有免费额度）
• 无需服务器，Serverless 架构
• 支持邮件通知、微信通知
• 支持 Markdown 语法
• 支持表情包
• 支持管理员后台

快速部署

1. 创建腾讯云开发环境

1. 登录 腾讯云开发控制台
2. 创建新环境（选择免费版）
3. 进入环境，点击「新建」→「云函数」
4. 选择「Twikoo」模板创建

2. 获取环境 ID

创建完成后，在环境概览页面获取环境 ID（envId）：

https://your-env-id-xxx.service.tcloudbase.com

3. 配置主题

在 hugo.toml 中添加：

[params.twikoo]
  enable = true
  envId = "https://your-env-id-xxx.service.tcloudbase.com"
  version = "1.7.7"

配置参数

完整配置示例

[params.twikoo]
  enable = true
  envId = "https://twikoo-xxx-xxx.service.tcloudbase.com"
  version = "1.7.7"
  region = "ap-shanghai"
  lang = "zh-CN"

评论显示位置

评论系统默认显示在：

• 文章页面（posts）
• 普通页面（pages）
• 笔记页面（notes）

不显示在：

• 首页
• 列表页
• 归档页
• 搜索页

管理评论

进入管理后台

在任意有评论的页面：

1. 点击评论框
2. 输入管理员密码（首次设置）
3. 点击「管理」进入后台

常用管理功能

• 审核评论
• 回复评论
• 删除评论
• 屏蔽用户
• 查看统计

邮件通知

在 Twikoo 管理后台配置邮件通知：

1. 进入「设置」→「邮件通知」
2. 配置 SMTP 服务器
3. 开启「新评论通知」

推荐邮件服务

• QQ邮箱（免费）
• 163邮箱（免费）
• SendGrid（免费额度）
• Mailgun（免费额度）

微信通知

1. 在 Twikoo 后台获取 Webhook URL
2. 使用 Server酱 或类似服务
3. 配置消息推送

关闭评论

如需在特定页面关闭评论，在文章 Front Matter 中设置：

---
title: "某篇文章"
comments: false
---

故障排查

评论加载失败

1. 检查 envId 是否正确
2. 检查腾讯云开发环境是否正常
3. 查看浏览器控制台错误信息

无法发表评论

1. 检查腾讯云开发免费额度是否用完
2. 检查是否开启评论审核
3. 检查是否被防火墙拦截

通知邮件收不到

1. 检查 SMTP 配置
2. 检查垃圾邮件文件夹
3. 测试 SMTP 连接

替代方案

如果不想使用 Twikoo，可以考虑：

• Waline - 类似 Twikoo 的评论系统
• Giscus - 基于 GitHub Discussions
• Utterances - 基于 GitHub Issues

需要自定义集成其他评论系统，可以修改 layouts/partials/comments.html。

下一步

• 搜索配置 - 配置站内搜索
• 内容类型 - 了解各种内容页面