国际象棋文件格式的瑞士军刀

这是 jja，一个用于与各种国际象棋文件格式交互的命令行工具。它仍处于早期开发阶段。作者的最初意图是将他们保存为 ChessBase 的专有 CTG 格式的开局书籍转换为免费和开放的 PolyGlot 格式。随着时间的推移，他们打算添加对其他国际象棋文件格式的支持（cbh、si4、si5 等）。

演示

金，吉延，阿扎迪

我在 2023 年国际妇女节开始编写这个项目，这一天是为了纪念女性的成就并在全球范围内倡导她们的权益。作为一名库尔德血统的人，我特别受到口号“妇女，生活，自由”的感动，这个口号已成为反抗压迫和呼吁平等的象征。在自由软件和自由言论的精神下，我努力为创建一个更加公正和包容的社会做出贡献，在这个社会中，每个人都被赋予了表达自己和追求梦想的自由。我还纪念玛莎·阿米尼，她的悲剧性死亡提醒我们，迫切需要为女性的自由和安全而斗争。

更多关于维基百科，WikiPedia::妇女，生活，自由

格式

截至版本 0.7.0，jja 支持

• PolyGlot，又称 bin
• Arena，又称 abk
• ChessBase，又称 ctg
• ChessMaster，又称 obk（版本 1 和 2，有无文本备注）
• BrainLearn，又称 exp

开局书籍文件，同时它支持写入/转换到

• PolyGlot，又称 bin
• Arena，又称 abk
• BrainLearn，又称 exp

开局书籍文件。

截至版本 0.5.0，jja 支持将所有支持的开局书籍格式导出为 PGN 格式。要使用此功能，请将具有 pgn 扩展名的输出文件作为 jja edit 的参数指定。

截至版本 0.8.0，jja 支持将 PGN 文件中的所有位置导出到输出 EPD 文件。要使用此功能，请将具有 pgn 扩展名的输入文件（或压缩的 pgn：pgn.bz2、pgn.gz、pgn.lz4、pgn.xz 或 pgn.zst）和具有 epd 扩展名的输出文件作为 jja edit 的参数指定。

在开局书籍转换过程中，jja 使用各种输入开局书籍格式中提供的信息来生成与 PolyGlot 开局文件中的移动一起的 移动权重。在 ctg 转换期间，jja 还在 learn 字段中写入一些自定义数字，例如 NAGs，或在 abk 转换期间的 优先级。您可以使用 --no-learn 禁用此自定义使用，因为它可能会使使用此字段的其它软件产生混淆。

注意，Arena，又称 abk，支持从 ChessBase，又称 ctg 书籍中写入开局书籍文件。使用命令行标志 --author、--comment、--probability-priority、--probability-games、--probability-win-percent 来配置 ABK 标头元数据。游戏统计信息（最小游戏数/胜利数，双方的胜利百分比）由 jja 自动管理。

使用命令行选项 -i, -in-place=SUFFIX 也可以对 Arena 开局书籍进行就地编辑。计划在未来版本中实现从 PolyGlot，又称 bin，和 ChessMaster，又称 obk 开局书籍到 Arena，又称 abk 开局书籍文件的转换。

用法

• 使用 jja info 获取关于棋文件的简要信息。
• 使用 jja find 在棋文件中搜索位置。
• 使用 jja edit 编辑开局书籍文件并将它们转换为 PolyGlot 文件或 Arena 文件。
• 使用 jja make 将 PolyGlot 或 BrainLearn 文件编译为 PolyGlot 开局书籍。
• 使用 jja dump 将 PolyGlot 或 BrainLearn 文件作为 JSON 数组的流导出。
• 使用jja restore从JSON数组流中恢复PolyGlot或BrainLearn文件。
• 使用jja merge合并两个PolyGlot开局书籍。
• 使用jja match通过随机模拟来安排书籍比赛。
• 使用jja play进行随机模拟，可选地使用书籍。
• 使用jja digest计算给定棋局的Zobrist哈希。
• 使用jja perft从给定位置计算到给定深度的节点数。
• 使用jja open浏览ECO分类。
• 使用jja quote打印棋局引语。

