Renju on philipjkim

오목 엔진 Rapfi 해부 Part 5: Rapfi 로 오목·렌쥬 서비스를 만들 때

Thu, 24 Sep 2026 19:21:56 +0900

이 글은 Claude Opus 5.5 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

시리즈의 마지막 편입니다. Part 4 에서 Rapfi 를 명령 단위로 돌려 봤으니, 이번에는 이것을 서비스의 엔진 으로 쓸 때 부딪히는 문제들을 정리합니다. 온라인 대국 사이트의 AI 상대, 기보 분석 기능, 퍼즐(필승 수순 찾기) 앱 같은 것을 염두에 둡니다.

이 글의 코드 인용은 master 커밋 3c94c2a (2026-07-23) 기준이고, 실측은 Apple M1 Max 에서 했습니다.

1. 어디서 돌릴 것인가

가장 먼저 정할 것은 엔진의 위치입니다. 이 결정이 라이선스 의무, 비용, 공정성을 한꺼번에 정합니다.

오목 엔진 Rapfi 해부 Part 4: 직접 빌드해서 돌려 보기

Thu, 24 Sep 2026 19:18:43 +0900

이 글은 Claude Opus 5.5 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Part 3 에서 Rapfi 의 내부를 소스 코드로 봤습니다. 이번 편은 직접 돌려 봅니다. 아래의 모든 출력은 2026-09-24 에 Apple M1 Max (macOS, Apple clang 17) 에서 master 커밋 3c94c2a 를 빌드해 실제로 실행한 결과 입니다. 긴 출력은 줄였고, 줄인 곳은 ... 로 표시했습니다.

1. 빌드와 준비

1.1 받을 것

Windows 라면 공식 릴리스 에 CPU 별 실행 파일과 GUI 가 함께 들어 있어 빌드할 필요가 없습니다. macOS·Linux 이거나 최신 master 를 쓰려면 직접 빌드합니다. 필요한 것은 C++17 컴파일러(README 는 Clang 을 권합니다)와 CMake 입니다.

오목 엔진 Rapfi 해부 Part 3: Rapfi 는 어떻게 수를 고르는가

Thu, 24 Sep 2026 19:14:57 +0900

이 글은 Claude Opus 5.5 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Part 2 에서 Rapfi 는 “평가를 싸게 만들고 깊게 읽는” 엔진이라고 했습니다. 이번 편은 그 말을 소스 코드로 풀어 봅니다. 인용하는 코드와 줄 번호는 모두 dhbloo/rapfi master 커밋 3c94c2a (2026-07-23, 버전 0.43.02) 기준이고, 경로는 저장소 안의 Rapfi/ 디렉터리 기준입니다.

0. 전체 흐름

TURN 7,8 같은 명령을 받은 뒤 좌표를 답하기까지의 흐름입니다.

flowchart TD
 A["명령 수신<br/>TURN / BOARD / BEGIN"] --> B{"탐색 없이<br/>답할 수 있나?"}
 B -->|"빈 판, 즉시 오목,<br/>DB 에 기록된 필승수"| Z["좌표 출력"]
 B -->|"아니오"| C{"탐색기 선택"}
 C -->|"기본값"| D["알파-베타 (PVS)<br/>반복 심화"]
 C -->|"INFO SEARCH_TYPE mcts"| M["MCTS (PUCT)"]
 D --> E["노드마다: 즉승 판정 → TT →<br/>평가 → 가지치기 → 수 정렬"]
 E -->|"깊이 0 도달"| F["VCF 잎 탐색<br/>(사만 이어 두기)"]
 F -.->|"값 반환"| E
 E --> G["스레드 투표로<br/>최선 결과 선택"]
 M --> N["방문 수 + LCB 로<br/>최종 수 선택"]
 N --> Z
 G --> H{"STRENGTH < 100?"}
 H -->|"예"| I["상위 후보 중<br/>무작위 선택"]
 H -->|"아니오"| Z
 I --> Z
 style D fill:#FFD700,color:#000000
 style F fill:#FF9999,color:#000000
 style M fill:#87CEEB,color:#000000

아래에서 판을 읽는 법(1~2절), 평가(3절), 탐색(4~5절), 그 밖의 장치(6~7절) 순으로 봅니다.

오목 엔진 Rapfi 해부 Part 2: Rapfi 와 KataGo, 같은 문제를 반대로 푸는 두 엔진

Thu, 24 Sep 2026 19:13:28 +0900

이 글은 Claude Opus 5.5 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Part 1 에서 오목·렌쥬 오픈소스 생태계의 최상위권이 Rapfi 와 KataGomo 두 갈래라고 했습니다. KataGomo 는 바둑 엔진 KataGo 를 오목용으로 고친 것입니다. 이번 편은 두 엔진을 나란히 놓습니다.

결론부터 말하면 두 엔진은 같은 목표를 정반대의 트레이드오프로 풉니다.

