小红书笔记

插件介绍

前台是一套完整的小红书式笔记插件：自适应瀑布流、图片与视频混合浏览、详情页、个人主页、消息中心和登录弹窗一体呈现。后台则把笔记标题、分类、原生标签、AI 分类和分类管理集中到熟悉的微语编辑器与插件设置页中。

功能一览

内容展示

• 小红书式自适应瀑布流，桌面、平板和手机端自动适配。
• 支持多图笔记、图片与视频混合轮播，视频首帧作为卡片封面。
• 视频接入 XGPlayer 播放器，播放失败时自动回退到原生播放器。
• 卡片右上角显示视频标识或图片数量，私密笔记显示锁形角标。
• 私密笔记仅作者自己可见。
• 详情页独立整页渲染，PC 端同时支持弹窗内浏览笔记。
• 支持无限滚动加载，翻页浏览更顺畅。

创作与分类

• 复用纸鱼博客核心微语编辑器，图片上传、正文编辑与站点一致。
• 编辑器内增加笔记标题、分类和标签字段。
• 标签保存在 note_tags，以独立胶囊展示，不写入正文，不会出现 %标签 污染内容。
• 支持 Markdown 正文。
• 自动解析核心插入的视频、音频以及正文中的视频/音频链接。
• AI 智能分类：单篇编辑时可根据标题和正文推荐分类；后台可批量处理未分类笔记。
• AI 候选来自现有启用分类和原版默认分类，支持配置是否允许 AI 新建分类；返回结果会经过候选校验，不会随意写入自造分类。
• 分类支持后台新增、编辑、排序、启用/停用；中文分类名自动生成拼音 slug，例如「健身」→ jian-shen。

互动与社区

• 点赞、取消点赞。
• 评论、回复、评论点赞和评论删除。
• 关注作者、取消关注，作者主页展示关注与粉丝列表。
• 消息中心：评论和回复、点赞通知、新增关注三类通知，支持未读角标和全部已读。
• 浏览量统计，详情页和弹窗访问都会记录，同一会话自动去重。
• 小红书式登录/注册弹窗，不跳转核心默认登录表单；注册开关、邮箱验证码等规则跟随纸鱼博客核心设置。

个人主页

• 作者主页包含笔记、关注、粉丝和点赞四个 Tab。
• 支持编辑昵称和个人简介。
• 展示笔记数、关注数、粉丝数和获赞数。

后台设置

• 每页笔记数量和无限滚动开关。
• 点赞、评论、关注、消息通知独立开关。
• 站点标识、笔记站名称、浏览器标题和 SEO 标题配置。
• 笔记分类管理与 AI 批量分类入口。
• AI 分类开关和「允许 AI 新建分类」开关。

安装说明

1. 确认站点为支持插件 API v2 的纸鱼博客（Pafish），PHP 版本 8.1 以上。
2. 将插件目录放到 plugins/xhs_notes。
3. 进入后台插件管理，启用「小红书笔记」。
4. 在插件设置中配置每页数量、互动开关、品牌与 SEO 信息。
5. 访问 /plugin/xhs_notes 进入笔记站。
6. 如果希望首页直接显示笔记，可在 Web 服务器将 / 301 跳转到 /plugin/xhs_notes。

可选：启用 AI 智能分类

1. 启用 ai_foundation 插件。
2. 在 ai_foundation 中配置一个可用的默认聊天模型。
3. 回到小红书笔记插件设置，打开「启用 AI 智能分类」。
4. 根据需要选择是否允许 AI 新建分类。
5. 单篇分类在笔记编辑器中操作；批量分类在插件设置页执行，只处理未分类笔记。

常见问题

为什么访问首页不是笔记站？
插件前台入口是 /plugin/xhs_notes。如需首页直达，请配置 301 跳转。

为什么 AI 分类按钮没有出现？
请确认已启用 AI 智能分类、ai_foundation 已启用并配置了默认聊天模型，同时至少存在一个可用分类，或已允许 AI 新建分类。

视频为什么无法播放？
视频播放取决于浏览器编解码支持，建议使用 mp4/H.264 格式。XGPlayer 加载失败时会回退到原生播放器；如果仍无法播放，请检查视频地址和浏览器控制台。

登录和注册规则在哪里配置？
登录弹窗只负责界面，注册开关、邮箱验证和验证码规则均跟随纸鱼博客核心用户设置。

标签会写进正文吗？
不会。标签单独保存在 note_tags，在卡片、详情页和弹窗底部以胶囊形式展示。