jja通过文件扩展名确定文件类型。扩展名为.bin的文件被认为是PolyGlot书籍。扩展名为.ctg的文件被认为是ChessBase书籍。扩展名为.abk的文件被认为是Arena书籍。扩展名为.obk的文件被认为是ChessMaster书籍。扩展名为.exp的文件被认为是BrainLearn经验文件。

默认情况下，如果标准输出是TTY，jja将使用花哨的表格显示信息。使用--porcelain命令行选项以CSV（逗号分隔值）格式获取输出。

安装

要从源代码编译，请使用cargo install jja。这需要安装Rust工具链。此外，您还需要在UNIX系统上安装OpenSSL库。另外，您还需要在Linux上安装liburing。如果您在Linux系统上运行的版本低于5.1或您无法安装liburing，您可以通过使用cargo install jja --no-default-features来禁用此功能。

作为替代方案，jja的发布版本托管在chesswob.org上，适用于64位Linux和Windows。这些版本由GnuPG使用密钥D076A377FB27DE70签名。要安装，从chesswob.org获取最新版本，验证校验和和GnuPG的数字签名。

$> export JJA_VERSION=0.7.1
$> export JJA_FLAVOUR=glibc
$> curl https://keybase.io/alip/pgp_keys.asc | gpg --import
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 13292  100 13292    0     0  13535      0 --:--:-- --:--:-- --:--:-- 26584
gpg: key D076A377FB27DE70: public key "Ali Polatel (Caissa AI) <[email protected]>" imported
gpg: Total number processed: 1
gpg:               imported: 1
$> for f in jja-${JJA_VERSION}-${JJA_FLAVOUR}.bin{,.sha512sum,.sha512sum.asc}; do wget -q https://chesswob.org/jja/${f}; done
$> gpg --verify jja-${JJA_VERSION}.bin.sha512sum.asc jja-${JJA_VERSION}.bin.sha512sum
gpg: Signature made Sun Mar 19 20:52:41 2023 CET
gpg:                using RSA key 5DF763560390A149AC6C14C7D076A377FB27DE70
gpg: Good signature from "Ali Polatel (Caissa AI) ...
$> sha512sum -c jja-${JJA_VERSION}.bin.sha512sum
jja: OK
$> sudo install -m755 jja-${JJA_VERSION}-${JJA_FLAVOUR}.bin /usr/local/bin

最后，您可以通过SourceHut 构建服务器下载最新 git 版本的构建版本。共有三种版本，分别是 windows、linux-glibc 和 linux-musl。只需浏览到最新构建版本，下载左侧列出的工件。注意：这些工件保留90天。

打包状态

许可证

jja 是免费软件：您可以在自由软件基金会发布的 GNU 通用公共许可证 的条款下重新分发和/或修改它，无论是许可证的第 3 版，还是（根据您的选择）任何更高版本。

本程序分发时希望它是有用的，但 不提供任何保证；甚至没有对 商品性 或 适用于特定目的的适用性 的暗示保证。有关详细信息，请参阅 GNU 通用公共许可证。

您应已收到本程序随附的 GNU 通用公共许可证副本。如果没有，请参阅 http://www.gnu.org/licenses/。

错误

Hey you, out there beyond the wall,
Breaking bottles in the hall,
Can you help me?

向 jja 的错误追踪器报告错误 https://todo.sr.ht/~alip/jja/

1. 始终 保持礼貌、尊重和友好： https://css-tricks.org.cn/open-source-etiquette-guidebook/
2. 尽可能使您的最终更改保持 小巧和整洁： https://tirania.org/blog/archive/2010/Dec-31.html
3. 在错误报告中附加诗歌会极大地鼓励考虑。

PGN 书制作

从版本 0.4.0 开始，jja 可以从 PolyGlot 文件制作 PGN。此功能与 polyglot make-book 类似，但有以下不同之处

