bioshogi 0.0.3

data/lib/bioshogi/cli/versus.rb

@@ -0,0 +1,160 @@
+# frozen-string-literal: true
+# bioshogi versus
+
+if $0 == __FILE__
+  require "../cli"
+end
+
+module Bioshogi
+  class Cli < Thor
+    desc "versus", "CPU同士の対戦"
+    option :depth_max,   type: :numeric, aliases: "-d", default: 8
+    option :times,       type: :numeric, aliases: "-n", default: 512
+    option :time_limit,  type: :numeric, aliases: "-t", default: 5.0
+    option :round,       type: :numeric, aliases: "-r", default: 1
+    option :logging,     type: :boolean, aliases: "-l", default: false
+    option :log_file,    type: :string,                 default: "brain.log"
+    option :black_diver, type: :string,                 default: "Diver::NegaAlphaDiver"
+    option :white_diver, type: :string,                 default: "Diver::NegaScoutDiver"
+    def versus
+      if options[:logging]
+        log_file = Pathname(options[:log_file])
+        FileUtils.rm_rf(log_file)
+        Bioshogi.logger = ActiveSupport::TaggedLogging.new(ActiveSupport::Logger.new(log_file))
+      end
+
+      divers = [
+        Bioshogi::Ai.const_get(options[:black_diver]),
+        Bioshogi::Ai.const_get(options[:white_diver]),
+      ]
+      tp divers
+      pp options
+      tp options
+
+      win_counts = Location.inject({}) { |a, e| a.merge(e.key => 0) }
+
+      options[:round].times do |round|
+        container = Container::Basic.start
+        options[:times].times do
+          current_player = container.current_player
+
+          deepen_score_list_params = {
+            time_limit: options[:time_limit],
+            depth_max_range: 0..options[:depth_max],
+          }
+          diver_class = divers[container.turn_info.current_location.code]
+          records = current_player.brain(diver_class: diver_class, evaluator_class: Ai::Evaluator::Level3).iterative_deepening(deepen_score_list_params)
+          record = records.first
+          hand = record[:hand]
+          container.execute(hand.to_sfen, executor_class: PlayerExecutor::WithoutMonitor)
+
+          puts "---------------------------------------- [#{container.turn_info.turn_offset}] #{hand} (#{diver_class})"
+          # container.players.each { |e| tp e.pressure_report }
+
+          tp deepen_score_list_params
+          tp Ai::Brain.human_format(records)
+          tp container.players.inject({}) { |a, e| a.merge(e.location => e.pressure_rate) }
+          puts container
+          puts
+          puts "#{hand} #{record[:black_side_score]}"
+          puts
+          puts container.to_kif_oneline
+
+          captured_soldier = current_player.executor.captured_soldier
+          if captured_soldier && captured_soldier.piece.key == :king
+            win_counts[current_player.location.key] += 1
+            Pathname("win_counts.txt").write(win_counts.inspect)
+            break
+          end
+        end
+      end
+    end
+  end
+end
+
+if $0 == __FILE__
+  Bioshogi::Cli.start(["versus", "-r1", "-n1", "-t3", "-d3"])
+end
+
+# >> |--------------------------|
+# >> | Bioshogi::Diver::NegaAlphaDiver |
+# >> | Bioshogi::Diver::NegaScoutDiver |
+# >> |--------------------------|
+# >> {"depth_max"=>3,
+# >>  "times"=>1,
+# >>  "time_limit"=>3,
+# >>  "round"=>1,
+# >>  "logging"=>false,
+# >>  "log_file"=>"brain.log",
+# >>  "black_diver"=>"Diver::NegaAlphaDiver",
+# >>  "white_diver"=>"Diver::NegaScoutDiver"}
+# >> |-------------+----------------|
+# >> |   depth_max | 3              |
+# >> |       times | 1              |
+# >> |  time_limit | 3              |
+# >> |       round | 1              |
+# >> |     logging | false          |
+# >> |    log_file | brain.log      |
+# >> | black_diver | Diver::NegaAlphaDiver |
+# >> | white_diver | Diver::NegaScoutDiver |
+# >> |-------------+----------------|
+# >> ---------------------------------------- [1] ▲７六歩(77) (Bioshogi::Diver::NegaAlphaDiver)
+# >> |-----------------+------|
+# >> |      time_limit | 3    |
+# >> | depth_max_range | 0..3 |
+# >> |-----------------+------|
+# >> |------+--------------+--------------+--------+------------+----------|
+# >> | 順位 | 候補手       | 読み筋       | ▲形勢 | 評価局面数 | 処理時間 |
+# >> |------+--------------+--------------+--------+------------+----------|
+# >> |    1 | ▲７六歩(77) | △３四歩(33) | 103400 |         30 | 0.031809 |
+# >> |    2 | ▲２六歩(27) | △３四歩(33) | 103400 |         30 | 0.029595 |
+# >> |    3 | ▲１六歩(17) | △３四歩(33) | 103394 |         30 | 0.028082 |
+# >> |    4 | ▲９六歩(97) | △３四歩(33) | 103394 |         30 | 0.029372 |
+# >> |    5 | ▲３六歩(37) | △３四歩(33) | 103394 |         30 | 0.030666 |
+# >> |    6 | ▲４六歩(47) | △３四歩(33) | 103393 |         30 | 0.029278 |
+# >> |    7 | ▲６六歩(67) | △３四歩(33) | 103393 |         30 | 0.029187 |
+# >> |    8 | ▲４八玉(59) | △３四歩(33) | 103392 |         30 |  0.02889 |
+# >> |    9 | ▲４八銀(39) | △３四歩(33) | 103392 |         30 | 0.027835 |
+# >> |   10 | ▲６八銀(79) | △３四歩(33) | 103392 |         30 | 0.029386 |
+# >> |   11 | ▲７八銀(79) | △３四歩(33) | 103392 |         30 | 0.029047 |
+# >> |   12 | ▲３八銀(39) | △３四歩(33) | 103392 |         30 | 0.029677 |
+# >> |   13 | ▲６八玉(59) | △３四歩(33) | 103392 |         30 | 0.027244 |
+# >> |   14 | ▲５八玉(59) | △３四歩(33) | 103392 |         30 | 0.029223 |
+# >> |   15 | ▲７八金(69) | △３四歩(33) | 103391 |         30 | 0.027379 |
+# >> |   16 | ▲５八金(49) | △３四歩(33) | 103391 |         30 | 0.029436 |
+# >> |   17 | ▲６八金(69) | △３四歩(33) | 103391 |         30 | 0.028743 |
+# >> |   18 | ▲５八金(69) | △３四歩(33) | 103391 |         30 | 0.028421 |
+# >> |   19 | ▲４八金(49) | △３四歩(33) | 103391 |         30 |  0.02853 |
+# >> |   20 | ▲３八金(49) | △３四歩(33) | 103391 |         30 | 0.026771 |
+# >> |   21 | ▲３八飛(28) | △３四歩(33) | 103391 |         30 |  0.03523 |
+# >> |   22 | ▲４八飛(28) | △３四歩(33) | 103391 |         30 | 0.036152 |
+# >> |   23 | ▲５八飛(28) | △３四歩(33) | 103391 |         30 | 0.034372 |
+# >> |   24 | ▲６八飛(28) | △３四歩(33) | 103391 |         30 | 0.027788 |
+# >> |   25 | ▲７八飛(28) | △３四歩(33) | 103391 |         30 | 0.029031 |
+# >> |   26 | ▲５六歩(57) | △３四歩(33) | 103390 |         30 | 0.029354 |
+# >> |   27 | ▲８六歩(87) | △３四歩(33) | 103390 |         30 | 0.030806 |
+# >> |   28 | ▲９八香(99) | △３四歩(33) | 103390 |         30 | 0.029306 |
+# >> |   29 | ▲１八香(19) | △３四歩(33) | 103390 |         30 | 0.027871 |
+# >> |   30 | ▲１八飛(28) | △３四歩(33) | 103390 |         30 | 0.040798 |
+# >> |------+--------------+--------------+--------+------------+----------|
+# >> 後手の持駒：なし
+# >>   ９ ８ ７ ６ ５ ４ ３ ２ １
+# >> +---------------------------+
+# >> |v香v桂v銀v金v玉v金v銀v桂v香|一
+# >> | ・v飛 ・ ・ ・ ・ ・v角 ・|二
+# >> |v歩v歩v歩v歩v歩v歩v歩v歩v歩|三
+# >> | ・ ・ ・ ・ ・ ・ ・ ・ ・|四
+# >> | ・ ・ ・ ・ ・ ・ ・ ・ ・|五
+# >> | ・ ・ 歩 ・ ・ ・ ・ ・ ・|六
+# >> | 歩 歩 ・ 歩 歩 歩 歩 歩 歩|七
+# >> | ・ 角 ・ ・ ・ ・ ・ 飛 ・|八
+# >> | 香 桂 銀 金 玉 金 銀 桂 香|九
+# >> +---------------------------+
+# >> 先手の持駒：なし
+# >> 手数＝1 ▲７六歩(77) まで
+# >>
+# >> 後手番
+# >>
+# >> ▲７六歩(77) 103400
+# >>
+# >> ▲７六歩(77)

