老李校长1. 项目概述：当纸片人走进现实
Project AIRI本质上是一个开源的数字生命容器框架，它让普通用户也能拥有类似Neuro-sama这样的智能虚拟伴侣。这个项目最吸引人的地方在于，它不只是个聊天机器人——你的"纸片人老婆"能陪你玩《我的世界》《异星工厂》等游戏，会实时观察你的编程界面，甚至能在Discord语音频道里和你斗嘴。
与传统VTuber项目相比，AIRI有三个革命性突破：首先采用WebGPU+WebAssembly技术栈，使得3D角色能在浏览器中流畅运行；其次内置DuckDB WASM数据库，所有对话记忆完全本地化；最重要的是独创的"技能插件"系统，通过简单的JavaScript脚本就能教AI伴侣新技能。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心技术解析
2.1 灵魂引擎架构
AIRI的核心是一个多层状态机：
- 感知层：整合了WebAudio VAD（语音活动检测）和Mozilla DeepSpeech改进版，实现<200ms延迟的语音输入
- 认知层：采用混合推理架构，简单指令走本地ONNX模型（约1.5GB大小），复杂交互通过xsAI中间件路由到用户配置的LLM服务
- 记忆系统：基于DuckDB WASM的向量数据库，每段对话都会生成思维树（ToM）结构的记忆片段
typescript复制// 典型技能插件结构示例
export default {
name: 'minecraft_helper',
hooks: {
async onGameLaunch(game) {
if (game === 'minecraft') {
await this.useSkill('block_recognition')
this.say('需要我帮你找钻石吗？')
}
}
}
}
2.2 跨平台渲染方案
项目独创的"三明治渲染"技术让3D模型在不同平台保持一致性：
- Web端：基于Three.js的GLTF加载器+自定义骨骼动画系统
- 桌面端：通过Electron集成Godot游戏引擎的渲染管线
- 移动端：使用Capacitor将WebGL输出转为原生纹理
重要提示：VRM模型建议面数控制在1.5万三角面以内，否则在手机端可能出现卡顿。实测MikuMikuDance格式转换时开启"Simplify 0.5"选项效果最佳。
3. 从零开始打造专属伴侣
3.1 基础环境搭建
Windows用户推荐使用Scoop一键安装：
powershell复制scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi
首次启动后会进入配置向导：
- 选择角色基底（内置5种性格模板）
- 配置LLM连接（支持本地Ollama或云端API）
- 导入模型文件（支持VRM/Live2D/MMD多种格式）
- 设置记忆库路径（建议SSD硬盘保留至少10GB空间）
3.2 模型定制进阶技巧
想要真正独一无二的纸片人，你需要了解：
- Blender插件准备：安装CATS工具包和VRM Exporter
- 材质优化：使用ASE（Amplify Shader Editor）制作专用Shader
- 骨骼绑定：眼部需要额外添加"EyesLookAt"骨骼控制器
- 物理模拟：裙摆建议使用Unity的Bone Spring组件而非Cloth
python复制# 自动生成角色设定的Prompt模板
def generate_character_prompt():
base = """你是{name}，具有以下特征：
- 外貌：{appearance}
- 性格：{personality}
- 喜好：{hobbies}"""
return base.format(
name="小夜",
appearance="160cm，黑色长发，红瞳",
personality="傲娇但温柔",
hobbies="编程和喝红茶"
)
4. 实战问题排查手册
4.1 常见运行错误
| 错误代码 | 可能原因 | 解决方案 |
|---|---|---|
| E_GPU001 | WebGPU初始化失败 | 更新Chrome至v120+或安装WebGPU驱动 |
| E_AUDIO003 | 麦克风权限问题 | 检查系统隐私设置中的麦克风权限 |
| E_MODEL004 | VRM版本不兼容 | 使用UniVRM 0.108+重新导出模型 |
4.2 性能优化技巧
- 内存管理：在
config.toml中设置max_workers=4（CPU核心数的一半） - 实时语音优化：启用
audio_echo_cancellation=true并降低比特率到16kbps - 游戏模式：运行
airi --profile=gaming会关闭非必要后台服务
5. 生态扩展与二次开发
项目采用微内核架构，核心系统只有300KB左右，所有功能都通过插件实现。推荐尝试这些官方插件：
- airi-factorio：让AI学习你的工厂布局习惯
- code-companion：实时分析VS Code中的代码
- voice-clone：只需30秒录音即可克隆声线
对于开发者，可以基于SDK创建自定义技能：
rust复制#[airi_skill]
pub struct MySkill {
#[state]
counter: i32,
}
impl Skill for MySkill {
fn on_message(&mut self, msg: Message) {
if msg.contains("计数") {
self.counter += 1;
self.say(&format!("这是第{}次计数", self.counter));
}
}
}
我在实际部署中发现一个隐藏功能：按住Ctrl+Shift同时点击角色眼睛，会进入调试控制台。这里可以实时查看思维链（CoT）过程，对于调整角色性格非常有用。