フォーマット仕様一覧

rsshogi は、棋譜（1 局の手順とメタデータ）、定跡（局面から候補手集合への辞書）、および機械学習用の局面と自己対局バイナリまで、用途に応じた複数のデータフォーマットをサポートしている。 本ページでは、各フォーマットの特性比較と相互変換の全体像を示す。

フォーマット変換ハブ

rsshogi におけるデータ構造と外部フォーマットの対応関係を以下の図に示す。

flowchart LR
    subgraph TextRecords["テキスト棋譜フォーマット"]
        KIF["KIF (.kif)"]
        KI2["KI2 (.ki2)"]
        CSA["CSA (.csa)"]
        JKF["JKF (.jkf)"]
        USI["USI / SFEN"]
    end

    subgraph CoreIR["rsshogi メモリ表現"]
        Record["Record (棋譜ツリー)"]
        Position["Board / Position (局面)"]
        BookIR["BookDatabase"]
    end

    subgraph TrainingBin["学習用圧縮バイナリ"]
        SBIN["SBINPACK (.sbinpack)"]
        PACK["PACK (.pack)"]
        HCP["HCP / HCPE (32B / 38B)"]
        PSV["PackedSfen / PSV (32B / 40B)"]
        SAZ["SAZPACK (.sazpack)"]
    end

    subgraph BookFormats["定跡フォーマット"]
        NativeBook["Native Book v4 (.book)"]
        DB2016["YaneuraOu DB2016 (.db)"]
        YBB["YaneuraOu YBB (.ybb)"]
        SBK["ShogiHome SBK (.sbk)"]
    end

    KIF <--> Record
    KI2 <--> Record
    CSA <--> Record
    JKF <--> Record
    USI <--> Record
    Record <--> SBIN
    Record <--> PACK
    Position <--> HCP
    Position <--> PSV
    Position <--> SAZ
    BookIR --> NativeBook
    BookIR <--> DB2016
    BookIR --> YBB
    BookIR <--> SBK
    YBB --> NativeBook
    DB2016 --> NativeBook
    SBK --> NativeBook

1. 棋譜フォーマット（KIF / KI2 / CSA / JKF）

1 局の指し手、消費時間、コメント、対局者情報などを記録するテキストフォーマット群である。 すべて Record 型を介して相互に変換できる。

棋譜変換の実装例

Python

from rsshogi.record import Record

# KIF 文字列をパースして他フォーマットへ変換する
record = Record.from_kif_str(kif_text)
csa_text = record.to_csa()
ki2_text = record.to_ki2()
jkf_text = record.to_jkf()

# Shift_JIS（cp932）で KIF ファイルに書き出す
record.write_kif("game_sjis.kif", encoding="cp932")

Rust

Rust では rsshogi クレートの records feature を有効にすることで、各フォーマットの関数を利用できる。 KI2 のパースおよびエクスポート関数は独立した ki2 サブモジュールではなく、rsshogi::records::formats::kif モジュール内で定義され、rsshogi::records::formats::* および rsshogi::records::* に再エクスポートされている。

#![allow(unused)]
fn main() {
use rsshogi::records::formats::{
    csa::{export_csa, parse_csa_str},
    jkf::{export_jkf, parse_jkf_str},
    kif::{export_ki2, export_kif, parse_ki2_str, parse_kif_str},
};

let record = parse_kif_str(kif_text)?;
let csa_text = export_csa(&record)?;
let ki2_text = export_ki2(&record)?;
let jkf_text = export_jkf(&record)?;
}

2. 定跡フォーマット（Native Book / YaneuraOu / SBK）

局面から候補手、評価値、探索深さ、採択回数（重み）へのマッピングを保持するフォーマット群である。 rsshogi のアーキテクチャと変換規則の詳細は 定跡アーキテクチャ を参照。

YBB は YbbBook で読み込み、YbbEntry を走査できる。 YbbBook::write_native_book(path, &options) で Native Book へ直接変換できる。 変換設定と欠落フィールドの扱いは 1.7.0 の移行ガイド を参照。 BookDatabase への取り込みは、呼び出し側で局面と候補手を変換する。

3. 学習および圧縮バイナリフォーマット

ニューラルネットワークの学習データ生成、大規模棋譜の高速ストリーム処理、および MCTS 自己対局ログの保存に特化したバイナリフォーマット群である。

関連項目

• Record と棋譜データモデル
• 定跡アーキテクチャ
• 局面圧縮の仕組み（HCP / PackedSfen）