小窝助手

旧版乐谱文件：乐器配置
新版乐谱文件：5.0乐谱测试
乐器小窝主体：乐器小窝

小窝助手主体：小窝助手安装包

修复小窝工具：1030修复工具

『Tips 1』 下载小窝助手 主体后，双击安装。
『Tips 2』 小窝助手的安装路径为：C:\LoCCai\cchelper文件夹。
『Tips 3』 小窝助手-乐器小窝检测引用的测试乐谱文件，需要放置在C:\LoCCai\cchelper\music\test_sound_text文件夹内（即自写乐谱TXT文件）。

所有的辅助软件均依赖管理员权限、杀毒软件白名单、C盘目录（即你运行的PC必须有C这个盘符）。

Step 1 找到你下载好的乐器&游戏小窝。
Step 2 右击，找到并左键单击属性选项卡以打开属性页面。
Step 3 在上方的多选项卡中找到兼容性，一般是第二个，单击它。
Step 4 在属性-兼容性页面下方找到设置子选项，在按钮-“更改高DPI设置”的上方有一个多选项以管理员身份运行此程序，勾选并点击确定，即可。

大多数杀毒软件基本都是同样的步骤，此处以WindowsDefender和火绒为例子，参考此过程进行设置。

Step 1 打开Windows设置界面。

Step 2 打开Windows设置中的隐私和安全性。

Step 3 打开隐私和安全性Windows安全中心选项卡。

Step 4 打开Windows安全中心。

Step 5 选择病毒和威胁防护选项。

Step 6 如果你的电脑有其他杀毒软件，此处的定期扫描一般会是关闭状态，打开即可设置。

Step 7 打开病毒和威胁防护设置。

Step 8 选择添加或删除排除项。

Step 9 点击最上方的添加排除项，选择文件夹（C:\LoCCai）目录。

Step 1 打开火绒界面。

Step 2 打开火绒右上角的菜单选项界面。

Step 3 打开菜单中的信任区选项卡。

Step 4 选择添加文件夹（C:\LoCCai）目录。

因为QMacro-2014版本的bug，使用脚本时，如果上次的进程未释放完毕，有可能出现1030错误的弹窗。

出现错误时，我们可以使用该工具进行修复。

Step 1 设置好1030修复工具的管理员权限等设置。
Step 2 打开1030修复工具。
Step 3 点击左下角的开始使用。
Step 4 点击界面中的修复按钮。

Tips：平时关闭辅助后，如果任务管理器的后台进程中有脚本执行器进程，可以点击进行终止，手动释放进程内存。

此部分仅针对需要使用脚本的一梦PC日常功能的用户，只使用乐器演奏的小可爱可以跳过。

找色模式：RGB
设置方法：win10-设置-系统-显示-高级显示设置-显示器1的显示适配器属性-列出所有模式-选择确定

缩放模式：100%
设置方法：win10-设置-系统-显示-缩放与布局-100% | 并 重启/注销电脑，再使用脚本

界面操作：端游模式

界面模式：晨曦模式


画质设置：关闭抗锯齿

运行界面：展开左侧图标列表

Tips：如果对速度&模式调节不理解，请看下例。

引：在使用篇-乐理知识可知，BPM为《一分钟里歌曲拍子的总数》
因此，由BPM我们可以计算出——某乐谱每一拍的时间。如下：
假设脚本需要演奏123三个半拍音符和一个1一拍音符。BPM设为60。
每一拍的时间为：60*1000/60（前一个60是60秒，后一个60是bpm）=1000ms=1s
那么，脚本应该是
按下1 弹起1 等待0.5s 按下2 弹起2 等待0.5s 按下3 弹起3 等待0.5s 按下1 弹起1 等待1s
倍速，调节的就是等待的时间 0.5s，1s，影响了脚本的运行速度。
演奏模式，改变的是脚本的演奏时间。比如，如果演奏模式设置为10-10-0，脚本演奏会变为如下：
按下1 等待0.5s 弹起1 按下2 等待0.5s 弹起2 按下3 等待0.5s 弹起3 按下1 等待1s 弹起1
没有改变脚本的运行速度，改变了按下弹起的时间间隔。
此功能适用于对长音模式下演奏的长音长度调节。
右侧一梦天刀按钮：改变演奏的游戏，当前天刀不可用，用一梦的前台模式监听键盘运行。
点击完后，左侧的窗口标签下边的下拉框会提示选择对应的窗口句柄。
提示：如果多开了很多窗口，请先点击一下你想要运行脚本的窗口，然后再点击一梦按钮，获得的第一个窗口句柄就是你刚刚点击的窗口。

不选择窗口勾选前台弹奏，脚本会在前台运行。
和弦功能暂时不可用，不要勾选。
空格长音：勾选后脚本会变为长音脚本。适用单轨用二胡琵琶类演奏。
后台播放：勾选后脚本在一梦游戏演奏，前台可听。
八度升降：按钮在界面右侧，小滑块。在上为正常模式，在下为升八度模式。

