查看“榴莲自定义功能”的源代码

== 关于 ==
该功能为基于 JavaScript 虚拟执行环境的被动响应式可编程功能，仅在[[附属群]]机器人研究室内开启内测。如果您不熟悉编程也没关系，可以来尝试由大家开发的最新小功能，或者对机器人进行简单的“调教”；如果您熟悉 JavaScript，非常欢迎来发散您的创意；如果您有意愿学习 JavaScript 编程语言，那同样欢迎您加入来利用虚拟环境练习、测试、开发属于自己的专属功能。

由于该功能向群内完全开放了自定义能力，因此严禁出现包括但不限于有关政治、色情、暴力、恐怖等敏感话题或违规话题，严禁任何违反 [https://ti.qq.com/agreement/index.html QQ 软件许可及服务协议] 8.2 条款的功能开发或调用，如果

* 您开发违反以上内容的功能，例如从色情网站上搬运照片等，则您会被拉黑，该功能会被直接删除
* 您利用他人开发的中立性功能有意调用导致出现违反以上内容的情况，例如利用他人开发的维基百科搬运功能搜索政治人物事件等，则您会被拉黑

另外，由于在群内所有群友共享一个 JavaScript 执行上下文，因此请不要恶意攻击虚拟执行环境，不要恶意覆盖、删除他人定义的变量或函数。屡犯不改的群友同样可能会被拉黑。

== 基本使用方法 ==
本节列举了无需编程知识就可以使用的功能列表，其中一些进阶的说明会用注释罗列到本节的最后。

=== 计算器 ===
此功能可以当作一个简单的计算器来用，支持 <code>+, -, *, /, % (模), ** (幂)</code> 等运算<ref group="注释">支持的运算符还包括位运算、比较运算、逻辑运算等，请参考[https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference#%E8%A1%A8%E8%BE%BE%E5%BC%8F%E5%92%8C%E8%BF%90%E7%AE%97%E7%AC%A6 表达式和运算符]。</ref>和 <code>sin, cos, exp, log</code> 等数学函数<ref group="注释">为了方便使用数学函数，所有 Math 对象的属性和方法均直接赋给了全局对象。支持的数学常数和函数请参考 [https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math Math 对象]。</ref>。
{| class="wikitable"
!发送
!回应
|-
|<code>1 + 1</code>
|<code>2</code>
|-
|<code>sqrt(3 ** 2 + 4 ** 2)</code>
|<code>5</code>
|-
|<code>PI * 10 ** 2</code>
|<code>314.1592653589793</code>
|-
|<code>(100 + 200 + 300) / 12</code>
|<code>50</code>
|}

=== 定义自动回复 ===
此功能可以当作另一个”调教榴莲“的方式使用，并且支持图片和表情。语法为 <code>触发语句='回复语句'</code> 或 <code>触发语句="回复语句"</code> 或 <code>触发语句=`回复语句`</code>，只有最后一种表达式支持多行定义<ref group="注释">具体来说，这个是定义了一个名为“触发语句”的字符串变量。字符串语法请参考 [https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String String]。</ref>，触发语句不能包含标点、空格或其它特殊字符。如果需要删除定义的自动回复，发送 <code>delete 触发语句</code> 即可。

=== 查找功能 ===
如果您想查找别人定义的功能，发送 <code>.find 关键词</code> 可以进行搜索，兼容句号前缀。注意，名称是'''大小写敏感'''的，错误的大小写无法得到预期的结果。

=== 查看功能帮助 ===
如果您想查看某个功能的帮助信息，发送 <code>.help 功能名</code> 即可，兼容句号前缀。具体的帮助信息由开发此功能的人员提供。

=== 调用功能 ===
发送 <code>.功能名</code> 可以调用该功能。如果这个功能需要参数，可以用空格分隔功能名称和参数，例如 <code>.功能名 参数1 参数2</code>。兼容句号前缀。

=== 查看源码 ===
如果您好奇别人开发的功能是如何实现的，可以发送 <code>.view 功能名</code> 查看源代码。兼容句号前缀。

<references group="注释"/>

== 进阶使用方法 ==

== 内置 API ==

=== 内置对象 ===
该功能是纯 JavaScript V8 执行环境，因此不像 Node.js 一样包含 <code>require, process</code> 等方法，也不像 Chrome 一样包含 <code>window, document</code> 等对象，只有标准 ECMAScript 6 内置的对象。

* 值对象：<code>Infinity, NaN, undefined, globalThis</code>
* 函数属性：<code>eval, isFinite, isNaN, parseFloat, parseInt, decodeURI, decodeURIComponent, encodeURI, encodeURIComponent, escape, unescape</code>
* 基本对象：<code>Object, Function, Boolean, Symbol</code>
** 错误对象：<code>Error, EvalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError</code>
* 数字和日期对象：<code>Number, BigInt, Math, Date</code>
* 字符串：<code>String, RegExp</code>
* 可索引的集合对象：<code>Array, Int8Array, Uint8Array, Int8Array, Uint16Array, Int16Array, Uint32Array, Int32Array, Float32Array, Float64Array, Uint8ClampedArray, BigUint64Array, BigInt64Array</code>
* 使用键的集合对象：<code>Map, Set, WeakMap, WeakSet</code>
* 结构化数据：<code>ArrayBuffer, SharedArrayBuffer, Atomics, DataView, JSON</code>
* 控制抽象对象：<code>Promise</code>
* 反射：<code>Proxy, Reflect</code>

具体的内置对象使用方法请参考 [https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects JavaScript 标准内置对象]。

=== 内置函数 ===
本节包括针对 QQ 环境注入的函数和方便开发功能注入的函数。这部分内容会随着开发频繁更改。如果您需要什么其它方便的函数请尽管提出。
{| class="wikitable"
|+QQ 相关内置函数
!定义
!参数类型
!返回值类型
!备注
|-
|<code>qq(qq)</code>
|(可选) ?string
|number
|返回 QQ 号，默认为发送消息者
|-
|<code>messageTime()</code>
|无
|number
|消息的秒级时间戳
|-
|<code>groupID()</code>
|无
|number
|消息所在的群号
|-
|<code>groupName()</code>
|无
|string
|消息所在的群名称
|-
|<code>qqName()</code>
|无
|string
|名称
|-
|<code>qqSex()</code>
|无
|string
|性别
|-
|<code>qqArea()</code>
|无
|string
|地区
|-
|<code>qqAge()</code>
|无
|number
|年龄
|-
|<code>qqLevel()</code>
|无
|number
|等级
|-
|<code>qqRole()</code>
|无
|string
|群员类型
|-
|<code>qqTitle()</code>
|无
|string
|头衔
|-
|<code>qqHead(qq)</code>
|<nowiki>(可选) ?(number | string)</nowiki>
|string
|生成 QQ 头像消息片段（默认发送消息者）
|-
|<code>at(qq)</code>
|<nowiki>number | string</nowiki>
|string
|生成 at 此人的消息片段
|-
|<code>img(imgURL)</code>
|string
|string
|生成图片消息片段
|-
|<code>env()</code>
|无
|object
|消息环境变量，一般以上函数足够使用，不需要手动处理环境变量
|}
{| class="wikitable"
|+其它内置函数
!定义
!参数类型
!返回值类型
!备注
|-
|<code>Buffer</code> 对象
|
|
|[https://www.npmjs.com/package/buffer buffer] 包提供的类似 Node.js [http://nodejs.cn/api/buffer.html Buffer 对象]
|-
|<code>seedRandom(seed)</code>
|any
|() => number
|[https://www.npmjs.com/package/seed-random seed-random] 包提供的带种伪随机数
|-
|<code>parse(html)</code>
|string
|object
|[https://www.npmjs.com/package/node-html-parser node-html-parser] 包提供的 HTML 解析器，风格与 Web API 相近
|-
|<code>setTimeout</code>
<code>(callback, ms, ...args)</code>
|function, number,
any
|number
|定时执行函数，延迟不能小于 5000 ms
|-
|<code>clearTimeout(timeout)</code>
|number
|void
|取消定时执行的函数
|-
|<code>alert(message)</code>
|<nowiki>string | number |</nowiki>
boolean | bigint
|void
|向群里发送消息
|-
|<code>get(url)</code>
|string
|Promise<string>
|向指定 URL 发送 GET 请求，返回 UTF-8 编码的结果
|}

=== 实用的自定义函数 ===
这里列举一些非内置的使用函数，由群友开发，请务必不要随意更改、删除这些函数。
{| class="wikitable"
|+
!定义
!参数类型
!返回值类型
!备注
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|}

== 注意事项 ==

== 开发计划 ==