1. jja 可以直接读取压缩的 PGN 文件 .pgn.{bz2,gz,lz4,xz,zst}
2. jja 可以通过在临时 RocksDB 数据库中持久化统计信息来处理比系统可用内存更大的 PGN 文件。
3. jja 默认按比例缩放移动权重，以防止具有巨大 PGN 文件的大文件发生溢出，使用 --no-scale 禁用。
4. jja 可以使用 筛选表达式 筛选移动，允许用户过滤掉不想要的比赛并创建专门的开局书籍。

筛选表达式

筛选表达式字符串应包含筛选条件，筛选条件由一个标签名称、一个比较运算符和一个值组成。以下运算符受支持

• >（大于）
• >=（大于或等于）
• <（小于）
• <=（小于或等于）
• =（等于）
• !=（不等于）
• =~（正则表达式匹配，不区分大小写）
• !~（否定正则表达式匹配，不区分大小写）

可以使用以下逻辑运算符组合筛选条件

• AND（逻辑与）
• OR（逻辑或）

示例

--filter="Event =~ World AND White =~ Carlsen AND ( Result = 1-0 OR ECO = B33 )"

受支持的标签是 Event、Site、Date、UTCDate、Round、Black、White、Result、BlackElo、WhiteElo、BlackRatingDiff、WhiteRatingDiff、BlackTitle、WhiteTitle、ECO、Opening、TimeControl、Termination、TotalPlyCount 和 ScidFlags。

除了这些，还有四个特殊变量，即：Player（玩家）、Elo（等级分）、Title（标题）和RatingDiff（评分差异）。这些变量可以用来匹配任一侧的相关标题。例如，过滤器

--filter="Player =~ Carlsen"

在功能上等价于

--filter="( 白方 =~ Carlsen OR 黑方 =~ Carlsen )"

注意：过滤设计得简单快捷。标记（包括括号）由空格分隔。不允许引用值。对于更复杂的过滤需求，请使用pgn-extract。

Scid标志

Scid使用单个字符标志，例如 DWBMENPTKQ!?U123456，用于每个字段，其中

• D - 已删除
• W - 白方开局
• B - 黑方开局
• M - 中局
• E - 终局
• N - 新颖性
• P - 兵结构
• T - 走法
• K - 马路战
• Q - 象路战
• ! - 亮点
• ? - 犯错
• U - 用户定义
• 1..6 - 自定义标志

不建议依赖于字符标志的顺序。

如果可能，请使用正则表达式匹配。

关于PGN图书制作的技巧和窍门

0. 默认设置在我的笔记本电脑上运行最佳，以及在我的SourceHut构建服务器上的个人基准测试，它们并不是普遍真理。
1. jja并行处理输入的PGN文件。您可以通过提供许多分割的PGN文件作为输入来增加并行性和性能。
2. 只要您有恒定的内存使用，增加批量大小就很好。当线程跟不上的话，您将获得增加的内存使用，这就是您真正知道您的极限的地方。
3. 尝试增加最大打开文件数到您不会从操作系统那里收到太多打开文件错误。您可以指定 --max-open-files=-1 以保持文件始终打开。
4. 尝试不同的压缩算法用于临时的RocksDB数据库，或者如果您有足够的空间，尝试完全禁用压缩。 jja将临时RocksDB数据库写入第一个PGN文件参数所在的目录。默认压缩算法Lz4和默认压缩级别4旨在以相对适中的空间使用速度进行转换。如果在转换过程中空间不足，请尝试使用类似于Zstd的算法，并使用“ultra”级别，即大于或等于20的级别。
5. 尽可能在 PGN 遍历时使用过滤器。由于这些过滤器在将游戏数据写入临时数据库之前进行匹配，因此如果使用得当，它们可能会对空间和内存成本产生重大影响，从而提高整体性能。这些过滤器包括：--filter=<expr>、--max-ply=<ply>、--min-pieces=<piece-count>、--only-white 和 --only-black。

致谢

