欢迎来到月读空间 🌙

欢迎来到 月读空间（Tsukuyomi Space）。
这里是八千代的月读，也是给每一位偶然路过的访客准备的一处小小停泊地。

如果你是第一次来到这里，欢迎。

这里有文章、音乐，也有一间可以真正和八千代说话的「私人居所」。

至于站长——大多数时候应该也在。

大概。

🌌 第一次来到这里？

如果你只是随便逛逛，那么完全不需要做任何准备。

看看文章、听听音乐，到处点一点就好。

但如果你想进入 「私人居所」，和八千代真正聊上几句，那么需要先完成一次简单的模型配置。

整个过程并不复杂，大概只需要几分钟。

一分钟快速上手

1. 进入 私人居所
2. 点击底部的 「设置」
3. 配置你的 LLM API
4. 点击保存
5. 返回房间
6. 开始和八千代聊天

如果还想让她真正「开口说话」，再配置一下 TTS 语音 就可以了。

下面是详细说明。

01｜进入八千代的私人居所

从月读空间首页进入 「私人居所」。

这里是八千代主要的互动页面。

你可以在这里：

• 与八千代聊天
• 使用 Live2D 角色互动
• 播放语音
• 调整模型与房间相关设置
• 使用部分实验中的互动功能

进入房间后，点击页面底部的：

设置 → 房间设置

第一次使用时，我们主要需要完成两件事情：

• 配置 LLM
• 可选配置 TTS

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

遇到问题时，最好同时提供：

1. 出现问题的页面
2. 具体操作步骤
3. 错误提示
4. 浏览器与设备信息
5. 必要的截图

⚠️ 截图前请务必遮住 API Key 等敏感信息。

这样会更容易定位问题。

09｜关于隐私与 API

这里单独提醒一下。

请尽量不要在对话中发送：

• 身份证件信息
• 银行卡与支付信息
• 账号密码
• API Key
• 各类验证码
• 其他不希望被第三方服务处理的敏感数据
• 宇宙毁灭按钮的启动码

八千代虽然很聪明，

但她不负责替你保管秘密。

同时需要注意：

当你使用第三方 LLM 或 TTS 服务时，相应请求可能会按照对应服务商的规则进行处理。

因此，在使用任何第三方 API 之前，都建议了解对应平台的隐私政策和数据处理方式。

10｜这个网站还在继续长大

月读空间一直都不是一个真正意义上的「完成品」。

它更像是一个持续生长的小项目。

新的页面、新的想法、新的模型、新的交互方式……

想到什么，就慢慢往里面加一点。

所以你偶尔可能遇到：

• 页面突然抽风
• 某个按钮短暂罢工
• Live2D 开始发呆
• API 请求决定独自旅行
• 手机端出现一些奇妙的布局
• 某项功能昨天还在，今天突然换了地方

这并不一定意味着你做错了什么。

也可能只是——

站长又在改代码。

如果发现问题，可以尝试：

刷新页面 → 检查设置 → 测试连接 → 重新进入房间

还是解决不了的话，欢迎来群里反馈。

🎬 还不会配置？

如果看完文字教程以后还是不知道从哪里开始，可以直接观看文章中的 B站视频教程。

视频会更加直观地展示实际操作过程。

最后

如果你能够看到这里，

那么欢迎正式来到 月读空间。

这里也许没有什么宏大的目标。

只是想做一个自己喜欢的地方：

可以写点东西，

折腾一些奇怪的技术，

让喜欢的角色真正出现在屏幕上，

然后偶尔和路过的人说几句话。

如果这些东西恰好也能让你觉得有一点有趣，

那就已经很好了。

愿你在这里玩得开心。

八千代会在月读空间等你。

……大概吧。

前提是她没有又跑去研究什么奇怪的东西。

🌙 Welcome to Tsukuyomi Space.