前言
智阅这个插件，最早其实是围绕“文章摘要”做的。
V3 版本里，它更多是一个站长写作辅助工具：生成摘要、生成标签、生成标题、润色文章、辅助创作。对内容站来说，这些能力已经能省下不少重复劳动。比如写完一篇文章后，不用再手动想摘要，也不用反复琢磨标签和标题。
但用下来会发现，站点里的 AI 能力不应该只停留在后台。
读者打开一篇文章，可能想快速了解内容；看到一个主题，可能想继续找相关文章；进入一个知识库站点，可能直接就想问：“这个问题你这里有没有写过？”
所以 V4 做的事情，简单说就是：把智阅从“后台内容助手”，升级成“站点 AI 助手”。
为什么这次叫大版本
V4 不是在 V3 上加一个按钮，也不是换一套界面。
这次把插件整体结构重新理了一遍。插件也正式更名为「智阅全能 AI 助手」。这个名字其实更贴近现在的定位：它不再只是给文章生成摘要，而是把内容生产、知识库、前台问答、宠物助手和站点 Agent 放到同一个体系里。
这也是为什么 V4 升级后需要重新检查配置。
旧版本里很多配置是围绕摘要和文章生成设计的，到了 V4，前台助手、RAG 知识库、Agent 工具、宠物展示、会话记录这些都加入了进来。直接沿用旧配置，很容易出现体验不完整或者能力没打开的情况。
前台终于有了一个真正的入口
V3 的 AI 能力主要在后台，站长用得多，访客感知不强。
V4 加了前台宠物助手。它不是简单挂一个聊天按钮，而是把前台入口做得更轻一点：可以是宠物，可以是小窗，也可以进入全屏对话。
有些站点适合放一个醒目的 AI 助手，有些个人博客只想要一个小宠物陪着页面。V4 后面也把模式拆开了：
可以只显示宠物，不打开对话
可以只走知识库问答
可以只走 Agent
也可以让 RAG 和 Agent 一起工作
这点很重要。不是所有站点都需要完整 AI 问答，也不是所有用户都想配置知识库。现在可以按站点自己的需要来开。
RAG 知识库是 V4 的核心变化
V3 里，AI 更多是“处理当前内容”。
V4 里，插件开始能理解“整个站点的内容”。
你可以把文章、页面、文档、Markdown、富文本、本地文件导入知识库，然后让访客直接基于这些资料提问。对博客、文档站、教程站来说，这个变化会很明显。
以前读者想找答案，只能靠搜索、分类、标签慢慢翻。现在可以直接问：
“这个插件怎么配置？”
“有没有写过某个功能？”
“哪几篇文章适合先看？”
插件会从站内知识库里找资料，再组织成回答，并保留来源引用。这样 AI 不是凭空聊天，而是尽量围绕站点已有内容说话。
索引这块也做了不少脏活
知识库听起来简单，真正麻烦的是索引。
内容多了以后，一次性重建很容易慢，甚至超时。所以 V4 对 RAG 索引做了不少处理：
支持批量导入
支持按文档批量生成 Embedding
支持导入后只索引本次新增内容
支持查看索引任务状态
支持失败重试
支持强制停止和强制重新索引
这些不算很“酷”，但实际用起来很关键。站点内容一多，索引任务能不能停、能不能重来、失败后能不能看到原因，都会直接影响体验。
Agent 让助手不只是回答问题
RAG 解决的是“基于资料回答”。
Agent 解决的是“根据用户意图做一点事”。
V4 引入了站点 Agent 能力后，前台助手可以结合当前页面、站内搜索、知识库检索等工具来回答。比如用户问友情链接、评论区、某个分类下的文章，它不一定只生成一段文字，而是可以去查站点资源，再给出更具体的引导。
当然，这部分也做了权限控制。
站点可以决定匿名用户能不能对话，能不能使用 Agent；也可以限制哪些工具开放。因为 Agent 能力一旦开放，就不只是聊天了，必须把边界收好。
PetDex 是为了让前台更像一个站点组件
V4 里宠物助手也接入了 PetDex。
这件事一开始看起来像“装饰功能”，但其实对前台体验影响挺大。传统聊天浮窗比较工具化，放在个人博客里有时会有点突兀。宠物入口会柔和一点，更适合博客、生活站、个人站。
后来又补了反代域名和附件库本地化。
原因也很现实：国内服务器加载远程资源不一定稳定。现在可以配置 PetDex 反代，也可以把宠物资源保存到 Halo 附件库，前台直接用本地资源，稳定性会好很多。
后台管理也重新整理了
V4 不只是前台变多了，后台也变复杂了。
因为一旦有知识库、会话、调用日志、导入任务，就必须让站长能看得清楚：
哪些资料已经导入
哪些内容启用了
索引有没有过期
重建进度到哪了
AI 调用失败是什么原因
用户问过哪些问题
所以 V4 增加了会话记录、AI 调用日志、知识库导入和索引任务状态。它不是为了堆页面，而是为了以后出问题时能查到。
AI 功能最怕的不是失败，而是失败后不知道为什么。
升级前要注意什么
这次从 V3 到 V4，建议不要当成普通小版本升级。
V4 依赖 Halo AI Foundation，需要先安装并配置可用模型。升级后也建议重新进入插件设置，把模型、前台助手、RAG、Agent、宠物等配置重新检查一遍。
如果要用知识库，最好重新导入资料或至少重新构建一次索引。这样 V4 的 RAG 能力才能正常工作。
简单说：
V3 更像是“帮站长写内容”。
V4 更像是“把站点内容变成可以被问、被找、被引导的知识入口”。
这也是这次升级最主要的变化。