data/lib/bioshogi/cli.rb

@@ -0,0 +1,106 @@
+# frozen-string-literal: true
+#
+# bioshogi versus -n 3
+#
+
+$LOAD_PATH.unshift(File.expand_path("..", __dir__))
+
+require "bioshogi"
+require "thor"
+
+module Bioshogi
+  class Cli < Thor
+    class_option :debug, type: :boolean
+    class_option :quiet, type: :boolean
+  end
+end
+
+Pathname(__dir__).glob("cli/*.rb").each do |file|
+  require file
+end
+
+if $0 == __FILE__
+  Bioshogi::Cli.start
+end
+# >> |------------------------|
+# >> | Bioshogi::Diver::NegaAlphaDiver |
+# >> | Bioshogi::Diver::NegaScoutDiver |
+# >> |------------------------|
+# >> {"depth_max"=>3,
+# >>  "times"=>1,
+# >>  "time_limit"=>3,
+# >>  "round"=>1,
+# >>  "logging"=>false,
+# >>  "log_file"=>"brain.log",
+# >>  "black_diver"=>"Diver::NegaAlphaDiver",
+# >>  "white_diver"=>"Diver::NegaScoutDiver"}
+# >> |-------------+----------------|
+# >> |   depth_max | 3              |
+# >> |       times | 1              |
+# >> |  time_limit | 3              |
+# >> |       round | 1              |
+# >> |     logging | false          |
+# >> |    log_file | brain.log      |
+# >> | black_diver | Diver::NegaAlphaDiver |
+# >> | white_diver | Diver::NegaScoutDiver |
+# >> |-------------+----------------|
+# >> ---------------------------------------- [1] ▲７六歩(77) (Bioshogi::Diver::NegaAlphaDiver)
+# >> |-----------------+------|
+# >> |      time_limit | 3    |
+# >> | depth_max_range | 0..3 |
+# >> |-----------------+------|
+# >> |------+--------------+---------------------------+------+------------+----------|
+# >> | 順位 | 候補手       | 読み筋                    | 形勢 | 評価局面数 | 処理時間 |
+# >> |------+--------------+---------------------------+------+------------+----------|
+# >> |    1 | ▲７六歩(77) | △４四歩(43) ▲４四角(88) |  205 |       1050 | 0.129571 |
+# >> |    2 | ▲９八香(99) | △１四歩(13) ▲４六歩(47) |    0 |         59 | 0.014618 |
+# >> |    3 | ▲８六歩(87) | △１四歩(13) ▲６六歩(67) |    0 |         59 | 0.015365 |
+# >> |    4 | ▲７八銀(79) | △１四歩(13) ▲１八香(19) |    0 |         57 |   0.0145 |
+# >> |    5 | ▲６八銀(79) | △１四歩(13) ▲３八飛(28) |    0 |         56 | 0.012922 |
+# >> |    6 | ▲６六歩(67) | △１四歩(13) ▲９六歩(97) |    0 |         59 | 0.015214 |
+# >> |    7 | ▲７八金(69) | △１四歩(13) ▲５六歩(57) |    0 |         56 | 0.014731 |
+# >> |    8 | ▲６八金(69) | △１四歩(13) ▲７六歩(77) |    0 |         56 | 0.014576 |
+# >> |    9 | ▲５八金(69) | △１四歩(13) ▲２六歩(27) |    0 |         54 | 0.015056 |
+# >> |   10 | ▲５六歩(57) | △１四歩(13) ▲４六歩(47) |    0 |         59 | 0.014406 |
+# >> |   11 | ▲６八玉(59) | △１四歩(13) ▲７八銀(79) |    0 |         57 | 0.015313 |
+# >> |   12 | ▲５八玉(59) | △１四歩(13) ▲１八香(19) |    0 |         56 | 0.014563 |
+# >> |   13 | ▲４八玉(59) | △１四歩(13) ▲３八飛(28) |    0 |         55 | 0.015561 |
+# >> |   14 | ▲４六歩(47) | △１四歩(13) ▲５八金(49) |    0 |         59 | 0.014996 |
+# >> |   15 | ▲５八金(49) | △１四歩(13) ▲７八銀(79) |    0 |         54 | 0.015237 |
+# >> |   16 | ▲４八金(49) | △１四歩(13) ▲９八香(99) |    0 |         54 | 0.014886 |
+# >> |   17 | ▲３八金(49) | △１四歩(13) ▲１六歩(17) |    0 |         52 | 0.013963 |
+# >> |   18 | ▲３六歩(37) | △１四歩(13) ▲３七桂(29) |    0 |         60 | 0.014453 |
+# >> |   19 | ▲４八銀(39) | △１四歩(13) ▲４六歩(47) |    0 |         53 | 0.013778 |
+# >> |   20 | ▲３八銀(39) | △１四歩(13) ▲９八香(99) |    0 |         52 |  0.01624 |
+# >> |   21 | ▲２六歩(27) | △１四歩(13) ▲８六歩(87) |    0 |         60 | 0.015151 |
+# >> |   22 | ▲３八飛(28) | △１四歩(13) ▲５八金(49) |    0 |         58 | 0.015105 |
+# >> |   23 | ▲４八飛(28) | △１四歩(13) ▲９六歩(97) |    0 |         57 | 0.015086 |
+# >> |   24 | ▲５八飛(28) | △１四歩(13) ▲５六歩(57) |    0 |         57 | 0.015008 |
+# >> |   25 | ▲６八飛(28) | △１四歩(13) ▲７六歩(77) |    0 |         57 | 0.014952 |
+# >> |   26 | ▲７八飛(28) | △１四歩(13) ▲５八金(49) |    0 |         58 | 0.014058 |
+# >> |   27 | ▲１八飛(28) | △１四歩(13) ▲９六歩(97) |    0 |         59 | 0.016418 |
+# >> |   28 | ▲１六歩(17) | △１四歩(13) ▲１七桂(29) |    0 |         61 | 0.014441 |
+# >> |   29 | ▲９六歩(97) | △１四歩(13) ▲９七角(88) |    0 |         62 | 0.012523 |
+# >> |   30 | ▲１八香(19) | △１四歩(13) ▲７六歩(77) |    0 |         57 | 0.015551 |
+# >> |------+--------------+---------------------------+------+------------+----------|
+# >> 後手の持駒：なし
+# >>   ９ ８ ７ ６ ５ ４ ３ ２ １
+# >> +---------------------------+
+# >> |v香v桂v銀v金v玉v金v銀v桂v香|一
+# >> | ・v飛 ・ ・ ・ ・ ・v角 ・|二
+# >> |v歩v歩v歩v歩v歩v歩v歩v歩v歩|三
+# >> | ・ ・ ・ ・ ・ ・ ・ ・ ・|四
+# >> | ・ ・ ・ ・ ・ ・ ・ ・ ・|五
+# >> | ・ ・ 歩 ・ ・ ・ ・ ・ ・|六
+# >> | 歩 歩 ・ 歩 歩 歩 歩 歩 歩|七
+# >> | ・ 角 ・ ・ ・ ・ ・ 飛 ・|八
+# >> | 香 桂 銀 金 玉 金 銀 桂 香|九
+# >> +---------------------------+
+# >> 先手の持駒：なし
+# >> 手数＝1 ▲７六歩(77) まで
+# >>
+# >> 後手番
+# >>
+# >> ▲７六歩(77) 205
+# >>
+# >> ▲７六歩(77)

