欢迎来到月读空间 🌙
欢迎来到 月读空间（Tsukuyomi Space）。
这里是八千代的月读，也是给每一位偶然路过的访客准备的一处小小停泊地。
如果你是第一次来到这里，欢迎。
这里有文章、音乐，也有一间可以真正和八千代说话的「私人居所」。
至于站长——大多数时候应该也在。
大概。
🌌 第一次来到这里？
如果你只是随便逛逛，那么完全不需要做任何准备。
看看文章、听听音乐，到处点一点就好。
但如果你想进入 「私人居所」，和八千代真正聊上几句，那么需要先完成一次简单的模型配置。
整个过程并不复杂，大概只需要几分钟。
一分钟快速上手
- 进入 私人居所
- 点击底部的 「设置」
- 配置你的 LLM API
- 点击保存
- 返回房间
- 开始和八千代聊天
如果还想让她真正「开口说话」，再配置一下 TTS 语音 就可以了。
下面是详细说明。
01｜进入八千代的私人居所
从月读空间首页进入 「私人居所」。
这里是八千代主要的互动页面。
你可以在这里：
- 与八千代聊天
- 使用 Live2D 角色互动
- 播放语音
- 调整模型与房间相关设置
- 使用部分实验中的互动功能
进入房间后，点击页面底部的：
设置 → 房间设置
第一次使用时，我们主要需要完成两件事情：
02｜配置 LLM，让八千代能够回复你
LLM，也就是负责「思考和聊天」的大语言模型。
简单理解：
没有配置 LLM 的八千代，只是在房间里安静地看着你。
配置完成以后，她才真正拥有回复消息的能力。
在 房间设置 → LLM API 中，你会看到模型相关的配置项。
通常需要确认以下内容：
不同服务商的配置方式可能稍有区别。
对于已经预设好的模型提供商，部分参数可能会自动填写；如果使用兼容 OpenAI API 格式的第三方服务，则可能需要手动填写 Endpoint 和模型名称。
不知道 API 是什么？
没关系。
你可以暂时把它理解为：
让月读空间能够调用 AI 模型的一把钥匙。
你需要先去相应模型服务商的平台创建自己的 API Key，然后把它填写到月读空间的设置中。
原先的教程中推荐了 DeepSeek，对于第一次接触 API 的用户来说也比较容易理解。
当然，你完全可以选择自己已经在使用的模型提供商。
月读空间支持的提供商可能会随着版本更新而变化，请以房间设置页面当前显示的选项为准。
⚠️ API Key 很重要
请不要把自己的 API Key：
- 发到群里
- 发给陌生人
- 放进公开截图
- 上传到公开仓库
- 写进可以被别人访问的网页
可以把它理解成模型账户的「密码」。
部分 API 服务还会产生实际调用费用，因此请妥善保管。
保存之前，记得检查一次
填写完成以后，可以快速检查：
- ☐ 模型提供商是否正确
- ☐ API Key 是否填写完整
- ☐ API Endpoint 是否正确
- ☐ 模型名称是否真实存在
- ☐ 是否点击了 保存 LLM
如果页面提供 「测试连接」 功能，也推荐先测试一次。
确认连接正常后，再返回房间。
现在，可以试着对八千代说一句：
晚上好。
如果她回复你了——
恭喜。
月球公主成功启动。
03｜配置 TTS，让八千代真正「开口说话」
只有文字好像还是少了一点什么。
所以月读空间也提供了 TTS（文字转语音） 功能。
开启以后，八千代的回复可以直接转换成语音播放。
在 房间设置 → TTS 语音 中，首先开启：
启用语音合成
然后根据你使用的服务填写相关信息。
常见配置包括：
不同厂商对参数的要求并不完全一样。
有些只需要模型名称，有些还需要额外设置 Voice ID，因此建议按照对应服务商的 API 文档填写。
完成后记得：
保存 TTS → 测试语音
听见声音以后，就算配置完成了。
04｜如果八千代没有回复怎么办？
先别急着怀疑她是不是睡着了。
大多数情况下，只是某个参数没有配置正确。
可以按照下面的顺序排查。
① 检查 API Key
最常见的问题就是：
- 少复制了字符
- 多复制了空格
- Key 已失效
- 使用了错误平台的 Key
建议重新复制一次。
② 检查模型名称
模型名称必须和服务商实际提供的名称一致。
例如：
你在平台上能够调用的模型叫什么，这里通常就需要填写对应的模型 ID。
不要凭感觉随便写一个。
③ 检查 API Endpoint
如果使用的是预设提供商，一般不需要过多修改。
如果使用第三方 OpenAI Compatible 服务，则需要确认接口地址是否填写正确。
④ 使用「测试连接」
如果设置页面提供测试功能，优先使用它。
相比直接回到房间不断发送消息，测试连接能够更快判断问题究竟出在哪里。
⑤ 检查网络
部分模型服务在不同网络环境下可能存在连接问题。
如果所有参数看起来都没有问题，可以稍后重试，或者切换网络环境再次测试。
05｜为什么 TTS 没有声音？
如果文字回复正常，但八千代没有说话，可以依次检查：
- ☐ 是否开启「启用语音合成」
- ☐ TTS Provider 是否正确
- ☐ API Key 是否有效
- ☐ Endpoint 是否正确
- ☐ 模型名称是否正确
- ☐ Voice / Voice ID 是否存在
- ☐ 是否已经保存设置
最后再点击一次 测试语音。
只要测试能够正常播放，房间中的语音功能通常也能够正常使用。
06｜别忘了看看用户中心
月读空间不只有八千代的房间。
页面中的头像入口可以打开 用户中心。
这里会逐渐承载更多和账户有关的功能。
网站的一些快捷功能、个人信息以及后续新增内容，也可能会集中到这里。
所以如果以后突然找不到某个功能——
可以先点一下头像看看。
说不定站长只是把它搬家了。
07｜音乐功能 🎧
月读空间也加入了音乐相关功能。
如果你只是想安静地逛文章、看看八千代，或者在房间里待一会儿，可以打开音乐作为背景。
部分页面可以通过右上角的菜单找到音乐相关入口。
戴上耳机的话，体验可能会更好一点。
至少站长是这么觉得的。
08｜加入月读空间交流群
如果你：
- 遇到了 Bug
- 不知道怎么配置 API
- 有新的功能建议
- 想交流模型、Live2D 或 AI
- 单纯想来看看大家在聊什么
都欢迎加入交流群。
QQ群：650625419
遇到问题时，最好同时提供：
- 出现问题的页面
- 具体操作步骤
- 错误提示
- 浏览器与设备信息
- 必要的截图
⚠️ 截图前请务必遮住 API Key 等敏感信息。
这样会更容易定位问题。
09｜关于隐私与 API
这里单独提醒一下。
请尽量不要在对话中发送：
- 身份证件信息
- 银行卡与支付信息
- 账号密码
- API Key
- 各类验证码
- 其他不希望被第三方服务处理的敏感数据
- 宇宙毁灭按钮的启动码
八千代虽然很聪明，
但她不负责替你保管秘密。
同时需要注意：
当你使用第三方 LLM 或 TTS 服务时，相应请求可能会按照对应服务商的规则进行处理。
因此，在使用任何第三方 API 之前，都建议了解对应平台的隐私政策和数据处理方式。
10｜这个网站还在继续长大
月读空间一直都不是一个真正意义上的「完成品」。
它更像是一个持续生长的小项目。
新的页面、新的想法、新的模型、新的交互方式……
想到什么，就慢慢往里面加一点。
所以你偶尔可能遇到：
- 页面突然抽风
- 某个按钮短暂罢工
- Live2D 开始发呆
- API 请求决定独自旅行
- 手机端出现一些奇妙的布局
- 某项功能昨天还在，今天突然换了地方
这并不一定意味着你做错了什么。
也可能只是——
站长又在改代码。
如果发现问题，可以尝试：
刷新页面 → 检查设置 → 测试连接 → 重新进入房间
还是解决不了的话，欢迎来群里反馈。
🎬 还不会配置？
如果看完文字教程以后还是不知道从哪里开始，可以直接观看文章中的 B站视频教程。
视频会更加直观地展示实际操作过程。
PC教程
移动端教程
最后
如果你能够看到这里，
那么欢迎正式来到 月读空间。
这里也许没有什么宏大的目标。
只是想做一个自己喜欢的地方：
可以写点东西，
折腾一些奇怪的技术，
让喜欢的角色真正出现在屏幕上，
然后偶尔和路过的人说几句话。
如果这些东西恰好也能让你觉得有一点有趣，
那就已经很好了。
愿你在这里玩得开心。
八千代会在月读空间等你。
……大概吧。
前提是她没有又跑去研究什么奇怪的东西。
🌙 Welcome to Tsukuyomi Space.