适用情况：高音少（无高音脚本），或者使用天刀监听，键位设置为1-7,Q-U,A-J的情况。
合奏多选框：先点击一梦，勾选合奏后，一梦自动弹起。窗口2选项显示。

选择合奏里面的歌曲，然后在窗口处选择演奏多轨乐谱的游戏窗口，在窗口2处选择演奏单轨的合奏游戏窗口（勾选合奏长音多选框，第二个合奏游戏窗口会变为长音。）
消音设置：先在上方下拉框选择消音的触发条件，再在下方滑块选择去掉几个音。

提示：目前来看，莲花阮和琵琶的吞音情况是要好于古琴的，推荐使用琵琶和莲花阮演奏。我的一些脚本也是针对莲花阮和琵琶做了特别的适配。
比如认错，改谱时我就考虑了莲花阮和琵琶只能发六个高音的问题，多降了两个调。
点一下就长音了哦：点一下你想长音的窗口，然后点击该按钮。此功能适用于一梦。

步骤1：选择歌曲
步骤2：出现歌曲信息后，点击一梦（前台选择一梦天刀都可）
（2021.1.14日更新去掉了该步骤。直接勾选前台演奏就可直接使用）
步骤3：勾选上左侧的前台播放
步骤4：如果是第一次打开这个演奏界面（注意是界面），波动一下两边的倍速条，即使这个倍速条的位置就是你需要的位置，移动一下再移回来。
步骤5：点击开始，然后点一下你要运行的页面。
特别说明：在天刀游戏运行，记得提前开启按键映射，映射成功后，再启动该脚本。
有关天刀映射的，参见群文件-演奏脚本-天刀按键映射，共两个版本。
（2021.1月左右天刀更新添加了演奏的按键映射。运行脚本时把八度滑块升到1-Q-A的高中低音模式即可，无需开启映射。）

步骤1：选择歌曲
步骤2：出现歌曲信息后，点击一梦/天刀（天刀记得切换演奏模式且打开升八度滑块）
（2021.1月左右天刀更新添加了演奏的按键映射。因此天刀的后台模式也可以使用了。注意使用时，运行脚本后请不要频繁点击游戏界面后点击外面的界面。天刀的鼠标检测屏蔽比较麻烦，如果勾选了后台不小心点到游戏界面，并且又点出来了，会概率卡死。若游戏不再是未响应了，重新开启即可。）
步骤3：如果想在前台听到后台演奏的声音，勾选后台播放。（2021.1.14日更新去掉了该设置。默认演奏声音无法去掉）
步骤4：如果是第一次打开这个演奏界面（注意是界面），波动一下两边的倍速条，即使这个倍速条的位置就是你需要的位置，移动一下再移回来。
步骤5：如果是在演奏单轨脚本，想以长音模式演奏，勾选上空格长音。
步骤6：演奏吞音的脚本，想要去音符的，在消音设置处设置好。（如何设置？请看功能讲解篇）
步骤7：点击开始。

BMP:一分钟里歌曲拍子的总数。用于描述歌曲的速度。
称：Tempo，拍速。
节拍：衡量节奏的单位。有一定强弱分别的一系列拍子在每隔一定时间重复出现。如 2 / 4 、 4 / 4 、 3 / 4 拍等。乐曲中表示固定单位时值和强弱规律的组织形式。每小节中强拍和弱拍的循环称二拍子；强拍、弱拍 、弱拍的循环称三拍子。表示每小节中基本单位拍的时值和数量的记号，称拍号。拍号的上方数字表示每小节的拍数，下方数字表示每拍的时值。
例子：2/4表示以4分音符为1拍 ，每小节有 2 拍。拍号中时值的实际时间，应视乐曲所标速度而定。
在不同节拍类型中，每小节只有一个强拍的叫做单拍子，如2/4、2/8是单2拍子，3/4、3/8是单3拍子。每小节有一个强拍并有次强拍的叫做复拍子。如 4/4、6/8是复 2 拍子，9/8、9/16是复3拍子。
调：X调谱子就是以X为"do"
C调是C全D全E半F全G全A全B半C，依次类推。

音符：1-7-1 do 2 re 3 mi 4 fa 5 so 6 la 7 xi 上面有一个点的，升一个八度（变高音），下面有一个点的，降一个八度（变低音）两个，三个依次类推。
节拍：下面没有线的，一拍。一条线的，半拍。两条线的，1/4拍。三条线的。1/8拍。依次类推。
音符后加点的：扩张这个音符的节拍。扩张值为音符的一半。
比如，上图中，第四小节，第一个音符高音5，本来为一拍，后面加点后，变为一拍+原来音符一拍的一半=1.5拍。
Tips：
1. 音符为0时，直接忽略
2. 反复注意符号问题
3. 时刻注意变调，八度问题
4. 待补充

