Jelu 书评功能完整指南：如何在自托管实例上写书评并与读者共享
【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jelu
Jelu 是一款自托管的阅读追踪工具（相当于个人版 Goodreads），内置完整的Jelu 书评功能：你可以为任意书籍撰写 Markdown 书评、打出 0~10 的半星评分，并自由控制"私有/公开"可见性，与同一实例上的其他读者共享阅读想法。本文用 3 个步骤带你写出第一篇 Jelu 书评，并介绍 3 种共享书评的方式 📖
为什么在 Jelu 里写书评？
- 🔒数据自主：书评、评分、阅读记录全部保存在你的本地数据库中，不再担心在线服务关停丢数据
- ✍️Markdown 编辑：书评正文支持 Markdown 语法，可分段、加粗，排版自由
- ⭐半星评分：0~10 分、0.5 步进的星级评分，比传统五星更细腻
- 👥实例级共享：公开书评可被同实例的所有用户看到，像小型书评社区一样运转
三步写出你的第一篇 Jelu 书评
第 1 步：进入书籍详情页
打开 Jelu 首页，在"My books"书架列表中找到目标书籍，点击进入书籍详情页：
第 2 步：打开 Jelu 书评创建窗口
在书籍详情页顶部找到"写书评"按钮，点击后弹出书评创建弹窗，包含三个核心字段：
| 字段 | 说明 |
|---|---|
| Review（正文） | Markdown 编辑器，支持多段落、加粗等格式 |
| Visibility（可见性） | private私有 /public公开，二选一 |
| Rating（评分） | 0~10 半星评分，右侧实时显示分值 |
第 3 步：提交书评
确认内容后点击SUBMIT提交。新书评会立刻出现在书籍详情页的"My reviews"区域，并进入实例的活动流中 🎉
Jelu 书评可见性设置：私有还是公开？
可见性是 Jelu 书评的关键设计，直接决定"谁能看到"：
- 🔍私有（private）：仅自己可见。未登录的访客请求私有书评会直接被拒绝
- 🌍公开（public）：实例上所有用户可见，未登录访客也能看到，适合乐于分享的读者
你可以随时在编辑书评时切换可见性，无需删除重建。
3 种与读者共享 Jelu 书评的方式
- 书籍书评页：每本书都有独立的"全部评论"页面（路径
/books/{bookId}/reviews），集中展示该书所有公开书评，读者点进书就能看 - 活动流页面：顶部导航的"活动"页（路径
/reviews）以时间线形式汇集全部书评，支持按阅读日期排序与分页浏览 - 单条书评独立页：每条书评有独立地址（路径
/reviews/{reviewId}），复制链接就能分享给朋友，或嵌入你的博客、笔记中
如何编辑或删除 Jelu 书评？
进入书籍详情页，"My reviews"列表中每篇书评都带有编辑和删除操作：
- ✏️编辑：再次打开创建弹窗，可修改正文、评分与可见性
- 🗑️删除：点击删除按钮，确认后即可彻底移除书评
Jelu 书评功能相关源码位置
想深入了解实现细节，可以看看这些文件（相对仓库根目录）：
- 书评创建/编辑弹窗：
src/jelu-ui/src/components/ReviewModal.vue - 书评数据模型（含可见性枚举）：
src/jelu-ui/src/model/Review.ts - 书评列表页：
src/jelu-ui/src/components/ReviewList.vue - 后端书评 API：
src/main/kotlin/io/github/bayang/jelu/controllers/ReviewsController.kt - 书评业务逻辑：
src/main/kotlin/io/github/bayang/jelu/service/ReviewService.kt
小结
Jelu 的书评功能简单而完整：Markdown 正文 + 半星评分 + 可见性控制，三要素齐全；书籍页、活动流、独立链接三条共享路径，让书评真正流通起来。现在就可以打开你的自托管实例，为最近读完的那本书写下第一条评论吧 ✍️
【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jelu
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