data/lib/bioshogi/container/basic.rb

@@ -0,0 +1,13 @@
+# frozen-string-literal: true
+
+module Bioshogi
+  module Container
+    class Basic
+      include CoreMethods
+      include PlayersMethods
+      include SerializeMethods
+      include ExecuteMethods
+      include TestMethods
+    end
+  end
+end

data/lib/bioshogi/container/checkmate_yomiage.rb

@@ -0,0 +1,87 @@
+module Bioshogi
+  module Container
+    class CheckmateYomiage
+      attr_accessor :container
+      attr_accessor :options
+
+      SYMBOL_TO_SLEEP_ARGUMENT = {
+        :sep1 => 0.5,
+        :sep2 => 1.0,
+      }
+
+      def initialize(container, options = {})
+        @container = container
+        @options = options
+      end
+
+      # 以前の方法
+      def to_s
+        av = []
+        av.concat(soldiers)
+        av.push(piece_box)
+        av = av.flatten
+        av = av.find_all { |e| e.kind_of?(String) }
+        av = av.join("。")
+        av
+      end
+
+      # 新しい方法
+      def to_a
+        av = []
+        av.concat(soldiers)
+        av.push(piece_box)
+        av = av.flatten
+        if av.last.kind_of?(Symbol)
+          av.pop
+        end
+        av = av.collect do |e|
+          if e.kind_of?(String)
+            { command: "talk", message: e }
+          else
+            { command: "interval", sleep: SYMBOL_TO_SLEEP_ARGUMENT.fetch(e), sleep_key: e }
+          end
+        end
+        av
+      end
+
+      private
+
+      def soldiers
+        soldiers = container.board.soldiers
+        group = soldiers.group_by(&:location)
+        group = group.transform_values do |soldiers|
+          soldiers = soldiers.sort_by { |e|
+            [e.place.y.to_sfen, e.place.x.to_sfen]
+          } # 右上から横に走査する順
+          soldiers = soldiers.collect { |e|
+            [e.place.yomiage, e.yomiage].join.squish
+          }
+          soldiers = append_separator(soldiers, :sep2)
+        end
+        av = Location.collect { |e|
+          [e.checkmate_yomiage, :sep1, group[e] || ["なし", :sep1]]
+        }
+        av = av.reverse           # 相手から読み上げるため
+        # append_separator(av, :sep1)
+      end
+
+      def piece_box
+        piece_box = container.player_at(:black).piece_box # 白側の持駒は無視
+        piece_counts = piece_box.sort_by { |e, count| -Piece.fetch(e).basic_weight }
+        av = piece_counts.collect { |e, count|
+          [Piece.fetch(e).yomiage(false), :sep1] * count
+        }
+        av = av.presence || ["なし", :sep1]
+        ["もちごま", :sep1, av]
+      end
+
+      # def array_separator(ary, separator)
+      #   ary.flat_map { |e| [e, separator] }[0..-2]
+      # end
+
+      def append_separator(ary, separator)
+        ary.flat_map { |e| [e, separator] }
+      end
+    end
+  end
+end

