koishi-plugin-hhs-huatu

# koishi-plugin-hhs-huatu [![npm](https://img.shields.io/npm/v/koishi-plugin-hhs-huatu?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-hhs-huatu) ## 介绍该插件基于 [novelai-bot](https://bot.novelai.dev/) 进行二次开发，增添多项实用功能。 **交流群：** [112879548](https://qm.qq.com/q/4nKKvckKbu) - 欢迎加群体验和反馈问题！ **作者QQ：** 2275438102 **项目地址：** [GitHub](https://github.com/hhs2275/koishi-plugin-hhs-huatu) ## 🔑 授权令牌的获取如何获取 NovelAI 的授权令牌（Token），请参考下图： ![令牌获取教程](./images/令牌获取教程.png) ## ✨ 功能特性 ### 🖼️ 以图生图支持 NovelAI 的图片转图片功能，可调节生成强度和噪声。直接添加图片在指令最后即可触发。 ### 🖌️ 局部重绘（Inpainting）支持 NovelAI V4/V4.5 模型的局部重绘功能，可对图片特定区域进行重新生成： **使用方法：** ```bash nai4 -M <提示词> <图片> ``` **交互流程：** 1. 发送命令后，机器人会返回一张调暗的原图 2. 使用画图工具在需要重绘的区域涂上**白色** 3. 在 120 秒内发送涂好的图片 4. 机器人开始局部重绘并返回结果 **技术特点：** - 采用 8x8 像素网格对齐算法，适配 V4 模型的 Latent 空间 - 自动膨胀处理，确保重绘边缘过渡自然 - 交互过程不占用任务队列 ### 🎨 角色提示词功能（Characters）支持为图像中的不同角色指定独立的提示词和位置，仅适用于 NovelAI v4/v4.5 模型。 **支持的模型：** - ✅ nai-diffusion-4-curated-preview (`nai4c`) - ✅ nai-diffusion-4-full (`nai4`) - ✅ nai-diffusion-4-5-curated (`nai4-5c`) - ✅ nai-diffusion-4-5-full (`nai4-5`) **使用方法：** ```bash # 基本格式 nai4 场景描述 -K "角色1@位置;角色2@位置" # 带负向提示 nai4-5 场景 -K "1girl, smile@B3 --uc:frown;1boy, tall@D3 --uc:short" # 使用中文分号（更方便） nai4c 场景 -K "角色1@A1；角色2@E5" ``` **位置坐标表（5×5网格）：** ``` A B C D E 1 A1 B1 C1 D1 E1 (顶部) 2 A2 B2 C2 D2 E2 3 A3 B3 C3 D3 E3 (中心) 4 A4 B4 C4 D4 E4 5 A5 B5 C5 D5 E5 (底部) (左) (右) ``` **语法说明：** - 格式：`A-E`(横向) + `1-5`(纵向)，如 `A1`(左上) 到 `E5`(右下) - 默认位置：`C3`(中心) - 分隔符：`;` 或 `；`（支持中英文分号） - 位置：`@位置` (如 @B3)，可选 - 负向提示：`--uc:xxx`，可选详细文档请查看插件目录下的 `CHARACTERS_USAGE.md`。 ### 🎯 精准参考（Precise Reference）（仅支持 v4.5 模型）（原角色参考）支持 NovelAI v4.5 模型的精准参考功能，允许上传多张参考图来进行角色或风格的控制。 **使用方法：** ```bash nai4-5 <提示词> -P -p "cs,1,1;c,0.8,0.9" ``` **交互流程：** 1. 发送上述指令后，机器人会提示等待发送精确参考图片。 2. 在 60 秒内发送图片（支持一次发送多张或分段发送），最多可支持 6 张。 3. 图片发送完毕后，回复“开始”执行绘画，若要放弃则回复“取消”。 **参数定义 (-p)：** - **多图分割**：使用分号（`;` 或 `；`）隔开对应不同图片的参数设定。 - **设值格式**：`模式,强度,保真度`（默认值：`cs,1,1`） - **模式 (Mode)**：可选 `cs`（角色+风格）、`c`（仅角色）或 `s`（仅风格） - **强度 (Strength)**：0 ~ 1 的数字 - **保真度 (Fidelity)**：0 ~ 1 的数字 > **注意：** 此功能在使用时会消耗额外的 Anlas（每张参考图额外扣除 5 点数）。 ### 🎬 导演工具支持多种图像处理工具： - **线稿提取**：提取图像线条 - **素描转换**：转换为素描风格 - **背景移除**：智能移除背景 - **图像上色**：为线稿上色 - **表情修改**：调整角色表情 - **删除文字**：移除图片中的文字发送 `help 导演工具` 查看详细说明。 ### 📋 智能队列系统解决多用户同时使用时的 429 错误问题： - 支持限制总队列数量和单用户队列数量 - 超出限制自动进入冷却时间，防止滥用 - 多 Token 池支持，提高并发处理能力 - 管理员可使用 `novelai.reset-queue <user>` 重置用户队列状态 ### 🔄 便捷重画功能一键重新生成之前的作品： - 支持灵活的指令格式：`重画`、`重画一下`、`重画两张`、`重画2张`等 - 支持重画 1-10 张图片 - 自动使用上次的参数 ### 💰 点数控制系统基于本地算法精确模拟各功能的 Anlas 消耗并进行预扣费，确保消耗透明且防止恶意刷图。 **计费细则：** - **默认消耗**：根据生成目标的像素总数进行基础扣费。 - **SMEA / DYN 加成**：一旦开启基于采样算法的优化SMEA 单独开启（nai -S tags） **1.2 倍** 放大，同时开启SMEA 和 DYN 消耗（nai -d tags） **1.4 倍** 放大。 - **以图生图**：系统会根据设定的去噪强度（`strength`）等比缩放扣除额度。 - **精确参考（-P）**：由于其附带复杂的预处理，每挂载一张参考图均会**额外扣除 5 点数**。 - **导演工具（Director Tools）**： - 普清免扣：分辨率在 `1024×1024`（或 1,048,576 像素）及以下时，处理**免收基础点数**。 - 高清计费：超过安全像素后根据公式 `像素数 ÷ 50000 - 1.8` 收取超额积分。 - **背景移除（bg-removal）**：单独的高耗能功能，使用时将在原本成本上强制**额外增加 65 点消耗**。 > **提示：** 因网络、超时、官方服务器熔断等原因导致的执行失败，系统会在阻断生成的瞬间启动安全机制，将已预扣的点数**全额退还**至您的账户。 ### 👥 会员系统（可选）完善的会员管理系统，支持差异化服务： **基础功能：** - ✅ 会员权限管理（授予/取消/查询） - ✅ 自动叠加会员时长 - ✅ 差异化的每日使用限额和冷却时间 - ✅ 会员列表查看（支持分页） **高级功能：** - ✅ **自动清理**：定时清理过期会员和不活跃用户数据 - ✅ **到期提醒**：提前提醒即将到期的会员 - ✅ **调试工具**：管理员可手动触发清理和提醒任务 **相关指令：** ```bash 会员 # 查询自己的会员状态会员 -u <QQ号> # 查询指定用户状态（需管理员权限）会员 -u <QQ号> -d <天数> # 授予会员（需管理员权限）会员 -u <QQ号> -c # 取消会员（需管理员权限）会员 -l # 查看所有会员列表会员调试 -s # 查看定时任务状态（需配置启用）会员调试 -c # 立即执行清理任务会员调试 -r # 立即执行提醒任务 ``` 使用 `help 会员` 查看完整指令说明。 ### 🛡️ 图片审核系统自动审核生成的图片，过滤不当内容： - 支持腾讯云和 API4AI 审核引擎 - 可配置审核失败时的处理方式（阻止发送/忽略） - 支持自动禁言违规用户 - 可指定审核的群组范围 ### ⚙️ 其他功能 - **多模型支持**：快捷指令 `nai4`、`nai4c`、`nai4-5`、`nai4-5c` 直接调用不同模型 - **参数调整**：`-R` 参数调整 cfg_rescale（范围 0-1） - **调试模式**：可配置是否输出详细调试日志 ## 使用说明 ### 基本指令 ```bash # 文本生图 nai <提示词> # 使用默认模型 nai4 <提示词> # 使用 v4 full 模型 nai4c <提示词> # 使用 v4 curated 模型 nai4-5 <提示词> # 使用 v4.5 full 模型 nai4-5c <提示词> # 使用 v4.5 curated 模型 # 局部重绘（仅 v4/v4.5） nai4 <提示词> <图片> -M # 角色提示词（仅 v4/v4.5） nai4 场景 -K "角色1@位置;角色2@位置" # 常用参数 -m <模型> # 指定模型 -r <分辨率> # 指定分辨率（portrait/landscape/square 或宽x高） -s <采样器> # 指定采样器 -t <步数> # 迭代步数 -x <种子> # 随机种子 -c <scale> # CFG Scale -R <rescale> # CFG Rescale (0-1) -u <负向提示> # 负向提示词 -M # 启用局部重绘模式 -K <角色> # 角色提示词 -P # 启用精准参考功能（仅 v4.5） -p <参数> # 精准参考参数配置 (如 "cs,1,1") # 重画功能重画 # 重画上一张重画 3 # 重画 3 张 ``` 详细指令使用 `help nai` 查看。 --- ## 图片审核配置 ### 腾讯云审核本功能使用数据万象 CI 为用户提供低延时、准确、标签丰富的内容审核服务，采用前沿的识别算法，结合海量的违规数据进行训练建模，对图片进行敏感内容审核，过滤色情性感、违法违规、广告宣传等多个场景。 #### 价格说明 - **免费额度**：10万次/2个月（图片审核） - **新用户优惠**：可在 [数据万象专场特惠](https://cloud.tencent.com/act/pro/ci) 低价购买额度 - **有效期**：1年（付费额度） #### 配置步骤配置需要获取 5 个值：`SecretId`、`SecretKey`、`Bucket`、`Region`、`BizType` ##### 1. 获取 Bucket 1. 登录数据万象控制台，点击概览，再点击立即开通服务。 2. 点击授权。 3. 点击同意授权。 4. 点击绑定存储桶。 5. 点击新建，输入存储桶名称，选择一个所属地域，点击确定。 > **注意**: 内容审核仅支持以下地域：北京、上海、广州、成都、重庆、南京、中国香港、新加坡、孟买、法兰克福。 > **提示**: Bucket 的值为存储桶名称，一般由你输入的存储桶名称加上十位随机数组成，例如 test-1250000000。 ##### 2. 获取 Region Region 的值一般为 ap- 加上你选择的所属地域的拼音，以下为对照表： | 所属地域 | 地域 | | -------- | ---- | | 华北地区（北京） | ap-beijing | | 华东地区（上海） | ap-shanghai | | 华南地区（广州） | ap-guangzhou | | 西南地区（成都） | ap-chengdu | | 西南地区（重庆） | ap-chongqing | | 华东地区（南京） | ap-nanjing | | 港澳台地区（中国香港） | ap-hongkong | | 亚太东南地区（新加坡） | ap-singapore | | 亚太东南地区（孟买） | ap-mumbai | | 欧洲地区（法兰克福） | eu-frankfurt | > **提示**: Region 的值为存储桶所在的地域，例如 ap-beijing。 ##### 3. 获取 BizType 找到刚才新建的存储桶，点击管理，点击内容审核，点击审核策略，复制默认策略的 BizType 值。 > **提示**: BizType 的值为审核策略的名称，例如 912f9a305ae1101b9f7430435ec51f66。 ##### 4. 获取 SecretId 1. 登录访问管理控制台，点击云 API 密钥。 2. 点击新建密钥。 3. 请先牢记 SecretId 和 SecretKey，然后点击确定。 > **注意**: SecretKey 只会展示一次，关闭后将再也无法看见，且尤为重要，请务必保存好。 > **提示**: SecretId 的值请自行参考上述步骤获取。 ##### 5. 获取 SecretKey 参考获取 SecretId 步骤获取 SecretKey。 **访问管理控制台：** [https://console.cloud.tencent.com/ci/secret](https://console.cloud.tencent.com/ci/secret) --- ## 常见问题 ### 如何使用局部重绘功能？ 1. 确保使用 v4 或 v4.5 模型（`nai4`、`nai4c`、`nai4-5`、`nai4-5c`） 2. 发送命令时添加 `-M` 参数和要重绘的原图 3. 收到调暗的图片后，使用画图工具涂白需要重绘的区域 4. 在 120 秒内发送涂好的图片 5. 等待生成结果 **注意事项：** - 涂白区域要覆盖完整需要重绘的部分 - 建议使用较粗的画笔（4像素以上） - 如果边缘出现瑕疵，可以尝试扩大涂白区域 ### 如何使用角色提示词功能？ 1. 确保使用 v4 或 v4.5 模型（`nai4`、`nai4c`、`nai4-5`、`nai4-5c`） 2. 使用 `-K` 参数指定角色 3. 用分号 `;` 或 `；` 分隔不同角色 4. 用 `@位置` 指定角色位置（可选） 5. 用 `--uc:` 指定负向提示（可选） **示例：** ```bash nai4 masterpiece -K "1girl, red hair@B3;1boy, blue hair@D3" ``` ### 会员系统如何配置？ 1. 在插件配置中启用"会员系统" 2. 设置会员和非会员的每日限额、冷却时间 3. 管理员使用 `会员 -u <QQ号> -d <天数>` 授予会员 4. （可选）配置自动清理和到期提醒 ### 如何查看调试日志？在插件配置的"高级设置"中启用"调试日志"选项，可以看到详细的运行日志，包括角色提示词解析和图片审核的详细信息。 --- ## 更新日志 ### v0.4.0 (2024-12-06) - ✨ **新增精准参考功能（Precise Reference）** - 完全替换旧版的角色参考功能 - 支持交互式多图参考（最多6张），可灵活调整每张图的偏好设定 - 提供全新的命令行参数 `-p` 自定义模式、强度以及保真度 - ✨ **新增局部重绘功能（Inpainting）** - 支持 V4/V4.5 模型的局部重绘 - 采用 8x8 网格对齐 + 膨胀算法，防止边缘伪影 - 交互流程不占用任务队列 - 🔧 优化 Mask 处理算法，提升重绘质量 - 🐛 修复各种已知问题 ### 历史版本 - ✨ 新增角色提示词功能（Characters），支持多角色分别设置位置和提示词 - ✨ 新增导演工具功能 - ✨ 会员系统增强：自动清理、到期提醒、调试指令 - ✨ 新增 `nai4c` 快捷指令（v4 curated 模型） - ✨ 新增调试日志开关配置 - 🐛 修复各种已知问题 --- ## 相关链接 - [GitHub 项目地址](https://github.com/hhs2275/koishi-plugin-hhs-huatu) - [NovelAI 官网](https://novelai.net/) - [原插件项目](https://bot.novelai.dev/) - [交流群](https://qm.qq.com/q/4nKKvckKbu) ## 许可证本插件基于原 novelai-bot 项目开发，遵循相应开源协议。