Skip to content

Waline 评论系统使用指南

📝 评论方式

我们的文档支持两种评论方式:

1️⃣ 内部团队评论(推荐)

适用场景:公司内部团队成员

使用方法

  1. 在评论框中填写 姓名(2-4个中文字符,例:张三)
  2. 填写 工号(6位数字,例:123456)
  3. 输入评论内容(支持 Markdown 语法)
  4. 点击 提交 按钮

验证规则

  • ✅ 姓名:必须是2-4个中文字符
  • ✅ 工号:必须是6位数字
  • 💡 系统会实时提示格式是否正确

2️⃣ GitHub 账号登录

适用场景:拥有 GitHub 账号的用户

使用方法

  1. 点击评论框上方的 登录 按钮(蓝色按钮)
  2. 选择 GitHub 登录
  3. 授权后自动返回,无需填写姓名和工号
  4. 直接输入评论内容并提交

🔐 如何退出登录

方法一:通过评论框退出(推荐)

如果你已经用 GitHub 账号登录,会在评论框顶部看到一个登录信息条,显示类似:

👤 CHENY  [退出登录]

操作步骤

  1. 找到评论框顶部的登录信息条
  2. 点击右侧的 退出登录 按钮
  3. 确认退出后即可切换为姓名+工号模式

方法二:清除浏览器缓存

如果找不到退出按钮,可以手动清除登录信息:

Chrome 浏览器

  1. F12 打开开发者工具
  2. 切换到 Application 标签
  3. 展开 Local Storage
  4. 找到 https://waline-comment-lilac.vercel.app
  5. 删除所有存储项
  6. 刷新页面

Firefox 浏览器

  1. F12 打开开发者工具
  2. 切换到 存储 标签
  3. 展开 本地存储
  4. 删除相关条目
  5. 刷新页面

方法三:使用无痕/隐私模式

如果只是临时需要以匿名方式评论:

  • ChromeCtrl + Shift + N(无痕模式)
  • FirefoxCtrl + Shift + P(隐私浏览)
  • EdgeCtrl + Shift + N(InPrivate)

💡 常见问题

Q: 为什么看不到退出登录按钮?

A: 可能的原因:

  1. 未登录:如果你从未登录过 GitHub,不会显示登录信息条
  2. 样式问题:尝试刷新页面或清除浏览器缓存
  3. 控制台错误:按 F12 查看是否有 JavaScript 错误

Q: 退出登录后工号信息会保留吗?

A: 不会。退出登录后:

  • GitHub 账号信息会被清除
  • 需要重新填写姓名和工号
  • 之前提交的评论不受影响

Q: 评论支持哪些 Markdown 语法?

A: 支持常用的 Markdown 语法:

  • 粗体**文本**
  • 斜体*文本*
  • 代码`代码`
  • 代码块:```语言\n代码\n```
  • 链接:[文本](URL)
  • 引用:> 引用内容

Q: 提交评论时出现错误怎么办?

A: 常见解决方法:

  1. 检查格式:确保姓名和工号格式正确
  2. 刷新页面:有时网络延迟会导致提交失败
  3. 清除缓存:按 Ctrl + Shift + Delete 清除浏览器缓存
  4. 联系管理员:如果问题持续存在,请联系技术支持

🎨 评论框样式说明

我们的评论系统采用了现代精致风格

  • 🎯 紧凑布局:输入框和按钮高度优化,更加精致
  • 🌈 主题适配:自动适配浅色/深色主题
  • 交互反馈:悬停、聚焦时有平滑的过渡效果
  • 🔍 实时验证:输入时即时显示格式提示

📞 技术支持

如果遇到任何问题,请:

  1. 查看浏览器控制台(F12)的错误信息
  2. 截图问题现象
  3. 联系技术团队

评论服务器https://waline-comment-lilac.vercel.app
客户端版本:Waline v3.6.0
主题版本:VitePress 2.0.0-alpha.12

You may not distribute, modify, or sell this software without permission.