房间
房间是 ChatLuna 的主要组成部分。
想象一下你在不同的群里都可以私人配置不同的房间，使用不同的预设，聊天模式。
多个用户可以在一个房间里一起调教模型。
这可能是目前最复杂的在 bot 上的聊天系统，但也是自由度最高的系统。
切换房间
切换你在当前环境里（群聊或私聊里）默认使用的房间。
切换后使用聊天命令等，会默认使用此的房间。
提示
如执行其他指令（加入房间），将会自动切换在当前环境里默认使用的房间。
以下为命令格式:
chatluna.room.switch <room:text>以下为例子:
创建房间
创建新的房间，并将当前环境的默认房间切换为新创建的房间。
此命令是目前已知的 ChatLuna 里前三复杂的指令。
命令含有两种模式：如果没有携带任何子参数，则自动进入交互式创建。否则将直接基于子参数进行快速创建。
提示
快速创建最低只需要携带 -n 参数。对于缺失的必须参数(如模型),会自动使用模版房间的配置。
以下为命令格式:
chatluna.room.create -n <name:string> -p <preset:string> -m <model:string> -c <chatMode:string> -w <password:string> -v <visibility:string>以下为可选参数:
-n,--name: 指定房间的名字。-p,--preset: 指定房间的预设。-m,--model: 指定房间的模型。-c,--chatMode: 指定房间的聊天模式。-w,--password: 指定房间的密码。
在这里我们分别介绍交互式创建和快速创建的例子。
交互式创建:
快速创建:
设置房间
设置当前环境的默认房间的配置。
此命令是目前已知的 ChatLuna 里前三复杂的指令。
和创建房间指令一样。命令含有两种模式：如果没有携带任何子参数，则自动进入交互式创建。否则将直接基于子参数进行创建。
以下为命令格式:
chatluna.room.set -n <name:string> -p <preset:string> -m <model:string> -c <chatMode:string> -w <password:string> -v <visibility:string>以下为可选参数:
-n,--name: 指定房间的名字。-p,--preset: 指定房间的预设。-m,--model: 指定房间的模型。-c,--chatMode: 指定房间的聊天模式。-w,--password: 指定房间的密码。-v,--visibility: 指定房间的可见性。
如果你想更换当前环境默认房间的模型，可以只带上 -m 参数:
对于该命令，我们不推荐你使用交互式创建。
额外的，如果你对该房间设置了新的预设，那么该房间之前的聊天记录会自动清空。
删除房间
删除某个已经加入了的房间。
警告
此命令只有房主能够执行。但如果执行者最低 3 级权限,那么也将会执行删除房间的操作。
以下为命令格式:
chatluna.room.delete <room:text>以下为可选参数:
room: 指定要删除的房间，默认为当前环境的默认房间。
以下为例子:
列出房间信息
列出在当前环境（群聊或私聊）里使用的房间的信息
以下为命令格式:
chatluna.room.info [room:text]以下为可选参数:
room: 指定要查询的房间，默认为当前环境的默认房间。
以下为例子:
设置自动更新
设置当前环境的房间是否跟随控制模版的配置更新。
如果设置为 false，当修改主插件的里的模版房间配置（如模型等），将不会自动更新配置。
该选项只对模版控制房间生效。
以下为命令格式:
chatluna.room.auto-update -r <room:string> <enable:boolean>以下为可选参数:
-r,--room: 指定要设置的房间，默认为当前环境的默认房间。enable: 指定是否开启自动更新权限，默认为 true。
以下为例子:
转移房主
将你在当前环境里默认使用的房间的房主转移给其他用户。
需要当前你默认使用的房间为房主。
提示
如果执行者的 Koishi 权限大于3，那么他将可以直接转移房主。包括转移到自己身上。
以下为命令格式:
chatluna.room.transfer <user:user>以下为可选参数:
user: 指定转移房间房主的用户 ID。(需要 AT 目标用户)
以下为例子:
邀请加入房间
邀请其他用户加入当前环境里默认使用的房间。
需要当前你默认使用的房间为管理员或房间权限。
提示
如果执行者的 Koishi 权限大于3，那么他将可以直接邀请用户加入房间。包括邀请自己加入。
以下为命令格式:
chatluna.room.invite <...arg:user>以下为可选参数:
user: 邀请加入房间的用户 ID。(支持 AT 多个用户)
以下为例子:
离开房间
退出加入某个房间。
提示
如果执行者为该房间的房主，这将导致该房间被删除。
以下为命令格式:
chatluna.room.leave [room:text]以下为例子:
踢出房间
将某用户踢出当前环境里默认使用的房间。
需要当前你默认使用的房间为管理员或房间权限。
以下为命令格式:
chatluna.room.kick <...arg:user>以下为可选参数:
user: 踢出房间的用户 ID。(需要 AT 目标用户)
以下为例子:
修改用户权限
修改某用户在当前环境里默认使用的房间的权限。
需要当前你默认使用的房间为管理员或房间权限。
以下为命令格式:
chatluna.room.permission <user:user>以下为可选参数:
user: 指定修改权限的用户 ID。(需要 AT 目标用户)
以下为例子:
禁言用户
禁言某用户在当前环境里默认使用的房间。
执行一次为禁言操作，反之则为取消禁言操作。禁言操作没有时间限制。
需要当前你默认使用的房间为管理员或房间权限。
以下为命令格式:
chatluna.room.mute <...arg:user>以下为可选参数:
user: 禁言房间的用户 ID。(需要 AT 目标用户)
以下为例子:
列出房间列表
列出你目前在当前环境里已经加入了的房间列表。
以下为命令格式:
chatluna.room.list -l <limit:number> -p <page:number>以下为可选参数:
-l,--limit: 指定返回的房间数量上限，默认为 3。-p,--page: 指定返回的房间页数，默认为 1。
以下为例子:
清除聊天记录
清除当前房间的聊天记录。
相当于重置模型记忆，开始新的会话。有助于获取不同的对话风格。
以下为命令格式:
chatluna.room.clear [room:text]以下为例子:
