Your browser does not seem to support JavaScript. As a result, your viewing experience will be diminished, and you have been placed in read-only mode.
Please download a browser that supports JavaScript, or enable it if it's disabled (i.e. NoScript).
请阅读: 论坛规则 常见问题QA 无法登录的临时处理方案
源代码和文档: mamoe/mirai, docs.mirai.mamoe.net
闲聊TG群: @mirai_mamoe， Gitter群 mamoe/mirai
引言其实一年前就写好了，今天整理资料时发现了这篇草稿，简单完善一下就发了
假设要在纯文本消息中实现表格排版
例如:
│ id │ name │ │ dog │ 小狗 │ │ cat │ 哈基米 │于是出现了经典的 「错位地狱」：单纯在字符上进行对齐 (例如编程语言中的 pad string 方法)，会导致全角字符也被偏移一个空格的距离。
解决方法当然也很简单，每个全角字符在等宽字体下约等于2个半角空格，只要将全角字符进行额外偏移就好。
这种方法在等宽字体下近乎完美，但日常使用的几乎都是非等宽字体，当然也包括各种社交媒体。
│ id │ name │
│ dog │ 小狗 │
│ cat │ 哈基米 │
于是就有了这篇文章。
视觉宽度在非等宽字体的环境中，字符的 「视觉宽度」 不再是一个可以被简单计算的常数。
比如**「i」和「m」**这两个半角字母，在同一行里甚至能差出半个汉字的距离。
于是，想在聊天栏或其它非等宽环境中整齐地输出一张表，就成了一场灾难。
不同系统、不同字体、甚至不同版本的 QQ 都会导致完全不同的视觉结果。
只能回到最古老、最笨但最有效的办法——以视觉为准，用算法补偿。
测量以大家常用的 NTQQ 为准，chromium 内核的默认字体为 Arial (sans-serif), 我注入了 chromium 进程，用脚本测量了每个 ascii 字体的像素宽度，得出以下表格：
{ " ": 4.1500, "!": 4.3750, "\"": 6.1000, "#": 8.9375, "$": 8.2125, "%": 12.4625, "&": 12.1875, "'": 3.6000, "(": 4.6875, ")": 4.6875, "*": 6.3750, "+": 10.3875, ",": 3.3750, "-": 6.0625, ".": 3.3750, "/": 5.9875, "0": 8.2125, "1": 8.2125, "2": 8.2125, "3": 8.2125, "4": 8.2125, "5": 8.2125, "6": 8.2125, "7": 8.2125, "8": 8.2125, "9": 8.2125, ":": 3.3750, ";": 3.3750, "<": 10.3875, "=": 10.3875, ">": 10.3875, "?": 6.7625, "@": 14.4375, "A": 9.8625, "B": 8.7875, "C": 9.3750, "D": 10.6750, "E": 7.7000, "F": 7.4375, "G": 10.4125, "H": 10.8375, "I": 4.1250, "J": 5.5500, "K": 8.8875, "L": 7.1875, "M": 13.6875, "N": 11.3875, "O": 11.4125, "P": 8.5750, "Q": 11.4125, "R": 9.1500, "S": 8.0875, "T": 8.0375, "U": 10.4625, "V": 9.4750, "W": 14.2500, "X": 9.0375, "Y": 8.4500, "Z": 8.6875, "[": 4.6875, "\\": 5.8250, "]": 4.6875, "^": 10.3875, "_": 6.2875, "`": 4.1375, "a": 7.7500, "b": 8.9500, "c": 7.0250, "d": 8.9625, "e": 7.9500, "f": 4.8625, "g": 8.9625, "h": 8.6250, "i": 3.7375, "j": 3.7500, "k": 7.6250, "l": 3.7375, "m": 13.1250, "n": 8.6375, "o": 8.9125, "p": 8.9500, "q": 8.9625, "r": 5.3500, "s": 6.5375, "t": 5.2250, "u": 8.6375, "v": 7.3500, "w": 11.0625, "x": 7.1000, "y": 7.4125, "z": 6.8875, "{": 4.6875, "|": 3.7750, "}": 4.6875, "~": 10.3875 }经过对半角空格宽度的相对计算，得出以下关键数据:
const asciiSizeMap = [1, 1.054, 1.47, 2.154, 1.979, 3.003, 2.937, 0.867, 1.13, 1.13, 1.536, 2.503, 0.813, 1.461, 0.813, 1.443, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 0.813, 0.813, 2.503, 2.503, 2.503, 1.63, 3.479, 2.377, 2.117, 2.259, 2.572, 1.855, 1.792, 2.509, 2.611, 0.994, 1.337, 2.142, 1.732, 3.298, 2.744, 2.75, 2.066, 2.75, 2.205, 1.949, 1.937, 2.521, 2.283, 3.434, 2.178, 2.036, 2.093, 1.13, 1.404, 1.13, 2.503, 1.515, 0.997, 1.867, 2.157, 1.693, 2.16, 1.916, 1.172, 2.16, 2.078, 0.901, 0.904, 1.837, 0.901, 3.163, 2.081, 2.148, 2.157, 2.16, 1.289, 1.575, 1.259, 2.081, 1.771, 2.666, 1.711, 1.786, 1.66, 1.13, 0.91, 1.13, 2.503] const emojiSize = 4.753 const cjkSize = 3.373 const mathFontSize = 2.12 名称 意义 例 注 asciiSizeMap 所有 ASCII 可见字符相对于半角空格的宽度比例 A ≈ 2.38, i ≈ 0.90 / emojiSize Emoji 平均宽度 😺, 🔥, 🧱 约为半角空格的 4.75 倍，接近一个半 CJK 字符 cjkSize 中日韩字符（CJK）的平均宽度 “字”、“ア” 约为半角空格的 3.37 倍 mathFontSize 数学符号与特殊字符的平均宽度 ±, 全角数学数字 一般介于 ASCII 与 CJK 之间这些比例值用于计算表格中每一列的视觉宽度（见上文），
例如当 │ dog │ 小狗 │ 中混合中英文字符时，就能根据实际像素比例进行动态补偿，而不是简单地按字符数量来填空格。
欢迎来到真正的地狱 —— Emoji。
在理想情况下，可以根据每个字符的查到对应的视觉比例进行排版，
但如何确定「一个表情由几个字符组成」？
如果尝试遍历带有emoji的字符串，可能会出现奇怪的情况：
在浏览器控制台中执行这几段代码
'😂'.length // 2 '😂'.split('') /** [ "\ud83d", "\ude02" ] */ '👨👩👧👦'.length // 11 '👨👩👧👦'.split('') /** [ "\ud83d", "\udc68", "", "\ud83d", "\udc69", "", "\ud83d", "\udc67", "", "\ud83d", "\udc66" ] */在技术上，Emoji 的逻辑长度和视觉宽度几乎没有任何线性关系。
码点 / 码元 / 字节快速复习一下 Unicode 几个基本概念：
名称 原文 说明 例 码点 Code Point Unicode 为每个字符分配的编号，如 U+1F602 😂 概念上等于“字符” 码元 Code Unit 实际在编码中占用的单元，UTF-8 中每个码元是 1 字节 😂 在 UTF-8 中需要 4 个码元在 utf8 中，每两个码元为一个字符串长度。
有的 Emoji 是单一字符（如 😊），只有一个码点，长度为 2；
有的则是由多个码点组合而成，比如「家庭」👨👩👧👦，
实际上是四个 人类 Emoji（👨👩👧👦） + 三个连接符（Zero Width Joiner, ZWJ），共 7 个码点，28 字节，长度为 4 * 2 + 3 == 11
综上，考虑到 Emoji 的情况，要处理复杂的拼接规则并正确根据视觉上显示的字符数进行计算。
碍于篇幅限制，跳过复杂的思考与推导，得到以下代码：
// 参考自 https://blog.jonnew.com/posts/poo-dot-length-equals-two // 包含部分修改与性能优化 function emojiLen(str) { const joiner = "\u200D" const split = str.split(joiner) let count = 0 for (const s of split) { let num = 0 let filtered = "" for (let i = 0; i < s.length; i++) { const charCode = s.charCodeAt(i) if (charCode < 0xFE00 || charCode > 0xFE0F) { filtered += s[i] } } num = Array.from(filtered).length count += num } return Math.ceil(count / split.length) } function isEmoji(code) { return ( (code === 0x200D) || (code >= 0x1F600 && code <= 0x1F64F) || // Emoticons (code >= 0x1F300 && code <= 0x1F5FF) || // Misc Symbols and Pictographs (code >= 0x1F680 && code <= 0x1F6FF) || // Transport and Map (code >= 0x1F1E6 && code <= 0x1F1FF) || // Regional country flags (code >= 0x2600 && code <= 0x26FF) || // Misc symbols (code >= 0x2700 && code <= 0x27BF) || // Dingbats (code >= 0xE0020 && code <= 0xE007F) || // Tags (code >= 0xFE00 && code <= 0xFE0F) || // Variation Selectors (code >= 0x1F900 && code <= 0x1F9FF) || // Supplemental Symbols and Pictographs (code >= 0x1F018 && code <= 0x1F270) || // Various Asian characters (code >= 0x238C && code <= 0x2454) || // Misc items (code >= 0x20D0 && code <= 0x20FF) // Combining Diacritical Marks for Symbols ) } 完抱歉仓促结尾，一年前的草稿到此完结。
本文原计划还有「全角数学字符」「视觉偏移算法」「基础排版引擎」等原创研究内容，但时间过得太久早就忘记当时的思路与感悟。同时在推导过程中隐去了大量细节，欢迎大家在阅读过程中进行查证。
非常抱歉。
本文及包含数据与代码完全原创，以 CC-BY-SA-NC 4.0 授权，转载务必告知。
之前发的类似技术分析也没人看，可能是因为论坛人太少了。
不过如果这篇能被更多人读到，我会考虑重拾旧稿，把剩下的部分补完。
最后附原始代码，欢迎大家随意改编使用，二次发布请附带本文地址。
原始代码为我某个程序的动态脚本，需要进行某些改编才能调用。
/** * tabel: 表格模式, 对尾部进行排版与填充 * list: 列表模式, 不填充尾部 * @type { "tabel" | "list" } */ const layoutType = "list" /** * normal: 不处理ascii字符 * math: 会将ascii字符替换为等宽数学字符(U+1D670), 例如 𝚖𝚢-𝚙𝚎𝚝𝚙𝚎𝚝 * @type { "normal" | "math" } */ const textStyle = "normal" /** * slilt: 对于溢出的新行在同列换行 * ```text * | right_symm | 对称, 右对称 | * | etry | , 左右对称 | * ``` * syaggered: 交错换行, 目前仅支持两列 * ```text * | right_symmetry | * | 对称, 右对称, 左右对称 | * ``` * @type { "split" | "syaggered" } */ const breakStyle = 'syaggered' // 连接别名的分隔符 const aliaDelimiter = ', ' // 表格左侧长度 const tabelLeftLength = 16 // 表格左侧长度 const tabelRightLength = 22 // 表格前缀 const linePerfix = '│ ' // 表格分隔符 const lineDelimiter = ' │ ' // 表格后缀 const lineSuffix = ' │' // 表格溢出新行前缀 (参与到长度计算, 请确保兼容性) const overflowNewLinePrefix = "- " // 列表前缀 const listPerfix = '> ' // 列表左侧长度 const listHeadLength = 22 // 换行符 const newLine = '\n' // 分组数量 const groupCount = 4 // 分组前缀 const groupPrefix = '模板范围 ' const otherGroupPrefix = '其他模板: ' // ==== 以下为脚本固定常量与正文，请勿随意修改，除非您完全了解其作用 ==== // 分组范围 const groupStartCode = 97 const groupEndCode = 122 const groupRangeSize = Math.ceil((groupEndCode - groupStartCode + 1) / groupCount) // see calculate-ascii-length.json const asciiSizeMap = [1, 1.054, 1.47, 2.154, 1.979, 3.003, 2.937, 0.867, 1.13, 1.13, 1.536, 2.503, 0.813, 1.461, 0.813, 1.443, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 1.979, 0.813, 0.813, 2.503, 2.503, 2.503, 1.63, 3.479, 2.377, 2.117, 2.259, 2.572, 1.855, 1.792, 2.509, 2.611, 0.994, 1.337, 2.142, 1.732, 3.298, 2.744, 2.75, 2.066, 2.75, 2.205, 1.949, 1.937, 2.521, 2.283, 3.434, 2.178, 2.036, 2.093, 1.13, 1.404, 1.13, 2.503, 1.515, 0.997, 1.867, 2.157, 1.693, 2.16, 1.916, 1.172, 2.16, 2.078, 0.901, 0.904, 1.837, 0.901, 3.163, 2.081, 2.148, 2.157, 2.16, 1.289, 1.575, 1.259, 2.081, 1.771, 2.666, 1.711, 1.786, 1.66, 1.13, 0.91, 1.13, 2.503] const emojiSize = 4.753 const cjkSize = 3.373 const mathFontSize = 2.12 let indexTexts const thisId = register(info => { return { hidden: true, inRandomList: false, defaultTemplateWeight: 100 } }) on("load", e => { if (thisId !== e.defaultTemplate) return indexTexts = buildIndexString(e.templates) }) on("bot_send", e => { e.responseInForward(true) for (const indexText of indexTexts) { e.response(indexText) e.responseNewParagraph() } }) /** * @param { PetpetTemplateInfo[] } templates * @returns {string[]} */ function buildIndexString(templates) { let resultArr = new Array(groupCount).fill('') let other = '' for (const template of templates) { const metadata = template.metadata if (!metadata || metadata.hidden) { continue } const alias = metadata.alias || [] const aliasStr = alias.length === 0 ? '-' : join(alias, aliaDelimiter) const firstCodePoint = template.id[0].toLowerCase().codePointAt(0) const group = Math.floor((firstCodePoint - groupStartCode) / groupRangeSize) let line switch (layoutType) { case "tabel": line = tabelLine([item(template.id, tabelLeftLength), item(aliasStr, tabelRightLength)]) + newLine break case "list": line = listPerfix + padRight(template.id, listHeadLength, 0, true).content + ' ' + aliasStr + newLine break } if (group < 0) { other += line } else { resultArr[group] += line } } resultArr = resultArr.filter(s => s.length > 0) .map((s, i) => { const start = i * groupRangeSize + groupStartCode return groupPrefix + String.fromCodePoint(start - 32) + ' - ' + String.fromCodePoint(Math.min(groupEndCode, start + groupRangeSize - 1) - 32) + ': ' + newLine + s }) if (other) { resultArr.push(otherGroupPrefix + other) } return resultArr } function tabelLine(items) { switch (breakStyle) { case "split": return lineSplit(items) case "syaggered": return lineSyaggered(items) default: throw Error("breakStyle 变量参数错误") } } function lineSyaggered(items) { if (items.length !== 2) { throw Error("syaggered break item length must == 2"); } let result = ''; const padder0 = padRight(items[0][0], items[0][1]); const padder1 = padLeft(items[1][0], items[1][1], padder0.offset); let lineLen = items[1][1]; if (padder0.overflow || padder1.overflow) { lineLen = items[0][1] + items[1][1] + lineDelimiter.length; result += linePerfix + syaggerePadder(items[0][0], lineLen, 0, true) + lineSuffix + newLine + linePerfix; } else { result += linePerfix + padder0.content + lineDelimiter; } if (padder1.overflow) { const prefix = padder0.overflow ? '' : overflowNewLinePrefix; result += syaggerePadder(prefix + items[1][0], lineLen, padder0.overflow ? 0 : padder0.offset, false) + lineSuffix; } else { if (padder0.overflow) { result += syaggerePadder(overflowNewLinePrefix + items[1][0], lineLen, 0, false) + lineSuffix; } else { result += padder1.content + lineSuffix; } } return result; } function syaggerePadder(str, len, offset = 0, isLeft = true) { let padFun = isLeft ? padRight : padLeft let padder = padFun(str, len, offset) let result = padder.content if (padder.overflow) { result += newLine + linePerfix + syaggerePadder(padder.overflow, len, padder.offset, isLeft) + lineSuffix } return result } function lineSplit(items) { let result = linePerfix let offset = 0 let overflows = [] for (let i = 0; i < items.length; i++) { const item = items[i] const padder = padRight(item[0], item[1], offset) offset = padder.offset if (padder.overflow) overflows[i] = padder.overflow result += padder.content if (i != items.length - 1) { result += lineDelimiter } } result += lineSuffix if (overflows.length > 0) { const overflowItems = items.map((it, i) => item(overflows[i] || ' ', it[1])) result += newLine + lineSplit(overflowItems) } return result } function item(str, length) { return [str, length] } function prePad(str, length) { if (textStyle === "math") { str = convertToMathCharacters(str) } let charIndex = 0 let displayLen = 0 let emojis = '' const chars = Array.from(str) for (let i = 0; i < chars.length; i++) { const codePoint = chars[i].codePointAt(0) let add = 0 if (isMathCaracter(codePoint)) { // 因为默认替换的原因, 数学字符命中率最高 if (emojis) { add += emojiLen(emojis) * emojiSize emojis = '' } add += mathFontSize // Full-width Math characters } else if (isEmoji(codePoint)) { emojis += String.fromCodePoint(codePoint) } else { if (codePoint >= 0x0020 && codePoint <= 0x7F) { add = asciiSizeMap[codePoint - 32] || 0 // ASCII characters } else if (codePoint >= 0x80 && codePoint <= 0x1FFF) { add = 1 // Half-width characters } else if (codePoint >= 0x2000 && codePoint <= 0xFF60) { add = cjkSize // Full-width CJK characters } else if (codePoint >= 0xFF61 && codePoint <= 0xFF9F) { add = 1 // Half-width katakana } else if (codePoint >= 0xFFA0) { add = 2 // Full-width characters } if (emojis) { add += emojiLen(emojis) * emojiSize emojis = '' } } if (i === chars.length - 1 && emojis) { add += emojiLen(emojis) * emojiSize emojis = '' } if (Math.round(displayLen) + add > length) { break } displayLen += add charIndex++ } return { str, displayLen, chars, charIndex } } function padLeft(str, length, offset = 0) { const p = prePad(str, length) str = p.str const resultLen = Math.round(p.displayLen + offset) const spaces = ' '.repeat(Math.max(length - resultLen, 0)) if (p.chars.length <= p.charIndex) { return { content: spaces + str, offset: p.displayLen - resultLen } } else { let result = p.chars.slice(0, p.charIndex).join('') return { content: spaces + str, offset: p.displayLen - resultLen, overflow: str.substring(result.length) } } } function padRight(str, length, offset = 0, allowOverflow = false) { const p = prePad(str, length) str = p.str const resultLen = Math.round(p.displayLen + offset) const spaces = ' '.repeat(Math.max(length - resultLen, 0)) if (p.chars.length <= p.charIndex || allowOverflow) { return { content: str + spaces, offset: p.displayLen - resultLen } } else { let result = p.chars.slice(0, p.charIndex).join('') return { content: result + spaces, offset: p.displayLen - resultLen, overflow: str.substring(result.length) } } } // by https://blog.jonnew.com/posts/poo-dot-length-equals-two function emojiLen(str) { const joiner = "\u200D" const split = str.split(joiner) let count = 0 for (const s of split) { let num = 0 let filtered = "" for (let i = 0; i < s.length; i++) { const charCode = s.charCodeAt(i) if (charCode < 0xFE00 || charCode > 0xFE0F) { filtered += s[i] } } num = Array.from(filtered).length count += num } return Math.ceil(count / split.length) } function isEmoji(code) { return ( (code === 0x200D) || (code >= 0x1F600 && code <= 0x1F64F) || // Emoticons (code >= 0x1F300 && code <= 0x1F5FF) || // Misc Symbols and Pictographs (code >= 0x1F680 && code <= 0x1F6FF) || // Transport and Map (code >= 0x1F1E6 && code <= 0x1F1FF) || // Regional country flags (code >= 0x2600 && code <= 0x26FF) || // Misc symbols (code >= 0x2700 && code <= 0x27BF) || // Dingbats (code >= 0xE0020 && code <= 0xE007F) || // Tags (code >= 0xFE00 && code <= 0xFE0F) || // Variation Selectors (code >= 0x1F900 && code <= 0x1F9FF) || // Supplemental Symbols and Pictographs (code >= 0x1F018 && code <= 0x1F270) || // Various Asian characters (code >= 0x238C && code <= 0x2454) || // Misc items (code >= 0x20D0 && code <= 0x20FF) // Combining Diacritical Marks for Symbols ) } function isMathCaracter(code) { return (code >= 0x1D670 && code <= 0x1D6A3) || // A - z (code >= 0x1D7F6 && code <= 0x1D7FF) // 0 - 9 } function convertToMathCharacters(input) { let result = '' for (const ch of input) { const code = ch.charCodeAt(0) if (code >= 65 && code <= 90) { result += String.fromCodePoint(0x1D670 + (code - 65)) } else if (code >= 97 && code <= 122) { result += String.fromCodePoint(0x1D68A + (code - 97)) } else if (code >= 48 && code <= 57) { result += String.fromCodePoint(0x1D7F6 + (code - 48)) } else { result += ch } } return result } // ==== 以下内容为 Nashorn 兼容性方案，请勿将其视为无用代码而删除，除非您确认此脚本可在指定引擎上正常运行 ==== function join(array, separator) { if (array.join) { return array.join(separator) } let result = '' for (let i = 0; i < array.length; i++) { if (i > 0) { result += separator } result += array[i] } return result } /** * https://github.com/efwGrp/nashorn-ext-for-es6 * The String.fromCodePoint() static method returns a string created from the specified sequence of code points. * ECMAScript 2015 */ if (!String.fromCodePoint) { String.fromCodePoint = function fromCodePoint() { var chars = [], point, offset, i var length = arguments.length for (i = 0; i < length; ++i) { point = arguments[i] if (point < 0x10000) { chars.push(point) } else { offset = point - 0x10000 chars.push(0xD800 + (offset >> 10)) chars.push(0xDC00 + (offset & 0x3FF)) } } return String.fromCharCode.apply(null, chars) } Object.defineProperty(String, "fromCodePoint", { enumerable: false }) } if (!Array.from) { Array.from = function (r, u, e) { let l = [] for (let n of r) null != u ? null != e ? l.push(u.call(e, n)) : l.push(u(n)) : l.push(n) return l } Object.defineProperty(Array, "from", { enumerable: false }) } if (!Array.prototype.fill) { Array.prototype.fill = function (value, start = 0, end = this.length) { const length = this.length let startIndex = Math.max(0, start < 0 ? length + start : start) let endIndex = Math.min(length, end < 0 ? length + end : end) for (let i = startIndex; i < endIndex; i++) { this[i] = value } return this } }效果预览
f30ba67a-e5b2-4f7d-8e9f-c102e77ff24c-image.png
完结烂尾撒花
在隔壁群看到的，但是无论怎么搜关键字都找不到类似的，有没有用过的大佬知道
3647b18f-97f6-425a-979a-e29c79522b39-image.png
断断续续写了两三年的bot，但是最近没什么精力继续维护了，故开源希望能起到抛砖引玉的作用 现在还会有人用mirai吗
仓库链接为 HatoYuze/HanaMozeBot，是我的bot同一功能重构了三次的最终产物，同时在结构上进行了不断的改进（存疑），希望能帮到各位
Bot的人设名称是墨泽酱，是我之前受软糖酱影响开启的项目，也因此抄了部分功能过去
9f713fee-a495-4dcb-b01b-1dce247dd7fa-moze_sig.png 在签到界面会出现的人设图
项目支持 一个账号系统（维护有签到,货币,经验值等杂七杂八的功能，这个也是抄的软糖酱)今日诗词（使用 www.jinrishici.com 的api)你可能觉得这个页面有点熟悉，事实上这个也是抄的软糖的，但是没有找到软糖的浅色版本:(
这个是不是也怪怪的？这是因为我先画的浅色版本，深色版本是速通的换色版
项目的绘图部分都使用了 skiko 作为支持，对于老旧的x86系统可能要遗憾离场了，因为万恶的skiko自出生其就没有x86的编译版
接下来是些比较无趣的纯文字返回的指令
random waifu 随机老婆，功能和别的差不多，会在本地缓存目标的头像，这里关于缓存部分好像有bug，但是能run就行 random dick 随机几把，纯粹的随机数比较，纯粹的享受，作为我写了3年从未移除的功能 random pc 随机胖次，依旧纯粹的字符串随机，词库来源于万能的群友 letter 开字母功能，可以多群联机，但对于别名，词库需要创造者自行处理 （我没测试过同时调用会不会造成资源竞争的bug） drawer color 画一个色块出来，不提供参数时随机一个rgb值，支持hex和rgb格式（当然还有透明度参数，但默认为255） cryptography 对同名图的套壳，但仅支持sha hmac的加密 ，我也不知道有什么用 sign 上文的签到 poem 上文的今日诗词用户账户内部使用了 ktorm 作为数据库层，可由 config/database.yml 设置内容, 连接好数据库后会创建一个名为 moze_users 的表，详情可见 data/database/UserDataStorage.kt
还有我用于凌晨0点自动更新数据的DailyRefreshTasks轮子
如何使用？和普通插件一样使用，在今日诗词部分的token会在初始化时调用 https://v2.jinrishici.com/token 并自动存储于 data/runtime_command_data ，在下一次调用时优先访问存储的token（有关token可参考今日诗词的文档，但这个api不要多用，容易被今日诗词风控）
data/runtime_command_data.yml 中的大多数据是用于存储和指令有关的数据的，其中大多数据为自动刷新的数据，如果您需要更改里面的内容，请保证操作时间在凌晨过后，避免忘记刷新其内部的数据
同时，本插件还内置了一套 project-mirai/chat-command/ 实现，用于将 /mz 的前缀转换为 / 并执行 mirai-console-command 的匹配工作，这里面可能写得不够完善，如果您的机器人已经装上了 chat-command 插件，可能导致一个指令被重复匹配，您可以通过删除 PluginMain.kt#L40 的语句 eventChannel.commandSubscribe() 重新编译解决问题
项目的 gradle-wrapper.properties 中的 gradle 为原生地址，可能较慢，建议将其替换为国内镜像 https\://mirrors.cloud.tencent.com/gradle/ 加快下载速度
个人认为项目的码风还算健康，如果有希望入坑mirai机器人的新人，也可以在本插件中进行进一步扩展作为自己的第一步
部分内部轮子的说明 RateLimiter项目内部基于反射，对 command目录下所有有 @CommandImpl 注解的对象自动注册为指令系统，在 java 指令类中添加这个注解同样也可以自动注册，只需要保证这个类是单例模式且提供 INSTANCE 静态字段即可
com.github.hatoyuze.mozebot.hana.command
一个简单的限制频率的实现，内部使用 LinkedBlockingQueue实现，先发送（调用 submit 方法）的任务将得到优先执行
maxConcurrentTasks 最多同时进行的操作数，每一个操作都使用协程相互独立 timeWindowMillis 每一次操作的间隔时间，单位为毫秒方法submit
task 将会执行的任务，返回的内容也将作为函数的返回值 onRemove 当内部等待 60s 后仍未进入等待队列，将调用该参数，其默认行为为抛出错误调用示例：
object PoemCommand : SimpleCommand(PluginMain, "poem") { private val limiter = RateLimiter<PoemSentenceData>(5, 250) @Handler suspend fun handleCommand(commandContext: CommandContext) = commandContext.run { val data = limiter.submit(task = { DailyPoemApi.getDailyPoemData() // 将被限制的任务，可用此来进行限流 }).await() .... } } DailyRefreshTaskscom.github.hatoyuze.mozebot.hana.data
内建有注解Refresh，可用于自动更新字段
使用 Refresh 标注自动更新的目标KProperty1，此目标必须为可变参数(var)
之后的每一次数据都将于每日的0时准点，修改为初始化时的初始数据
当目标未初始化时，始终设置为null
你需要通过 DailyRefreshTasks.initRefresh 加载后，功能才会生效，这也意味着数据的载体应该继承自DailyRefreshTasks
示例:
object Example : DailyDailyRefreshTasks { init { initRefresh() } @Refresh var data: Int by lazy { 0 } }它也可以与 mirai-console 的 AutoSavePluginData 混合使用，上诉描述的初始数据将变为by value 块内容
对于 List 的数据，将改为调用 clear() 方法
com.github.hatoyuze.mozebot.hana.data
对插件所有的文件I/O操作的管理，当 isTesting 设置为 true 时，数据将存储为 系统临时目录 或 当前工作目录
该文件内还提供了对协程 launch async 操作的包装，当isTesting时，所创建的协程将基于GlobalScope反之则为PluginMain
“不好！这里要撑不下去了”
“A4 求救，A4 求救，A32 地区的沙雕数量超过阈值，即将突破防线！”
“什么！？啧。。”
“B8 已完成沙雕清除任务，现赶往 A32 地区”
“这样。。什么时候是个头啊。。”
如果想订阅本贴更新可以点击右上角铃铛🔔按钮
【持续时间】
1970.1.1 ~ 114514.12.31
【活动内容】
糟糕！沙雕小别墅遭到了从未知之处涌出的沙雕攻击，防御工事濒临崩溃，如果能用其他的方法击退它们的话。。
对了！沙雕图！
【参与方式】
在本贴中回复沙雕图，协助沙雕防御工事击退沙雕。
【活动奖励】
从其他 miraier 获取的沙雕图！是不是非常丰厚呢？
【注意事项】
遵守摸鱼区规则。
是沙雕图不是涩图！
【样例】
3c2dfb62-5555-4c00-a17b-d76715bf2088-image.png
视奸你的群友-SteamWatcherX 是一个 mirai 插件，可以订阅群友的Steam状态并将状态变更发送到指定qq群聊
功能（Features） 可以订阅一个或多个 Steam 用户的状态（例如：上线、离线、游戏中，成就获取）。 当状态发生变化时，自动向指定的 QQ 群或 mirai 群聊发送通知。 支持简单配置，易于部署和使用。 安装（Installation） 前往Release下载插件本体 将插件放入mirai控制台的/plugins文件夹中 重启控制台 使用方法（How to Use） 确保插件正确加载（查看控制台输出） 前往配置文件配置steam api key https://steamcommunity.com/dev/apikey 重启控制台 在你想要获取通知的群聊中发送/bind Steam64位ID(例如76561198377324521) 可以通过配置Config来修改部分功能 指令（Command）/bind
/unbind
/list
62771116-3383-4813-9349-0ce17370b8ca-image.png
仓库地址
Bot is Watching you.👁️
若APIKey与欲查询的用户为同一个账号时，设置游戏私密功能将无效 新成就大约4分钟后才能被Bot发现 修改刷新间隔配置后需要重载插件依赖文件 libHarfBuzzSharp.dll libSkiaSharp.dll 放置在框架/加载器的 根目录 或者 x86 文件夹 或者 libraies 文件夹 Assets.zip 解压后放置在插件的数据目录内，保留 Assets 文件夹
5dfe2e77-1fe4-469c-91b2-ac26d0b8a6ac-image.png
7f17bccd-8625-48d2-841a-9c2fa50a14fc-image.png
Overflow.png
项目地址：https://github.com/MrXiaoM/Overflow
无缝迁移 mirai 到 OpenShamrock、Gensokyo、Lagrange、LLOnebot、NapCat 等 Onebot 实现！
该项目正在施工中，敬请期待详细安装教程请见官网结尾。
由于学业问题以及还有其它项目正在进行，Overflow 的开发暂缓
mirai-core 和 mirai-console 均可使用。
项目开发进度以及开发版本发布将会在群 1047497524 中进行，目前已经可以正常收发消息。
在尝试了各种方法后，找到了持续稳定的本地化部署方案（其实也可以服务器部署，但是配置要求较高）。使用模拟器加open shamrock部署，如果有需要的话会考虑出一个教程。
open shamrock文档：https://whitechi73.github.io/OpenShamrock/guide/getting-started.html
一个简单的每日新闻速报/番剧速报 mirai-console 插件
项目地址:https://github.com/LinHeLurking/mirai-news-reporter
功能 爬取知乎的一个每日新闻页面, 以图片形式分享. 向机器人说 "今日新闻", "今日速报" 即可触发. 爬取 B 站的今日番剧列表, 以图片形式分享. 用 "今日动画", "今日番剧" 触发. 白名单为了避免打扰网友, 群聊使用白名单管理. 只有通过命令指定的群聊, 才会在群聊中触发本机器人.
番剧群组白名单和新闻播报群组白名单是分开的两个名单，你可以使用 /reporter_list 命令来管理这两个名单。
该命令允许 show, add, remove 三种后缀。其中 add, remove 两个后缀需要跟一个群号。
在群号之后你可以用 anime, news 来指定操作哪一个白名单（留空表示二者都操作）。
举例如下：
将群号为 123456 的群加入番剧、新闻白名单：
/reporter_list add 123456
将群号为 123456 的群加入番剧白名单：
/reporter_list add 123456 anime
将群号为 123456 的群加入新闻白名单：
/reporter_list add 123456 news
自定义语句更多命令细节可以通过 /help 获取.
Bot 在回复命令时的很多语句，都可以通过 /reporter_msg 命令来自定义。
命令格式： /reporter_msg <key> <list>。
其中，<key> 的可能取值及其含义见下表。
<list> 是一个用逗号或分号分割的列表（也可以只是一个词），中文标点和英文标点都可以，但是不能有空格。
<list> 表示相应的用户发出触发语句可以使用 <list> 中的任何一个，
而机器人回复的语句会在列表中随机选取。
效果展示上述的 key，写成单数形式也 OK
目前排版还不是很好, 以后找机会继续优化.
效果展示：
今日番剧:
000000000-000000000-00F92DB7B9564739595DD98104249079
今日新闻:
000000000-000000000-97C34B229D32E4E897AE6F268A950E3B
本人没有什么插件制作经验，借鉴了前辈@yorin 的思路
GITHUB地址 https://github.com/BestBcz/BiliURL
本人不常看论坛，所以想要你的问题被快速答复请移步github~~~
本人不常看论坛，所以想要你的问题被快速答复请移步github~~~
--2025/6/1--
🌱 解析QQ中分享的哔哩哔哩小程序视频并下载发送的mirai插件 🛠️安装&依赖前置 从Release中下载最新版本 将Jar文件放入 %mirai文件根目录%/Plugins/ 中 重新启动你的mirai-console Enjoy~ 🛠️依赖前置（请安装到你搭建机器人的服务器上） FFmpeg yt-dlp Mirai-console 2.16版本或以上可选Chat-Command 🚀代办清单 （可以订阅Release来获取更新) 竖屏视频分辨率缺失 视频缩略图获取失败 只能使用默认黑色缩略图 MacOS登录协议的支持(使用人数太少，可能未来不会提供此支持) 设置不同群开启 指令权限兼容LuckPerms 重载配置指令 或 群聊查看当前设置状态的指令 🧐已拥有的功能 视频解析下载 以短视频形式发送到群聊 封面下载并单独发送 视频链接解析 视频详细信息解析 自动删除下载视频 Config文件 长链接bilibili.com/video/BVxxx 和 短链接b23.tv/xxxx 的选择 指令支持 设置管理员 🔑指令 /bilivideoparser /bvp 用法: /bvp [value][!IMPORTANT]
以上↑为下载视频功能必需依赖
可用选项: enable # 开关插件 shortlink # 开关短链接 info # 开关详细信息 download # 开关下载视频 addadmin # 添加管理员 removeadmin # 移除管理员 listadmins # 管理员列表 addwhite # 添加群白名单 addblack # 添加群黑名单 removewhite # 移除白名单 removeblack # 移除黑名单 listgroups # 查看群组列表
📷插件截图<details>
<summary>相关截图</summary>
e1ffac4d-3043-4d6b-a814-d6be1497e997.png
QQ_1742202849146.png
QQ_1742202875264.png
356a4b0d-57b0-4a12-acac-8435e5e4aafa.png
</details>
💡 Config已实现自动更新，旧版Config.yml已失效，新版BiliVideoParserConfig.yml会自动生成在同一文件夹 Config 介绍 Default 可改参数 configVersion 配置版本号，用于自动检测和更新旧版配置，请勿自行修改 IGNORE enableParsing 是否启用解析功能 true false logMessages 是否记录群消息日志 true false useShortLink 是否使用短链接（b23.tv）；若为 false 则使用长链接（bilibili.com） true false enableDetailedInfo 是否显示详细视频信息（包括up主、播放量、评论数、简介、点赞、收藏、投币、转发） true false enableDownload 是否启用视频下载功能 true false adminQQs 管理员QQ 123456789 %QQ号% groupWhiteList 白名单群号列表（优先生效） [] %群号% groupBlackList 黑名单群号列表 [] %群号% 编译 - 非开发者请无视 如果需要使用pluginbuild 编译请使用 ./gradlew clean buildPlugin -x miraiPrepareMetadata 来防止miraiPrepareMetadata造成的报错(理论上普通build也可行)--2025/3/17--
BiliVideoParser 1.1.0正式版发布，在原先简易插件的基础上做了很多更新
已拥有的功能
这个插件仍然有许多已知未知的BUG，已知BUG会在Readme中列入代办清单，未知BUG可以通过#issue来进行反馈或催更
...356a4b0d-57b0-4a12-acac-8435e5e4aafa.png
^fold
e1ffac4d-3043-4d6b-a814-d6be1497e997.png
^fold
QQ_1742202849146.png
^fold
QQ_1742202875264.png
群号：780594692
点击加群
欢迎加入本群！本群为纯公益交流群，旨在提供自由、平等、公正的交流环境。
允许测试机器人，但请勿影响他人或导致封群风险。 绝不无故禁言、滥用@全体成员，尊重每位成员的体验。 永久运营，永不解散，且完全非盈利。 禁止内容为确保良好氛围，严禁讨论：
❌ 政治相关
❌ 违法内容
❌ 广告/商业行为
❌ 色情/低俗内容
❌ 恶意刷屏、引战等滥用行为
入群即视为同意：
用户需对自身言行负责，群内一切行为与群主、管理员及平台无关。 本群不承担任何法律或经济责任。2a6c392e-9c37-45ed-8747-ec2c142c2c17-QQ_1757839522277.png
新群活了不到一个月 又被封了
从三年前开始，换过约8个QQ账号，分别来自不同的群友借我的小号 无一例外都被封禁 1-3 个月或永久
群聊也被封过11次，每次都是重新邀请群友开新群
以下为某个账号的封禁历史，战绩可查
群里从不建政，发色图频率极低 每个群存活时间随机，2周-9个月 不等 每周目群人数约90人8857e61f0376ef723270bd72c1c65f16.jpg
以下是关于腾讯审核机制的推测：
发色图时会被腾讯的AI检测一遍，如果别人能看到发送的图像则说明检测通过；文字消息不会被检测 被举办后会交给更聪明的AI检测，如果检测成功则提示「你的账号____已被他人举报」 AI无法处理的会由人工审核，被封禁提示「经平台检测____限制使用部分产品功能」 文字谐音等规避审查的方式也会被检测，例如「扔子」「小学」等封号机制：
被封号后无法发言，进行同意入群申请，修改群设置等操作 通常来说，前3次封号可马上解封，第4/5次封禁一天，之后每次封禁 7天/1个月/3个月/永久，与账号风控等级有关 封号后手机端个人资料会被隐藏TIPS：
被封群后不用慌，NTQQ右键将被封的群消息标记为未读，再点击右下角托盘的闪烁图标即可看到全部群友名单，可复制QQ号
Petpet - 生成各种奇怪的图片 已更新 1.0.0-beta3 版本, 支持多线程, 可自定义 头像 文字 坐标 概率 关键词 频率限制 等参数项目地址 releases 前端版本 / 功能预览
如果你觉得此插件对你有帮助, 请在此帖下回复不错的插件 让更多人看到, 这对我非常重要!
PetpetMirai version
GitHub
GitHub all releases
GitHub Repo stars
GitHub release (latest by date)
GitHub issues
GitHub closed issues
GitHub closed pull requests
自定义合成图片的 Mirai 插件 / 独立程序 / gocq-http插件, 灵感/部分数据来自 nonebot-plugin-petpet。
原生 java 编写, kotlin仅用于数据序列化, 使用底层API, 多线程优化: 轻量, 高性能, 易拓展
特别注意本贴为旧版项目文档仅供参考，新版文档请前往 Github 项目页查看
使用方法 单独运行下载 最新版本 petpet.jar 或 petpet-no-ws.jar
下载 图片素材
将图片素材放入 ./data/xmmt.dituon.petpet/ 目录
运行 start.bat 或 start.sh, 可自行更改配置文件 config.json, 重启后生效
参考WebServer一节 发起网络请求 / 或使用WebUI
Mirai插件部署 Mirai 机器人框架
下载 最新版本
将插件放入 Mirai/plugins/
下载 图片素材
将图片素材放入 Mirai/data/xmmt.dituon.petpet/
启动 Mirai, 可自行更改配置文件 Petpet.yml, 重启后生效 (参考 配置项说明)
使用 戳一戳 有 30% 的概率触发; 或发送 pet @xxxpet key @xxx 或 key @xxx 可返回指定图片 例如 pet kiss @xxx kiss @xxx
可通过发送的图片生成Petpet kiss [图片], 支持GIF
可通过回复构造图片, 例如 [图片] -> [回复[图片]] 对称
gocq-http插件可使用 pet指令 获取 keyList
Warning
此功能处于测试阶段, 目前仅能通过key生成图片, 请期待后续开发!
部署 gocq-http 机器人框架, 设置正向 WebSocket 监听 (默认端口为8080)
更改 gocq-http 配置项 message.post-format 为 array
下载 最新版本 petpet.jar
下载 图片素材
将图片素材放入 ./data/xmmt.dituon.petpet/ 目录
cd ./ java -jar petpet.jar -gocq, 可自行更改配置文件 gocq-config.json, 重启后生效
配置文件 配置项说明<details>
<summary>展开/收起</summary>
<br/>
probability: 30触发petpet指令, 默认为pet
例: pet @xxx pet kiss @xxx
仅发送pet时会返回keyList
<br/>
antialias: true戳一戳 触发概率, 0-100整数, 默认为 30%
<br/>
resampling: true画布抗锯齿, 默认为true
<br/>
disabled: []重采样缩放, 启用后头像质量更高, 可对模板单独配置
<br/>
keyCommandHead: ''禁用表列, 默认为空, 在此数组中的key不会被随机触发 (会覆盖data.json中的配置)
<br/>
respondReply: truekey作为指令头时的前缀, 默认为空
例 (配置项为'#'时): #kiss @xxx osu hso!
<br/>
cachePoolSize: 10000响应回复的消息, 默认为true
可通过回复消息 定位到之前发送的图片并构造petpet
启用后 会缓存接收到的图片(见cachePoolSize)
例 : [回复[图片]]kiss(等价于 kiss [图片])
<br/>
respondSelfNudge: falserespondReply=true时, 图片消息缓存池大小, 默认为10000
本质为HashMap<imageId(long), imageUrl(String)>, 超过此限制会清空Map
<br/>
keyListFormat: FORWARD某些情况下, 机器人会主动戳其他成员, 响应机器人自己发出的戳一戳, 默认为false
<br/>
disablePolicy: FULL发送pet时 keyList响应格式, 默认为FORWARD
枚举: MESSAGE(发送普通消息) FORWARD(发送转发消息) IMAGE(发送图片)
<br/>
fuzzy: false发送pet on/off时 禁用哪些功能, 默认为FULL
枚举: NONE(无效) NUDGE(只禁用戳一戳) MESSAGE(只禁用指令) FULL(同时禁用戳一戳和指令)
strictCommand: true模糊匹配用户名, 默认为false
例 : (配置项为true时): kiss @田所浩二(响应) kiss 浩二(响应)
<br/>
synchronized: false严格匹配指令, 默认为true
人话: 可以省略key后的空格
例 : (配置项为false时): kiss 田所(响应) kiss田所(响应)
<br/>
gifEncoder: ANIMATED_LIB消息事件同步锁, 会锁住相同的消息事件, 默认为false
人话: 多机器人对于同一条指令只有一个会响应
<br/>
GIF编码器, 默认为ANIMATED_LIB
枚举:
编码速度较慢, 所需堆内存小, 生成Gif体积小
BUFFERED_STREAM:
基于缓存的STREAM流, 在编码过程中对Gif进行压缩;ANIMATED_LIB:
编码速度极快, 所需堆内存较多, 生成Gif体积较小
基于byte[]序列, 使用多线程分析像素;
<br/>
gifMaxSize: []gifQuality: 5GIF缩放阈值/尺寸, 默认为空 (不限制)
[width, height, frameLength]:
当Gif长度超过frameLength时, 会对Gif进行等比例缩放
注: 缩放在图片合成时进行, 不会影响性能
例: (配置项为[200, 200, 32]时)
当Gif长度超过32帧时, 检查Gif尺寸 当Gif尺寸大于200*200时, 对Gif进行等比例缩放 Gif缩放后 最长边不会超过设定值
(当Gif中包含40帧, 尺寸为300*500时) 输出的Gif长度不变, 尺寸为120*200
headless: trueGif编码质量(1-49), 默认为5
数字越小, 速度越慢, 质量越好 (大于20时, 速度不会有明显提升)
仅适用于ANIMATED_LIB编码器
autoUpdate: true启用headless模式, 默认为true
人话: 有些服务器没有输入输出设备, 画图库无法正常运行, 启用这个配置项可以修复, 因为总是有人不看常见问题, 干脆默认启用了(
<br/>
repositoryUrl: 'https://dituon.github.io/petpet'自动更新PetData, 每次启动时都会检查并自动下载船新pet, 默认为true
注: 仅更新PetData, 不会更新插件版本, 请放心食用
人话: 每次启动都会自动下载新的超赞梗图, 墙裂推荐
<br/>
devMode: false仓库地址, 用于自动更新, 默认为此仓库的github page
messageHook: false开发模式, 启用后任何人都能使用pet reload指令热重载PetData, 默认为false
<br/>
coolDown: 1000消息注入, 参考MessageHook, 默认为false
<br/>
groupCoolDown: -1成功触发指令后对该用户的冷却时间(单位为毫秒), 默认为 1000
设置为 -1 可禁用冷却
<br/>
inCoolDownMessage: 技能冷却中...成功触发指令后对该群聊的冷却时间, 默认为 -1
<br/>
在冷却时间中触发命令的回复消息
配置项为[nudge]时, 会以戳一戳形式回复
<br/>
</details>
修改后重启 Mirai 以重新加载
权限管理群主或管理员使用 pet on pet off 以 启用/禁用 戳一戳
pet on/off指令控制的事件可在配置文件中更改
图片预览 自定义 data.json可在配置文件中禁用指定key, 被禁用的key不会随机触发, 但仍可以通过指令使用
./data/xmmt.dituon.petpet/ 下的目录名为 key ，插件启动时会遍历 ./data/xmmt.dituon.petpet/$key/data.json
data.json 是模板配置文件, 程序解析此文件以生成图像
{ "type": "GIF", "avatar": [], "text": [], "delay": 50, "alias": [ "别名1", "别名2" ] } 属性 类型 注释 默认值 type 模板类型枚举 图片类型枚举, IMG或GIF 必须 avatar Avatar 数组 头像配置数组, 见下文 必须 text Text 数组 文本配置数组, 见下文 必须 inRandomList 布尔值 是否在随机列表中 false reverse 布尔值 GIF是否倒放 false delay 整数 帧间延时 (毫秒) 65 background Background 背景配置, 见下文 null alias 字符串数组 别名数组 [] hidden 布尔值 是否隐藏 false 模板类型枚举 GIF 动图, 程序会读取目录下所有.png格式的图像 IMG 静态图片, 程序会读取目录下随机.png格式的图像 头像程序支持复杂的图像处理, 包括裁切, 旋转, 透明度, 滤镜等
{ "avatar": [ { "type": "FROM", "pos": [[92, 64, 40, 40], [135, 40, 40, 40], [84, 105, 40, 40]], "round": true, "rotate": false, "avatarOnTop": true, "angle": 90 }, { "type": "TO", "pos": [[5, 8], [60, 90], [50, 90], [50, 0], [60, 120]], "posType": "DEFORM", "opacity": 0.5 } ] } 属性 类型 注释 默认值 type 头像类型枚举 见下文, 例如FROM或TO 必须 pos 坐标数组 头像的坐标信息 必须 posType 坐标格式枚举 坐标格式枚举, ZOOM或DEFORM ZOOM round 布尔值 头像是否裁切为圆形 false avatarOnTop 布尔值 头像图层是否在背景之上 true angle 整数 头像的初始角度 0 origin 旋转原点枚举 头像的旋转原点 DEFAULT opacity 浮点数 头像的不透明度 1.0 rotate 布尔值 GIF类型的头像是否旋转 false fit 填充模式枚举 填充模式枚举, 可以是CONTAIN或FILL FILL crop 裁切坐标数组 头像裁切坐标信息 null cropType 裁切格式枚举 见下文 NONE style 风格化枚举数组 风格化枚举数组, 见下文 [] filter 滤镜对象数组 滤镜数组, 见下文 [] antialias 布尔值 是否使用抗锯齿算法, 默认跟随全局配置 null resampling 布尔值 是否使用重采样缩放, 默认跟随全局配置 null头像类型枚举 type
FROM 发送者头像 TO 接收者头像, 或构造的图片 GROUP 群头像 BOT 机器人头像 RANDOM 随机头像 (随机从群聊成员中选择, 不会重复) 坐标坐标格式枚举posType
ZOOM 缩放, 通过 x, y, width, height 表示图像 DEFORM 变形, 通过四点坐标来表示图像 ZOOMZOOM 缩放坐标的基本组成单位是 4长度 int[] 数组
其中，前两项为 左上角顶点坐标， 后两项为 宽度和高度
例:
[65, 128, 77, 72] 即 头像的左上角顶点坐标是 (65,128), 宽度为 77, 高度为 72
如果是 GIF 类型，坐标应为二维数组，GIF 的每一帧视为单个图像文件
{ // pos的元素对应GIF的4帧 "pos": [[65, 128, 77, 72], [67, 128, 73, 72], [54, 139, 94, 61], [57, 135, 86, 65]] }如果是IMG类型, 可以使用一维数组
{ "pos": [0, 0, 200, 200] }坐标支持变量运算, 例如 [100,100,"width/2","height*1.5^2"]
坐标变量
width 原图宽度 height 原图高度 DEFORMDEFORM 仿射变换坐标格式为 [[x1,y1],[x2,y2],[x3,y3],[x4,y4],[x_anchor,y_anchor]];
分别对应图片的[[左上角],[左下角],[右下角],[右上角],[锚点]]，四角坐标用相对于锚点的偏移量表示
旋转原点枚举 origin
DEFAULT 左上角 CENTER 中心 裁切图片裁切坐标 [x1, y1, x2, y2], [0, 0, x2, y2] 可简写为 [x2, y2]
裁切格式枚举 cropType
NONE 不裁切 PIXEL 按像素裁切 PERCENT 按百分比裁切填充模式 fit
CONTAIN 缩小以适应画布, 不改变原比例 COVER 裁切以适应画布, 不改变原比例 FILL 拉伸, 改变原比例风格化枚举 style
MIRROR 水平镜像 FLIP 上下翻转 GRAY 灰度化 BINARIZATION 二值化 滤镜 filter通过滤镜实现头像特效, Java 与 JavaScript 版本实现有偏差, 并非完全相同
{ "filter": [ { "type": "SWIRL", "radius": 200, "angle": 5.0 } ] } 滤镜类型 type SWIRL 对应 AvatarSwirlFilter BULGE 对应 AvatarBulgeFilter BLUR 对应 AvatarBlurFilter CONTRAST 对应 AvatarContrastFilter HSB 对应 AvatarHSBFilter HALFTONE 对应 AvatarHalftoneFilter DOT_SCREEN 对应 AvatarDotScreenFilter NOISE 对应 AvatarNoiseFilter DENOISE 对应 AvatarDenoiseFilter 滤镜对象 AvatarSwirlFilter 对象, 漩涡滤镜 属性 类型 注释 默认值 radius 浮点数 涡旋半径, 值为0时表示图片半径 0.0 angle 浮点数 涡旋角度 3.0 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarBulgeFilter 对象, 膨胀收缩滤镜 属性 类型 注释 默认值 radius 浮点数 膨胀半径, 值为0时表示图片半径 0.0 strength 浮点数 膨胀强度 [-1, 1], 负数时产生收缩效果 0.5 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarBlurFilter 对象, 模糊滤镜 属性 类型 注释 默认值 radius 浮点数 模糊半径 10.0 AvatarContrastFilter 对象, 亮度对比度滤镜 属性 类型 注释 默认值 brightness 浮点数 亮度 0.0 contrast 浮点数 对比度 0.0 AvatarHSBFilter 对象, 相对HSB (色相, 饱和度, 亮度) 滤镜 属性 类型 注释 默认值 hue 浮点数 色相 0.0 saturation 浮点数 饱和度 0.0 brightness 浮点数 亮度 0.0 AvatarHalftoneFilter 对象, 半色调滤镜 (模仿彩色印刷的CMYK色彩) 属性 类型 注释 默认值 angle 浮点数 角度 0.0 radius 浮点数 半径 4.0 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarDotScreenFilter 对象, 单色点阵滤镜 (模仿黑白印刷品) 属性 类型 注释 默认值 angle 浮点数 角度 0.0 radius 浮点数 半径 4.0 x 浮点数 中心点X坐标百分比 0.5 y 浮点数 中心点Y坐标百分比 0.5 AvatarNoiseFilter 对象, 噪声滤镜 属性 类型 注释 默认值 amount 浮点数 噪声强度 0.25 AvatarDenoiseFilter 对象, 降噪滤镜 属性 类型 注释 默认值 exponent 短整数 指数 20 文字如果你想在图片上添加文字，可以编辑 text
{ "text": [ { "text": "Petpet!", // 文字内容 "color": "#66ccff", // 颜色, 默认为#191919 "pos": [100, 100], // 坐标 "size": 24 // 字号, 默认为12 }, { "text": "发送者: $from, 接收者: $to", // 支持变量 "pos": [20, 150], // 坐标 "position": ["CENTER", "BOTTOM"], //坐标计算基准([x, y]) "font": "宋体", // 字体, 默认为黑体 "strokeColor": "#ffffff", // 描边颜色 "strokeSize": 2 // 描边宽度 }, { "text": "$txt1[我]超市$txt2[你]!", // 支持关键词变量 "pos": [0,200,300], // 第三个值为文本最大宽度 "align": "CENTER", // 对齐方式, 默认为LEFT "wrap": "ZOOM", // 显示设置, 默认为NONE "style": "BOLD" // 字体样式, 默认为PLAIN } ] } 属性 类型 注释 默认值 text 字符串 文本内容 必须 pos 数组 文本的坐标信息 必须 color 字符串 文本颜色 #191919 size 整数 文本字号 12 angle 整数 头像的初始角度 0 origin 旋转原点枚举 文字的旋转原点 DEFAULT position 数组 文本坐标计算基准 [LEFT, TOP] font 字符串 字体 黑体 strokeColor 字符串 文本描边颜色 null strokeSize 整数 文本描边宽度 0 align 字符串 文本对齐方式 LEFT wrap 字符串 文本显示设置 NONE style 字符串 字体样式 PLAIN greedy 布尔值 是否贪婪匹配多余的关键词 false变量
$from : 发送者, 会被替换为发送者昵称 $to : 接收者, 被戳或At的对象 $group : 群名称 $txt(i)[(xxx)] : 文本变量, 可用于生成meme图, i为关键词索引, xxx为默认值; 例: $txt1[我]超市$txt2[你] 指令为 pet [key] 我 你font
在data/fonts目录下的字体文件会注册到环境中
align
LEFT: 左对齐, 文本基线是标准的字母基线 RIGHT: 右对齐, 文本基线是标准的字母基线 CENTER: 居中对齐, 文本基线在文本块的中间wrap
NONE: 不换行 BREAK: 自动换行, 超过最大宽度的文本会显示在下一行 ZOOM: 自动缩放, 缩放字体大小以填充最大宽度使用BREAK或ZOOM时, maxWidth 默认为 200
style
PLAIN: 默认 BOLD: 粗体 ITALIC: 斜体 BOLD_ITALIC: 粗体与斜体position
LEFT: 左定位(默认) RIGHT: 右定位 TOP: 上定位(默认) BOTTOM: 下定位 CENTER: 居中定位 background程序支持动态创建画布
{ "background": { "size": ["avatar0Width*2","avatar0Height"], //支持变量运算 "color": "#f0f0f0" } }坐标变量
avatar(i)Width i号头像(i为定义头像时的顺序, 从0开始)处理后的宽度 avatar(i)Height i号头像处理后的高度 text(i)Width i号文本渲染后的宽度 text(i)Height i号文本渲染后的高度 MessageHook本特性仅适用于 Mirai 插件, 消息注入, 插件会检查将要发送的消息 解析后注入图片, 可配合各类消息回复插件使用
<pet></pet> 标签中的JSON会被解析, 请求格式参考 WebServer.POST
用例:
这段文字之后的标签会变成一张图片发送<pet>{ "key": "petpet", "to": { "qq": 2544193782 }, "textList": [ "text1" ] }</pet>消息的顺序会被正确处理, 支持多张图片不同于 POST 请求格式, 你可以用 "qq" 令程序自动获取头像和昵称, 也可以自定义"name" "avatar"
(更推荐自定义的做法, 程序可能在某些情况下无法推断出正确的"name")
WebServer被"hidden": true隐藏的模板会正常调用
此功能默认禁用, 需在配置文件中启用messageHook: true
程序可作为http服务器 / API单独运行, 被其它项目/语言使用
java -jar petpet.jar
启动时会生成 config.json:
{ "port": 2333, // 监听端口 "webServerThreadPoolSize": 10, // HTTP服务器线程池容量 "dataPath": "data/xmmt.dituon.petpet", // PetData路径 "preview": false, // 启用动态预览 (启动时生成所有模板预览) "antialias": true, // 启用抗锯齿, 详见上文 "resampling": true, // 启用重采样, 详见上文 "gifMaxSize": [200, 200, 32], // GIF缩放阈值, 详见上文 "gifEncoder": "ANIMATED_LIB", // GIF编码器, 详见上文 "gifQuality": 5, // GIF质量, 详见上文 "threadPoolSize": 0, // GIF编码器线程池容量, 详见上文 "headless": true // 使用headless模式 }程序使用com.sun.net.httpserver实现http服务器
PetServer API访问 127.0.0.1:2333/petpet 以获取 PetDataList
GET使用 GET 传递参数, 例如 127.0.0.1:2333/petpet?key=petpet&toAvatar=$avatarUrl
127.0.0.1:2333/petpet?key=osu&textList=hso!
结构
<details>
<summary>展开/收起</summary>
使用 POST 传递参数, 例如 127.0.0.1:2333/petpet
{ "key": "petpet", "to": { "name":"d2n", "avatar":"https://q1.qlogo.cn/g?b=qq&nk=2544193782&s=640" }, "randomAvatarList": [ "url" ], "textList": [ "text" ] }其中, key为必须项, 其它可以省略
form-data可直接将图片二进制文件上传至服务器进行处理
类似于 GET数据结构, 使用 multipart/form-data
语言 示例 javascript post.js get.js python example.py php example.php WebUI可参考example-script中的代码实现请求
启动WebServer后即可使用WebUI
启用preview配置项以加载WebUI模板预览 (可选, 默认关闭)
修改 server-config.json preview: true 常见问题戳一戳无法触发?
检查 Mirai 登录协议, 仅 ANDORID_PHONE 可以收到 戳一戳 消息
没有生成配置文件?
Mirai 2.11.0 提供了新的 JavaAutoSaveConfig 方法, 请更新Mirai版本至 2.11.0 (不是2.11.0-M1), 旧版本不支持自定义配置项
Could not initialize class java.awt.Toolkit?
对于无输入输出设备的服务器 需要启用headless
自动更新下载速度慢 / 无法连接远程资源?
修改Petpet.yml中repositoryUrl的值为'https://ghproxy.com/https://raw.githubusercontent.com/Dituon/petpet/main'(高速镜像)
自动更新后 读取data.json出错?
自动更新时网络出错导致, 删除出错的文件 重新获取即可
其它错误? 问题?
性能 & 兼容性若此文档无法解决您的问题, 欢迎提交issue
程序使用底层java.awt类合成图片, 渲染时使用多线程, 静态图片渲染时间一般不会超过1ms
对GIF编码器的分析, 转换, 映射部分进行多线程优化, 速度极快
Android JVM没有实现java.awt, 推荐使用JDK 11+版本
分享你的作品 (模板)如果你想分享自定义的 Petpet, 欢迎Pr
二次开发程序提供超多实用API 拓展性极强, 附有互动式开发实例, 欢迎初学者学习!
互动式开发实例 参见test.moe.dituon.petpet.example.HelloPetpet
在别的项目二次开发: mirai-simplepetpet-plugin
后话如果此插件和您预期的一样正常工作，请给我一个 star
欢迎提交任何请求
交流群: 922959760
2024-04-11 15:23:34 I/Bot.QQ号: [SliderCaptcha] 正在提交中...
2024-04-11 15:23:34 I/Bot.QQ号: [SliderCaptcha] Submitting...
2024-04-11 15:23:35 I/Bot.QQ号: Bot cancelled: Bot closed
Login failed: BotAuthorization(BotAuthorization.byPassword(<ERASED>)) threw an exception during authorization process. See cause below.
2024-04-11 15:23:35 E/console: net.mamoe.mirai.network.BotAuthorizationException: BotAuthorization(BotAuthorization.byPassword(<ERASED>)) threw an exception during authorization process. See cause below.
net.mamoe.mirai.network.BotAuthorizationException: BotAuthorization(BotAuthorization.byPassword(<ERASED>)) threw an exception during authorization process. See cause below.
at net.mamoe.mirai.internal.network.components.SsoProcessorImpl.login(SsoProcessor.kt:263)
at net.mamoe.mirai.internal.network.handler.CommonNetworkHandler$StateConnecting$startState$2.invokeSuspend(CommonNetworkHandler.kt:247)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)
at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:106)
at kotlinx.coroutines.scheduling.CoroutineScheduler.runSafely(CoroutineScheduler.kt:570)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.executeTask(CoroutineScheduler.kt:750)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.runWorker(CoroutineScheduler.kt:677)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.run(CoroutineScheduler.kt:664)
Suppressed: net.mamoe.mirai.network.WrongPasswordException: Error(bot=Bot(QQ号), code=45, title=禁止登录, message=登录失败，请前往QQ官网im.qq.com下载最新版QQ后重试，或通过问题反馈 与我们联系。, errorInfo=)
at net.mamoe.mirai.internal.network.components.SsoProcessorImpl$SlowLoginImpl.doLogin(SsoProcessor.kt:490)
at net.mamoe.mirai.internal.network.components.SsoProcessorImpl$SlowLoginImpl$doLogin$1.invokeSuspend(SsoProcessor.kt)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)
at kotlinx.coroutines.internal.ScopeCoroutine.afterResume(Scopes.kt:33)
at kotlinx.coroutines.AbstractCoroutine.resumeWith(AbstractCoroutine.kt:102)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:46)
... 5 more
Caused by: [CIRCULAR REFERENCE: net.mamoe.mirai.network.WrongPasswordException: Error(bot=Bot(QQ号), code=45, title=禁止登录, message=登录失败，请前往QQ官网im.qq.com下载最新版QQ后重试，或 通过问题反馈与我们联系。, errorInfo=)]2024-04-11 15:23:34 I/Bot.QQ号: [SliderCaptcha] 正在提交中...
2024-04-11 15:23:34 I/Bot.QQ号: [SliderCaptcha] Submitting...
2024-04-11 15:23:35 I/Bot.QQ号: Bot cancelled: Bot closed
Login failed: BotAuthorization(BotAuthorization.byPassword(<ERASED>)) threw an exception during authorization process. See cause below.
2024-04-11 15:23:35 E/console: net.mamoe.mirai.network.BotAuthorizationException: BotAuthorization(BotAuthorization.byPassword(<ERASED>)) threw an exception during authorization process. See cause below.
net.mamoe.mirai.network.BotAuthorizationException: BotAuthorization(BotAuthorization.byPassword(<ERASED>)) threw an exception during authorization process. See cause below.
at net.mamoe.mirai.internal.network.components.SsoProcessorImpl.login(SsoProcessor.kt:263)
at net.mamoe.mirai.internal.network.handler.CommonNetworkHandler$StateConnecting$startState$2.invokeSuspend(CommonNetworkHandler.kt:247)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)
at kotlinx.coroutines.DispatchedTask.run(DispatchedTask.kt:106)
at kotlinx.coroutines.scheduling.CoroutineScheduler.runSafely(CoroutineScheduler.kt:570)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.executeTask(CoroutineScheduler.kt:750)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.runWorker(CoroutineScheduler.kt:677)
at kotlinx.coroutines.scheduling.CoroutineScheduler$Worker.run(CoroutineScheduler.kt:664)
Suppressed: net.mamoe.mirai.network.WrongPasswordException: Error(bot=Bot(QQ号), code=45, title=禁止登录, message=登录失败，请前往QQ官网im.qq.com下载最新版QQ后重试，或通过问题反馈 与我们联系。, errorInfo=)
at net.mamoe.mirai.internal.network.components.SsoProcessorImpl$SlowLoginImpl.doLogin(SsoProcessor.kt:490)
at net.mamoe.mirai.internal.network.components.SsoProcessorImpl$SlowLoginImpl$doLogin$1.invokeSuspend(SsoProcessor.kt)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:33)
at kotlinx.coroutines.internal.ScopeCoroutine.afterResume(Scopes.kt:33)
at kotlinx.coroutines.AbstractCoroutine.resumeWith(AbstractCoroutine.kt:102)
at kotlin.coroutines.jvm.internal.BaseContinuationImpl.resumeWith(ContinuationImpl.kt:46)
... 5 more
Caused by: [CIRCULAR REFERENCE: net.mamoe.mirai.network.WrongPasswordException: Error(bot=Bot(QQ号), code=45, title=禁止登录, message=登录失败，请前往QQ官网im.qq.com下载最新版QQ后重试，或 通过问题反馈与我们联系。, errorInfo=)]
图片消息内容：
[{"type":"MessageSource","kind":"GROUP","botId":1831766333,"ids":[2574],"internalIds":[1280584505],"time":1739257169,"fromId":123456789,"targetId":782233797,"originalMessage":[{"type":"Image","imageId":"{57454715-A857-BAD2-D863-CA717CB64A5B}.jpg","size":275828,"imageType":"JPG","width":990,"height":990,"isEmoji":false}]},{"type":"Image","imageId":"{57454715-A857-BAD2-D863-CA717CB64A5B}.jpg","size":275828,"imageType":"JPG","width":990,"height":990,"isEmoji":false}] // 使用 [Builder] 构建图片 Image.Builder builder = Image.newBuilder(imageId); builder.setType(ImageType.valueOf(imageMessage.getImageType())); builder.setWidth(imageMessage.getWidth()); builder.setHeight(imageMessage.getHeight()); builder.setSize(imageMessage.getSize()); builder.setEmoji(imageMessage.getEmoji()); Image image = builder.build(); // 当图片在服务器上存在时返回 `true`, 这意味着图片可以直接发送. boolean uploaded = Image.isUploaded(image, event.getBot()); // 获取到图片地址，以便于下载或读取图片信息 String imageUrl = Image.queryUrl(image); System.out.println(imageId);图片消息：解析图片地址：http://gchat.qpic.cn/gchatpic_new/1831766333/0-0-57454715A857BAD2D863CA717CB64A5B/0?term=2
获取的图片地址不能访问
登录和发消息时需要对数据包进行签名验证
无法通过验证就会出现 code=45 或者 他人无法看到机器人发送的消息
并且签名服务和登录协议版本需要匹配，否则签名无效
Mirai 不会提供内置的签名服务，但提供了接入第三方服务的接口
需要注意的是，Mirai 不对签名服务作任何的推荐，
并且是否使用及使用何种服务，由用户自行决定。
对签名服务支持是在 2.15.0 正式引入的
如何使用第三方签名服务 https://github.com/cssxsh/fix-protocol-version本插件参考和使用了OpenAI ChatBot 插件，已添加预设功能（为啥你们都想整猫娘）的源代码，因此遵循AGPL-3.0协议公开源代码
目前实现了：chat功能
https://github.com/Tki-sor/mirai-deepai-plugin
额外实现了，多模型支持，流式输出兼容（ds这种的）
效果：
8fbd684c-148a-4aac-8b1e-2e30f2546a56-image.png
由于功能有些从头写的，还没做到原插件所有功能（才...才不是偷懒）
要什么功能发issues吧...
每次管理服务器时都要登录网站，觉得有十分甚至九分的麻烦?
想要在QQ群里遇到问题快速解决？
Mirai to MCSM它来了！
一个使你可以从QQ控制MCSM面板的插件
相关链接使用方法 部署 部署Mirai Console Loader; 安装前置插件 Chat Command; 在 Releases 中下载最新的插件, 放入 MCL 根目录下的 plugins 文件夹中 配置APIKey 登录MCSM面板 点击右上角账户 进入个人资料 点击API接口密钥处的生成密钥并复制 填入/config/top.nlrdev.mirai2mcsm/MCSMConfig.yml中的相应位置 参阅权限说明文档, 赋予相对应的权限 开始使用吧! 命令
Tips：
当只有一个守护进程时，<remote_uuid>项可以被省略 命令缩写用法与命令相同 使用名称代替uuid的功能正在开发中 指令 描述 权限节点 /queryStatus /面板状态 查看面板状态 top.nlrdev.mirai2mcsm:command.querystatus /listRemotes缩写：/listre``/守护进程列表 列出守护进程列表 top.nlrdev.mirai2mcsm:command.listremotes /listInstances <uuid> [page] 缩写：/listinst``/实例列表 <守护进程uuid> [页数] 列出实例列表 top.nlrdev.mirai2mcsm:command.listinstances /operateInstance <operation> <remote_uuid> <uuid> 缩写：/opinst /实例操作 <操作类型> <守护进程UUID> <实例UUID> 操作一个实例，操作类型：open stop restart kill top.nlrdev.mirai2mcsm:command.operateinstance 配置文件 MCSMConfig.yml APIKey 描述：MCSM面板的APIKey，必填，连接至MCSM的必须密钥 默认值：空 APIUrl 描述：MCSM面板的链接，形如http://example.com:23333，默认为本机面板 默认值：http://127.0.0.1:23333 PluginConfig.yml UseForwardMessage 描述：是否在群聊中使用消息合并转发以避免消息过长 默认值：true IsDebugMode 描述：是否开启调试模式，在调试模式下插件会有更详细的输出以诊断错误 默认值：false 更多 此插件正在开发，未来会加入更多的功能，可以提出issue以催更（不是） 您可加入我们的 QQ社群 了解更多