当前版本：v1.0.0
详细配置与使用指南请查阅：TodayWaifu 完整使用指南与配置手册
本插件是 早柚核心 (gsuid_core) 的扩展插件，须先完成 GsCore 框架部署方可使用。首次安装后需重启 GsCore 才能完全生效
Note
插件仍在持续迭代。使用中如遇问题或有改进建议，欢迎提交 Issue，或加入交流群 798949533 讨论。
- 前提：已部署 gsuid_core。
- 将本仓库克隆至 GsCore 插件目录，随后重启：
cd gsuid_core/gsuid_core/plugins
git clone https://github.com/MimoKit/TodayWaifu也可以向机器人发送：
core安装插件TodayWaifu
重启 GsCore 后，框架会按 pyproject.toml 安装插件依赖，包括腾讯云 COS SDK。
安装完成后，在聊天窗口发送以下指令即可获取完整的可视化帮助图：
今日老婆帮助
普通个人账号（OB11）保持默认配置即可使用原有发送方式，无需配置 QQ 官方机器人模式或 COS。 首次抽取角色前，请按下文准备本地图库，或选择远程图库并填写访问令牌。
在 GsCore 网页控制台 配置，图片来源按功能独立选择：
| 配置项 | 作用范围 | 默认 |
|---|---|---|
DailyWifeImageSource |
今日老婆 / 今日老公 | local |
DailyWifeNteImageSource |
今日异环老婆 | gallery |
DailyWifePgrImageSource |
今日战双老婆 | gallery |
DailyLoliImageSource |
今日萝莉 | gallery |
local：只读取本地图库，不请求远程接口；本地没有图片的角色会被跳过。gallery：使用远程图库接口，接口不可用时按功能回退本地资源。
各功能默认值与升级前行为一致。普通老婆、今日老公和今日异环老婆默认关闭，可在控制台开启。
本仓库不包含角色图片。首次安装使用 local 时，需要已有 XutheringWavesUID 本地图库，
或在 DailyWifeCustomRolePilePath 配置自己的角色图片目录；没有本地图片时，可将对应来源改为
gallery，并填写下方的图库访问令牌。
图库的列表接口与图片本身均要求鉴权，必须在控制台填写
DailyWifeGalleryToken，否则拉取列表和下载图片都会返回 403。
令牌请进 QQ 交流群 798949533 获取， 或前往 https://twf.xlinxc.cn 自助申请；留空则不携带令牌。无论通过哪种方式申请， 均需加入该交流群，未加群者不予审核。
插件会在列表与图片两类请求上都自动携带该令牌；当图库因限流、封禁或配额拒绝时， 会提示对应的处理方式，而不会笼统地提示检查令牌。列表返回的图片地址自带短期签名， 插件下载图片时同时携带令牌，因此即使签名已过期（例如读取昨天抽到的老婆记录） 也能正常取图。
Warning
远程图库模式会从线上接口拉取并发送图片。部分图片可能存在风控风险，请自行评估是否启用；因使用远程图库产生的任何风险由部署者自行承担。
QQ 官方机器人需要在 GsCore 网页控制台的 QQ机器人配置 页开启
DailyWifeQqBotMode（是否开启QQ机器人模式）。该开关默认关闭。
开启后，角色结果图会上传到腾讯云 COS，并通过 Markdown 发送。请填写以下配置：
| 配置项 | 填写内容 |
|---|---|
DailyWifeQqBotCosRegion |
存储桶所在地域，例如 ap-guangzhou |
DailyWifeQqBotCosBucket |
带 APPID 后缀的存储桶名，例如 qqbot-1234567890 |
DailyWifeQqBotCosSecretId |
有该存储桶上传和读取权限的腾讯云 SecretId |
DailyWifeQqBotCosSecretKey |
对应的 SecretKey |
COS 上传目录和图片链接有效期可保留默认值。插件使用带签名的 HTTPS 图片链接， 无需将整个存储桶设为公有读。
在插件业务配置中开启 启用娶群友（DailyWifeMarryGroupMemberEnabled）后，
群内发送 娶群友 即可使用。成员来自 GsCore 已记录的本群成员缓存。
娶群友统一发送原有文案和单张群友头像；QQ 官方模式开启时使用 Markdown @，
关闭时使用普通 @，并遵守 发送时艾特触发者（DailyWifeAtUser）开关。
摸头是可选功能。在 QQ机器人配置 页的 DailyWifeMemeGeneratorUrl
填写已部署的 meme-generator 后端地址后，可发送 摸头 或 群友摸头，
用最近一次娶到的群友头像生成表情包。后端地址留空只影响摸头，不影响娶群友。
感谢所有为 TodayWaifu 提交代码、修复问题、完善文档或提出建议的人。
贡献者头像和提交贡献数会由 GitHub Actions 从仓库 Contributors API 自动更新（每周一次，也会在 main 更新时刷新）；机器人账号不显示。
 MimoKit 201 contributions |
 linsheng0s 17 contributions |
 Xbaiyz12 9 contributions |
 CWalkene 8 contributions |
 spaxie 5 contributions |
 zory1117 2 contributions |
 KimigaiiWuyi 1 contribution |
- 感谢 An 提供的老婆图库服务器支持。
- 感谢 CWalkene 提供的插件修改和建议。
- 感谢 wuyi 提供的插件帮助图UI设计
- 本项目仅供学习与交流使用，严禁用于任何商业用途。
- 本项目采用 GNU General Public License v3.0 (GPLv3) 协议开源。
本插件为增强娱乐互动体验，内置了部分游戏与动漫作品的角色台词、文案及语音文本，涉及但不限于：
- 《鸣潮》（Wuthering Waves）—— 版权归 库洛游戏（Kuro Games） 所有
- 《异环》（NTE）—— 版权归 完美世界（Perfect World） 旗下 Hotta Studio 所有
- 《战双帕弥什》（Punishing: Gray Raven）—— 版权归 库洛游戏（Kuro Games） 所有
- 以及其他动漫、番剧、游戏作品中的角色台词与相关文案 —— 版权归各自原作者、动画制作公司、出版社及发行商所有
上述台词、文案、角色名称及相关内容的著作权、版权及其他一切权利，均归其原作品版权方、开发商、发行商及原作者所有。本插件仅在非商业性的娱乐互动场景中引用这些内容，不以任何形式主张对上述素材的版权，亦不代表与原版权方存在任何关联、合作或授权关系。
若相关版权方认为本插件的内容引用侵犯了您的合法权益，请通过 Issue 或交流群 798949533 联系我们，我们将在核实后第一时间删除或调整相关内容。
- 本插件代码部分版权归 TodayWaifu 项目及贡献者所有，采用 GPLv3 协议开源。
- 插件内置的游戏台词、动漫文案、角色名称及相关素材，版权归各自原版权方所有（详见上方「关于内置台词文案的版权说明」）。
- 除另有说明外，本项目不拥有任何第三方游戏、动漫素材的版权。