Saylo AI 伙伴
版本：1.0.6
适用：XIUNOX 1.1
Saylo AI 伙伴是一款面向 XIUNOX 的沉浸式 AI 角色陪伴插件，提供角色发现、连续对话、本地记忆、角色创作、动态、语音朗读与主题体验。插件可使用内置本地回复引擎，也可接入 OpenAI 兼容的 HTTPS 模型接口。
核心功能
角色发现：内置多位不同性格、场景和表达风格的 AI 角色。
AI 对话：支持上下文消息、角色设定、记忆注入和消息长度限制。
本地记忆：聊天、记忆及自定义角色保存在当前浏览器
localStorage。角色创作：用户可创建名称与简介自定义的本地角色。
语音体验：通过浏览器 TTS 朗读角色内容。
扩展模块：包含角色动态、灵感钱包和本地数据清理入口。
双引擎模式：远程模型未启用时使用本地引擎；启用后调用 OpenAI 兼容接口。
后台配置：可配置访问策略、功能开关、模型地址、API Key、模型名、超时和页面文案。
数据与隐私
聊天记录、个人记忆和自定义角色默认只保存在用户当前浏览器。
远程模型 API Key 只保存在服务端插件设置中，不会下发前端。
启用远程模型后，必要的对话上下文与用户选择保存的记忆会发送到配置的模型服务商。
使用远程模型前，请确认服务商的数据处理条款符合站点隐私要求。
安装
将
wajxy_saylo目录上传至 XIUNOX 的plugin/目录。在后台安装并启用“Saylo AI 伙伴”。
清理论坛
tmp/编译缓存。打开插件设置，选择是否允许游客并按需配置远程模型。
远程模型配置
API Base URL：必须为 HTTPS 公网地址，例如
https://api.openai.com/v1。API Key：留空保存时保留原密钥。
模型名称：填写服务商支持的 OpenAI 兼容模型标识。
请求超时：可设置为 5–120 秒。
启用远程模型后，接口失败会返回明确错误，不会静默降级；未启用时使用内置本地角色引擎。
兼容性与安全
使用原生 JavaScript，不依赖 jQuery、Alpine.js 或 idiomorph。
POST 请求带 CSRF 令牌，服务端执行 CSRF 校验。
动态 DOM 内容通过
textContent等安全 API 写入。安装与升级脚本使用 utf8mb4；升级脚本可重复执行。
支持 PHP 8+ 的错误模型，不依赖
@抑制错误。
卸载说明
卸载会删除 wajxy_saylo_usage 插件统计表和 wajxy_saylo 设置。浏览器中的本地聊天、记忆与自定义角色需要用户在前台“本地设置”中清理，或手动清除对应站点存储。
更新记录
1.0.6
完成结构、安全、Hook、缓存、前端与数据规范自检。
规范终止性
exit防护。强化脚本块 JSON 转义与 CSRF 表单语义。
为路由补充服务类显式加载。
新增自检清单与插件介绍文档。
