站点助理

站点助理是显示在页面左下角的交互式角色，支持 Rive 动画和 Live2D 模型两种形式，可配置按页面路由定制对话台词。

站点助理默认关闭。不放模型文件也能开启，这时只显示对话气泡。台词写在 src/data/agent-dialogue.ts，默认是示例站的口吻（比如首页那句「我是 Miki」），开启前先改成你自己的。

两种形态

Rive

使用 .riv 文件格式的矢量动画角色，由 Rive 平台制作。支持状态机驱动，可以实现注视跟随鼠标、眨眼、说话等交互效果。

Live2D

使用 Live2D Cubism 技术制作的 2D 角色模型。支持鼠标追踪、表情切换等交互。

配置方法

在 src/data/config/features.ts 中修改 agent 字段：

TypeScript

agent: {    enabled: true,    provider: 'rive',    name: 'Miki',    rive: {        src: '/model.riv'    },    live2d: {        modelPath: '/model.json'    }}

agent: {
    enabled: true,
    provider: 'rive',
    name: 'Miki',
    rive: {
        src: '/model.riv'
    },
    live2d: {
        modelPath: '/model.json'
    }
}

字段说明

字段	必填	说明
`enabled`	是	`true` 启用，`false` 关闭
`provider`	是	`rive` 或 `live2d`
`name`	否	角色名称，显示在对话气泡中
`rive.src`	否	`.riv` 文件路径（provider 为 rive 时生效）
`live2d.modelPath`	否	Live2D 模型入口 JSON 路径（provider 为 live2d 时生效）

文件准备

Rive

在 Rive 平台创建或下载动画角色
导出为 .riv 文件
将文件放入 public/ 目录（如 public/model.riv）
在配置中引用 src: '/model.riv'

Live2D

准备 Live2D 模型文件（.model3.json 及配套资源）
将模型目录放入 public/ 目录
在配置中引用入口 JSON 文件路径

开启与关闭

默认是 false，改成 true 就开启：

TypeScript

agent: {    enabled: true,    provider: 'rive',    name: '你的角色名',}

agent: {
    enabled: true,
    provider: 'rive',
    name: '你的角色名',
}

台词按页面地址匹配，每个页面可以有几句进场时说的话和几句闲聊，都在 src/data/agent-dialogue.ts 里修改。