你的二次元赛博哈基米 —— 基于 LLM 的智能化私人番剧管理与分析助手
OtakuNeko 不仅仅是一个个人助手。
它能同步指定用户名的 Bangumi 收藏，利用 AI 对你的二次元成分进行充分鉴定，
生成精美的年度总结海报，并提供真正懂你的番剧推荐。
如果该项目对你有用, 欢迎 star 🌟 & fork 🍴
OtakuNeko 旨在解决传统番剧管理工具“只记录不分析”的痛点，通过 LLM 为你的二次元生活赋能。
一键查询好友二次元成分，让查成分不停留在嘴上，让老资历成为认证（bushi）
- 成分鉴定：生成雷达图以及成分组成饼图，一键查好友成分。
- 多重人格：支持切换 “毒舌猫娘” 、 “柔情猫娘” 或 “圆头耄耋” 语调，让分析符合你的喜好。
- 自动绘图：自动导出格子图下载，便于朋友圈分享。
一键生成 4x3 布局的精美年度总结海报，包含 12 个深度维度：
- 深度评选：年度声优、最忙月份、最佳动画、最意难平...
- 自动绘图：无需设计，自动抓取封面图并排版，支持一键下载分享。
- 无感同步：一键拉取 Bangumi (bgm.tv) 收藏，自动整理“看过/在看/想看”。
- 向量推荐：基于向量数据库 (Vector Store)，告别大众榜单，推荐符合你口味的冷门佳作。
- 灵活配置：支持 DeepSeek 和任何 OpenAI 兼容的 API 端点（如 OpenAI、Moonshot、Groq 等）
- 运行时切换：可在应用运行时动态切换 AI 提供商
- 个性化设置：为不同用途配置不同的模型（聊天模型 vs 推理模型）
- 熔断机制：实现熔断器模式，防止外部服务不可用时的级联故障
- 优雅降级：网络问题时提供清晰的错误信息而非应用崩溃
- 自动恢复：服务恢复后自动恢复正常操作
- 智能缓存：多层缓存机制减少重复计算和网络请求
- 高效处理：优化的数据处理流程提升响应速度
- 资源管理：改进的内存管理和资源释放
OtakuNeko 控制台界面预览
无需掌握复杂的命令行，我们为 Windows 用户提供了极致的懒人启动方案。
请确保你已经安装了python（点击下载），暂无版本要求
在项目根目录下，双击运行脚本：
Setup.bat⏳ 说明：脚本会自动创建 Python 虚拟环境并安装所有依赖，仅需初次运行一次。
Run.bat🎉 成功：程序将在后台静默运行，并自动在浏览器打开
http://localhost:8501。
在弹出的框里，填入你的 AI 提供商 API Key：
- DeepSeek：获取 DeepSeek API Key
- OpenAI 兼容提供商：获取相应提供商的 API Key（如 OpenAI、Moonshot、Groq 等）
同时填入 Bungumi token（非必要）（点击获取）和 Bungumi 的用户名。
⚠️ DeepSeek API 需要付费，请自行斟酌。你也可以使用其他更具成本效益的提供商。
OtakuNeko api界面预览
OtakuNeko/
├── data/ # 📦 数据存储 (JSON数据集、生成的年度海报)
├── src/ # 🧠 核心源码
│ ├── agent/ # AI 智能体 (Profile, Recommend, YearReport)
│ ├── plugins/ # 插件系统
│ └── config/ # 语气、人格、Prompt配置
├── venv/ # 🐍 虚拟环境 (自动生成)
├── app.py # 🚀 Streamlit 主入口
├── .env # 🔑 配置文件
├── Setup.bat # 🛠️ 环境初始化脚本
├── Run.bat # 💻 调试启动脚本 (带黑窗口)
└── Run.vbs # ✨ 静默启动脚本 (暂不推荐，有问题)
| 模块 | 操作说明 |
|---|---|
| 控制台 (Sidebar) | • 🔄 一键全量更新：初次使用或看完新番后同步数据 • 🖼️ 元数据补全：补充更新动画的 Staff 和声优信息，影响推荐准确度 • 🧩 扩展插件：点击生成“2025 年度动画报告” • 🎭 助手风格：随时切换 AI 说话风格 |
| 对话框 (Chat) | 直接输入自然语言指令，例如： • “分析一下我最近的看番口味” • “推荐几部剧情像《命运石之门》一样的番” |
| 关闭程序 | 使用完毕后，务必点击侧边栏底部的 “❌ 关闭程序” 按钮以释放后台资源。 |
输入类似指令，如生成用户画像，或者分析我的喜好等，判断模式为PROFILE后进入模式。进入模式后，会将你的看过和抛弃的动画全部扔给AI进行分析，生成成分鉴定表。
OtakuNeko 生成用户画像
OtakuNeko 用户画像的格子图
进行推荐动画前，请一定要生成用户画像，不然没办法知道用户喜好。为了避免token爆炸，这里采用下面的逻辑推荐：
LLM根据输入指令输出标签->根据标签进行RAG检索->匹配动画+想看+搁置+用户画像输入LLM
事实上，还会采用最近两年内的观看记录作为绝对不能推荐的去重策略，尽管如此还是会有看过的动画推荐出来，因此有概率会出现让你重温的动画推荐。
⚠️ 对于声优、导演的动画推荐不太准确，这可能对于声豚是个坏消息。
OtakuNeko 生成用户画像
这实际上是作为一个生成用户画像的衍生模式进行的。逻辑相似，只不过使用了最近一年你加入bungumi的动画，因此范围不限于今年的新番，而是今年你看过的所有动画，更具备特殊性。点击2025年度动画报告即可触发。
OtakuNeko 生成年度动画报告
OtakuNeko 年度动画的格子图
Q: 启动时命令行提示中文乱码？
A: 这是一个 Windows 已知问题。请直接使用无窗口启动.vbs 启动，或者直接双击 启动程序.bat（脚本内已内置 UTF-8 修复），不要在 PowerShell 中手动运行。
Q: 年度报告生成失败或图片加载不出？
A: 生成海报需要访问 Bangumi 的图片服务器，请确保你的网络环境可以正常访问 bgm.tv 的图片资源。Q: 如何更新项目依赖？
A: 如果项目有更新，再次运行一键配置.bat 即可自动更新 requirements.txt 中的依赖。
Q: 更新数据缓慢？
A: 一般来说，全量数据更新是很快的，只有补全声优数据时，才会一个个补充信息，就会变得相当缓慢。如果你是前者，请检查你的网络设置。Q: 如何配置多个 AI 提供商？
A: 你可以在 .env 文件中同时配置多个提供商的 API Key。应用启动后，可以在侧边栏的 AI 提供商选择器中动态切换。Q: 网络不稳定导致请求失败怎么办？
A: 应用实现了熔断机制，当检测到连续失败时会暂时停止请求并显示清晰的错误信息。一段时间后会自动尝试恢复。Q: 为什么推荐的结果有时会重复？
A: 应用采用了缓存机制来提高性能。如果你希望获取最新的推荐结果，可以清除缓存或等待缓存自动过期。- ✨ 新增：
- 雷达图、饼图成分分析。
- 新增云端服务，无需下载本地部署环境。（免费的请轻点折腾）
- 🐛 修复：
- 修复了格子图文字显示不全的问题。
- 修复了云服务存在的问题。
- 💄 优化：
- 优化了成分鉴定时的提示词。
过往版本的更新日志
- ✨ 新增：
- 多AI提供商支持：现在可以使用 DeepSeek 或任何 OpenAI 兼容的 API 端点
- 运行时提供商切换：可在应用运行时动态切换 AI 提供商
- 熔断机制：实现熔断器模式，防止外部服务不可用时的级联故障
- 智能缓存：多层缓存机制减少重复计算和网络请求
- 增强的错误处理：提供更清晰的错误信息和优雅降级
- 🐛 修复：
- 解决了 OpenAI 客户端初始化错误问题
- 修复了网络请求失败时的处理逻辑
- 修复了中文id的问题。
- 改进了数据处理的健壮性
- 💄 优化：
- 优化了应用启动脚本的可靠性和错误处理
- 改进了依赖管理，使用精确版本锁定
- 增强了跨平台兼容性（Windows 和 Unix/macOS）
- ✨ 新增：
- 现在bangumi的api变为可选输入，不输入的情况下，获取用户的公开收藏。
- 新增了柔情猫娘，圆头耄耋两个人格。
- 🐛 修复：年度报告不能选择人格的问题。
- 💄 优化：优化了傲娇猫娘的人格，现在更有趣味。
- 🎉 发布：OtakuNeko 初始版本发布，支持 Bangumi 同步与基础画像分析。
| 选项 | 描述 |
|---|---|
| ✅ | 页面优化 |
| ✅ | 圆头耄耋、柔情猫娘人格加入 |
| ✅ | 优化画像生成的准确性 |
| ✅ | 优化UI逻辑 |
| ✅ | 多AI提供商支持 |
| ✅ | 熔断机制实现 |
| ✅ | 智能缓存系统 |
| ✅ | 云端服务 |
| 🔄 | 排程算法 |
| 🔄 | 支持基于格子图建立用户画像 |
| ⬜ | 年度报告的网页跳转 |
| ⬜ | 格子图一键填充 |
| ⬜ | 支持接入类Gemini API |
| ⬜ | ...... |
本项目采用 MIT License 协议进行开源。