评论功能配置说明

1# hugo-teek-site/config/teek-plugins/services.toml
2# 所有主题共用的服务配置
3# 推荐在此文件中进行评论配置

1# hugo-teek-site/config/themes/hugo-teek/services.toml
2# 仅当前主题使用的服务配置
3# 用于覆盖通用配置

1  enabled = true                              # ◀️ 总开关：启用评论系统
2  provider = "twikoo"                         # ◀️ 评论提供商，目前支持 twikoo
3  envId = "https://twikoo.example.com/"       # ◀️ Twikoo 服务器地址，记得替换自己部署的

1  enabled = true        # ◀️ 启用/禁用评论系统
2  provider = "twikoo"   # ◀️ 评论系统提供商
3  envId = "..."         # ◀️ Twikoo 环境 ID 或自定义域名

 1# 1️⃣  fork Twikoo 仓库
 2# 访问 https://github.com/imaegoo/twikoo 点击 Fork
 3
 4# 2️⃣ 在 Vercel 导入项目
 5# 访问 https://vercel.com/new
 6# 选择你 fork 的 twikoo 仓库
 7
 8# 3️⃣ 配置环境变量
 9# 添加 MONGODB_URI 变量
10# 格式：mongodb+srv://用户名:密码@集群地址/数据库名
11
12# 4️⃣ 获取环境 ID
13# 部署完成后，Vercel 会分配域名
14# 如：https://twikoo-xxx.vercel.app

1  enabled = true
2  provider = "twikoo"
3  envId = "https://twikoo-xxx.vercel.app"  # ◀️ Vercel 分配的域名

 11️⃣ 登录腾讯云 CloudBase 控制台
 2   访问：https://console.cloud.tencent.com/tcb
 3
 42️⃣ 创建新环境
 5   选择【新建环境】-> 选择免费版
 6
 73️⃣ 安装 Twikoo 云函数
 8   进入环境 -> 云函数 -> 新建云函数
 9   选择模板：Twikoo 评论系统
10
114️⃣ 获取环境 ID
12   在环境设置中查看环境 ID
13   格式：twikoo-xxx

1  enabled = true
2  provider = "twikoo"
3  envId = "twikoo-xxx"  # ◀️ CloudBase 环境 ID

 1version: '3'
 2services:
 3  twikoo:
 4    image: imaegoo/twikoo:latest
 5    container_name: twikoo
 6    restart: always
 7    ports:
 8      - "8080:8080"           # ◀️ 映射端口
 9    environment:
10      - MONGODB_URI=mongodb://mongo:27017/twikoo
11      - TWIKOO_THROTTLE=1000   # ◀️ 限流配置（毫秒）
12    volumes:
13      - ./data:/app/data       # ◀️ 数据持久化

1  enabled = true
2  provider = "twikoo"
3  envId = "https://twikoo.example.com"  # ◀️ 你的服务器域名

1# ========================================
2# 💬 评论系统配置
3# ========================================
4[comment]
5  enabled = true                              # ◀️ 启用评论系统
6  provider = "twikoo"                         # ◀️ 使用 Twikoo
7  envId = "https://twikoo.xxdevops.cn/"       # ◀️ Twikoo 服务器地址
8  version = "1.6.41"                          # ◀️ Twikoo 版本号
9  hideAdmin = false                           # ◀️ 是否隐藏管理按钮

1  enabled = true
2  provider = "twikoo"
3  envId = "https://twikoo.xxdevops.cn/"
4  version = "1.6.41"      # ◀️ 指定 Twikoo 版本，用于加载对应 JS
5  hideAdmin = false       # ◀️ true 时隐藏评论区的管理设置按钮

1  enabled = true
2  provider = "twikoo"
3  envId = "https://twikoo.example.com/"
4  hideAdmin = true        # ◀️ 隐藏管理员设置按钮

1/* 隐藏 Twikoo 管理设置按钮（齿轮图标） */
2.tk-admin {
3  display: none !important;
4}

1  enabled = true        # ◀️ 启用最近评论卡片
2  pageSize = 5          # ◀️ 每页显示评论数量
3  totalSize = 50        # ◀️ 总共获取评论数量

1# 配置文件位置：
2# config/themes/hugo-teek/homepage.toml
3# 或
4# config/teek-plugins/homepage.toml

1原因：comment.enabled 设置为 false 或 envId 配置错误
2解决：
31️⃣ 检查 services.toml 中 enabled = true
42️⃣ 确认 envId 地址正确且可访问
53️⃣ 检查浏览器控制台是否有报错

1原因：Twikoo 服务未启动或跨域问题
2解决：
31️⃣ 访问 envId 地址确认服务正常
42️⃣ 检查 Twikoo 云函数/容器是否运行
53️⃣ 查看 Twikoo 后台是否有错误日志

1原因：homepage.toml 配置错误或依赖未满足
2解决：
31️⃣ 检查 homepage.toml 中 enabled = true
42️⃣ 确认 comment.enabled 也为 true
53️⃣ 检查网络是否可以访问 Twikoo 服务器

1  enabled = true
2  provider = "twikoo"
3  envId = "你的 Twikoo 环境 ID"

1  enabled = true
2  provider = "twikoo"
3  envId = "https://twikoo.example.com/"
4  version = "1.6.41"
5  hideAdmin = false

1  enabled = true
2  pageSize = 5
3  totalSize = 50

1  enabled = false         # ◀️ 完全禁用评论系统