RAG 智能助手

配置组：assistant

RAG 智能助手用于控制前台悬浮宠物、问答面板、快捷问题、PetDex 资源加载和助手样式。

基础配置

显示模式与链路

如果站点只需要装饰或陪伴型宠物，选择 petOnly 即可。

宠物气泡文案

建议：

• 对话模式文案侧重引导提问，例如“有什么站内资料想查？”。
• 仅宠物模式文案侧重陪伴和装饰，例如“今天也要元气满满。”。

PetDex 反代域名

留空表示直连 PetDex。填写 https://proxy.example.com/ 时，插件会把 PetDex 资源改写为同路径代理地址。

也支持模板：

https://proxy.example.com/{url}
https://proxy.example.com/?url={encodedUrl}
https://proxy.example.com{path}

模板变量：

Nginx 反代参考

PetDex 的 API 和资源来自不同上游，建议按路径分开代理。

location ^~ /pets/ {
    proxy_pass https://assets.petdex.dev;
    proxy_set_header Host assets.petdex.dev;
    proxy_ssl_server_name on;
    proxy_ssl_name assets.petdex.dev;
}

location ^~ /manifests/ {
    proxy_pass https://assets.petdex.dev;
    proxy_set_header Host assets.petdex.dev;
    proxy_ssl_server_name on;
    proxy_ssl_name assets.petdex.dev;
}

location ^~ /api/ {
    proxy_pass https://petdex.dev;
    proxy_set_header Host petdex.dev;
    proxy_ssl_server_name on;
    proxy_ssl_name petdex.dev;
    proxy_redirect https://assets.petdex.dev/ https://petdex.halo.sb/;
    proxy_redirect https://petdex.dev/ https://petdex.halo.sb/;
}

location ^~ /install/ {
    proxy_pass https://petdex.dev;
    proxy_set_header Host petdex.dev;
    proxy_ssl_server_name on;
    proxy_ssl_name petdex.dev;
}

不要把 proxy_set_header Host 设置为 $host，否则上游 Cloudflare 可能返回 421 Misdirected Request。

PetDex 附件库本地化

开启后，插件会把 sprite.webp 和 petjson.json 保存到附件库，并把宠物配置中的资源地址替换为附件 permalink。

注意：

• 只对新导入或重新保存的 PetDex 宠物生效。
• 已导入的旧宠物需要重新导入，或打开编辑后保存一次，才会转换为附件库资源。
• 如果同时配置反代域名，本地化下载阶段也会使用反代地址拉取资源。

助手样式配置

默认悬浮位置

用户拖动宠物后，浏览器本地保存的位置会优先于默认配置。

相关配置

• 问答是否允许匿名访问，由 AI 设置 中的 AI 助手访问模式控制。
• 是否允许 Agent 工具，由 Agent 能力 和 AI 助手访问模式共同控制。
• 知识库检索参数由 知识库设置 控制。