Rapfi: 평가를 극단적으로 싸게 만들고, 그만큼 깊고 빠르게 읽습니다. CPU 한 코어에서 초당 수십만 노드입니다.
KataGo / KataGomo: 평가를 비싸고 정확하게 만들고, 그 평가가 가리키는 곳만 골라서 읽습니다. GPU 에서 초당 수천 번입니다.

1. KataGo 는 무엇인가

KataGo 는 David J. Wu(lightvector)가 만든 바둑 엔진이고, 가장 널리 쓰이는 AlphaZero 계열 공개 바둑 엔진 중 하나입니다. 2026-08-30 에 v1.18.2 가 나왔습니다.

오목 엔진 Rapfi 해부 Part 1: 오목·렌쥬 오픈소스 생태계와 Rapfi 의 역사

Thu, 24 Sep 2026 19:11:13 +0900

이 글은 Claude Opus 5.5 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

바둑에 KataGo 가 있다면 오목·렌쥬에는 Rapfi 가 있습니다. dhbloo/rapfi 는 GPLv3 로 공개된 C++ 오목·렌쥬 엔진이고, 오목 AI 들의 연례 대회인 Gomocup 에서 2022년부터 2026년까지 참가한 리그를 거의 모두 우승했습니다.

이 시리즈는 Rapfi 를 다섯 편에 걸쳐 뜯어봅니다.

편	주제
Part 1 (이 글)	오목·렌쥬 오픈소스 생태계, Rapfi 의 역사
Part 2	Rapfi 와 KataGo 비교
Part 3	Rapfi 는 어떻게 수를 고르는가: 패턴, NNUE, 알파-베타, MCTS
Part 4	직접 빌드해서 돌려 보기: 실측 예제
Part 5	Rapfi 로 오목·렌쥬 서비스를 만들 때

규칙 자체(금수, 26주형, 스왑 오프닝)는 렌쥬 입문 시리즈 에서 다뤘으므로 여기서는 필요한 만큼만 다시 적습니다. 이 시리즈의 소스 코드 인용은 모두 2026-07-23 자 master 커밋 3c94c2a (내부 버전 0.43.02) 기준입니다.

렌쥬(連珠) 입문 Part 4: 26주형 (2) 직접형 13가지

Wed, 23 Sep 2026 10:59:05 +0900

이 글은 Claude Fable 5.1 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Part 3 에서는 백 2수가 대각선으로 붙는 간접형 13주형을 보았습니다. 이번 편은 백 2수가 흑 1수의 바로 옆(가로·세로) 에 붙는 직접형(直接, direct) 13가지입니다. 도해 규약, 이름의 규칙, 평가의 출처는 Part 3 의 1절과 같으므로 여기서는 요점만 다시 적습니다.

흑 1수는 중앙 h8, 백 2수는 바로 위 h9 에 둡니다. 영문·일문 위키피디아의 도해와 같은 규약입니다.
직접형에서는 h 열을 축으로 좌우 대칭인 자리가 같은 주형입니다. 예를 들어 i9 와 g9 는 같은 花月입니다. 도해에는 오른쪽만 그렸습니다.
도해는 15줄 판의 중앙 부근 7×7 이고 라벨은 실제 좌표입니다. 숫자 1·3 은 흑, 2 는 백입니다.
평가는 영문 위키피디아가 정리한 옛 RIF 룰(1997~2007) 기준입니다. 현행 Taraguchi-10 에서 그대로 통하는 값은 아닙니다.

1. 직접형 13주형 요약

번호	한자	한국 한자음	일본어 독음	흑 3수	흑1·흑3 관계	옛 RIF 룰 평가
1D	寒星	한성	칸세이 (Kansei)	h10	간(間)	흑 필승
2D	渓月	계월	케이게츠 (Keigetsu)	i10	계(桂)	흑 필승
3D	疎星	소성	소세이 (Sosei)	j10	간(間)	거의 대등, 약간 백 우세
4D	花月	화월	카게츠 (Kagetsu)	i9	연(連)	흑 필승
5D	残月	잔월	잔게츠 (Zangetsu)	j9	계(桂)	흑 우세
6D	雨月	우월	우게츠 (Ugetsu)	i8	연(連)	흑 필승
7D	金星	금성	킨세이 (Kinsei)	j8	간(間)	흑 필승
8D	松月	송월	쇼게츠 (Shogetsu)	h7	연(連)	약간 흑 우세
9D	丘月	구월	큐게츠 (Kyugetsu)	i7	연(連)	약간 흑 우세
10D	新月	신월	신게츠 (Shingetsu)	j7	계(桂)	흑 우세
11D	瑞星	서성	즈이세이 (Zuisei)	h6	간(間)	거의 대등, 약간 흑 우세
12D	山月	산월	산게츠 (Sangetsu)	i6	계(桂)	흑 우세
13D	遊星	유성	유세이 (Yusei)	j6	간(間)	백 필승

