koishi-plugin-float

“但为君顾”无审无设语 C 群专用 Koishi 插件。机器人名为“小曦”，服务水群、戏群和管理群。

功能

• 数据库皮表、占皮二次确认、管理员补录/清档、六界群公告自动同步
• 运行时新增、修改、停用、启用或删除皮，无需改代码或重启
• 戏群普通消息与合并转发计字、计段、连续出戏倍率、每日计分上限与千字奖励
• 设定战阶初始修为、三万字满级的修为突破、戏群专属头衔同步
• 每日随机诗句抽签、管理员人数设置与提前结算
• 水群“首大罚末小”骰局，每人每轮只记录第一次骰面
• 水群随机/自定义头衔商城，AI 失败不扣分，QQ 接口失败自动退款
• 每周古风图片积分榜、低活跃提醒、可开关的 24 小时复查清理
• 水群/戏群自动同意加群申请、只提示不拦截的数据库黑名单
• 入群欢迎、群名片称号开头检查和 72 小时未完成登记清理
• 退群双群核对；只有确认同时离开水群和戏群才清档释放皮
• 占皮和确认退出两群后，向管理群发送对应 QQ 与原称号记录

安装

把整个 float 文件夹放到 Koishi 项目的 external 目录，与 twilight 并列：

external/
├── twilight/
└── float/

然后在项目根目录安装依赖并构建/重启 Koishi。控制台中启用 float，填写三个群号和管理员 QQ。DeepSeek API Key 只影响“随机头衔”，留空不会阻止其他功能。

首次启动会把 data/default-roster.json 写入数据库。之后数据库是唯一真源；不要直接修改 JSON 来维护已经上线的皮表，应使用管理群命令。

权限与适配器

机器人应为三个群的管理员，建议为水群和戏群群主。以下能力依赖 LLBot / OneBot 扩展接口：

• 群公告：_send_group_notice、_get_group_notice、_delete_group_notice（同时兼容旧别名 _del_group_notice）
• 专属头衔：set_group_special_title（通常需要机器人是群主）
• 踢出群成员：set_group_kick
• 自动审批：set_group_add_request
• 读取群名片：get_group_member_info
• 合并转发读取：get_forward_msg

QQ/LLBot 没有可靠的“原地编辑公告”接口，本插件采用“发布新公告 → 获取编号 → 删除旧公告”。数据库始终是皮表真源，接口失败会保留错误状态供重试。

完整规则见 docs/rules.md，全部指令见 docs/commands.md，上线前检查见 docs/release-checklist.md。