Speak to Lichess

# 与 Lichess 2.1 对话

Speak to Lichess 是一个开源 Chrome 扩展程序，可让您在 Lichess.org 上指示动作。它使用 Web Speech API 来解释语音数据，并使用 Lichess Board API 来读取棋盘状态并提交动作。

完整的语音控制 - 无需进一步键盘或鼠标输入即可自动播放您的口语动作 - 提供快速、古典和通信时间格式。 Blitz 或更快的时间格式需要一些键盘输入，并且必须是 SAN 格式 (https://www.chessprogramming.org/Algebraic_Chess_Notation)。

支持标准游戏；替代模式（例如 crazyhouse、'from position' 等）应支持 UCI 格式移动，但可能会错误地处理 SAN 格式移动（使用 API 提交时）。

查看“使用此扩展程序”部分，了解如何有效地指示移动。

**该扩展需要英文片名才能正确识别 SAN 格式移动。但是，您可以使用单词更正功能添加其他语言的乐曲名称。例如，说西班牙语的玩家可以告诉分机，只要它听到“torre”，就可以将其解释为“rook”。如果有足够的兴趣，将来可能会提供更好的外语支持。**

这个扩展非常适合较慢的时间格式，而不适合较快的格式。它可以成为蒙眼国际象棋的绝佳工具。 Lichess 提供移动播放（在大多数浏览器中），以便您可以听到播放的每个移动：输入游戏并单击右上角的名称 -> 声音 -> 语音。

在此处从 Chrome 网上应用店添加：https://chrome.google.com/webstore/detail/speak-to-lichess/ldiiocggpmgljihlkgpngjlhnggpapig

如果您喜欢该扩展程序，请给它一个好评！

### ---了解更多关于使用的 API ---

网络语音 API：https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API

Lichess Board API：https://lichess.org/blog/XlRW5REAAB8AUJJ-/welcome-lichess-boards

### ---支持 Lichess.org ---

https://lichess.org/help/contribute

### ---来源/演示/资源---

Github：https://github.com/ChrisAntley1/Speak-to-Lichess

2.1 董事会状态跟踪演示：https://www.youtube.com/watch?v=V3aak7WYozs

2.0 演示显示大多数功能（注意：有关 SAN 与 UCI 移动提交的信息截至 2.1 已过期）：https://www.youtube.com/watch?v=FB0uJwfo87k

命令、SAN 和 UCI 示例以及公认的单词：https://docs.google.com/spadsheets/d/1g6cGDRYvjGPj2gqeEMUVYwbZG3xjz_SrX_2q9z0Tsxo/edit?usp=sharing

Speak to Lichess 是开源的。欢迎在 Github 或 speak2lichess@gmail.com 上提供反馈。如果您想贡献，请随时联系！

## 添加您的 API 令牌

您需要为免提语音控制创建一个 Lichess API 令牌 (https://lichess.org/account/oauth/token)。选项页面将有一个直接指向 Lichess 令牌创建页面的链接，并且已经设置了正确的参数。创建令牌时不要添加任何额外的权限，也不要与他人共享您的令牌。只需点击蓝色的“提交”按钮并复制生成的令牌。返回选项页面并粘贴您的令牌； pss“输入”或“提交”按钮。如果提供了有效令牌，红色图标将变为绿色，您应该会看到显示的用户名。

重要提示：“删除存储的令牌”按钮将从该扩展程序中删除您的令牌。但是，令牌对您的 Lichess 帐户仍然有效。确保也将其从 Lichess 中删除，特别是如果您认为它已被泄露：https://lichess.org/account/oauth/token

**--警告：不要为您的令牌添加额外的权限！令牌以纯文本形式存储！--**

在此处阅读有关 Lichess Board API 的更多信息：https://lichess.org/blog/XlRW5REAAB8AUJJ-/welcome-lichess-boards

## 使用这个扩展

首先与计算机玩快速、经典或通信游戏，以感受语音识别和正确口述动作。请务必阅读下面的“成功听写”部分。

“ctrl”键用于“切换”或“一键通”录音。您应该会看到板右侧的消息更改为“正在听...”。清楚地说明你的举动。当您说完后，扩展程序将尝试创建一个有效的国际象棋移动。您应该会在板下方看到“成功”或“失败”消息。您还可以查看控制台 (f12) 了解更多信息。

将“capture”、“take”、“short”、“long”、“castle”、“promote”和“equals”正确解释为正确的国际象棋符号。请注意，诸如“捕获”和“促进”之类的补充词不是必需的。

**单词“to”将始终被解释为“2”；例如，“骑士三角洲四”将始终被解释为“N2d4”。**

## 成功听写

**要指定一列，说出以该字母开头的单词比说出实际字母要成功得多，例如 d 列的“delta”。语音处理服务很难辨别单个字母。**

例子：

'骑士查理 3' -> Nc3

'三角洲四'-> d4

'皇后边 7' -> Qe7

'取八皇后' -> f8=Q

**您可以尝试自己使用这些字母，但根据我的经验，这不值得头疼。**

## 字更正

您可能会遇到一个经常被识别服务误认为另一个词的词。例如，“rook”几乎总是被解释为“Brooke”。该扩展程序跟踪一个单词更正列表，以帮助提供更一致的体验。 （默认情况下，'Brooke' 已被更正。）

将扩展固定到 Chrome 工具栏，然后单击图标以打开弹出菜单。在这里，您可以指定哪个单词是错误的（'Brooke'）以及应该听到哪个单词或短语（'rook'）。在选项页面中，您可以查看已更正的单词列表，搜索被替换/被替换的单词，并删除单词条目。

希望使用英语以外的语言的用户应该能够使用单词更正将英语作品名称替换为其首选语言中的名称。例如，说西班牙语的玩家可以告诉分机，只要它听到“torre”，就可以将其解释为“rook”。

注意：您可以使用任何您想识别棋子的词（例如，'noon' 代表 knight，'rail' 代表 rook 等），但有一个例外：bishops。除“bishop”外，任何以“b”开头的单词都将被解释为棋子；例如，“bagel alpha 4”将被解释为“ba4”，并且始终被视为棋子——即使这对你的主教来说是合法的。这是因为坐标集和 Bishop 在符号中共享字母“b”。

您可以通过在单词更正中将首选单词替换为“bishop”来解决此问题；例如，要使用“百吉饼”，您会告诉扩展程序将“百吉饼”解释为“主教”。

*该扩展包含一些已替换的有问题的单词（包括“布鲁克”）。

为什么需要字词校正：Web Speech API 当前使用 SpeechGrammar 接口 (https://developer.mozilla.org/en-US/docs/Web/API/SpeechGrammar)。此接口包含识别服务应专门查找的一组单词或单词模式。如果按预期工作，这将允许我们设置一个众所周知的单词列表来表示列并获得一致的识别结果。不幸的是，Chrome/Google 提供的识别服务忽略了这个列表。请参阅此页面的“处理错误和无法识别的语音”部分：https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API/Using_the_Web_Speech_API。

可以在此处找到更多命令示例和通常连续插入的单词：https://docs.google.com/spadsheets/d/1g6cGDRYvjGPj2gqeEMUVYwbZG3xjz_SrX_2q9z0Tsxo/edit?usp=sharing

##文本输入框提交

对于 Blitz 或更快的格式，或者如果您不能/不希望使用 API 令牌，您可以使用 Lichess 文本输入框来提交移动。这要求您 pss 'enter' 以提交移动，并且您的移动是 SAN 格式。

1. 在 Lichess 上，通过转到 https://lichess.org/account/pferences/game-behavior 并启用“使用键盘输入移动”来启用文本输入

2. 确保扩展程序正在使用“ctrl”键监听您的输入。您应该会看到板右侧的消息更改为“正在听...”。

3. 以 SAN 格式指示您的行动。完成后，您应该会在输入框附近看到显示您的移动的消息。按 enter 将显示的移动提交到输入框，如果显示的移动不正确，则指示另一个移动。

## 附加命令：

此扩展支持其他命令，包括：

辞职

提供抽奖

拿回来

接受

衰退

中止

复赛

翻转板

分析游戏

新游戏

愤怒退出

## 安装指南：

--从网上商店添加到chrome这里绝对是最简单的

——来自 Github：

1. 从 GitHub 下载最新版本的 zip 文件（通常在页面右侧），或克隆存储库。

2.解压包；记下生成的文件夹所在的位置。

3. 转到 chrome://extensions

4.在右上角切换开发者模式，然后点击左上角的'load unpacked'；选择您在步骤 2 中提取的“Speech-to-Text-Lichess”文件夹。

5. 完成！您应该在扩展页面上看到与 Lichess 对话。确保它已启用。您仍然需要在选项页面中添加 API 令牌。

6. 在 chrome 的右上角，单击拼图图标，然后固定 Speak to Lichess。这将允许您使用弹出菜单来指定语音识别软件听错的单词并管理您的替换单词列表。

## 备注：

网络语音 API：https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API

Lichess Board API：https://lichess.org/blog/XlRW5REAAB8AUJJ-/welcome-lichess-boards，https://lichess.org/api#tag/Board

Speak to Lichess 是开源的。欢迎在 Github 上提供反馈，或发送至 speak2lichess@gmail.com。如果您想贡献，请随时与我们联系！

如果您喜欢该应用程序，请给它一个好评！

### 已知问题/其他：

一些用户报告了非常差的识别结果。这一切都取决于语音识别服务对您的声音的解析程度。为获得最佳效果，请确保清晰明确地表达您移动的每个组成部分。继续尝试不同的单词，直到找到软件一致识别的集合。并利用单词校正功能。

语音识别服务确实提供了替代结果，有望在未来用于帮助更准确地解释动作。

我曾计划将此扩展程序移植到 Firefox，在那里我以某种方式得到了 SpeechGrammar 接口将被正确引用为词汇表的印象。事实证明，Firefox 目前不支持 Web Speech API 的语音识别服务。