感谢 Steinar H. Gunderson 发布了 CTG 规范，并编写了 remoteglot 工具：在 jja 中的 CTG 探测代码直接从他们的 C 探测代码移植过来，规范在澄清各种粗糙边缘方面发挥了巨大作用。感谢 Fabien Letouzey，原始 PolyGlot 软件作者：在 jja 中的 PolyGlot 探测、制作和合并代码主要移植自相应的 C 代码。感谢 Michel Van den Bergh，pg_utils 的作者，一套用于与 PolyGlot 开局库交互的工具：在 jja 中的 PolyGlot 书籍编辑代码使用了 pg_utils 的许多思想和代码片段。感谢 Peter Österlund，DroidFish 的作者：在 jja 中的 ABK 开局库接口代码使用了来自 DroidFish 的思想和代码片段。感谢 Jens Nissen，ChessX 的作者：在 jja 中的 CTG 和 ABK 探测代码使用了来自 ChessX 的思想和代码片段。感谢 LiChess，地球上最好的棋类网站。在 jja 中的 quote 命令从 LiChess 代码库中导入了引用。感谢 Shane Hudson，Scid vs. PC 的作者：在 jja eco 命令中使用的是由 Scid 项目完成的 ECO 分类。此外，jja 中的 PolyGlot 编辑代码使用了来自 Scid 的思想和代码。感谢 Marcus Bufett，chess-tactics-cli 的作者：在 PolyGlot 和 ABK 编辑屏幕中的棋盘显示代码来自 chess-tactics-cli。

变更日志

0.9.1

• 将 nix 包从 0.27 升级到 0.28。
• 将 tempfilecrate 从 3.8 升级到 3.10。
• 将 rust-embedcrate 从 8.1 升级到 8.4。
• 将 rusqlitecrate 从 0.30 升级到 0.31。
• 将 rayoncrate 从 1.8 升级到 1.10。
• 将 hostnamecrate 从 0.3 升级到 0.4。
• 添加从 Lichess 评估导出 JSON 恢复 BrainLearn 经验文件的支持。
• 现在在 make 过滤器中支持 TotalPlyCount PGN 标签。
• 修复 make 中 --win,draw,loss-factor 的计算。
• 将 50 棋子检测和 3 位置重复检测添加到 play 子命令中。
• 将 once_cellcrate 从 1.18 升级到 1.19。
• 将 rayoncrate 从 1.7 升级到 1.8。
• 将 zstdcrate 从 0.12 升级到 0.13。
• 将 rusqlitecrate 从 0.29 升级到 0.30。
• 将 dialoguercrate 从 0.10 升级到 0.11。
• 将 i18n-embedcrate 从 0.13 升级到 0.14。
• 将 rust-embedcrate 从 6.8 升级到 8.0。
• 将 builtcrate 从 0.6 升级到 0.7。
• 修复在没有通配符字符时在单词边界处的引号匹配。
• 将 -O<u16>, --outlier-threshold=<u16> 合并到指定异常值阈值，其中权重高于给定阈值的移动将从合并输出书中过滤。这是基于这样一个事实：如果两个不同书中相同移动的权重差异很大，那么计算任何平均值可能都不会得到有意义的成果。默认值为0，这会禁用此功能。
• 合并学习 --strategy dynmid，代表 jja::merge::MergeStrategy::DynamicMidpoint。
• 合并学习 --strategy wdist，代表 jja::merge::MergeStrategy::WeightedDistance。
• 将 nix 包从 0.26 升级到 0.27 并添加了 signal 功能。
• 合并学习 --strategy wmedian，代表 jja::merge::MergeStrategy::WeightedMedian。
• 合并学习 --strategy entropy，代表 jja::merge::MergeStrategy::Entropy。
• 合并学习 --strategy quadratic，代表 jja::merge::MergeStrategy::QuadraticMean。该策略使用二次平均（均方根）方法进行合并。二次平均（也称为均方根）是一组数字的幅度统计量。它提供了一个更平衡的视角，尤其是在处理大小不同的数字时。
• 合并学习 --strategy lavg，代表 jja::merge::MergeStrategy::LogarithmicAverage。该策略使用对数平均方法进行合并。由于对数函数会压缩大值并扩展小值，我们可以使用它们来得到一个对较小权重差异敏感，同时对较大权重差异具有更强抵抗力的合并策略。