data/lib/bioshogi/container/core_methods.rb

@@ -0,0 +1,99 @@
+# frozen-string-literal: true
+
+module Bioshogi
+  module Container
+    concern :CoreMethods do
+      attr_writer :board
+
+      def before_run_process
+      end
+
+      def params
+        @params ||= {
+          :skill_monitor_enable           => false,
+          :skill_monitor_technique_enable => false,
+          :candidate_enable               => true,
+          :validate_enable                => true,
+          :board_class                    => Board,
+        }
+      end
+
+      def deep_dup
+        Marshal.load(Marshal.dump(self))
+      end
+
+      def context_new(&block)
+        yield deep_dup
+      end
+
+      def inspect
+        to_s
+      end
+
+      def board
+        @board ||= params[:board_class].new
+      end
+
+      def placement_from_bod(str)
+        str = str.lines.collect(&:strip).join("\n")
+        if md = str.match(/(?<board>^\+\-.*\-\+$)/m)
+          board.placement_from_shape(md[:board])
+        end
+        str.scan(/(.*)の持駒：(.*)/) do |location_key, piece_str|
+          player_at(location_key).pieces_set(piece_str)
+        end
+
+        if md = str.match(/^手数\s*(＝|=)\s*(?<counter>\d+)/)
+          turn_info.turn_base = md[:counter].to_i
+        end
+
+        # 手合割は bod の仕様にはないはずだけどあれば駒落ちの判断材料にはなる
+        if md = str.match(/^手合割：\s*(\S+)\s*/)
+          if preset_info = PresetInfo.lookup(md.captures.first)
+            turn_info.handicap = preset_info.handicap
+          end
+        end
+
+        # 「上手」「下手」の名前がどこかに使われていれば駒落ち(雑)
+        if Location.any? { |e| str.include?(e.handicap_name) }
+          turn_info.handicap = true
+        end
+
+        # FIXME: 「先手番」のチェックがない
+      end
+
+      def placement_from_preset(preset_key = nil)
+        preset_info = PresetInfo.fetch(preset_key || "平手")
+
+        # 盤の反映
+        board.placement_from_soldiers(preset_info.sorted_soldiers)
+
+        # 持駒の反映
+        preset_info.piece_boxes.each do |location_key, piece_str|
+          player_at(location_key).pieces_set(piece_str)
+        end
+
+        # 手番の反映
+        turn_info.handicap = preset_info.handicap
+
+        Assertion.assert { turn_info.turn_base == 0 }
+        Assertion.assert { turn_info.turn_offset == 0 }
+
+        # 玉の位置を取得
+        players.each(&:king_place_update)
+
+        # TODO: ここで居玉判定をするべきかどうかの判定を入れたらいい？
+      end
+
+      # SFEN で初期配置する
+      def placement_from_sfen(sfen_info)
+        SfenImporter.new(self, sfen_info).import_initial
+      end
+
+      # SFEN のすべてを流し込む
+      def load_from_sfen(sfen_info)
+        SfenImporter.new(self, sfen_info).import_all
+      end
+    end
+  end
+end

