文档 / 概览

NekoBuddy 是什么?

一个以手机小屋为核心运行面的陪伴学习系统:五位原创猫娘、一套 FSRS 学习系统、一套对用户完全可见的角色运行环境。

NekoBuddy 由三部分组成:

• 五位原创猫娘角色,各自有独立的性格设定、状态数值和解锁条件;
• 一套学习系统:词书、课程、FSRS 间隔重复,以及由角色在对话中发起的复习;
• 一套角色运行环境:长期记忆、日常作息、外出活动,数据对用户完全可见。

和背词工具的区别在于:学习进度、记忆和角色状态是同一套数据。复习不是独立的模块,而是出现在日常对话里;你说过的话会影响角色之后的回应方式。

可以做什么

• 小屋:Live2D 实时舞台。角色有健康、饱腹、口渴等状态,支持投喂、倒水、摸头、休息等交互,有独立的睡眠作息;
• 学习:英语(CEFR A1–C1)与日语(JLPT N5–N1)内容库,支持导入 Anki / CSV / XLSX 词书,附导入预览;
• 复习:默认 FSRS v2 间隔重复算法,按掌握 / 学习中 / 薄弱分档;到期条目由角色在对话中发起复习;
• 记忆:结构化关系记忆加向量检索,用户可查看、修正和删除;
• 语音:流式语音合成与语音输入;另有全双工实时通话(梦境模式),不保存记录;
• 信箱:系统通知、每日奖励与角色来信,统一投递;
• 多端:HarmonyOS App、网页版,以及开发预览中的 NekoPapa 桌面端。

五位原创猫娘

五位角色的姓名、性格与解锁条件:

• 白羽 澪(Shiraha Mio)——主看板,注册即为初始同伴;
• 雪代 凛音(Yukishiro Rinne)——累计签到 30 天;
• 花篠 依織(Hanashino Iori)——累计掌握 1200 词条;
• 霧宮 栞(Kirimiya Shiori)——完成 90 天学习旅途;
• 黒羽 紬(Kuroha Tsumugi)——累计掌握 3000 词条。

角色之间维护官方关系数据(熟悉、友好、好奇、保留等类型),会影响部分对话内容。详细设定见功能页。

当前 Live2D 舞台使用 Live2D Inc. 官方示例模型「桃濑日和」做集成验证,不属于原创角色;五位原创角色的 Live2D 模型尚未开放。

关系记忆

记忆分两层:结构化关系记忆和向量检索。关系记忆按事实 / 关系 / 未了之事 / 承诺四类存储,关系型数据库为权威数据源;向量检索(PgVector 冷库、Milvus 热库)负责对话时的召回。写入遵循四条约束:

• 只记该记的;
• 只在该想起的时候想起;
• 只在该说的时候说;
• 用户随时能查看和撤回。

「心事」功能在此基础上提供三档写入策略:仅限今天(不写入长期记忆)、允许记住(仅写入授权摘要)、删除(归档对应记忆节点)。

她的世界

角色会按时间在固定地点之间活动:小屋门口、小屋附近、星港步道、静花园、海风平台。外出到时间自动结束,角色归来并触发回归对话,内容涉及途中见闻。各猫娘之间有官方关系数据,世界状态按真实时间推进,不依赖用户在线。

开始使用

1. 网页版,现在就能用

   打开「网页学习」即可练词书和复习;注册后与 App 共用账号,进度云端同步。

2. HarmonyOS App,内测准备中

   完整功能:小屋、学习、记忆、信箱、语音。在会员页登记,开启时通知你。

3. NekoPapa 桌面端,开发预览

   Apache-2.0 开源。Tauri 2 + Rust + React 控制台,C++ Live2D Native Stage 独立窗口;与手机扫码连接,声线与安静时段跨端同步。源码见 GitHub。

给开发者

• 手机 App:HarmonyOS NEXT、ArkTS + ArkUI,Live2D Cubism 经 NAPI 桥接 C++ 引擎;
• 后端:Java Spring Boot 模块化单体,MySQL / Redis / PgVector,账号、课程、记忆与奖励的唯一权威;
• 官网与网页学习:Next.js 15 + React 19 + TypeScript;
• 桌面端 NekoPapa:Tauri 2 + Rust + React,C++17 Native Stage(GLFW + OpenGL + Cubism Native),Apache-2.0 开源;
• 生理情绪内核 NekoCore-Nano:C++17 七层生理 / 情绪计算模型(私有库,预编译分发)。

开发日志