先上代码。这可能对大多数人来说没有必要，仅仅是我个人奇怪的操作习惯。

// 添加下面的代码到你继承了 ReadOnlyPluginData 或者 ReadOnlyPluginConfig 的配置类即可 @OptIn(ConsoleExperimentalApi::class) private lateinit var owner_: PluginDataHolder @OptIn(ConsoleExperimentalApi::class) private lateinit var storage_: PluginDataStorage @OptIn(ConsoleExperimentalApi::class) override fun onInit(owner: PluginDataHolder, storage: PluginDataStorage) { owner_ = owner storage_ = storage } // 不需要设为 public，直接调用扩展方法 save 即可 @OptIn(ConsoleExperimentalApi::class) private fun save() { kotlin.runCatching { storage_.store(owner_, this) }.onFailure { e -> // 记得处理异常 }

如果你只想关闭定时保存，不想关闭属性修改后自动保存，请用 AutoSavePluginData 或 AutoSavePluginConfig 并重写  ​shouldPerformAutoSaveWheneverChanged​() 使它返回 false

mirai 的只读配置文件曾让我陷入了两难的局地，按照我的个人理解，PluginConfig 是给用户确定插件的一些参数的，插件不应该去修改数值，所以我没用 AutoSavePluginConfig 而是用了 ReadOnlyPluginConfig，在我编写插件调试的过程中我发现一个问题，它真的是只读的 —— 这很正常，因为它就叫只读配置，它在配置文件不存在时会保存默认配置文件，但在我添加新的配置键到类之后，却因为它的只读而没有在配置文件里更新不存在的配置键……

这不符合我的预期，由于我当时没看到 AutoSavePluginData 里可以关定时保存，故着手研究如何保存只读配置，最后在 AutoSavePluginData 里找到了……

重载配置文件时，reload() 再 save()，即可更新不存在的配置键。

我只能以「简化成了我想要的样子不像 AutoSavePluginData 有我不需要的功能」来安慰自己了 :(

补充

经过讨论，ReadOnlyPluginData 无法保存是在旧版本 mirai 中的问题，在新版本 mirai 可正常保存（具体哪个版本我还没去验证）。添加上述代码可兼容在旧版本 mirai 保存只读配置文件。

有时候我们可能不可避免地要给配置文件添加注释以便提升配置文件可读性，这个时候就要添加注释了。

怎么用

要添加注释，首先导入包 yamlkt

compileOnly("net.mamoe.yamlkt:yamlkt-jvm:0.10.2")

然后在你的配置上头打上 @Comment 注解就行，比如

public object MyConfig : AutoSavePluginConfig("config") { @Comment("这是一条注释") public var message: String by value("awa") @Comment( """ 可以多行 就像这样 或者你用换行符也行 """ ) public var enable : Boolean by value(true) } 这其实 又是一个坑

我想加注释无奈 mirai-console 文档里没教程。

某天我忽然想到自带的自动登录配置文件不是有注释吗，于是我在源码找到了 AutoLoginConfig，才看到了 @Comment 注解。

其实这个东西就在 Him188/yamlkt 的最下面