data/lib/bioshogi/container/execute_methods.rb

@@ -0,0 +1,40 @@
+# frozen-string-literal: true
+
+module Bioshogi
+  module Container
+    concern :ExecuteMethods do
+      # Simple では使ってないメソッド
+      concerning :HumanMethods do
+        included do
+          delegate :to_kif_a, :to_ki2_a, :to_kif_oneline, to: :hand_logs
+        end
+
+        attr_writer :kill_count      # 駒を取った回数
+        attr_accessor :critical_turn # 最初の駒が取られる直前の手数           (avg: 21.6328)
+        attr_accessor :outbreak_turn # 「歩と角」を除く駒が取られる直前の手数 (avg: 41.8402)
+
+        def kill_count
+          @kill_count ||= 0
+        end
+
+        def hand_logs
+          @hand_logs ||= HandLogs.new([])
+        end
+      end
+
+      def execute(str, options = {})
+        options = {
+          executor_class: executor_class,
+        }.merge(options)
+
+        InputParser.scan(str).each do |str|
+          current_player.execute(str, options)
+        end
+      end
+
+      def executor_class
+        PlayerExecutor::Human
+      end
+    end
+  end
+end

data/lib/bioshogi/container/fast.rb

@@ -0,0 +1,16 @@
+# frozen-string-literal: true
+
+module Bioshogi
+  module Container
+    class Fast
+      include CoreMethods
+      include PlayersMethods
+      include SerializeMethods
+      include ExecuteMethods
+
+      def executor_class
+        PlayerExecutor::WithoutMonitor
+      end
+    end
+  end
+end

