koishi-plugin-twilight

风契公会语 C 机器人“希格斯”的 Koishi 插件。

安装后配置

插件通过 Koishi 的配置页读取以下内容：

• DeepSeek API Key、API 地址与模型
• 审核群、幕后群、幕前群、管理群
• 管理员 QQ 列表
• 是否启用调试功能

API Key、群号和管理员 QQ 均不会写入 npm 包。Linux 与 Windows 使用同一套 Koishi 配置机制，不需要 .env。审核群自动拒绝名单统一维护在源码文件 src/data/review-blacklist.ts 中；修改后需要重新构建并发布插件。 该名单及备注会被编译进 lib/index.js，如果 npm 包公开，包的下载者也能读取。

插件所需的四张 PNG 模板位于 data/twilight/templates，会随 npm 包安装。 运行时生成的临时图片仍写入 Koishi 工作目录的 data/twilight/images。

主要玩法

• 成员登记、欢迎与群名片
• 幕前字数积分、里程碑、积分流水与排行榜
• 正式任务、指定任务、协作者奖励与月度考核
• 私聊发送“领取月报”领取最新个人月报
• 食堂菜单与 12:00–14:00 免费食堂剧情分析
• 付费“请求分析支援”
• 每日公会实况、积分商城、角色线索与审核管理

完整指令见 docs/commands.md，数据库说明见 docs/database.md。

构建与发布检查

在仓库根目录执行：

yarn clean
yarn build
yarn test:twilight
cd external/twilight
npm pack --dry-run

npm pack --dry-run 的清单中应包含 lib/index.js、lib/index.d.ts 和 data/twilight/templates/*.png，且不应包含 .env、src、测试或本地数据库。