koishi-plugin-starfx-bot

StarFreedomX机器人的小功能，自用

已加入的功能列表：

• 明日方舟封印功能
• 闲鱼“卖掉了”功能
• 艾特我/他又不说话
• 我才不是机器人！
• 我也喜欢你！
• BanG Dream!边框绘制
• 群语录
• roll
• 待机人数记录
• 房间号记录
• 推特查看原图
• 复读
• echo
• 撤回
• 汇率推送
• 黑白名单配置
• 我的会话信息

List to Do

• 语录token通过聊天获取，并自动与语录web控制台通信 ✅
• 语录支持bot端添加tag ✅ Web 端已支持

语录功能

QQ 命令

命令	说明
投稿 [图片]	上传语录图片
语录 [tag]	随机获取语录（tag 加权）
语录.验证 <code>	验证身份，获取 Web Token
语录.重置	撤销当前 Token，重新验证
语录.删除群 <群号>	从访问列表移除群
语录.设权限 <qqId> <role>	Owner 设置用户权限（user/admin）
语录.用户列表	Owner 查看所有用户
语录.删除用户 <qqId>	Owner 删除用户

角色权限

操作	user	admin	owner
投稿 / 获取语录	✅	✅	✅
添加标签	✅	✅	✅
删除标签 / 图片	❌	✅	✅
查看操作日志	❌	❌	✅
管理用户	❌	❌	✅

配置项（koishi.yml）

starfx-bot:
  autoToken: true
  apiSecret: "随机密钥"
  ownerId: "你的用户ID"

字段	说明
autoToken	开启自动获取 Token
apiSecret	Web 端调 Bot API 的共享密钥
ownerId	Owner 的用户 ID（自动获得 owner 权限）

语录tag可视化控制

详情见StarFreedomX/image-tag-editor-web: 为starfx-bot的语录功能可视化添加tag

配置项的imageFolderPath填写Koishi数据文件夹下的/data/starfx-bot/record/

🔧 功能权限控制（可选）

本插件支持为各个功能设置 群聊白名单 / 黑名单，用于控制不同功能在指定群聊中是否启用。

• whitelist: ✅：启用白名单模式，仅允许列出的群使用该功能
• whitelist: 🟪：启用黑名单模式，禁止列出的群使用该功能
• groups：群号数组，必须为数字，用半角逗号分隔

若未配置某功能项，则默认所有群均可使用。

---

📌 可配置功能键一览

键名	功能说明
lock	明日方舟封印功能（对应openLock）
sold	闲鱼“卖掉了”功能（对应openSold）
repeat	群复读功能（对应openRepeat）
record	群语录功能（对应投稿、语录）
record-push	群语录功能（对应投稿）
record-get	群语录功能（对应语录）
atNotSay	“艾特我/他又不说话”系列功能
replyBot	“我才不是机器人！”系列功能
iLoveYou	“我也喜欢你”系列功能
bdbd	BanG Dream! 边框功能（对应bangdreamBorder）
roll	随机数功能
undo	撤回功能
echo	echo功能
originImg	rss获取推特原图
sendLocalImage	自定义指令发送图片功能(自定义指令也可配置，键为自定义的指令名称)
forward	消息转发功能
exchangeRate	汇率播报功能
myId	我的会话信息
pickup	车牌检测

---

🧪 示例：仅允许特定群使用 roll，禁止某群使用 sold

functionName	whitelist	groups
roll	✅	123456789
sold	🟪	789456123

更新日志

版本	更新日志
0.0.1	加入封印功能
0.1.0	加入"卖掉了"功能
0.2.0	加入"艾特我又不说话"回复功能
0.3.0	加入"我喜欢你"和"我才不是机器人！"回复功能
0.4.0	更改处理库为sharp
0.5.0	加入BanG Dream!边框功能
0.6.0	加入群语录功能，修复一处bangdream绘制的bug
0.7.0	加入复读功能
0.8.0	将各个工具函数封装在utils.ts中，更改语录的触发方式
0.9.0	添加白名单/黑名单模式，对每个功能做过滤
0.10.0	添加随机数功能
0.11.0	增加适配于onebot（主要是qq）的撤回功能
0.12.0	加入echo功能
0.13.0	语录支持tag以及调整权重
0.14.0	echo增加对引用消息的支持，且支持有at触发
0.15.0	自用rss获取推特原图
0.16.0	新增自定义指令发送本地图片功能(其实网络图片也行)
0.16.3	发送文件前转为使用base64
0.17.0	语录功能新增链接，可以配置权重
0.18.0	新增定时echo
0.19.0	新增查汇率功能
0.19.1	查汇率适配更多语法
0.19.2	查汇率修复文件缺失
0.19.3	转移currency.json到assets
0.19.4	inject database for ctx.broadcast
0.19.5	提取代码量较大的功能为单独插件
0.19.6	查汇率支持近5d
0.19.7	base64转换捕获file协议
0.19.8	base64适配linux目录
0.19.9	base64更改适配windows
0.19.10	减少不必要的控制台输出
0.19.11	修复无代理情况下无法查看原图的bug
0.20.0	gid uid cid查询功能
0.21.0	skia-canvas使用koishi服务实现
0.22.0	sharp改用koishi服务实现
0.23.0	jimp转sharp
0.24.0	build
0.24.1	检测sharp服务，删除无用配置
0.24.2	修复检测逻辑
0.25.0	优化功能控制模块
0.25.1	修正功能控制模块功能名相关bug
0.26.6	修正roll扔骰子的判断错误
0.26.8	修复sharp库传回参数改为对象的错误
0.27.0	新增监听车牌修改群名功能
0.27.1	车牌监听权限设置
0.27.2	车牌检测可以保留其他文字
0.27.3	修复at机器人bdbd时无法识别参数的bug
0.28.0	语录扩展及API