声笔系列码，又称声笔输入法，是基于著名的开源输入法平台 Rime 进行二次开发的，其安装配置比较复杂。这一方面有 Rime 的原因，因为它没有提供丰富的图形界面，对普通用户不太友好。
在配置方面，声笔系列码主要是基于 YAML 文件来进行的，对于只习惯于图形界面的用户来可能是一个挑战。不过，一旦学会用文本来做配置，就会感觉到这种方式的强大和灵活。闯过这一关，就会如鱼得水，就能随心所欲！本文就是帮助用户克服困难，过关斩将的。
1 软件与资源
声笔系列码现在有两种发行版，一种是通过定制 librime 而形成的魔改版，另一种是在原版 rime 上通过 lua 脚本实现的 lua 版。
为了便于用户下载使用，声笔系列码已经发布在了网上，可以通过github或者码云下载。软件也可以在声笔 QQ 交流群（780510469、783734487、445906697 和 728093309）的共享文件夹里下载，下载位置如下图所示。使用 iOS 的用户，可以直接在苹果应用商店下载仓输入法。网上其它地方查找到的版本太陈旧，下载站点转载太多，也不一定安全，不建议使用。
Windows 版本至少要求 Windows 10。安卓版本至少要求 8.0，而华为的鸿蒙是兼容安卓的，也没有问题。MacOS 采用较新的版本即可，iOS 版根据仓输入法的要求而定。至于 Linux 的用户，则需要自己通过声笔定制的 librime 源程序进行编译，声笔爱好者有编译打包声笔 librime 的，可以想法借此编译使用，具体可参见编译参考。
魔改版安装包文件名称后的日期为发布日期。你下载的文件日期可能是不一样的，不要紧，是正常的，因为软件是可能会不断更新的。lua 版只有声笔方案的压缩包。
2 安装与更新
魔改版的安装请点这里观看声笔输入法安装讲解，点这里观看声笔输入法 WIN 版安装演示。luo 版需要先安装原版的 rime 程序，再复制方案进去。
Poto 特别做了：声笔安装教程；声笔查字软件；飞系部首条反下载版；屏幕置顶的声笔部首键位助记软件——声笔飞魂。另外，HotLeave 做了飞系部首条反网页版，并由 Poto 进行了修改。
2.1 WIN 版安装
在 Windows 上，把您下载的声笔输入法 WIN 版压缩包解压，在解压后的文件夹中找到安装程序 Weasel4sbxlm，以管理员权限进行安装。
点击「我接受」，然后按默认步骤安装即可，建议不要改变默认的安装路径，更不要使用含有中文的路径，以免出现不可预知的问题。
2.2 安卓版安装
声笔输入法安卓版没有包含输入方案，所以需要同时用到 Win 版安装包（需另行下载）中的方案文件。在安装主程序后，打开用户文件夹 rime（其路径一般是/storage/emulated/0/rime），将声笔 Win 版安装包里 sbxlm 文件夹（但不包含该文件夹本身）中的内容都复制进去，再重新部署一下就算安装好了。
如果发生闪退，就请重启一下系统后使用就没问题了。如果直接安装时崩溃，可以先卸载 APP 后再安装。
2.3 Mac 版安装
声笔输入法 Mac 版没有包含输入方案，所以需要同时用到 Win 版安装包（需另行下载）中的方案文件。在安装主程序后（一般会重启系统），打开用户设定文件夹，将声笔 Win 版安装包里 sbxlm 文件夹（但不包含该文件夹本身）中的内容都复制进去，再重新部署一下就算安装好了。
2.4 iOS 版安装
直接在苹果应用商店搜索和下载仓输入法，声笔已经内置在其中了。注意，基于 lua 的声笔 10 开始，已经可以使用原版的仓输入法来支持声笔，所以已经取消了下面介绍的定制版。
2.4.1 获取并部署声笔方案
安装仓输入法后进入主界面，点击「输入方案设置」→ 右上角「+」→「开源方案下载」→「声笔输入法」→「替换并部署」。
2.4.2 选择键盘布局
在主界面点击「键盘设置」→「键盘布局」，选择「声笔 46」和「声笔 trime」之一即可。
➀ 每个按键除了键面字符之外，还用小号字标出了划动字符。
➁ 一些功能键：a 键划动打开方案选单和一系列开关，相当于电脑上的 Control+grave；f, g 键划动分别是上页和下页，相当于电脑上的 Shift+Tab 和 Tab；b 键划动将光标移到第二码，相当于电脑上的 Control+L；「符」键是切换到符号键盘，它的上划是切换到数字键盘。
2.4.3 配置
必须进行的配置有：「键盘设置」→「候选栏设置」：「显示候选项索引」开启，「显示候选文字 Comment」开启，「划动分页模式」关闭
可选配置有：
➀「键盘设置」→「Shift 状态锁定」关闭，这样可以方便使用大写字母参与编码
➁「键盘设置」→「空格设置」→「长显显示输入方案名」开启，这样可以在空格键上显示当前方案名称
2.5 Linux 上安装
在 linux 上安装声笔软件，请参见以下链接。
https://aur.archlinux.org/packages/rime-sbxlmhttps://aur.archlinux.org/packages/librime-sbxlm-git
如果是 arch 系的发行版，直接从 archlinux-cn 的社区源中安装 librime-sbxlm-git 和 rime-sbxlm：
sudo pacman -S librime-sbxlm-git rime-sbxlm完成后执行命令 sbxlm-init 即可。
如果是其他发行版，可以参考 archlinux 的打包脚本。
2.6 方案选择
在安装好声笔软件后，默认使用的输入方案为声笔简码。如果要使用声笔输入法的其它方案，在电脑上可用 F4 或者 Ctrl+~进行切换。
在手机上则长按左下角标有的「选单」的按键，然后选择「方案」，再从弹出窗口里选择你需要的方案即可。
2.7 错误处理
安装后无法使用一般都是由于安装不全造成的。最简单的办法就是打用户文件夹，删除其中的所有文件，然后将安装包里 sbxlm 目录里的所有东西（包括文件和子目录，但不包括 sbxlm 目录本身）手动复制进去，再重新部署一下就行了。
电脑上遇到无法删除文件时，可以停用小狼毫算法服务以后再删除，但是要记住更名后重新启动小狼毫算法服务，否则是不能打中文的。如果要保留原来的文件，则请先做一个备份。
2.8 软件卸载
声笔系列码的卸载很简单。在 Windows 上，通过控制面板里的卸载程序功能，找到小狼毫程序将其卸载就行了。在 Android 手机上，通过系统自身的应用程序管理功能就能方便地卸载。MAC 版和 Linux 下声笔的卸载方法与原版的相同，请参见相关资料。
如果遇到卸载不了或者卸载不干净的输入法，可以下载使用群文件软件工具里的「输入法删除工具」来解决。此工具无需安装，直接运行就可以了。
3 配置与定制
Rime 的图形界面能做的事情是有限的，在 Rime 的世界里是文本为王，通过编辑适当的 yaml 文件可以配置和定制输入法的方方面面，比传统输入法灵活和强大得多。要编辑 yaml 文件就需要有一个好的编辑器。在 Windows 上建议使用 Notepad++或者 Vscode，千万不要用记事本，更不要用 Word。在安卓上使用时，建议使用 MT 管理器。
3.1 修改小狼毫的主题
从 Windows 左下角的开始菜单找到小狼毫输入法，进入输入法设定。
在弹出的方案选单设定对话框中，点击「中」按钮。
进入下面的介面风格设定对话框，选择喜欢的配色进行预览，找到满意的配色时，点击「确定」按钮」即可。
如果想手动修改主题，可用文本编辑器编辑用户文件夹中的 weasel.custom.yaml 文件，将配色的名称改为你所需要的，默认是 aqua。另一个常常需要更改的选项是决定候选项采用横向还是纵向显示，默认是横向显示；将 horizontal 的值改为 false 就可以变成纵向显示。是否采用嵌入模式是由inline_preedit来指定的，声笔建议采用非嵌入的方式，否则在有的应用程序中可能出现莫名其妙的异常现象，因为宿主程序对编码的处理方式可能是千奇百怪的。
下面列出配色的预览图，以便用户直观地查看和选择，在每个图下文件名的最后一个下划线后的部分就是配色的名称，可用于确定 weasel.custom.yaml 文件里的style/color_schema。
3.2 修改同文的主题和配色
在使用声笔同文版时，长按左下角的「设置选单」键，进入后找到主题一项，点击后切换主题。长按右下角的「上屏配色」键则可以选择主题所提供的配色。
建议用户使用默认主题，因为它是针对声笔系列码优化过的，为各种声笔方案提供了助记，还有众多的配色。特别感谢空白、白焕等群友在默认主题上的无私贡献，默认主题的完善是在他们作品基础上进行的。
以下是几个默认主题的配色实例。如果用户还需要定制的话，可以进一步修改 rime 文件夹下的 trime.yaml 文件。无滑动大写是在默认主题基础上取消了通过上滑或者下滑来输入大写字母的主题。
声笔 33 键是大键主题，供那些因拇指大而容易误触的人使用，如下所示。
除了以上主题之外，还有一些声笔用户和皮肤大佬，如莫颜、强的、单单和 Poto 等也专门为声笔定制了皮肤，感兴趣的朋友可到声笔 QQ 群里下载使用。
3.3 修改鼠须管的配色
打开用户设定，创建 squirrel.custom.yaml 文件， 将配色的名称 color_scheme 改为你所需要的即可。另一个常常需要更改的选项是决定候选项采用横向还是纵向显示，默认是横向显示；将 horizontal 的值改为 false 就可以变成纵向显示。
以下是一些配色的效果图和对应的配色名称。
