希顶维基 - 用户贡献 [zh]

LNNBot/指令/musicjs*

2026-02-13T02:50:25Z

Cycwin：/* Tr3() */

{{LNNBot指令信息
|别名=musicjsx
|属性=别名指令
|所属插件=
|父级指令=
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码字符串。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（最初以“'''A'''SCII '''简'''谱”命名）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code><ref>'''t'''riplet/'''t'''uplet</ref>
| 开始三连音或结束连音 || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref>irregular '''d'''ivision</ref><ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音 || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref>'''r'''atio</ref><ref name="division-num"/>
| 开始 ''M'':''N'' 连音 || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code><ref>'''s'''ustain</ref>
| 延长 || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|-
| <code>S</code><ref>'''s'''taccato</ref>
| 断奏 || 将前一个音符实际播放的时间减半，不影响下一个音符开始的时间。
|-
| <code>X</code>
| 打击乐音符（高） || 以当前的一拍为时值创建采样率为 8000Hz 的噪波音符，<code>,</code> <code>'</code> 可以减半或倍增其采样率。
|-
| <code>x</code>
| 打击乐音符（低） || 以当前的一拍为时值创建采样率为 (4000 √2) Hz 的噪波音符，<code>,</code> <code>'</code> 可以减半或倍增其采样率。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种移植自[https://test.vudrux.site/islp/music.html 网页版谱曲工具]的、相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法如下：
{| class="wikitable"
|+ 乐谱语法说明
! 字符 !! 作用
|-
| <code>1 2 3 4 5 6 7</code>
| 代表低音区七个音符，从 C3 到 B3。
|-
| <code>d r m f s l t</code>
| 代表中音区七个音符，从 C4 到 B4。
|-
| <code>D R M F S L T</code>
| 代表高音区七个音符，从 C5 到 B5。
|-
| <code>8 9 x y X Y</code>
| 打击乐：采样率分别为 2048√2、4096、4096√2、……、16384 Hz 的噪波音符。
|-
| <code>#</code>
| 将接下来的音符升高半音。
|-
| <code>b</code>
| 将接下来的音符降低半音。
|-
| <code>'</code>
| 将接下来的音符升高三个八度。
|-
| <code>,</code>
| 将接下来的音符降低三个八度。
|-
| <code>-</code>
| 延长前一个音符的时值。
|-
| <code>~</code>
| 时值计数器增加 1。
|-
| <code>!</code>
| 时值计数器除以 2。
|-
| <code>(</code>
| 整体速度乘以 2。
|-
| <code>)</code>
| 整体速度乘以 0.5。
|-
| <code>...</code> + <code>/</code>
| 开始连音组（三连音无需加点，x 连音加点数为 x-3）。
|-
| <code>...</code> + <code>;</code>
| 结束连音组（三连音无需加点，x 连音加点数为 x-3）。
|-
| <code><</code>
| 将后续音符移低 12 个半音（一个八度）。
|-
| <code>></code>
| 将后续音符移高 12 个半音（一个八度）。
|-
| <code>+</code>
| 将后续音符移高 1 个半音。
|-
| <code>=</code>
| 将后续音符移低 1 个半音。
|-
| <code>p</code>
| 音量降低至原来的 1/1.5。
|-
| <code>P</code>
| 音量增强至原来的 1.5 倍。
|-
| <code>[ ... <nowiki>|</nowiki> ... ]</code>
| 并行播放多个音符或和弦。
|-
| <code>{ ... : ... : ... }</code>
| 重复段落。用冒号分隔不同段落，每轮重复依次播放对应段落。
|-
| <code>_</code>
| 休止符，暂停一个音符的时值。
|-
|colspan=2| *时值计数器决定下一个音符的长度，默认为 1。音符播放后重置。
|}

{{collapse|示例：《月半小夜曲》前半段|<syntaxhighlight lang="javascript">ip7("=>[3d7d--3-3d7d--4-2767--2-2544--3-3d7d--3-36dm--rr---7--(dr)m-#5-76---3d7d--3--355--(64--22)767--2-(22)544-(45-3--33)d7d--3-36dm--!rr--!_dd---7-rd!~d!~7__(33)d7d--33-355--642767--22-544-4533d7d--d3-/36d;m--rr--dd--d7-7d76---67dd---r-765-3(56----)67d---7-d-f------(mr)m---_7drmdm!d!~mdrms--ff---rd7!6!~557rf-m!r!~m367d7d7-67dm--r(r----rmr)(d----drd)7-7d76------__<6-[#5|3]>(33)d7d--3--355--64(22)767--222544-4533d7d--d336dm--rr--dd--d7-7!d!~76---67d[d---|6---][r-|7-]765-3(56)6-67d---7-d-f------(mr)m----<<|p___6mltD---26rmf---5rslt---15d-37m-,L36dmlm-26rflRlf37m#st---6mltD---6mlmD---26rflR--5rslt---15d-37m-6mltD---26rmf---dfDf7rf-37rm#s---,L36dmlm-26rfl---,S25rs---15dm37m-,L36dm-l-26rmf-r-4dld37#s-,L367d---4dfl5rt-37s-6mD-4dfl,T7df37rmlmR_7(#sm7#5m,T),M---,L-{[m-|d-|6-]:::}2-{[f-|r-|d-|6-]:::},S-{[t-|s-|f-]:::}1-[m-|d-|5-]3-[t-|#s-|m-],L-{[m-|d-|6-]:::}2-{[f-|r-|6-]:::}4df-37m-,L37dm7dm37m7t---,L367dmd-26rflfr-,S5rsr7r-15dm37#s-,L36dmlm-26rflfr-4dfd37#s-,L367d---4dld5rsr37s-,L3d-4dfd,T7df37rmlmr-7(#sm7#5m,T),M---]", 184)</syntaxhighlight>}}

=== <code>Tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>Tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为<code>;</code>)，使用一种相对松散的语法，音符可以连写。乐谱语法如下:
{| class="wikitable"
|+ <code>Tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将前面的音符升高半音。最多连用两个。
|-
| <code>b</code>
| 后缀，将前面的音符降低半音。最多连用两个，不得与<code>#</code>同时使用。
|-
| <code>.</code>
| 后缀，将前面的音符升高八度。可连用。
|-
| <code>_</code>
| 后缀，将前面的音符降低八度。可连用，不得与<code>.</code>同时使用。
|-
| <code>*</code>
| 后缀，将前面的音符时值增加一拍。可连用。
|-
| <code>/</code>
| 后缀，将前面的音符时值减半。可连用。
|-
| <code>$</code>
| 后缀，当某音符存在n个$后缀时，最终计算出的时值乘以n。
|-
| <code>%</code>
| 后缀，当某音符存在n个%后缀时，最终计算出的时值除以n。可以结合<code>$</code>实现三连音。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个半音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。
|-
| <code>j...</code>
| 若...为非负数，跳到...-1个音符的位置继续，若...为负数，则往前跳...个音符再继续，并且j...为'''一次性'''的。如:<code>12345;j-2</code>等效于<code>1234545</code>，<code>12345;j1</code>等效于<code>123452345</code>。
|-
| <code>z Z</code>
| 分别为-8000Hz与-5657.7Hz的音符，可视为鼓点使用。
|}
{{collapse|示例: 《热异常》副歌四句歌词|<syntaxhighlight lang="javascript">//musicjs*
Tr3("b183 n 1.# r1 6b r1 4 6.b r1 2b r1 6b 1.# r1 6b r1 4 1. r1 5b r1 1. r1 5b r1 1 6b r1 5b r1 2b 4/3/4/4#/4 r1 2b r1 6_b n/ 3b/ 4 r1 2b 3b/4/ 3b r1 1 r1 6_ 3b r1 1 r1 6_ 4 r1 1 r1 6_ 6b/ r0.5 4/ r0.5 3b/ 6/ 7b r1 4 r1 2b 6.b r1 2b r1 6b 1.# r1 6b r1 4 1./ r0.5 4/ r0.5 2b/ 7b/ 6b r1 2b r1 7_b 4/3/4/ r0.5 2b/ 3/ 4 n 4/ r0.5 1/ 3b/4/3b/4/ r0.5 1#/ 3b/4/ r0.5 1/ r0.5 6_/3b/4/3b/4 r1 3b r1 1 2b../ r0.5 2b./ 1../ r0.5 1./ 7.b r1 4. r1 2.b r1 7b 2..b r1 2b. 6..b r1 2b. r1 6.b 2b.. r1 2.b 1.. r1 6b. r1 4. r1 1. 6b. r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4.**/ r1.5 2.b**/ r1.5 7b**/ r1.5 4**/ 3.b/ 4. r1 2.b r1 7b r1 4# 3.b/ 4./ 3.b r1 1. r1 6b r1 4 3.b 4. r1 1. r1 6 r1 4 6.b/ r0.5 6b/ 6./ r0.5 6/ 7.b r1 4. r1 2.b r1 7b 6..b r1 6.b 2..b r1 6.b r1 4. r1 2.b 1../ r0.5 1./ 7.b/ r0.5 7b/ 6.b r1 4. r1 2.b r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ n/ n 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ 3.b/ 4./ r0.5 1./ r0.5 6/ 3.b/ 2.b/ 1./ 7b"," ") //right hand
time=0
Tr3("b183 7b__ r1 4__ r1 7b___ 7b__**/ r1.5 4_**/ r1.5 6_b**/ 7b__/ 7b___/ 4__/ 4#__**/ 4#__ 4_/ r0.5 2_b/ 7_b r1 5_b 2b__ r1 2b___ 6b__/ 2b_/ 4_/ 6__b**/ r1 4_ r1 2_b 4__**/ r1.5 4___**/ 4__ 1_/ 4__ 7b__ r1 4__ r1 7b___ 6_b**/ r1.5 4_**/ r1.5 7__b**/ 7__b/ 7___b/ 4__/ 4#__**/ r1.5 4#___**/ 7_b r1 4_# 4_/ r0.5 2_b/ 7__b/ 4__#/ 2__b r1 2___b 6__b**/ r1.5 2_b**/ r1.5 4_**/ 6__b/ 4_ r1 2_b 4__ r1 4___ 4__/ 1_/ 4_/ 1_**/ r1 4_ r1 6_ 7__b r1 7___b 7___b/ 7__b/ 5___b/ 5__b/ r0.5 2___b/ 5___b/ 5__b/ r0.5 2___b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7___b/ 7__b/ r0.5 4__/ 7___b/ 7__b/ r0.5 4__/ 5___b/ 2b__/ r0.5 5b__/ 5___/ 2b__/ r0.5 5b__/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7__b r1 4__ r1 7___b"," ") //left hand
</syntaxhighlight>}}

== <code>infxdi8music()</code> ==

<code>infxdi8music()</code> 函数接受一个[[希吕表声法]]字符串并解析、播放。目前实现并不完整。

LNNBot/指令/musicjs*

2026-02-12T05:02:29Z

Cycwin：/* Tr3() */

{{LNNBot指令信息
|别名=musicjsx
|属性=别名指令
|所属插件=
|父级指令=
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码字符串。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（最初以“'''A'''SCII '''简'''谱”命名）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code><ref>'''t'''riplet/'''t'''uplet</ref>
| 开始三连音或结束连音 || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref>irregular '''d'''ivision</ref><ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音 || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref>'''r'''atio</ref><ref name="division-num"/>
| 开始 ''M'':''N'' 连音 || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code><ref>'''s'''ustain</ref>
| 延长 || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|-
| <code>S</code><ref>'''s'''taccato</ref>
| 断奏 || 将前一个音符实际播放的时间减半，不影响下一个音符开始的时间。
|-
| <code>X</code>
| 打击乐音符（高） || 以当前的一拍为时值创建采样率为 8000Hz 的噪波音符，<code>,</code> <code>'</code> 可以减半或倍增其采样率。
|-
| <code>x</code>
| 打击乐音符（低） || 以当前的一拍为时值创建采样率为 (4000 √2) Hz 的噪波音符，<code>,</code> <code>'</code> 可以减半或倍增其采样率。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种移植自[https://test.vudrux.site/islp/music.html 网页版谱曲工具]的、相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法如下：
{| class="wikitable"
|+ 乐谱语法说明
! 字符 !! 作用
|-
| <code>1 2 3 4 5 6 7</code>
| 代表低音区七个音符，从 C3 到 B3。
|-
| <code>d r m f s l t</code>
| 代表中音区七个音符，从 C4 到 B4。
|-
| <code>D R M F S L T</code>
| 代表高音区七个音符，从 C5 到 B5。
|-
| <code>8 9 x y X Y</code>
| 打击乐：采样率分别为 2048√2、4096、4096√2、……、16384 Hz 的噪波音符。
|-
| <code>#</code>
| 将接下来的音符升高半音。
|-
| <code>b</code>
| 将接下来的音符降低半音。
|-
| <code>'</code>
| 将接下来的音符升高三个八度。
|-
| <code>,</code>
| 将接下来的音符降低三个八度。
|-
| <code>-</code>
| 延长前一个音符的时值。
|-
| <code>~</code>
| 时值计数器增加 1。
|-
| <code>!</code>
| 时值计数器除以 2。
|-
| <code>(</code>
| 整体速度乘以 2。
|-
| <code>)</code>
| 整体速度乘以 0.5。
|-
| <code>...</code> + <code>/</code>
| 开始连音组（三连音无需加点，x 连音加点数为 x-3）。
|-
| <code>...</code> + <code>;</code>
| 结束连音组（三连音无需加点，x 连音加点数为 x-3）。
|-
| <code><</code>
| 将后续音符移低 12 个半音（一个八度）。
|-
| <code>></code>
| 将后续音符移高 12 个半音（一个八度）。
|-
| <code>+</code>
| 将后续音符移高 1 个半音。
|-
| <code>=</code>
| 将后续音符移低 1 个半音。
|-
| <code>p</code>
| 音量降低至原来的 1/1.5。
|-
| <code>P</code>
| 音量增强至原来的 1.5 倍。
|-
| <code>[ ... <nowiki>|</nowiki> ... ]</code>
| 并行播放多个音符或和弦。
|-
| <code>{ ... : ... : ... }</code>
| 重复段落。用冒号分隔不同段落，每轮重复依次播放对应段落。
|-
| <code>_</code>
| 休止符，暂停一个音符的时值。
|-
|colspan=2| *时值计数器决定下一个音符的长度，默认为 1。音符播放后重置。
|}

{{collapse|示例：《月半小夜曲》前半段|<syntaxhighlight lang="javascript">ip7("=>[3d7d--3-3d7d--4-2767--2-2544--3-3d7d--3-36dm--rr---7--(dr)m-#5-76---3d7d--3--355--(64--22)767--2-(22)544-(45-3--33)d7d--3-36dm--!rr--!_dd---7-rd!~d!~7__(33)d7d--33-355--642767--22-544-4533d7d--d3-/36d;m--rr--dd--d7-7d76---67dd---r-765-3(56----)67d---7-d-f------(mr)m---_7drmdm!d!~mdrms--ff---rd7!6!~557rf-m!r!~m367d7d7-67dm--r(r----rmr)(d----drd)7-7d76------__<6-[#5|3]>(33)d7d--3--355--64(22)767--222544-4533d7d--d336dm--rr--dd--d7-7!d!~76---67d[d---|6---][r-|7-]765-3(56)6-67d---7-d-f------(mr)m----<<|p___6mltD---26rmf---5rslt---15d-37m-,L36dmlm-26rflRlf37m#st---6mltD---6mlmD---26rflR--5rslt---15d-37m-6mltD---26rmf---dfDf7rf-37rm#s---,L36dmlm-26rfl---,S25rs---15dm37m-,L36dm-l-26rmf-r-4dld37#s-,L367d---4dfl5rt-37s-6mD-4dfl,T7df37rmlmR_7(#sm7#5m,T),M---,L-{[m-|d-|6-]:::}2-{[f-|r-|d-|6-]:::},S-{[t-|s-|f-]:::}1-[m-|d-|5-]3-[t-|#s-|m-],L-{[m-|d-|6-]:::}2-{[f-|r-|6-]:::}4df-37m-,L37dm7dm37m7t---,L367dmd-26rflfr-,S5rsr7r-15dm37#s-,L36dmlm-26rflfr-4dfd37#s-,L367d---4dld5rsr37s-,L3d-4dfd,T7df37rmlmr-7(#sm7#5m,T),M---]", 184)</syntaxhighlight>}}

=== <code>Tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>Tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为<code>;</code>)，使用一种相对松散的语法，音符可以连写。乐谱语法如下:
{| class="wikitable"
|+ <code>Tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将前面的音符升高半音。最多连用两个。
|-
| <code>b</code>
| 后缀，将前面的音符降低半音。最多连用两个，不得与<code>#</code>同时使用。
|-
| <code>.</code>
| 后缀，将前面的音符升高八度。可连用。
|-
| <code>_</code>
| 后缀，将前面的音符降低八度。可连用，不得与<code>.</code>同时使用。
|-
| <code>*</code>
| 后缀，将前面的音符时值增加一拍。可连用。
|-
| <code>/</code>
| 后缀，将前面的音符时值减半。可连用。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个半音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。
|-
| <code>j...</code>
| 若...为非负数，跳到...-1个音符的位置继续，若...为负数，则往前跳...个音符再继续，并且j...为'''一次性'''的。如:<code>12345;j-2</code>等效于<code>1234545</code>，<code>12345;j1</code>等效于<code>123452345</code>。
|-
| <code>z Z</code>
| 分别为-8000Hz与-5657.7Hz的音符，可视为鼓点使用。
|}
{{collapse|示例: 《热异常》副歌四句歌词|<syntaxhighlight lang="javascript">//musicjs*
Tr3("b183 n 1.# r1 6b r1 4 6.b r1 2b r1 6b 1.# r1 6b r1 4 1. r1 5b r1 1. r1 5b r1 1 6b r1 5b r1 2b 4/3/4/4#/4 r1 2b r1 6_b n/ 3b/ 4 r1 2b 3b/4/ 3b r1 1 r1 6_ 3b r1 1 r1 6_ 4 r1 1 r1 6_ 6b/ r0.5 4/ r0.5 3b/ 6/ 7b r1 4 r1 2b 6.b r1 2b r1 6b 1.# r1 6b r1 4 1./ r0.5 4/ r0.5 2b/ 7b/ 6b r1 2b r1 7_b 4/3/4/ r0.5 2b/ 3/ 4 n 4/ r0.5 1/ 3b/4/3b/4/ r0.5 1#/ 3b/4/ r0.5 1/ r0.5 6_/3b/4/3b/4 r1 3b r1 1 2b../ r0.5 2b./ 1../ r0.5 1./ 7.b r1 4. r1 2.b r1 7b 2..b r1 2b. 6..b r1 2b. r1 6.b 2b.. r1 2.b 1.. r1 6b. r1 4. r1 1. 6b. r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4.**/ r1.5 2.b**/ r1.5 7b**/ r1.5 4**/ 3.b/ 4. r1 2.b r1 7b r1 4# 3.b/ 4./ 3.b r1 1. r1 6b r1 4 3.b 4. r1 1. r1 6 r1 4 6.b/ r0.5 6b/ 6./ r0.5 6/ 7.b r1 4. r1 2.b r1 7b 6..b r1 6.b 2..b r1 6.b r1 4. r1 2.b 1../ r0.5 1./ 7.b/ r0.5 7b/ 6.b r1 4. r1 2.b r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ n/ n 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ 3.b/ 4./ r0.5 1./ r0.5 6/ 3.b/ 2.b/ 1./ 7b"," ") //right hand
time=0
Tr3("b183 7b__ r1 4__ r1 7b___ 7b__**/ r1.5 4_**/ r1.5 6_b**/ 7b__/ 7b___/ 4__/ 4#__**/ 4#__ 4_/ r0.5 2_b/ 7_b r1 5_b 2b__ r1 2b___ 6b__/ 2b_/ 4_/ 6__b**/ r1 4_ r1 2_b 4__**/ r1.5 4___**/ 4__ 1_/ 4__ 7b__ r1 4__ r1 7b___ 6_b**/ r1.5 4_**/ r1.5 7__b**/ 7__b/ 7___b/ 4__/ 4#__**/ r1.5 4#___**/ 7_b r1 4_# 4_/ r0.5 2_b/ 7__b/ 4__#/ 2__b r1 2___b 6__b**/ r1.5 2_b**/ r1.5 4_**/ 6__b/ 4_ r1 2_b 4__ r1 4___ 4__/ 1_/ 4_/ 1_**/ r1 4_ r1 6_ 7__b r1 7___b 7___b/ 7__b/ 5___b/ 5__b/ r0.5 2___b/ 5___b/ 5__b/ r0.5 2___b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7___b/ 7__b/ r0.5 4__/ 7___b/ 7__b/ r0.5 4__/ 5___b/ 2b__/ r0.5 5b__/ 5___/ 2b__/ r0.5 5b__/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7__b r1 4__ r1 7___b"," ") //left hand
</syntaxhighlight>}}

== <code>infxdi8music()</code> ==

<code>infxdi8music()</code> 函数接受一个[[希吕表声法]]字符串并解析、播放。目前实现并不完整。

LNNBot/指令/musicjs*

2026-01-25T07:47:56Z

Cycwin：/* Tr3() */

{{LNNBot指令信息
|别名=musicjsx
|属性=别名指令
|所属插件=
|父级指令=musicjs
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码字符串。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（最初以“'''A'''SCII '''简'''谱”命名）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code><ref>'''t'''riplet/'''t'''uplet</ref>
| 开始三连音或结束连音 || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref>irregular '''d'''ivision</ref><ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音 || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref>'''r'''atio</ref><ref name="division-num"/>
| 开始 ''M'':''N'' 连音 || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code><ref>'''s'''ustain</ref>
| 延长 || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|-
| <code>X</code>
| 打击乐音符（高） || 以当前的一拍为时值创建采样率为 8000Hz 的噪波音符，<code>,</code> <code>'</code> 可以减半或倍增其采样率。
|-
| <code>x</code>
| 打击乐音符（低） || 以当前的一拍为时值创建采样率为 (4000 √2) Hz 的噪波音符，<code>,</code> <code>'</code> 可以减半或倍增其采样率。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种移植自[https://test.vudrux.site/islp/music.html 网页版谱曲工具]的、相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法如下：
{| class="wikitable"
|+ 乐谱语法说明
! 字符 !! 作用
|-
| <code>1 2 3 4 5 6 7</code>
| 代表低音区七个音符，从 C3 到 B3。
|-
| <code>d r m f s l t</code>
| 代表中音区七个音符，从 C4 到 B4。
|-
| <code>D R M F S L T</code>
| 代表高音区七个音符，从 C5 到 B5。
|-
| <code>#</code>
| 将接下来的音符升高半音。
|-
| <code>b</code>
| 将接下来的音符降低半音。
|-
| <code>'</code>
| 将接下来的音符升高三个八度。
|-
| <code>,</code>
| 将接下来的音符降低三个八度。
|-
| <code>-</code>
| 延长前一个音符的时值。
|-
| <code>~</code>
| 时值计数器增加 1。
|-
| <code>!</code>
| 时值计数器除以 2。
|-
| <code>(</code>
| 整体速度乘以 2。
|-
| <code>)</code>
| 整体速度乘以 0.5。
|-
| <code>...</code> + <code>/</code>
| 开始连音组（三连音无需加点，x 连音加点数为 x-3）。
|-
| <code>...</code> + <code>;</code>
| 结束连音组（三连音无需加点，x 连音加点数为 x-3）。
|-
| <code><</code>
| 将后续音符移低 12 个半音（一个八度）。
|-
| <code>></code>
| 将后续音符移高 12 个半音（一个八度）。
|-
| <code>+</code>
| 将后续音符移高 1 个半音。
|-
| <code>=</code>
| 将后续音符移低 1 个半音。
|-
| <code>p</code>
| 音量降低至原来的 1/1.5。
|-
| <code>P</code>
| 音量增强至原来的 1.5 倍。
|-
| <code>[ ... <nowiki>|</nowiki> ... ]</code>
| 并行播放多个音符或和弦。
|-
| <code>{ ... : ... : ... }</code>
| 重复段落。用冒号分隔不同段落，每轮重复依次播放对应段落。
|-
| <code>_</code>
| 休止符，暂停一个音符的时值。
|-
|colspan=2| *时值计数器决定下一个音符的长度，默认为 1。音符播放后重置。
|}

{{collapse|示例：《月半小夜曲》前半段|<syntaxhighlight lang="javascript">ip7("=>[3d7d--3-3d7d--4-2767--2-2544--3-3d7d--3-36dm--rr---7--(dr)m-#5-76---3d7d--3--355--(64--22)767--2-(22)544-(45-3--33)d7d--3-36dm--!rr--!_dd---7-rd!~d!~7__(33)d7d--33-355--642767--22-544-4533d7d--d3-/36d;m--rr--dd--d7-7d76---67dd---r-765-3(56----)67d---7-d-f------(mr)m---_7drmdm!d!~mdrms--ff---rd7!6!~557rf-m!r!~m367d7d7-67dm--r(r----rmr)(d----drd)7-7d76------__<6-[#5|3]>(33)d7d--3--355--64(22)767--222544-4533d7d--d336dm--rr--dd--d7-7!d!~76---67d[d---|6---][r-|7-]765-3(56)6-67d---7-d-f------(mr)m----<<|p___6mltD---26rmf---5rslt---15d-37m-,L36dmlm-26rflRlf37m#st---6mltD---6mlmD---26rflR--5rslt---15d-37m-6mltD---26rmf---dfDf7rf-37rm#s---,L36dmlm-26rfl---,S25rs---15dm37m-,L36dm-l-26rmf-r-4dld37#s-,L367d---4dfl5rt-37s-6mD-4dfl,T7df37rmlmR_7(#sm7#5m,T),M---,L-{[m-|d-|6-]:::}2-{[f-|r-|d-|6-]:::},S-{[t-|s-|f-]:::}1-[m-|d-|5-]3-[t-|#s-|m-],L-{[m-|d-|6-]:::}2-{[f-|r-|6-]:::}4df-37m-,L37dm7dm37m7t---,L367dmd-26rflfr-,S5rsr7r-15dm37#s-,L36dmlm-26rflfr-4dfd37#s-,L367d---4dld5rsr37s-,L3d-4dfd,T7df37rmlmr-7(#sm7#5m,T),M---]", 184)</syntaxhighlight>}}

=== <code>Tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>Tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为<code>;</code>)，使用一种相对松散的语法，音符可以连写。乐谱语法如下:
{| class="wikitable"
|+ <code>Tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将前面的音符升高半音。最多连用两个。
|-
| <code>b</code>
| 后缀，将前面的音符降低半音。最多连用两个，不得与<code>#</code>同时使用。
|-
| <code>.</code>
| 后缀，将前面的音符升高八度。可连用。
|-
| <code>_</code>
| 后缀，将前面的音符降低八度。可连用，不得与<code>.</code>同时使用。
|-
| <code>*</code>
| 后缀，将前面的音符时值增加一拍。可连用。
|-
| <code>/</code>
| 后缀，将前面的音符时值减半。可连用。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个半音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。
|}
{{collapse|示例: 《热异常》副歌四句歌词|<syntaxhighlight lang="javascript">//musicjs*
Tr3("b183 n 1.# r1 6b r1 4 6.b r1 2b r1 6b 1.# r1 6b r1 4 1. r1 5b r1 1. r1 5b r1 1 6b r1 5b r1 2b 4/3/4/4#/4 r1 2b r1 6_b n/ 3b/ 4 r1 2b 3b/4/ 3b r1 1 r1 6_ 3b r1 1 r1 6_ 4 r1 1 r1 6_ 6b/ r0.5 4/ r0.5 3b/ 6/ 7b r1 4 r1 2b 6.b r1 2b r1 6b 1.# r1 6b r1 4 1./ r0.5 4/ r0.5 2b/ 7b/ 6b r1 2b r1 7_b 4/3/4/ r0.5 2b/ 3/ 4 n 4/ r0.5 1/ 3b/4/3b/4/ r0.5 1#/ 3b/4/ r0.5 1/ r0.5 6_/3b/4/3b/4 r1 3b r1 1 2b../ r0.5 2b./ 1../ r0.5 1./ 7.b r1 4. r1 2.b r1 7b 2..b r1 2b. 6..b r1 2b. r1 6.b 2b.. r1 2.b 1.. r1 6b. r1 4. r1 1. 6b. r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4.**/ r1.5 2.b**/ r1.5 7b**/ r1.5 4**/ 3.b/ 4. r1 2.b r1 7b r1 4# 3.b/ 4./ 3.b r1 1. r1 6b r1 4 3.b 4. r1 1. r1 6 r1 4 6.b/ r0.5 6b/ 6./ r0.5 6/ 7.b r1 4. r1 2.b r1 7b 6..b r1 6.b 2..b r1 6.b r1 4. r1 2.b 1../ r0.5 1./ 7.b/ r0.5 7b/ 6.b r1 4. r1 2.b r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ n/ n 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ 3.b/ 4./ r0.5 1./ r0.5 6/ 3.b/ 2.b/ 1./ 7b"," ") //right hand
time=0
Tr3("b183 7b__ r1 4__ r1 7b___ 7b__**/ r1.5 4_**/ r1.5 6_b**/ 7b__/ 7b___/ 4__/ 4#__**/ 4#__ 4_/ r0.5 2_b/ 7_b r1 5_b 2b__ r1 2b___ 6b__/ 2b_/ 4_/ 6__b**/ r1 4_ r1 2_b 4__**/ r1.5 4___**/ 4__ 1_/ 4__ 7b__ r1 4__ r1 7b___ 6_b**/ r1.5 4_**/ r1.5 7__b**/ 7__b/ 7___b/ 4__/ 4#__**/ r1.5 4#___**/ 7_b r1 4_# 4_/ r0.5 2_b/ 7__b/ 4__#/ 2__b r1 2___b 6__b**/ r1.5 2_b**/ r1.5 4_**/ 6__b/ 4_ r1 2_b 4__ r1 4___ 4__/ 1_/ 4_/ 1_**/ r1 4_ r1 6_ 7__b r1 7___b 7___b/ 7__b/ 5___b/ 5__b/ r0.5 2___b/ 5___b/ 5__b/ r0.5 2___b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7___b/ 7__b/ r0.5 4__/ 7___b/ 7__b/ r0.5 4__/ 5___b/ 2b__/ r0.5 5b__/ 5___/ 2b__/ r0.5 5b__/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2___b/ 2__b/ r0.5 6___b/ 2___b/ 2__b/ r0.5 6___b/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7__b r1 4__ r1 7___b"," ") //left hand
</syntaxhighlight>}}

== <code>infxdi8music()</code> ==

<code>infxdi8music()</code> 函数接受一个[[希吕表声法]]字符串并解析、播放。目前实现并不完整。

LNNBot/指令/musicjs*

2026-01-03T13:17:59Z

Cycwin：/* tr3() */

{{LNNBot指令信息
|别名=
|属性=别名指令
|所属插件=
|父级指令=musicjs
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（“'''A'''SCII '''简'''谱”）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code>
| 开始三连音或结束连音（'''t'''riplet/'''t'''uplet） || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音（irregular '''d'''ivision） || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref name="division-num"/>
| 开始 ''M'':''N'' 连音（'''r'''atio） || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code>
| 延长（'''s'''ustain） || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法见此页面：[https://test.vudrux.site/islp/music.html ip7 music]

=== <code>tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为;)，使用一种相对松散的语法，在音符间可以省略空格。返回的是音符列表字符串，需搭配模板代码使用(参见示例)。乐谱语法如下:
{| class="wikitable"
|+ <code>tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将最前面第一个音符升高半度。最多连用两个。
|-
| <code>b</code>
| 后缀，将最前面第一个音符降低半度。最多连用两个。不得与<code>#</code>重复。
|-
| <code>.</code>
| 后缀，将最前面第一个音符'''延长'''一拍。可复用。
|-
| <code>/</code>
| 后缀，将最前面第一个音符时值除以2。可复用。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。

|}
{{collapse|示例: 《热异常》副歌四句歌词(似乎有问题) |<syntaxhighlight lang="javascript">//musicjs*
for(let i of eval(tr3("g0 b183 n 1.# r1 6b r1 4 6.b r1 2b r1 6b 1.# r1 6b r1 4 1. r1 5b r1 1. r1 5b r1 1 6b r1 5b r1 2b 4/3/4/4#/4 r1 2b r1 6_b n/ 3b/ 4 r1 2b 3b/4/ 3b r1 1 r1 6_ 3b r1 1 r1 6_ 4 r1 1 r1 6_ 6b/ r0.5 4/ r0.5 3b/ 6/ 7b r1 4 r1 2b 6.b r1 2b r1 6b 1.# r1 6b r1 4 1./ r0.5 4/ r0.5 2b/ 7b/ 6b r1 2b r1 7_b 4/3/4/ r0.5 2b/ 3/ 4 n 4/ r0.5 1/ 3b/4/3b/4/ r0.5 1#/ 3b/4/ r0.5 1/ r0.5 6_/3b/4/3b/4 r1 3b r1 1 2b../ r0.5 2b./ 1../ r0.5 1./ 7.b r1 4. r1 2.b r1 7b 2..b r1 2b. 6..b r1 2b. r1 6.b 2b.. r1 2.b 1.. r1 6b. r1 4. r1 1. 6b. r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4.**/ r1.5 2.b**/ r1.5 7b**/ r1.5 4**/ 3.b/ 4. r1 2.b r1 7b r1 4# 3.b/ 4./ 3.b r1 1. r1 6b r1 4 3.b 4. r1 1. r1 6 r1 4 6.b/ r0.5 6b/ 6./ r0.5 6/ 7.b r1 4. r1 2.b r1 7b 6..b r1 6.b 2..b r1 6.b r1 4. r1 2.b 1../ r0.5 1./ 7.b/ r0.5 7b/ 6.b r1 4. r1 2.b r1 6b 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ 3./ r0.5 3/ 4./ r0.5 4/ n/ n 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ r0.5 2.b/ r0.5 7b/ 3.b/ 4./ 3.b/ 4./ r0.5 1./ r0.5 6/ 3.b/ 2.b/ 1./ 7b"," ")))note(eval(i[0]),i[1]) //right hand
time=0
for(let i of eval(tr3("b183 7b__ r1 4__ r1 7b___ 7b__**/ r1.5 4_**/ r1.5 6_b**/ 7b__/ 7b___/ 4__/ 4#__**/ 4#__ 4_/ r0.5 2_b/ 7_b r1 5_b 2b__ r1 2b___ 6b__/ 2b_/ 4_/ 6__b**/ r1 4_ r1 2_b 4__**/ r1.5 4___**/ 4__ 1_/ 4__ 7b__ r1 4__ r1 7b___ 6_b**/ r1.5 4_**/ r1.5 7__b**/ 7__b/ 7___b/ 4__/ 4#__**/ r1.5 4#___**/ 7_b r1 4_# 4_/ r1 2_b/ 7__b/ 4__#/ 2__b r1 2___b 6__b**/ r1.5 2_b**/ r1.5 4_**/ 6__b/ 4_ r1 2_b 4__ r1 4___ 4__/ 1_/ 4_/ 1_**/ r1 4_ r1 6_ 7__b r1 7___b 7___b/ 7__b/ 5___b/ r0.5 2___b/ 7__b/ 5___b/ r0.5 2___b/ 2____b/ 5___b/ r0.5 1___/ 2____b/ 5___b/ r0.5 1___/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2____b/ 5___b/ r0.5 1___/ 2____b/ 5___b/ r0.5 1___/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7___b/ 7__b/ r0.5 4__/ 7___b/ 7__b/ r0.5 4__/ 4___/ 2b__/ r0.5 5b__/ 4___/ 2b__/ r0.5 5b__/ g0.8 7__b/ 5___b/ r0.5 2___b/ 7__b/ 5___b/ r0.5 2___b/ 2____b/ 5___b/ r0.5 1___/ 2____b/ 5___b/ r0.5 1___/ 4___/ 4__/ r0.5 1__/ 4___/ 4__/ r0.5 1__/ 7b___/ 7b__/ r0.5 4__/ 7b___/ 7b__/ r0.5 4__/ 5___b/ 5__b/ r0.5 2__b/ 5___b/ 5__b/ r0.5 2__b/ 2____b/ 5___b/ r0.5 1___/ 2____b/ 5___b/ r0.5 1___/ n 7__b r1 4__ r1 7___b"," ")))note(eval(i[0]),i[1])//left hand
</syntaxhighlight>}}

LNNBot/指令/musicjs*

2026-01-03T12:50:01Z

Cycwin：/* tr3() */

LNNBot/指令/musicjs*

2026-01-03T11:30:24Z

Cycwin：/* tr3() */

{{LNNBot指令信息
|别名=
|属性=别名指令
|所属插件=
|父级指令=musicjs
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（“'''A'''SCII '''简'''谱”）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code>
| 开始三连音或结束连音（'''t'''riplet/'''t'''uplet） || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音（irregular '''d'''ivision） || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref name="division-num"/>
| 开始 ''M'':''N'' 连音（'''r'''atio） || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code>
| 延长（'''s'''ustain） || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法见此页面：[https://test.vudrux.site/islp/music.html ip7 music]

=== <code>tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为;)，使用一种相对松散的语法，在音符间可以省略空格。返回的是音符列表字符串，需搭配模板代码使用(参见示例)。乐谱语法如下:
{| class="wikitable"
|+ <code>tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将最前面第一个音符升高半度。最多连用两个。
|-
| <code>b</code>
| 后缀，将最前面第一个音符降低半度。最多连用两个。不得与<code>#</code>重复。
|-
| <code>.</code>
| 后缀，将最前面第一个音符'''延长'''一拍。可复用。
|-
| <code>/</code>
| 后缀，将最前面第一个音符时值除以2。可复用。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。

|}
{{collapse|示例: 《热异常》前两句歌词 |<syntaxhighlight lang="javascript">//musicjs*
for(let i of eval(tr3("g0 b183 n 1.# 5.# r1 2.# r1 7b 1.# 1. r1 4 r1 2# 6b 4/ r0.5 1/ 3/4/3/ 4 r1 2b r1 7b_ n/ g0.6 3b.******/ r3.5 5b******/ n/ n/// 1.#/// 2b.**// 3b./ 4./ 6b/ 7b/ n 3b/ 4/4/3b/4/3b/ n/3b46b/6/7b r1 4 r1 2b 5_b/ 4/ n/ 5_b/2b/ r0.5 7_b/1/6_b/n/6_b/n/3b/6_b/1"," ")))note(eval(i[0]),i[1])
time=0
for(let i of eval(tr3("b183 7___b r1 7____b 7__b/ 4_ 7_b/ 2b/ 4**/ 2b_**/ r1.5 2b__**/ 4__**/ r1.5 4___**/ 5__b/ r0.5 5___b/ 7___b/ 5___b/ 5__b************/ 7__b r1 7___b 7___b/ 4__ 7b__ 7b_**/ r1.5 6b_**/ r1.5 4_**/ 7b__/ 7b___**/ 7b___/ 4__/ r0.5 4___/ 6___b/ 5__b**/ r1.5 5___b**/ 5__b/ 2b_****/ 4_ 2b_4_/4__/6__b/"," ")))note(eval(i[0]),i[1])</syntaxhighlight>}}

LNNBot/指令/musicjs*

2026-01-03T11:28:05Z

Cycwin：/* tr3() */

{{LNNBot指令信息
|别名=
|属性=别名指令
|所属插件=
|父级指令=musicjs
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（“'''A'''SCII '''简'''谱”）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code>
| 开始三连音或结束连音（'''t'''riplet/'''t'''uplet） || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音（irregular '''d'''ivision） || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref name="division-num"/>
| 开始 ''M'':''N'' 连音（'''r'''atio） || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code>
| 延长（'''s'''ustain） || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法见此页面：[https://test.vudrux.site/islp/music.html ip7 music]

=== <code>tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为;)，使用一种相对松散的语法，在音符间可以省略空格。乐谱语法如下:
{| class="wikitable"
|+ <code>tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将最前面第一个音符升高半度。最多连用两个。
|-
| <code>b</code>
| 后缀，将最前面第一个音符降低半度。最多连用两个。不得与<code>#</code>重复。
|-
| <code>.</code>
| 后缀，将最前面第一个音符'''延长'''一拍。可复用。
|-
| <code>/</code>
| 后缀，将最前面第一个音符时值除以2。可复用。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。

}
{{collapse|示例: 《热异常》前两句歌词 |<syntaxhighlight lang="javascript">//musicjs* for(let i of eval(tr3("g0 b183 n 1.# 5.# r1 2.# r1 7b 1.# 1. r1 4 r1 2# 6b 4/ r0.5 1/ 3/4/3/ 4 r1 2b r1 7b_ n/ g0.6 3b.******/ r3.5 5b******/ n/ n/// 1.#/// 2b.**// 3b./ 4./ 6b/ 7b/ n 3b/ 4/4/3b/4/3b/ n/3b46b/6/7b r1 4 r1 2b 5_b/ 4/ n/ 5_b/2b/ r0.5 7_b/1/6_b/n/6_b/n/3b/6_b/1"," ")))note(eval(i[0]),i[1])
time=0
for(let i of eval(tr3("b183 7___b r1 7____b 7__b/ 4_ 7_b/ 2b/ 4**/ 2b_**/ r1.5 2b__**/ 4__**/ r1.5 4___**/ 5__b/ r0.5 5___b/ 7___b/ 5___b/ 5__b************/ 7__b r1 7___b 7___b/ 4__ 7b__ 7b_**/ r1.5 6b_**/ r1.5 4_**/ 7b__/ 7b___**/ 7b___/ 4__/ r0.5 4___/ 6___b/ 5__b**/ r1.5 5___b**/ 5__b/ 2b_****/ 4_ 2b_4_/4__/6__b/"," ")))note(eval(i[0]),i[1])</syntaxhighlight>}}

LNNBot/指令/musicjs*

2026-01-03T11:26:41Z

Cycwin：/* 用法 */

{{LNNBot指令信息
|别名=
|属性=别名指令
|所属插件=
|父级指令=musicjs
|所需权限=
}}
'''<code>musicjs*</code>''' 是 {{LNNBot指令链接|musicjs}} 的衍生指令，提供了辅助函数用于更便捷地编写旋律。

== 用法 ==

<pre>musicjs* <code...></pre>

除 <code>musicjs</code> 提供的函数和变量之外，<code>musicjs*</code> 还提供一些由用户定义的函数用来用更简洁的语法编写旋律。

用户可以使用 <code>[[LNNBot/指令/evaluate|eval]]</code> 指令向 <code>musicjs*</code> 添加辅助函数，只需在对象 <syntaxhighlight inline lang="javascript">storage.musicjsX</syntaxhighlight> 上创建属性，名称建议与辅助函数名称相同，值为函数声明的 JavaScript 源代码。

=== <code>aj()</code> ===

辅助函数作者：{{LNN}}

<code>aj()</code>（“'''A'''SCII '''简'''谱”）函数接受一个乐谱字符串，可以通过一种受简谱启发的语法编写乐曲。

此辅助函数还定义了一个变量 <code>dd</code>，控制音符 <code>6</code> 与基准音（由 <code>baseFrequency</code> 定义，默认为 440 Hz）相差的半音数，初始为 0（即 1=C4），使用 <code>></code>、<code><</code> 会增减其值。例如使用 5 个 <code>></code> 可使 1=F4。

<code>aj()</code> 每次被调用时，会将 <code>gain</code> 设为 0.5，并将内部的“时值乘数”变量初始化为 1，它与 <code>bpm</code> 及圆括号的层数共同定义一“拍”的时长。

{| class="wikitable"
|+ <code>aj()</code> 乐谱语法
! 字符 !! 名称 !! 作用
|-
| <code>1</code>–<code>7</code>
| 音符 || 以当前的一拍为时值创建对应的简谱音符。
|-
| <code>0</code>
| 休止符 || 休止一拍。
|-
| <code>,</code>
| 低音点 || 将前一个音符降低一个八度。
|-
| <code>'</code>
| 高音点 || 将前一个音符升高一个八度。
|-
| <code>.</code>
| 附点 || 将前一个音符的时值延长半拍。 连用多个时，每个后续附点延长的时值是前一个附点的一半。
|-
| <code>-</code>
| 延音线 || 将前一个音符的时值延长一拍。可以跨过小节线甚至减时线的起止。
|-
| <code><nowiki>|</nowiki></code>
| 小节线 || 无作用，仅辅助阅读。
|-
| <code>(</code> <code>)</code>
| 减时线 || 括号内一拍的时长减半，可以嵌套。
|-
| <code>b</code>
| 降号 || 使下一个音符降低一个半音。不会影响后续的音符。
|-
| <code>#</code>
| 升号 || 使下一个音符升高一个半音。不会影响后续的音符。
|-
| <code>[</code> <code>/</code> <code>]</code>
| 分声部 || 方括号内由斜杠分隔的各部分将同时开始演奏。 顺序最后的一个部分演奏结束时，无论其他各部分是否演奏完毕，都会继续演奏方括号之后的乐谱。
|-
| <code>></code>
| 升调 || 升调一个半音。
|-
| <code><</code>
| 降调 || 降调一个半音。
|-
| <code>p</code>
| 力度：弱 || 将 <code>gain</code> 设为 0.33，若已经是 0.33 则设为 0.18。
|-
| <code>m</code>
| 力度：中 || 将 <code>gain</code> 设为 0.5。
|-
| <code>f</code>
| 力度：强 || 将 <code>gain</code> 设为 0.75，若已经是 0.75 则设为 1。
|-
| <code>t</code>
| 开始三连音或结束连音（'''t'''riplet/'''t'''uplet） || 如果当前时值乘数为 1，则将其设为 2 / 3；否则设为 1。
|-
| <code>d</code>''N''<ref name="division-num">''M''、''N'' 可以是正整数或小数；在这些指令之后不可直接跟音符或休止符，需要加空格分隔开。</ref>
| 开始 ''N'' 连音（irregular '''d'''ivision） || 若 ''N'' 是 2 的正整数次幂，则将时值乘数设为 0.75；否则设为 <math>\frac{2^{\lfloor\log_2N\rfloor}}N</math>。''N'' 为 1 时实际效果为结束连音。
|-
| <code>r</code>''M''<code>:</code>''N''<ref name="division-num"/>
| 开始 ''M'':''N'' 连音（'''r'''atio） || 将时值乘数设为 ''N'' / ''M''。
|-
| <code>s</code>
| 延长（'''s'''ustain） || 将前一个音符实际播放的时间延长一拍，不影响下一个音符开始的时间。 可连用，可套在减时线内使用来延长更短的时长。
|}
<references/>

{{collapse|示例：《Somebody That I Used To Know》副歌|
<syntaxhighlight lang="javascript">//musicjs*
bpm=129
aj('>>>>>') // 1=F
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|4'.(3')3'(66)|
(2'3'3'3'3'.(2')2'6)|655-|
/pp
3''--0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0(5561'1'6)|4'.(3')3'-|
0(2'3'2'2'2'2'|5'5'5'5'4')3'(2')|
1'-(61'1'6)|3'.(2')2'-|
(2'3'3'3'1'2'2'2')|2'1'1'-|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''-----2''|-)
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
]`)
aj(`[f
0000|0000|
(2'3'3'3'1'2'2'2')|2'1'1'-|
0000|0000|
(2'3'3'3'1'2'2'(2'3'))|2'1'1'-|
/p
(50502'02'0|3'4'5'3')2'0|
(1'01'07070|6060)50|
(50502'02'0|3'4'5'3')2'0|
(60)00(70)|(60)00((2'3')0)|
/pp
(03''----)0|00(5''--2''|
-3''----)0|1''-(5'--2''|
-3''----)0|00(5''--2''|
-3''----02''|-1''----)0|
/m
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|
6,,.(6,,)5,,.(5,,)|4,,.(4,,)5,,.(5,,)|6,,
]`)
</syntaxhighlight>}}

=== <code>ip7()</code> ===

辅助函数作者：{{U|6xL-Bro islptng}}

<code>ip7()</code> 函数接受一个乐谱字符串和一个 BPM 数字，使用一种相比于 <code>aj()</code> 更加紧凑的语法。乐谱语法见此页面：[https://test.vudrux.site/islp/music.html ip7 music]

=== <code>tr3()</code> ===

辅助函数作者：{{U|cycwin}}

<code>tr3()</code> 函数接受一个乐谱字符串和分隔符(可省略，默认为;)，使用一种相对松散的语法，在音符间可以省略空格。乐谱语法如下:
{| class="wikitable"
|+ <code>tr3()</code> 乐谱语法
! 字符 !! 作用
|-
| <code>1–7</code>
| 音符do–ti。
|-
| <code>#</code>
| 后缀，将最前面第一个音符升高半度。最多连用两个。
|-
| <code>b</code>
| 后缀，将最前面第一个音符降低半度。最多连用两个。不得与<code>#</code>重复。
|-
| <code>.</code>
| 后缀，将最前面第一个音符'''延长'''一拍。可复用。
|-
| <code>/</code>
| 后缀，将最前面第一个音符时值除以2。可复用。
|-
| <code>n</code>
| 休止符，被视作一个正常音符处理。
|-
| <code>b...</code>
| 调整bpm到...
|-
| <code>m...</code>
| 将后面的音符整体增加...个音(12平均律)。...可以为负数。
|-
| <code>r...</code>
| 将时间往回调...'''拍'''，可利用此做和弦之类。
{{collapse|示例: 《热异常》前两句歌词 |<syntaxhighlight lang="javascript">//musicjs* for(let i of eval(tr3("g0 b183 n 1.# 5.# r1 2.# r1 7b 1.# 1. r1 4 r1 2# 6b 4/ r0.5 1/ 3/4/3/ 4 r1 2b r1 7b_ n/ g0.6 3b.******/ r3.5 5b******/ n/ n/// 1.#/// 2b.**// 3b./ 4./ 6b/ 7b/ n 3b/ 4/4/3b/4/3b/ n/3b46b/6/7b r1 4 r1 2b 5_b/ 4/ n/ 5_b/2b/ r0.5 7_b/1/6_b/n/6_b/n/3b/6_b/1"," ")))note(eval(i[0]),i[1])
time=0
for(let i of eval(tr3("b183 7___b r1 7____b 7__b/ 4_ 7_b/ 2b/ 4**/ 2b_**/ r1.5 2b__**/ 4__**/ r1.5 4___**/ 5__b/ r0.5 5___b/ 7___b/ 5___b/ 5__b************/ 7__b r1 7___b 7___b/ 4__ 7b__ 7b_**/ r1.5 6b_**/ r1.5 4_**/ 7b__/ 7b___**/ 7b___/ 4__/ r0.5 4___/ 6___b/ 5__b**/ r1.5 5___b**/ 5__b/ 2b_****/ 4_ 2b_4_/4__/6__b/"," ")))note(eval(i[0]),i[1])</syntaxhighlight>}}

LNNBot/WhatCommands指令/wthsvg

2025-12-22T12:16:42Z

Cycwin：

WhatCommands 指令 '''<code>wthsvg</code>''' 可根据输入的一系列中文指令绘制图像。主要作者为 {{U|Cycwin}}，{{LNN}} 补充完善部分功能。

== 用法 ==

¿¿wthsvg 指令...

wthsvg 的参数中每行为一条指令，指令分为操作和属性，操作以横杠（<code>-</code>）开头，属性跟在其所属的操作之后。

=== 操作 ===

;<code>-画布 ''w'' ''h''</code>
:指定画布宽为''w''，高为''h''，一般写在最开头作为第一个操作。
;<code>-左下角坐标</code>
:特殊操作：此操作执行后，后续的所有操作中坐标原点在左下角，纵轴向上。未使用此操作时原点在左上角，纵轴向下。
;<code>-线段 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制从 (''x1'', ''y1'') 到 (''x2'', ''y2'') 的线段。 线段目前没有默认颜色，必须通过<code>颜色</code>属性手动设置颜色才可绘制。
;<code>-圆形 ''r'' ''x'',''y''</code>
:绘制一个圆心在 (''x'', ''y'')，半径为 ''r'' 的圆形。
;<code>-矩形 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制一个对角为 (''x1'', ''y1'') 与 (''x2'', ''y2'')，平行于坐标轴的矩形。可以缺省任意一个坐标，默认值为(0,0)。
;<code>-多边形 ''x1'',''y1'' ''x2'',''y2'' ''x3'',''y3''...</code>
:以给定的一系列坐标为顶点绘制多边形。
;<code>-文字 ''x'',''y'' ''内容''</code>
:在 (''x'', ''y'') 处绘制文本。
;<code>-扇形 ''r'' ''x'',''y'' ''a1'' ''a2''</code>
:绘制一个圆心在 (''x'', ''y'')，圆心角(顺时针)为 ''a1''，半径为 ''r'' ，起始角度(顺时针)为 ''a2'' 的扇形。 ''a2'' 可以缺省，默认值为0。
图形操作（不包括 <code>-文字</code>）可以一次输入多组参数，用英文分号（<code>;</code>）分隔，此时将同时绘制多个同类图形并共用属性。建议在分号之后或前后均添加空格以便阅读。例如，绘制四个半径 50 单位，紧挨在一起的圆：<code>-圆形 50 100,100; 50 100,200; 50 200,100; 50 200,200</code>

=== 属性 ===

设置颜色时，可以使用方括号括起并以空格分隔的 RGB 颜色值（<code>[''r'' ''g'' ''b'']</code>），CSS 颜色语法（包括 <code>rgb(''R'',''G'',''B'')</code>、井号开头的十六进制颜色值、英文关键字颜色名）和[http://lnnbot.哼.site/whatcolorreplacer/ 我们预先定义的中文颜色名]表示。

;<code>背景 ''c''</code>
:只对 <code>-画布</code> 指令有效：设置画布背景颜色为 ''c''。可以是“<code>透明</code>”。未设置时默认为白色。
;<code>颜色 ''c''</code>
:设置图形的颜色为 ''c''。 对于除线段之外的图形，未设置时默认为黑色；可将<code>颜色</code>设置为“<code>透明</code>”后再设置<code>描边</code>属性来绘制空心的图形。
;<code>描边 ''c''</code>
:为图形添加颜色为 ''c'' 的描边。 对于线段，与<code>颜色</code>属性等价。
;<code>粗细 ''d''</code>
:设置线段或描边的宽度为 ''d''。
;<code>旋转 ''a'' ''x'',''y''</code>
:将图形沿点 (''x'', ''y'') 旋转 ''a'' 度(顺时针)。
;<code>渐变 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
;<code>渐变描边 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
:设置图形（或描边）为渐变色，从 (''x1'', ''y1'') 处颜色 ''c1'' 平滑过渡到 (''x2'', ''y2'') 处颜色 ''c2''。 (''x1'', ''y1'')、(''x2'', ''y2'') 两个点可以连成一条线段，称为渐变轴，颜色的 RGB 值在渐变轴上分别均匀变化；图形上任何一个其他的点，都与渐变轴上离那个点最近的一个点的颜色相同。也就是说，让渐变轴沿着垂直于自身的方向平移，扫过的面积里颜色均匀变化，而没有扫过的地方颜色与相应端点的颜色相同，即 ''c1'' 和 ''c2''。
;<code>渐变 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
;<code>渐变描边 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
:除了渐变轴的两个端点外，可以在渐变轴上选定更多控制点并设置颜色，每两个相邻控制点之间颜色的 RGB 值都会均匀变化。每个中间控制点由一个颜色 ''c'' 和一个位置比值定义，比值可以是一个百分比 ''t''% 或分数 ''m''/''n''，表示控制点位置到渐变轴起点的距离与渐变轴长度的比值。若两个中间控制点的位置重合，会形成一个颜色突变，分界线垂直于渐变轴。
;<code>虚线 ''l'' ''d''</code>
:设置线段或描边为许多短线组成的虚线，短线长度为 ''l''，每两条短线之间空出 ''d'' 的距离。 ''d'' 与 ''l'' 相同时可省略 ''d''。
;<code>虚线 ''l1'' ''d1'' ''l2'' ''d2'' ''l3'' ...</code>
:高级虚线：从图形轮廓的起点开始先画长 ''l1'' 的短线，空出 ''d1'' 的距离，再画 ''l2'' 的短线，空出 ''d2''，以此类推，直到最后一组 ''ln''、''dn'' 后循环。若最后一组只有 ''ln'' 没有 ''dn''（即总共有奇数个数字），则最后一个短线长度 ''ln'' 跟循环回开头的第一个短线长度 ''l1'' 合并为一条长 ''ln'' + ''l1'' 的短线，之后再空出 ''d1'' 的距离，画 ''l2'' 的短线……这样继续下去。
;<code>平头</code>
:取消线段或虚线两端默认存在的小半圆，使本来圆头的线变为平头。
;<code>方头</code>
:将线段或虚线两端本来的小半圆改为小长方形，类似于<code>平头</code>但是视觉上使线的两端各延长了线宽度的一半。
;<code>字号 ''s''</code>
:设置文字的大小为 ''s''。
;<code>字体 ''名称''</code>
:设置文字使用的字体族名称。
;<code>字重 ''w''</code>
:设置字重（文字形状的粗细）为 ''w''。 字重是一个 1000 以内的正整数，未设置时默认为 400，即常规。''w'' 也可以是汉字“<code>粗</code>”，表示 700，即粗体。只有部分字体支持任意设置字重，多数只支持几个固定的值，如果字体不支持你设置的字重，会自动选择一个比较接近的可用值。
;<code>字宽 ''w''</code>
:设置字宽为 ''w''%。 字宽是一个 50% 到 200% 之间的百分数，未设置时为 100%。只有部分字体支持设置字宽。
;<code>斜体</code>
:使文字倾斜（使用意大利体的字母）。
;<code>斜体 ''a''</code>
:<code>斜体</code> 后面也可以跟一个角度 ''a''，表示让文字倾斜大约 ''a'' 度。正常的倾斜体是 14 度。很少有字体支持任意设置倾斜角度。
;<code>左对齐</code>
;<code>右对齐</code>
:让文字的左/右端对准设置的坐标。未设置时，默认是让文字的中心落在设置的坐标处。

== 示例 ==

待添加

== 一些想说的 ==
{{quote|
这条命令实际上是受一位有着视力障碍的群友激发而产生的。这位群友在我们不知道的地方打听到了某款电脑专用的盲用画图软件(经过LNN的逆向可知这是一个Python程序，根据原作者的描述实际上是给盲人写论文画示例图用的)，又打听到LNN有个LNNBot(大概因为他也是玩造语的)于是前来询问LNN能否将这个盲用画图软件移植到LNNBot上使用。我一时兴起建了一个SVGpath解析器，后来觉得太难用于是搓出来了wthsvg的最初模样:只有画布、线段，以及颜色、描边。我很不想很不想辜负这位发言极其真诚的群友，我一再声明：这不符合那款软件的语法！这里的漏洞还有很多！但这位群友仍然在鼓励我(他截止目前已画出来了许多我们认为不错的作品)，于是在大概一周内有了整整八个操作。LNN的加入实际上以我们替换中文颜色的词库匮乏而起，他在渐变的语法判定上、圆形的语法转化上以及关于字体的所有属性等等都做出了巨大的贡献！包括这篇文档也是他写的。我很感谢一直支持这个项目的人(尽管这项目才开展了两周不到，我编辑时离月考只有两三天了)，包括代码贡献者，指令使用者(尽管有预防)。能做成一个对他人有着帮助的wc指令我感到高兴至极！即便不为人知，这件事已成为我人生漆黑夜空中一颗不亮的闪星，在我极匮乏的内心世界中照耀。十分感谢各位。我们会在除这个指令外的世界中共同走下去，可能在将来不再有互联网上的联系，但这段旅程我会铭记于心。(好申必的升华啊)
|{{U|Cycwin}}}}

LNNBot/WhatCommands指令/wthsvg

2025-12-22T12:13:40Z

Cycwin：

WhatCommands 指令 '''<code>wthsvg</code>''' 可根据输入的一系列中文指令绘制图像。主要作者为 {{U|Cycwin}}，{{LNN}} 补充完善部分功能。

== 用法 ==

¿¿wthsvg 指令...

wthsvg 的参数中每行为一条指令，指令分为操作和属性，操作以横杠（<code>-</code>）开头，属性跟在其所属的操作之后。

=== 操作 ===

;<code>-画布 ''w'' ''h''</code>
:指定画布宽为''w''，高为''h''，一般写在最开头作为第一个操作。
;<code>-左下角坐标</code>
:特殊操作：此操作执行后，后续的所有操作中坐标原点在左下角，纵轴向上。未使用此操作时原点在左上角，纵轴向下。
;<code>-线段 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制从 (''x1'', ''y1'') 到 (''x2'', ''y2'') 的线段。 线段目前没有默认颜色，必须通过<code>颜色</code>属性手动设置颜色才可绘制。
;<code>-圆形 ''r'' ''x'',''y''</code>
:绘制一个圆心在 (''x'', ''y'')，半径为 ''r'' 的圆形。
;<code>-矩形 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制一个对角为 (''x1'', ''y1'') 与 (''x2'', ''y2'')，平行于坐标轴的矩形。可以缺省任意一个坐标，默认值为(0,0)。
;<code>-多边形 ''x1'',''y1'' ''x2'',''y2'' ''x3'',''y3''...</code>
:以给定的一系列坐标为顶点绘制多边形。
;<code>-文字 ''x'',''y'' ''内容''</code>
:在 (''x'', ''y'') 处绘制文本。
;<code>-扇形 ''r'' ''x'',''y'' ''a1'' ''a2''</code>
:绘制一个圆心在 (''x'',''y'')，圆心角(顺时针)为''a1''，半径为''r''，起始角度(顺时针)为''a2''的扇形。''a2''可以缺省，默认值为0。
图形操作（不包括 <code>-文字</code>）可以一次输入多组参数，用英文分号（<code>;</code>）分隔，此时将同时绘制多个同类图形并共用属性。建议在分号之后或前后均添加空格以便阅读。例如，绘制四个半径 50 单位，紧挨在一起的圆：<code>-圆形 50 100,100; 50 100,200; 50 200,100; 50 200,200</code>

=== 属性 ===

设置颜色时，可以使用方括号括起并以空格分隔的 RGB 颜色值（<code>[''r'' ''g'' ''b'']</code>），CSS 颜色语法（包括 <code>rgb(''R'',''G'',''B'')</code>、井号开头的十六进制颜色值、英文关键字颜色名）和[http://lnnbot.哼.site/whatcolorreplacer/ 我们预先定义的中文颜色名]表示。

;<code>背景 ''c''</code>
:只对 <code>-画布</code> 指令有效：设置画布背景颜色为 ''c''。可以是“<code>透明</code>”。未设置时默认为白色。
;<code>颜色 ''c''</code>
:设置图形的颜色为 ''c''。 对于除线段之外的图形，未设置时默认为黑色；可将<code>颜色</code>设置为“<code>透明</code>”后再设置<code>描边</code>属性来绘制空心的图形。
;<code>描边 ''c''</code>
:为图形添加颜色为 ''c'' 的描边。 对于线段，与<code>颜色</code>属性等价。
;<code>粗细 ''d''</code>
:设置线段或描边的宽度为 ''d''。
;<code>旋转 ''a'' ''x'',''y''</code>
:将图形沿点(''x'',''y'')旋转''a''度(顺时针)。
;<code>渐变 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
;<code>渐变描边 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
:设置图形（或描边）为渐变色，从 (''x1'', ''y1'') 处颜色 ''c1'' 平滑过渡到 (''x2'', ''y2'') 处颜色 ''c2''。 (''x1'', ''y1'')、(''x2'', ''y2'') 两个点可以连成一条线段，称为渐变轴，颜色的 RGB 值在渐变轴上分别均匀变化；图形上任何一个其他的点，都与渐变轴上离那个点最近的一个点的颜色相同。也就是说，让渐变轴沿着垂直于自身的方向平移，扫过的面积里颜色均匀变化，而没有扫过的地方颜色与相应端点的颜色相同，即 ''c1'' 和 ''c2''。
;<code>渐变 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
;<code>渐变描边 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
:除了渐变轴的两个端点外，可以在渐变轴上选定更多控制点并设置颜色，每两个相邻控制点之间颜色的 RGB 值都会均匀变化。每个中间控制点由一个颜色 ''c'' 和一个位置比值定义，比值可以是一个百分比 ''t''% 或分数 ''m''/''n''，表示控制点位置到渐变轴起点的距离与渐变轴长度的比值。若两个中间控制点的位置重合，会形成一个颜色突变，分界线垂直于渐变轴。
;<code>虚线 ''l'' ''d''</code>
:设置线段或描边为许多短线组成的虚线，短线长度为 ''l''，每两条短线之间空出 ''d'' 的距离。 ''d'' 与 ''l'' 相同时可省略 ''d''。
;<code>虚线 ''l1'' ''d1'' ''l2'' ''d2'' ''l3'' ...</code>
:高级虚线：从图形轮廓的起点开始先画长 ''l1'' 的短线，空出 ''d1'' 的距离，再画 ''l2'' 的短线，空出 ''d2''，以此类推，直到最后一组 ''ln''、''dn'' 后循环。若最后一组只有 ''ln'' 没有 ''dn''（即总共有奇数个数字），则最后一个短线长度 ''ln'' 跟循环回开头的第一个短线长度 ''l1'' 合并为一条长 ''ln'' + ''l1'' 的短线，之后再空出 ''d1'' 的距离，画 ''l2'' 的短线……这样继续下去。
;<code>平头</code>
:取消线段或虚线两端默认存在的小半圆，使本来圆头的线变为平头。
;<code>方头</code>
:将线段或虚线两端本来的小半圆改为小长方形，类似于<code>平头</code>但是视觉上使线的两端各延长了线宽度的一半。
;<code>字号 ''s''</code>
:设置文字的大小为 ''s''。
;<code>字体 ''名称''</code>
:设置文字使用的字体族名称。
;<code>字重 ''w''</code>
:设置字重（文字形状的粗细）为 ''w''。 字重是一个 1000 以内的正整数，未设置时默认为 400，即常规。''w'' 也可以是汉字“<code>粗</code>”，表示 700，即粗体。只有部分字体支持任意设置字重，多数只支持几个固定的值，如果字体不支持你设置的字重，会自动选择一个比较接近的可用值。
;<code>字宽 ''w''</code>
:设置字宽为 ''w''%。 字宽是一个 50% 到 200% 之间的百分数，未设置时为 100%。只有部分字体支持设置字宽。
;<code>斜体</code>
:使文字倾斜（使用意大利体的字母）。
;<code>斜体 ''a''</code>
:<code>斜体</code> 后面也可以跟一个角度 ''a''，表示让文字倾斜大约 ''a'' 度。正常的倾斜体是 14 度。很少有字体支持任意设置倾斜角度。
;<code>左对齐</code>
;<code>右对齐</code>
:让文字的左/右端对准设置的坐标。未设置时，默认是让文字的中心落在设置的坐标处。

== 示例 ==

待添加

== 一些想说的 ==
{{quote|
这条命令实际上是受一位有着视力障碍的群友激发而产生的。这位群友在我们不知道的地方打听到了某款电脑专用的盲用画图软件(经过LNN的逆向可知这是一个Python程序，根据原作者的描述实际上是给盲人写论文画示例图用的)，又打听到LNN有个LNNBot(大概因为他也是玩造语的)于是前来询问LNN能否将这个盲用画图软件移植到LNNBot上使用。我一时兴起建了一个SVGpath解析器，后来觉得太难用于是搓出来了wthsvg的最初模样:只有画布、线段，以及颜色、描边。我很不想很不想辜负这位发言极其真诚的群友，我一再声明：这不符合那款软件的语法！这里的漏洞还有很多！但这位群友仍然在鼓励我(他截止目前已画出来了许多我们认为不错的作品)，于是在大概一周内有了整整八个操作。LNN的加入实际上以我们替换中文颜色的词库匮乏而起，他在渐变的语法判定上、圆形的语法转化上以及关于字体的所有属性等等都做出了巨大的贡献！包括这篇文档也是他写的。我很感谢一直支持这个项目的人(尽管这项目才开展了两周不到，我编辑时离月考只有两三天了)，包括代码贡献者，指令使用者(尽管有预防)。能做成一个对他人有着帮助的wc指令我感到高兴至极！即便不为人知，这件事已成为我人生漆黑夜空中一颗不亮的闪星，在我极匮乏的内心世界中照耀。十分感谢各位。我们会在除这个指令外的世界中共同走下去，可能在将来不再有互联网上的联系，但这段旅程我会铭记于心。(好申必的升华啊)
|{{U|Cycwin}}}}

User:Cycwin/我的经历

2025-12-21T14:28:26Z

Cycwin：创建页面，内容为“要不来瞎写写我的成长经历？只是接触现代网络技术之类的。 ==第一台电脑== 二三年级，我得到了付琴的电脑，不知道是不是赶上了各类营销号盛行的时期，每日在电脑上测试所谓“恶搞代码”，印象更深的是一个20行Python马里奥，后来在评论区大海捞针竟未寻得一个细看代码发现这只是import的花招的人，我记得那代码我是一个一个字敲电脑上去的…”

要不来瞎写写我的成长经历？
只是接触现代网络技术之类的。

==第一台电脑==
二三年级，我得到了付琴的电脑，不知道是不是赶上了各类营销号盛行的时期，每日在电脑上测试所谓“恶搞代码”，印象更深的是一个20行Python马里奥，后来在评论区大海捞针竟未寻得一个细看代码发现这只是import的花招的人，我记得那代码我是一个一个字敲电脑上去的。但我敲完之前，

电脑被我整坏了。我点击了自带PE系统的引导修复，然后引导TMD炸了。

几个月后，付琴拿着电脑去电脑店，装回来了8.1，系统盘啥也没了，我对电脑依旧不知所以，但是...
==PE时代==
我也忘了我如何接触到了Windows PE。我将付琴的2G优盘格式化(得到同意啦)，激活了UltraISO，然后烧进去了第一个PE镜像。

TMD引导也坏了！

从此我在网上搜集各种winPE，无一例外烧U盘里面都是引导错误，我寻找最小化的PE，同时，我跟着一个教程制作了人生中第一个有桌面的PE:桌面从newbeePE偷的，工具从tangoPE借的，PECMD从软件园下载的。但是我成啦！(实际上之前我直接把东西塞boot.wim里面造过一堆废物PE，install.wim都没删)

一天下午我拿360U盘扩容检测测试U盘，这破U盘原来才108M。我被气着了整整一下午。

还是几个月后，我寻得了令我震惊的PE:不到100M还能联网还带dism++的win10PE，我烧进了U盘还把一个不到10M的浏览器扔进去，啊！成了！

自此，我进入短短的空档期。

==编程时代==
我脑子终于好使了，六年级，我开始学Python。我在社团跟同学们炫耀0.1+0.2!=0.3，炫耀自己沟槽的turtle技术，然后太闲了又学了HTML+CSS+JS(JS还是我在外面玩的路上学的)，做了一堆CSS动画，那时的新目标就是纯CSS游戏。我搓出来过但是差强人意。

这部分我想一笔带过。因为重头戏即将到来。

==QQ时代==
六年级毕业那个暑假后期，一个名为“这只是只瓜诶”的UP找上了我，经过几十条消息的迂回后，我安装了QQ，加入了一个重磅大群:esolang交流群。我TM认识了预防，UrnEn这个天才，还有亲爱的DGCK81LNN。

开始只是聊天，我依旧记得那晚我在路灯下询问TC与TM的含义，等着他们的回复，esolang在我心中种下了种子。

==ESO时代==
我的第一个esolang:sdac2在入学考场上被构思了出来，我又接连制作了好几个esolang，我为他们感到自豪，为别的esolang证明图灵完备性感到苦恼，为自己的esolang寻找TC介质而迷茫，在我偷偷向外界交流的一块电子书被没收后，我似乎不再对esolang兴趣浓厚了。

==WL时代==
看到群友们都在搞的whatlang，我跃跃欲试，在sinπ们的指导下我终于学会了whatlang，我频繁地编写Whatcommand，四处搜寻API，那是我对WL最狂热的时期。

................（未完待续

User:Cycwin

2025-12-21T14:01:04Z

Cycwin：

Vnu8 们好！我是Cycwin。LNN想叫我写点什么到用户页上我就干脆瞎写了，我也不知道该写什么。

本人是一位二初生，河南人但说的不是河南话，和所属城市的方言也有差异。本人爱好于在QQ与一群人自娱自乐，起初本人是把编程这项作为爱好日日挂在嘴边的，现在已经提不起大兴趣了，本人在生活的流水中冲掉了乐趣，冲掉了爱好，冲掉了态度，冲掉了梦想，依旧乐哉。

本人在班里是一位疯子，在课上被公开宣布是“从精神病院里跑出来的”，被班里倒数嬉皮笑脸的询问了一遍，本人严辞拒绝了。现任左同桌自号沐风大帝，对近代历史的兴趣远超班中其他同学，政治素养不用想也是极好的。右同桌是班长，我现在没啥好介绍的。

本人为假期作业所折磨，编辑时还有错题本未整理，语数英外的作业一笔未动。

本人读现代文时，常想到一段话，若读者认为断章取义还请指出，“在遭受后现代文化的洗礼之后，我们的作家更是如获至宝，把缺失视为强项，奉行‘躲避崇高’的策略，鄙视宏大叙事，消解终极追问。”

LNNBot/WhatCommands指令/wthsvg

2025-12-21T08:14:16Z

Cycwin：

WhatCommands 指令 '''<code>wthsvg</code>''' 可根据输入的一系列中文指令绘制图像。主要作者为 {{U|Cycwin}}，{{LNN}} 补充完善部分功能。

== 用法 ==

¿¿wthsvg 指令...

wthsvg 的参数中每行为一条指令，指令分为操作和属性，操作以横杠（<code>-</code>）开头，属性跟在其所属的操作之后。

=== 操作 ===

;<code>-画布 ''w'' ''h''</code>
:指定画布宽为''w''，高为''h''，一般写在最开头作为第一个操作。
;<code>-左下角坐标</code>
:特殊操作：此操作执行后，后续的所有操作中坐标原点在左下角，纵轴向上。未使用此操作时原点在左上角，纵轴向下。
;<code>-线段 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制从 (''x1'', ''y1'') 到 (''x2'', ''y2'') 的线段。 线段目前没有默认颜色，必须通过<code>颜色</code>属性手动设置颜色才可绘制。
;<code>-圆形 ''r'' ''x'',''y''</code>
:绘制一个圆心在 (''x'', ''y'')，半径为 ''r'' 的圆形。
;<code>-矩形 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制一个对角为 (''x1'', ''y1'') 与 (''x2'', ''y2'')，平行于坐标轴的矩形。
;<code>-多边形 ''x1'',''y1'' ''x2'',''y2'' ''x3'',''y3''...</code>
:以给定的一系列坐标为顶点绘制多边形。
;<code>-文字 ''x'',''y'' ''内容''</code>
:在 (''x'', ''y'') 处绘制文本。

图形操作（不包括 <code>-文字</code>）可以一次输入多组参数，用英文分号（<code>;</code>）分隔，此时将同时绘制多个同类图形并共用属性。建议在分号之后或前后均添加空格以便阅读。例如，绘制四个半径 50 单位，紧挨在一起的圆：<code>-圆形 50 100,100; 50 100,200; 50 200,100; 50 200,200</code>

=== 属性 ===

设置颜色时，可以使用方括号括起并以空格分隔的 RGB 颜色值（<code>[''r'' ''g'' ''b'']</code>），CSS 颜色语法（包括 <code>rgb(''R'',''G'',''B'')</code>、井号开头的十六进制颜色值、英文关键字颜色名）和[http://lnnbot.哼.site/whatcolorreplacer/ 我们预先定义的中文颜色名]表示。

;<code>背景 ''c''</code>
:只对 <code>-画布</code> 指令有效：设置画布背景颜色为 ''c''。可以是“<code>透明</code>”。未设置时默认为白色。
;<code>颜色 ''c''</code>
:设置图形的颜色为 ''c''。 对于除线段之外的图形，未设置时默认为黑色；可将<code>颜色</code>设置为“<code>透明</code>”后再设置<code>描边</code>属性来绘制空心的图形。
;<code>描边 ''c''</code>
:为图形添加颜色为 ''c'' 的描边。 对于线段，与<code>颜色</code>属性等价。
;<code>粗细 ''d''</code>
:设置线段或描边的宽度为 ''d''。
;<code>渐变 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
;<code>渐变描边 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
:设置图形（或描边）为渐变色，从 (''x1'', ''y1'') 处颜色 ''c1'' 平滑过渡到 (''x2'', ''y2'') 处颜色 ''c2''。 (''x1'', ''y1'')、(''x2'', ''y2'') 两个点可以连成一条线段，称为渐变轴，颜色的 RGB 值在渐变轴上分别均匀变化；图形上任何一个其他的点，都与渐变轴上离那个点最近的一个点的颜色相同。也就是说，让渐变轴沿着垂直于自身的方向平移，扫过的面积里颜色均匀变化，而没有扫过的地方颜色与相应端点的颜色相同，即 ''c1'' 和 ''c2''。
;<code>渐变 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
;<code>渐变描边 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
:除了渐变轴的两个端点外，可以在渐变轴上选定更多控制点并设置颜色，每两个相邻控制点之间颜色的 RGB 值都会均匀变化。每个中间控制点由一个颜色 ''c'' 和一个位置比值定义，比值可以是一个百分比 ''t''% 或分数 ''m''/''n''，表示控制点位置到渐变轴起点的距离与渐变轴长度的比值。若两个中间控制点的位置重合，会形成一个颜色突变，分界线垂直于渐变轴。
;<code>虚线 ''l'' ''d''</code>
:设置线段或描边为许多短线组成的虚线，短线长度为 ''l''，每两条短线之间空出 ''d'' 的距离。 ''d'' 与 ''l'' 相同时可省略 ''d''。
;<code>虚线 ''l1'' ''d1'' ''l2'' ''d2'' ''l3'' ...</code>
:高级虚线：从图形轮廓的起点开始先画长 ''l1'' 的短线，空出 ''d1'' 的距离，再画 ''l2'' 的短线，空出 ''d2''，以此类推，直到最后一组 ''ln''、''dn'' 后循环。若最后一组只有 ''ln'' 没有 ''dn''（即总共有奇数个数字），则最后一个短线长度 ''ln'' 跟循环回开头的第一个短线长度 ''l1'' 合并为一条长 ''ln'' + ''l1'' 的短线，之后再空出 ''d1'' 的距离，画 ''l2'' 的短线……这样继续下去。
;<code>平头</code>
:取消线段或虚线两端默认存在的小半圆，使本来圆头的线变为平头。
;<code>方头</code>
:将线段或虚线两端本来的小半圆改为小长方形，类似于<code>平头</code>但是视觉上使线的两端各延长了线宽度的一半。
;<code>字号 ''s''</code>
:设置文字的大小为 ''s''。
;<code>字体 ''名称''</code>
:设置文字使用的字体族名称。
;<code>字重 ''w''</code>
:设置字重（文字形状的粗细）为 ''w''。 字重是一个 1000 以内的正整数，未设置时默认为 400，即常规。''w'' 也可以是汉字“<code>粗</code>”，表示 700，即粗体。只有部分字体支持任意设置字重，多数只支持几个固定的值，如果字体不支持你设置的字重，会自动选择一个比较接近的可用值。
;<code>字宽 ''w''</code>
:设置字宽为 ''w''%。 字宽是一个 50% 到 200% 之间的百分数，未设置时为 100%。只有部分字体支持设置字宽。
;<code>斜体</code>
:使文字倾斜（使用意大利体的字母）。
;<code>斜体 ''a''</code>
:<code>斜体</code> 后面也可以跟一个角度 ''a''，表示让文字倾斜大约 ''a'' 度。正常的倾斜体是 14 度。很少有字体支持任意设置倾斜角度。
;<code>左对齐</code>
;<code>右对齐</code>
:让文字的左/右端对准设置的坐标。未设置时，默认是让文字的中心落在设置的坐标处。

== 示例 ==

待添加

== 一些想说的 ==
{{quote|
这条命令实际上是受一位有着视力障碍的群友激发而产生的。这位群友在我们不知道的地方打听到了某款电脑专用的盲用画图软件(经过LNN的逆向可知这是一个Python程序，根据原作者的描述实际上是给盲人写论文画示例图用的)，又打听到LNN有个LNNBot(大概因为他也是玩造语的)于是前来询问LNN能否将这个盲用画图软件移植到LNNBot上使用。我一时兴起建了一个SVGpath解析器，后来觉得太难用于是搓出来了wthsvg的最初模样:只有画布、线段，以及颜色、描边。我很不想很不想辜负这位发言极其真诚的群友，我一再声明：这不符合那款软件的语法！这里的漏洞还有很多！但这位群友仍然在鼓励我(他截止目前已画出来了许多我们认为不错的作品)，于是在大概一周内有了整整八个操作。LNN的加入实际上以我们替换中文颜色的词库匮乏而起，他在渐变的语法判定上、圆形的语法转化上以及关于字体的所有属性等等都做出了巨大的贡献！包括这篇文档也是他写的。我很感谢一直支持这个项目的人(尽管这项目才开展了两周不到，我编辑时离月考只有两三天了)，包括代码贡献者，指令使用者(尽管有预防)。能做成一个对他人有着帮助的wc指令我感到高兴至极！即便不为人知，这件事已成为我人生漆黑夜空中一颗不亮的闪星，在我极匮乏的内心世界中照耀。十分感谢各位。我们会在除这个指令外的世界中共同走下去，可能在将来不再有互联网上的联系，但这段旅程我会铭记于心。(好申必的升华啊)
|{{U|Cycwin}}}}

User:Cycwin

2025-12-20T08:11:34Z

Cycwin：

User:Cycwin

2025-12-20T07:35:42Z

Cycwin：

User talk:Cycwin

2025-12-17T14:23:38Z

Cycwin：/* 欢迎 */ 回复

{{欢迎}}

==欢迎==
感谢您造访希顶维基。因为没有欢迎模板就手动欢迎吧，我是 [[User:ColorfulGalaxy|ColorfulGalaxy]]（[[User talk:ColorfulGalaxy|留言]]） [[User:ColorfulGalaxy|ColorfulGalaxy]]（[[User talk:ColorfulGalaxy|留言]]） 2025年12月17日 (三) 13:03 (CST) 
Thanks for your visiting and there is a manual welcoming in case of that there is no welcoming template. I'm [[User:ColorfulGalaxy|ColorfulGalaxy]]（[[User talk:ColorfulGalaxy|留言]]） 2025年12月17日 (三) 13:03 (CST)

:感谢您的祝福！ [[User:Cycwin|Cycwin]]（[[User talk:Cycwin|留言]]） 2025年12月17日 (三) 22:23 (CST)

User:Cycwin

2025-12-16T13:25:03Z

Cycwin：创建页面，内容为“我能创建了！”

我能创建了！

LNNBot/WhatCommands指令/lrcsrc

2025-12-13T14:12:06Z

Cycwin：/* 用法 */

WhatCommands 指令 '''<code>lrcsrc</code>''' 可从网易云音乐获取歌曲的歌词。

== 用法 ==
待完善
<div style="opacity:0;">写个屁！我是山里灵活的狗！</div>
$$$分割参数。
#第一参数:歌名。
#第二参数(可选):第几个搜索结果。
#第三参数(可选):不为空就输出罗马音。

LNNBot/WhatCommands指令/wthsvg

2025-12-13T14:00:00Z

Cycwin：

WhatCommands 指令 '''<code>wthsvg</code>''' 可根据输入的一系列中文指令绘制图像。主要作者为 {{U|Cycwin}}，{{LNN}} 补充完善部分功能。

== 用法 ==

¿¿wthsvg 指令...

wthsvg 的参数中每行为一条指令，指令分为操作和属性，操作以横杠（<code>-</code>）开头，属性跟在其所属的操作之后。

=== 操作 ===

;<code>-画布 ''w'' ''h''</code>
:指定画布宽为''w''，高为''h''，一般写在最开头作为第一个操作。
;<code>-左下角坐标</code>
:特殊操作：此操作执行后，后续的所有操作中坐标原点在左下角，纵轴向上。未使用此操作时原点在左上角，纵轴向下。
;<code>-线段 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制从 (''x1'', ''y1'') 到 (''x2'', ''y2'') 的线段。 线段目前没有默认颜色，必须通过<code>颜色</code>属性手动设置颜色才可绘制。
;<code>-圆形 ''r'' ''x'',''y''</code>
:绘制一个圆心在 (''x'', ''y'')，半径为 ''r'' 的圆形。
;<code>-矩形 ''x1'',''y1'' ''x2'',''y2''</code>
:绘制一个对角为 (''x1'', ''y1'') 与 (''x2'', ''y2'')，平行于坐标轴的矩形。
;<code>-多边形 ''x1'',''y1'' ''x2'',''y2'' ''x3'',''y3''...</code>
:以给定的一系列坐标为顶点绘制多边形。
;<code>-文字 ''x'',''y'' ''内容''</code>
:在 (''x'', ''y'') 处绘制文本。

图形操作（不包括 <code>-文字</code>）可以一次输入多组参数，用英文分号（<code>;</code>）分隔，此时将同时绘制多个同类图形并共用属性。建议在分号之后或前后均添加空格以便阅读。例如，绘制四个半径 50 单位，紧挨在一起的圆：<code>-圆形 50 100,100; 50 100,200; 50 200,100; 50 200,200</code>

=== 属性 ===

设置颜色时，可以使用方括号括起并以空格分隔的 RGB 颜色值（<code>[''r'' ''g'' ''b'']</code>），CSS 颜色语法（包括 <code>rgb(''R'',''G'',''B'')</code>、井号开头的十六进制颜色值、英文关键字颜色名）和[http://lnnbot.哼.site/whatcolorreplacer/ 我们预先定义的中文颜色名]表示。

;<code>背景 ''c''</code>
:只对 <code>-画布</code> 指令有效：设置画布背景颜色为 ''c''。可以是“<code>透明</code>”。未设置时默认为白色。
;<code>颜色 ''c''</code>
:设置图形的颜色为 ''c''。 对于除线段之外的图形，未设置时默认为黑色；可将<code>颜色</code>设置为“<code>透明</code>”后再设置<code>描边</code>属性来绘制空心的图形。
;<code>描边 ''c''</code>
:为图形添加颜色为 ''c'' 的描边。 对于线段，与<code>颜色</code>属性等价。
;<code>粗细 ''d''</code>
:设置线段或描边的宽度为 ''d''。
;<code>渐变 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
;<code>渐变描边 ''c1'' ''x1'',''y1'' ''c2'' ''x2'',''y2''</code>
:设置图形（或描边）为渐变色，从 (''x1'', ''y1'') 处颜色 ''c1'' 平滑过渡到 (''x2'', ''y2'') 处颜色 ''c2''。 (''x1'', ''y1'')、(''x2'', ''y2'') 两个点可以连成一条线段，称为渐变轴，颜色的 RGB 值在渐变轴上分别均匀变化；图形上任何一个其他的点，都与渐变轴上离那个点最近的一个点的颜色相同。也就是说，让渐变轴沿着垂直于自身的方向平移，扫过的面积里颜色均匀变化，而没有扫过的地方颜色与相应端点的颜色相同，即 ''c1'' 和 ''c2''。
;<code>渐变 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
;<code>渐变描边 ''c0'' ''x1'',''y1'' ''c1'' ''t1'' ''c2'' ''t2'' ... ''cn'' ''x2'',''y2''</code>
:除了渐变轴的两个端点外，可以在渐变轴上选定更多控制点并设置颜色，每两个相邻控制点之间颜色的 RGB 值都会均匀变化。每个中间控制点由一个颜色 ''c'' 和一个位置比值定义，比值可以是一个百分比 ''t''% 或分数 ''m''/''n''，表示控制点位置到渐变轴起点的距离与渐变轴长度的比值。若两个中间控制点的位置重合，会形成一个颜色突变，分界线垂直于渐变轴。
;<code>虚线 ''l'' ''d''</code>
:设置线段或描边为许多短线组成的虚线，短线长度为 ''l''，每两条短线之间空出 ''d'' 的距离。 ''d'' 与 ''l'' 相同时可省略 ''d''。
;<code>虚线 ''l1'' ''d1'' ''l2'' ''d2'' ''l3'' ...</code>
:高级虚线：从图形轮廓的起点开始先画长 ''l1'' 的短线，空出 ''d1'' 的距离，再画 ''l2'' 的短线，空出 ''d2''，以此类推，直到最后一组 ''ln''、''dn'' 后循环。若最后一组只有 ''ln'' 没有 ''dn''（即总共有奇数个数字），则最后一个短线长度 ''ln'' 跟循环回开头的第一个短线长度 ''l1'' 合并为一条长 ''ln'' + ''l1'' 的短线，之后再空出 ''d1'' 的距离，画 ''l2'' 的短线……这样继续下去。
;<code>平头</code>
:取消线段或虚线两端默认存在的小半圆，使本来圆头的线变为平头。
;<code>方头</code>
:将线段或虚线两端本来的小半圆改为小长方形，类似于<code>平头</code>但是视觉上使线的两端各延长了线宽度的一半。
;<code>字号 ''s''</code>
:设置文字的大小为 ''s''。
;<code>字体 ''名称''</code>
:设置文字使用的字体族名称。
;<code>字重 ''w''</code>
:设置字重（文字形状的粗细）为 ''w''。 字重是一个 1000 以内的正整数，未设置时默认为 400，即常规。''w'' 也可以是汉字“<code>粗</code>”，表示 700，即粗体。只有部分字体支持任意设置字重，多数只支持几个固定的值，如果字体不支持你设置的字重，会自动选择一个比较接近的可用值。
;<code>字宽 ''w''</code>
:设置字宽为 ''w''%。 字宽是一个 50% 到 200% 之间的百分数，未设置时为 100%。只有部分字体支持设置字宽。
;<code>斜体</code>
:使文字倾斜（使用意大利体的字母）。
;<code>斜体 ''a''</code>
:<code>斜体</code> 后面也可以跟一个角度 ''a''，表示让文字倾斜大约 ''a'' 度。正常的倾斜体是 14 度。很少有字体支持任意设置倾斜角度。
;<code>左对齐</code>
;<code>右对齐</code>
:让文字的左/右端对准设置的坐标。未设置时，默认是让文字的中心落在设置的坐标处。

== 示例 ==

待添加

== 一些想说的 ==
LNN会让这条内容过审吗？

这条命令实际上是受一位有着视力障碍的群友激发而产生的。这位群友在我们不知道的地方打听到了某款电脑专用的盲用画图软件(经过LNN的逆向可知这是一个Python程序，根据原作者的描述实际上是给盲人写论文画示例图用的)，又打听到LNN有个LNNBot(大概因为他也是玩造语的)于是前来询问LNN能否将这个盲用画图软件移植到LNNBot上使用。我一时兴起建了一个SVGpath解析器，后来觉得太难用于是搓出来了wthsvg的最初模样:只有画布、线段，以及颜色、描边。我很不想很不想辜负这位发言极其真诚的群友，我一再声明：这不符合那款软件的语法！这里的漏洞还有很多！但这位群友仍然在鼓励我(他截止目前已画出来了许多我们认为不错的作品)，于是在大概一周内有了整整八个操作。LNN的加入实际上以我们替换中文颜色的词库匮乏而起，他在渐变的语法判定上、圆形的语法转化上以及关于字体的所有属性等等都做出了巨大的贡献！包括这篇文档也是他写的。我很感谢一直支持这个项目的人(尽管这项目才开展了两周不到，我编辑时离月考只有两三天了)，包括代码贡献者，指令使用者(尽管有预防)。能做成一个对他人有着帮助的wc指令我感到高兴至极！即便不为人知，这件事已成为我人生漆黑夜空中一颗不亮的闪星，在我极匮乏的内心世界中照耀。十分感谢各位。我们会在除这个指令外的世界中共同走下去，可能在将来不再有互联网上的联系，但这段旅程我会铭记于心。(好申必的升华啊)(编辑者:[[User:Cycwin]])

LNNBot/WhatCommands指令/song

2025-12-13T13:25:45Z

Cycwin：/* 用法 */

{{消歧义|搜索并解析网易云音乐，输出为语音消息的WhatCommands指令|检索荆哲歌单的指令|LNNBot/指令/song}}
WhatCommands 指令 '''<code>song</code>''' 可将网易云音乐上的歌曲发送为语音消息。

== 用法 ==
以$$$分隔参数，
第一参数:要搜索的名称，这里你完全可以相信网易云的搜索。
第二参数(可选):选择第几个搜索结果。最多十个。