モジュール別ドキュメント

更新日: 2026-07-05

src/pca/の実装をモジュールごとに説明します。最初にソース設計で全体像を確認し、個別の責務やAPIはこのページからたどってください。

はじめに

• 目的別の読み方
• 目的別に読む順番と、確認する実装を示す。
• 処理フロー
• self-play、ISMCTS、学習、評価の処理フロー。
• 実装レシピ
• よくある変更作業の手順書。
• API一覧
• import先、引数、戻り値、副作用、関連テストの一覧。
• 生成物一覧
• JSONL、CSV、チェックポイント、メタデータキャッシュ、提出用bundleの一覧。
• テストマップ
• 変更内容ごとに走らせるテスト。

基盤

• CABT境界
• pca.cabt, pca.cli_config, pca.data
• 特徴量
• pca.features
• 意思決定
• pca.decision
• モデル
• pca.models

探索

• 探索の共通処理
• pca.search.mcts, pca.search.belief, pca.search.determinized
• ISMCTS
• pca.search.ismcts

学習

• 学習データ
• pca.training.targets, pca.training.dataset, pca.training.data
• Self-Play
• pca.training.selfplay
• Policy・Value学習
• pca.training.train, pca.training.policy_value
• Belief学習
• pca.training.belief_train, pca.training.belief

実行・評価

• 評価
• pca.evaluation
• ルールエージェント
• pca.rule_agents
• 提出・推論提供
• pca.serving, pca.submission
• ツール・設定
• pca.tools, config/YAML helpers

更新ルール

• Pythonモジュールを追加したら、対応する文書のモジュール一覧に1行追加する。
• 公開APIを追加したら、「公開API」節にimport先と用途を書く。
• CLIのオプションやJSONLスキーマを変えたら、関連する文書とソース設計の両方を更新する。
• 実装手順が複数ファイルにまたがる場合は recipes.md に追加する。
• 生成物の形式や保存場所を変えたら artifacts.md に追加する。