和《偶像大师 闪耀色彩》的偶像实时对话的 AI 分身
语音 · 文字 · 剧情回忆 · 跨角色共享记忆
简体中文 · English · 日本語
预览 · 特性 · 快速开始 · 配置指南 · 部署 · 架构决策
Eidolon-SC 让你以 283 事务所制作人的身份，和原作中的偶像打字聊天或者直接打电话。她用日语原声回答，附上中文字幕；能回忆自己在原作里经历过的剧情；还会记住你说过的事，并在偶像之间「传开」。
原作八个组合的 28 位偶像和事务员七草はづき都已经配好，可以直接对话。部署到公网后，任何人都能用 Google 或 GitHub 登录使用。
[!IMPORTANT]
本项目是非官方的粉丝作品，与万代南梦宫及《偶像大师》系列的版权方无关，角色由 AI 扮演。剧情数据不随仓库分发，需要自行准备（ADR-0003）；角色会通过回复间接地把剧情内容提供给登录的用户，这一风险见 ADR-0006。
📸 预览
✨ 特性
和她说话
- 🎙️ 实时语音通话：基于 WebRTC 的全双工通话，中文、日语都能说，随时可以插话打断她。
- 🇯🇵 日语原声 + 中文字幕：她用日语回答，保留口癖，每句附中文字幕（ADR-0001）；专有名词按读音表念对。
- 🎭 会动的立绘：通话时叠上原作的 Spine 立绘，会呼吸、眨眼、动嘴，随情绪换表情。原作出了新卡，每周同步一次就能穿。
- 📷 她发照片：你开口要，她按自己的样子和当时的情境拍一张发来，只有全年龄的内容（配置指南）。
- 💗 好感度和礼物：你说的话会让她亲近或疏远你，冒犯多了她会挂断电话、结束这段对话。每天在玩法里抽奖得到礼物送给她，她会回应；解锁成就能多得抽奖次数。
- 📅 日历：角色和制作人的生日、日本的节假日，她当天也知道。
- 🗓️ 日程：每周发布的工作，你排进她的一周，她知道并以此说话；做完的工作让她更亲近你（配置指南）。
- 🌙 周期：她也有经期，经前、经期这几天会不舒服，体贴她有回报；你凭她的言行把经期记在周期页，页面替你推算下一次，并讲清怎么算（配置指南）。
- 🍸 VA-283：她来酒吧光顾，你照她的点单调饮品。每天第一次玩完的光顾给一次抽奖，她也会更亲近你；第一次进店有はづき 教你调。画面和调法致敬《VA-11 HALL-A》。
- 💌 搭话：你一阵子没来，她会在对话里先说几句；越亲近来得越早（配置指南）。
- ✉️ 信：在特别的日子，比如更亲近的那天、你的生日、相识纪念，她给你写一封信，用她的声音念给你听（配置指南）。
- 🌅 朋友圈：和你聊过的角色在你的朋友圈里发动态，常带配图，写着地名和东京的天气，其他偶像来赞和评论；你也能赞、能评论，她会回你（配置指南）。
- 🌦️ 天气：她知道东京这会儿的天气；你在档案里设了所在城市，她也知道你那边的天气和预警，隔了一阵或天气不寻常时会关心一句（配置指南）。
她记得什么
- 📖 回忆原作剧情：导入剧情库后，她只回忆自己出场过的正式经历。
- 🔄 与原作同步：一条命令同步粉丝汉化和日语原文，新卡、新活动一周内就能回忆；歌曲和演出也写进她的世界设定。
- 🧠 跨角色共享记忆：对灯織说过的事，恋鐘也会知道，并以「听灯織说……」的口吻提起（ADR-0002）。她记住的事你都能查看和删除。
- 🗂️ 历史对话：随时开新对话，旧的留着翻看，不要了可以删。
- 🪪 制作人档案：称呼、性别、时区和生日都能在设置里改；生日当天她会祝你生日快乐。
- 📊 统计：看你和她们聊了多少回合、通了多久电话、送了多少礼物，可以导出一张分享图。
- ⚡ 按需检索：先判断这句话要不要查资料，寒暄闲聊没有额外延迟。
部署和运营
- 👥 对公众开放：Google 或 GitHub 登录，也可以只让拿到邀请链接的人注册；按用户限流，记忆互相隔离；用户可以彻底删除自己的数据，数据库每天加密备份到异地。
- 📦 数据包：对话、照片、记忆和制作人档案导出成一个 zip，在别的部署导入后接着用；好感度、礼物、日程和酒吧的光顾记录不随行（ADR-0025）。
- 🔑 自带密钥：用户可以填自己的 LLM、语音合成、语音识别和生图密钥，用自己的额度，满足条件时不占限额（配置指南）。密钥只存在浏览器里（ADR-0017）。
- 🛠️ 后台：看用量、花费和进行中的通话，改模型和限额不用重启，封禁用户、发公告；看不到任何人的对话和记忆。
- 🚦 服务状态：用户在对话列表就能看到各项服务正不正常。
- 🔌 服务可以替换：模型支持 OpenAI Chat Completions、Responses 和 Anthropic Messages 三种接口；语音识别、向量化各有两家可选，判断模型有三家；每项服务都可以单独走网络代理。
- 🚀 一键部署：Docker Compose 生产配置，自带 Caddy（自动 HTTPS）和 coturn（TURN 中继）；CI 构建镜像并发布到 GHCR。
🚀 快速开始
让 Agent 帮你部署
不熟悉 Docker 和各种 API key 也没关系：把下面这段话发给你用的编程 Agent（Claude Code、Codex、Cursor 等都行），它会照仓库里的部署说明一步步带你做，碰到报错也会帮你查。
帮我部署 Eidolon-SC（https://github.com/Sallyn0225/eidolon-sc）。先把仓库克隆下来，
再照仓库里 docs/agents/deploying.md 带我一步步做。要我注册账号、申请 key 的地方告诉我怎么做；
key 我自己填进 .env，不贴给你。
[!NOTE]
为什么部署好了没有剧情、通话里也没有立绘？ 剧情文本和立绘素材的版权不属于本项目，不随仓库分发，仓库里只有同步工具。部署后自己同步一次就有了，Agent 会带你做（见部署说明的「剧情库」「立绘」）。同步之前，角色只凭人设回复，通话里只显示背景图。
自己动手
需要 Docker 与 Docker Compose，以及一个支持流式输出和工具调用的对话模型。不想装 Docker（比如在 Windows 上），也可以用 uv 和 Node.js 直接跑前后端，见下面的「开发」和部署说明的「三种跑法」。
git clone https://github.com/Sallyn0225/eidolon-sc.git && cd eidolon-sc
cp .env.example .env # 填写 CHAT_LLM_BASE_URL、CHAT_LLM_API_KEY、CHAT_LLM_MODEL，再加一行 EIDOLON_DEV_LOGIN=1
docker compose up --build
打开 http://localhost:3000 是落地页。点右上角的「登录」，在登录面板里选「开发登录」，随便填一个名字，同意隐私政策和使用条款、声明年满 13 岁后就进入对话列表，点一位偶像开始对话。
只填对话模型时能文字聊天。按需再补上其他服务的密钥，逐步开启语音通话、剧情回忆、记忆和立绘：
| 功能 | 需要的配置 |
|---|
| 文字对话 | CHAT_LLM_* |
| 语音通话 | FISH_AUDIO_API_KEY，加语音识别的 key：SONIOX_API_KEY（默认）或阿里云百炼的 DASHSCOPE_API_KEY |
| 剧情库 | 向量化的 key：SILICONFLOW_API_KEY（默认）或 GEMINI_API_KEY |
| 检索与记忆 | 向量化的 key、SILICONFLOW_API_KEY（重排），加判断模型：JEV_API_KEY（默认）、Cloudflare 或阿里云百炼的凭证 |
| 照片 | 判断模型，加生图的 key：NOVELAI_API_KEY |
| 立绘、招呼与酒吧的音乐 | EIDOLON_STAND_ASSETS_URL 和存放素材的存储桶 |
每项怎么配、配了以后有什么效果，见 配置指南；所有环境变量的说明见 .env.example。
配好以后运行 docker compose run --rm backend eidolon doctor（直接跑时在 backend/ 下 uv run --env-file=../.env eidolon doctor），它会逐项试一次各项服务，说明哪一项连不上、key 不对或者要走代理。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