data/lib/bioshogi/container/players_methods.rb

@@ -0,0 +1,106 @@
+# frozen-string-literal: true
+
+module Bioshogi
+  module Container
+    concern :PlayersMethods do
+      class_methods do
+        def start
+          new.tap do |e|
+            e.placement_from_preset("平手")
+          end
+        end
+      end
+
+      attr_reader :players
+
+      def players
+        @players ||= Location.collect do |e|
+          Player.new(container: self, location: e)
+        end
+      end
+
+      # player_at(-1) でも後手を取得できる
+      def player_at(location)
+        players[Location.fetch(location).code]
+      end
+
+      # 現在の手番のプレイヤー
+      # 引数の数値だけ手番が入れ替わる
+      def current_player(diff = 0)
+        players[turn_info.current_location(diff).code]
+      end
+
+      # 現在の手番の相手プレイヤー
+      def opponent_player
+        current_player(1)
+      end
+
+      # 次のプレイヤー(つまり相手)
+      def next_player
+        opponent_player
+      end
+
+      # 対局が終わった時点での勝者
+      def win_player
+        opponent_player
+      end
+
+      # 対局が終わった時点での敗者
+      def lose_player
+        current_player
+      end
+
+      # 両方のプレイヤーの駒台をクリア
+      def piece_box_clear
+        players.each { |e| e.piece_box.clear }
+      end
+
+      # 両者の(別名を含む)スキル名のリストを合わせてユニークにしたもの
+      # つまりその対局に関連するすべてのタグに相当する
+      def normalized_names_with_alias
+        players.flat_map { |e| e.skill_set.normalized_names_with_alias }.uniq
+      end
+
+      # def basic_score
+      #   evaluator.basic_score
+      # end
+
+      # 互いに王手されている局面か？ (ありえない)
+      def position_invalid?
+        players.all?(&:mate_advantage?)
+      end
+
+      concerning :OtherMethods do
+        # 文字列で両者に駒を配る
+        def pieces_set(str)
+          Piece.s_to_h2(str).each do |location_key, counts|
+            player_at(location_key).piece_box.set(counts)
+          end
+        end
+      end
+
+      concerning :TurnMethods do
+        attr_writer :turn_info
+
+        def turn_info
+          @turn_info ||= TurnInfo.new
+        end
+      end
+
+      concerning :PieceCountCheckMethods do
+        # 両者の駒を一つに集める
+        def to_piece_box
+          piece_box = PieceBox.new
+          piece_box = players.inject(piece_box) { |a, e| a.add(e.piece_box) }
+          piece_box.add(board.to_piece_box)
+        end
+
+        # 足りない駒が入っている箱を返す
+        def not_enough_piece_box
+          all = PieceBox.real_box
+          all.safe_sub(to_piece_box)
+        end
+      end
+    end
+  end
+end