评论管理
在 PrimeEdge Admin 中管理 Waline On EdgeOne 评论
评论管理
PrimeEdge Admin 内置了 Waline 评论管理能力，可以直接审核、搜索、回复、编辑、置顶和删除 Waline On EdgeOne 中的评论。
前置条件
评论管理依赖两个项目共用同一个评论 KV：
| 项目 | 必需 KV 绑定 |
|---|---|
| Waline On EdgeOne | WALINE_KV |
| PrimeEdge Admin | WALINE_KV，绑定到 Waline 项目的同一个 KV 命名空间 |
PrimeEdge Admin 不通过 https://wl.example.com/api/... 调用评论服务，而是直接读写 WALINE_KV 中的评论和设置。因此只配置 params.waline.serverURL 不能让 Admin 评论菜单生效。
评论管理页面
进入「评论系统 -> 评论管理」后，可以按状态查看评论：
| 状态 | 说明 |
|---|---|
| 已通过 | approved，会显示在博客前端 |
| 待审核 | waiting，需要管理员通过后显示 |
| 垃圾 | spam，不会正常显示 |
支持的操作：
- 搜索昵称、邮箱、评论内容和页面路径。
- 将待审核评论通过或标记为垃圾。
- 将垃圾评论恢复为通过。
- 置顶或取消置顶已通过评论。
- 回复评论，回复会写入 Waline 评论树。
- 编辑评论正文，保存时会重新渲染 Markdown。
- 删除评论及其子回复。
- 批量重新渲染评论，用于修复历史评论表情或 HTML 渲染问题。
评论列表最多扫描前 10 个状态分页，适合日常审核和近期评论处理。超大规模历史检索建议使用 Waline Admin 的导出功能或直接做数据迁移处理。
评论设置页面
进入「评论系统 -> 评论设置」可以维护 Waline 的常用配置：
| 设置区 | 内容 |
|---|---|
| 基本设置 | 站点名称、站点地址、博主邮箱、Waline 前端版本 |
| 邮件通知 | SMTP、Resend、SendGrid、发件人、邮件模板、测试邮件 |
| PushPlus | 微信推送 Token、Topic、模板、渠道、Webhook |
| 评论策略 | 匿名/登录用户默认审核状态、IP 评论频率、UA 和地区显示 |
| 图片上传 | KV、七牛云、又拍云 |
| 安全验证 | 极验 4.0 Captcha ID 和 Captcha Key |
这些配置会写入 WALINE_KV 的 setting:{key} 键。Waline On EdgeOne 服务端会优先读取 KV 设置，再回退到环境变量。
与 Waline 后台的区别
| 工具 | 适合场景 |
|---|---|
| PrimeEdge Admin 评论管理 | 日常审核、回复、置顶、快速修改评论策略 |
Waline Admin (/ui) | 用户管理、数据迁移、账号资料、原生 Waline 管理体验 |
EdgeOne 设置页 (/ui/worker-setting) | 评论服务自身的完整扩展设置 |
三个入口可以同时使用。只要它们连接的是同一个 WALINE_KV，数据就是同一份。
极验验证联动
如果在评论设置中填写了极验：
geetest_captcha_id和geetest_captcha_key保存在WALINE_KV。- 博客
config.toml的params.waline.geetestCaptchaId需要填写同一个 Captcha ID。 - Captcha Key 只留在服务端，不要写入博客配置。
保存后重新部署 Waline 服务和博客，匿名用户提交评论前就会触发极验验证。
常见问题
Q: 打开评论管理提示 WALINE_KV 未绑定
A: 在 PrimeEdge Admin 项目设置中绑定 Waline 评论服务同一个 KV 命名空间，绑定名必须是 WALINE_KV，然后重新部署 Admin。
Q: 博客能显示评论，但 Admin 里看不到评论
A: 多数情况是 Admin 绑定了另一个空 KV。确认 Waline 项目和 Admin 项目选择的是同一个 KV 命名空间。
Q: 回复评论后邮件没有发出
A: 检查评论设置中的邮件服务、发件人、SMTP 用户名和密码；如果使用 Resend 或 SendGrid，SMTP 密码 / API Key 填服务商 API Key。
评论