13가지 중 5가지가 흑 필승이고, 백에게 기우는 것은 疎星과 遊星 둘입니다. 간접형(흑 필승 7, 백 우세 3)보다 흑 필승이 적고 중간 평가가 많습니다. 백 2수가 흑 1수와 같은 세로줄에 붙어 있어 흑의 세로 방향 하나를 처음부터 막고 들어가기 때문입니다.

렌쥬(連珠) 입문 Part 3: 26주형 (1) 간접형 13가지

Wed, 23 Sep 2026 10:56:40 +0900

이 글은 Claude Fable 5.1 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Part 2 에서 렌쥬의 첫 세 수는 26가지 정해진 모양 중 하나여야 한다고 했습니다. 이 모양을 주형(珠型) 이라고 부르고, 저마다 이름이 있습니다. 이번 편과 다음 편에서 26가지를 전부 도해로 봅니다. 이번 편은 백 2수가 흑 1수에 대각선으로 붙는 간접형(間接, indirect) 13가지입니다.

1. 도해를 읽는 법

주형은 첫 세 수, 즉 흑 1수·백 2수·흑 3수의 배치로 정해집니다. 흑 1수는 규칙상 중앙 h8 입니다. 백 2수는 중앙에서 한 칸 이내여야 하므로 가로·세로로 붙거나 대각선으로 붙는 두 경우뿐이고, 대칭을 제거하면 각각 한 자리로 고정할 수 있습니다. 이 시리즈는 영문·일문 위키피디아의 도해와 같은 규약을 씁니다.

렌쥬(連珠) 입문 Part 2: 흑은 왜 묶이고, 왜 색을 바꾸는가

Wed, 23 Sep 2026 10:53:10 +0900

이 글은 Claude Fable 5.1 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

Part 1 에서는 렌쥬의 규칙과 오목과의 차이를 정리했습니다. 이번 편은 “왜” 를 다룹니다. 왜 흑에게만 금수가 있는지, 금수만으로는 왜 부족한지, 그리고 게임 시작 직후 두 선수가 색을 맞바꾸는 스왑 규정이 왜 30년 넘게 계속 손질되어 왔는지를 봅니다.

이 편의 시간순 요약은 다음과 같습니다.

시기	사건
1899년	黒岩涙香(필명 高山互楽)이 『萬朝報』 지상에서 오목 선공 필승법을 연재하고, 12월 6일 이 게임을 「聯珠」 로 부르자고 제안
1931년	3세 명인 高木楽山이 15줄 판 채용과 흑의 사사 금수를 제안. 논쟁 끝에 단체 분열의 원인이 됨
1936년	15줄 전용판(十五道盤) 제정. Wágner·Virág 는 이 해에 렌쥬 규칙이 완성되었다고 봄
1966년	분열되어 있던 단체가 社団法人日本連珠社로 통합
1988년	국제연주연맹(RIF) 창립. 일본·소련·스웨덴 세 나라
1989년	제1회 렌쥬 세계선수권(교토)
1992~1994년	Allis 가 무제한 오목과 표준 고모쿠가 15줄 판에서 흑 필승임을 컴퓨터로 증명
1996년	RIF 총회가 새 오프닝 규정(RIF 룰) 채택, 1997년 대회부터 적용
2001년	Wágner·Virág 가 오프닝 규정 없는 렌쥬(금수만 있는 렌쥬)도 흑 필승임을 증명
2008년	RIF 총회가 2009년 대회부터 야마구치 룰 채택
2015년	RIF 총회가 2017년 대회부터 Soosõrv-8 채택
2023년	RIF 총회가 Taraguchi-10 으로 변경 가결. 2025년 세계선수권부터 적용

1. 선공은 얼마나 유리한가: 증명된 사실

오목을 어느 정도 두어 본 사람이면 흑이 유리하다는 것을 감으로 압니다. 그런데 렌쥬의 규칙 체계를 이해하려면 “유리하다” 를 넘어 “필승이 증명되어 있다” 는 사실에서 출발해야 합니다.

렌쥬(連珠) 입문 Part 1: 오목과 렌쥬는 무엇이 다른가

Wed, 23 Sep 2026 10:49:44 +0900

이 글은 Claude Fable 5.1 을 이용해 초안이 작성되었으며, 이후 퇴고를 거쳤습니다.

오목은 규칙을 설명하는 데 한 문장이면 충분한 게임입니다. “돌을 번갈아 놓아 다섯 개를 먼저 이으면 이긴다.” 그런데 이 한 문장짜리 게임을 국제 대회에서 두려면 규칙집이 수십 항목으로 늘어납니다. 흑에게만 금지되는 수가 세 종류 있고, 첫 세 수는 26가지 정해진 모양 중 하나여야 하며, 게임 시작 직후 두 선수가 색을 맞바꿀 기회가 몇 번씩 있습니다. 이 규칙 체계의 이름이 렌쥬(連珠) 입니다.