Waline 评论系统使用指南
📝 评论方式
我们的文档支持两种评论方式:
1️⃣ 内部团队评论(推荐)
适用场景:公司内部团队成员
使用方法:
- 在评论框中填写 姓名(2-4个中文字符,例:张三)
- 填写 工号(6位数字,例:123456)
- 输入评论内容(支持 Markdown 语法)
- 点击 提交 按钮
验证规则:
- ✅ 姓名:必须是2-4个中文字符
- ✅ 工号:必须是6位数字
- 💡 系统会实时提示格式是否正确
2️⃣ GitHub 账号登录
适用场景:拥有 GitHub 账号的用户
使用方法:
- 点击评论框上方的 登录 按钮(蓝色按钮)
- 选择 GitHub 登录
- 授权后自动返回,无需填写姓名和工号
- 直接输入评论内容并提交
🔐 如何退出登录
方法一:通过评论框退出(推荐)
如果你已经用 GitHub 账号登录,会在评论框顶部看到一个登录信息条,显示类似:
👤 CHENY [退出登录]操作步骤:
- 找到评论框顶部的登录信息条
- 点击右侧的 退出登录 按钮
- 确认退出后即可切换为姓名+工号模式
方法二:清除浏览器缓存
如果找不到退出按钮,可以手动清除登录信息:
Chrome 浏览器:
- 按
F12打开开发者工具 - 切换到 Application 标签
- 展开 Local Storage
- 找到
https://waline-comment-lilac.vercel.app - 删除所有存储项
- 刷新页面
Firefox 浏览器:
- 按
F12打开开发者工具 - 切换到 存储 标签
- 展开 本地存储
- 删除相关条目
- 刷新页面
方法三:使用无痕/隐私模式
如果只是临时需要以匿名方式评论:
- Chrome:
Ctrl + Shift + N(无痕模式) - Firefox:
Ctrl + Shift + P(隐私浏览) - Edge:
Ctrl + Shift + N(InPrivate)
💡 常见问题
Q: 为什么看不到退出登录按钮?
A: 可能的原因:
- 未登录:如果你从未登录过 GitHub,不会显示登录信息条
- 样式问题:尝试刷新页面或清除浏览器缓存
- 控制台错误:按
F12查看是否有 JavaScript 错误
Q: 退出登录后工号信息会保留吗?
A: 不会。退出登录后:
- GitHub 账号信息会被清除
- 需要重新填写姓名和工号
- 之前提交的评论不受影响
Q: 评论支持哪些 Markdown 语法?
A: 支持常用的 Markdown 语法:
- 粗体:
**文本** - 斜体:
*文本* 代码:`代码`- 代码块:
```语言\n代码\n``` - 链接:
[文本](URL) - 引用:
> 引用内容
Q: 提交评论时出现错误怎么办?
A: 常见解决方法:
- 检查格式:确保姓名和工号格式正确
- 刷新页面:有时网络延迟会导致提交失败
- 清除缓存:按
Ctrl + Shift + Delete清除浏览器缓存 - 联系管理员:如果问题持续存在,请联系技术支持
🎨 评论框样式说明
我们的评论系统采用了现代精致风格:
- 🎯 紧凑布局:输入框和按钮高度优化,更加精致
- 🌈 主题适配:自动适配浅色/深色主题
- ✨ 交互反馈:悬停、聚焦时有平滑的过渡效果
- 🔍 实时验证:输入时即时显示格式提示
📞 技术支持
如果遇到任何问题,请:
- 查看浏览器控制台(
F12)的错误信息 - 截图问题现象
- 联系技术团队
评论服务器:https://waline-comment-lilac.vercel.app
客户端版本:Waline v3.6.0
主题版本:VitePress 2.0.0-alpha.12
