从旧版本升级

如果你以前用过 YesImBot v3 或更早版本，这个页面会告诉你 v4 有哪些重要变化。它不适合“直接照抄旧配置”，因为很多旧设置已经不存在了。

一句话说明

v4 是重写版本，不是一次普通的版本更新。旧配置不能直接搬过来，机器人的人设、记忆、插件和模型配置都需要重新设置一遍。

主要变化

旧版本	v4
核心插件里配置模型服务	安装独立的模型服务插件
旧的模型组和任务分配	直接在配置里选择聊天模型
旧版“允许频道”配置	新的“允许响应的频道”白名单
旧版核心记忆目录	由 PERSONA.md、AGENTS.md 和会话文件负责
旧版世界状态摘要	会话压缩、归档和可选记忆插件
旧的扩展工具体系	通过 Launcher 接入 v4 源码并启用功能插件

升级时要做的事

1. 备份旧人设、旧记忆文件或旧配置内容。
2. 安装 Launcher，并运行 yesimbot-cli init 接入 v4 源码。
3. 在 Koishi 控制台启用一个模型服务插件并填写 API Key。
4. 重新选择聊天模型。
5. 重新配置“允许响应的频道”。
6. 在 Koishi 插件列表里按需启用功能插件；当前 v4 插件未上架 npm/插件市场，不需要逐包安装。

升级后没有自动迁移

• 旧会话文件不会自动转换格式。
• 旧目录布局不会被读取。
• 重置会话只会清空当前频道的新会话和资源，不会恢复旧版本数据。

如果你还保留旧文件，建议先备份到其他地方，不要指望 v4 自动读取。