第一行：//+乐谱的BPM
eg：//86
tips：BPM就是乐谱的左上角有个小音符=一个数字的那个数字

第二行：//+乐谱的调号
eg：//C
eg2：//D#
tips：同上，在乐谱左上角，很显眼

第三行：//+小节标志
eg：//4/4
eg2：//2/4
tips：同上，在乐谱左上角，很显眼

第四行：//+作者标志
eg：//LoCCai
tips：想写什么写什么

第五行：//+版本信息
eg：//V3.0
tips：此处不可忽略，只可以写"V3.0"或者“V4.0”，没有版本信息的谱子是无法识别的

之后就是乐谱的书写方式了，
格式：键盘按键1键盘按键2键盘按键3.......+空格+节拍

需要注意以下几个方面
1.在V3.0版本中，回车换行可以随便打，但是换行的对应行应该无内容。
2.//+文本，文本后面的内容会被忽略，这个是我将来留给歌词显示的，你们想加的可以加上。
3.>>+等式（不知道谱子需不需要滑音的，忽略写此类东西。转BPM的，需要写）
eg：>>BPM=86
则在此处的BPM为86（需要注意，到下一个小节需要你自己添加切换回来的等式）
eg：>>long_vowel=1/0（长音修改。1为长音勾选开启。0为关闭。适用于脚本部分位置需要滑音）

写一小段例子：
//120
//C
//4/4
//作者名字

az 1
az 1
gz 1
gz 1

hz 1
hz 1
gz 1
z 1

//任意位置（不包括前三行）加文字也可以加
fz 1
fz 1
dz 1
dz 1

sz 1
sz 1
sz 1
z 1

//4
//这里想加文字也可以加

V4.0版本的谱子

基本和上面的写法类似，具体格式如下：（红色的为注释）
//120//BPM
//C//调号
//3/4//小节分节
//LoCCai//作者
//V4.0//版本信息
1/q 1/e 1/ 1/q 1/e 1/ 1/q 1/e 1/q 2/q 0.5/w 0.5/e 0.5/q 0.5/t 1.5/e 0.5/w 1/t 1/w 1/q 0.5/h 0.5/e 1.5/q 0.5/j 2/j
1//1-8小节的主旋律
z 1/b 1/a 1/z 1/b 1/a 1/z 1/b 1/a 1/ 3/z 1/b 1/a 1/b 1/x 1/b 1/n 1/c 1/n 1/c 1/m 1/c 1//1-8小节的和弦
//1-8//注释
依次类推。
前五行是对应谱子信息，第六行，第九行，第十二行......是主旋律，第七行，第十行，第十三行..........是和弦，第八行，第十一行，第十四行.........是注释

测试步骤：
1. 在小窝根目录=C:\LoCCai文件夹下，新建TXT文档，名字为歌曲名字（注意不要带有编码无法携带的字符｛EG:部分特殊日语文字，音符，韩语文字，音符等｝）
2. 打开该txt文件，选择，文件，另存为。
3. 选择另存到C:\LoCCai文件夹，编码选择ANSI（不选择会造成部分字符识别错误）
4. 保存完毕后，重新打开写谱即可
5. 谱子写一部分，或者写完，皆可开始测试。
6. 打开最新版本的小窝
7. 选择，测试模式右边的开关，打开，在下面的文本框即可选中在根目录下的谱子文件，进行测试。
8. 在写谱时，注意随时分节，写好//下的注释。这样，在脚本卡在某个位置不往下运行时，可以判断谱子的哪个位置出错了。

1. 勾选自己需要的项目（记得提前在游戏界面把输入模式改为英文，不然无法输入技能等操作）
2. 选择是否要在脚本运行后运行一次自动使用(原来这个自动使用是全程检测的，但是它和主线程有所冲突，还没解决，暂时只能运行在脚本后）
3. 点击开始脚本就运行了
4. 上面的白色文本框：显示当前正在运行项目
5. 下面的白色文本框：显示当前正在进行的步骤
6. 卡到有关步骤可以截图下边的文本框到群里反馈

喊话 为世界，帮派，队伍，私聊等发送一些文本消息时使用。自定义文本内容，发送延迟时间。
下拉框为对应颜色代码自行选择，自动加入至文本框。
下方线程为侠缘私聊发送表情，单开双开皆可。

设置好换线时间，采集时间，换线数，即可开始。
自己设置相关配置选项。

步骤1：勾选自己需要使用的（推荐自动使用和自动关闭打开）
步骤2：输入你想添加的配置项名字
步骤3：点击添加配置
这样就添加好了一个配置项。需要使用的时候，单击它，就会加载我们勾选的项目
双击某个不需要的配置项以删除它
点击清空配置按钮以清空全部配置项