xiaomoBoy/pi-bluebook

What it solves

Pi 학습 블루북은 중국어 초보자를 위한 비공식 학습 매뉴얼로, 완전히 경험이 없는 사람이 Pi Coding Agent(미니멀한 터미널 Coding Harness)를 처음부터 익힐 수 있도록 돕습니다. 해결하는 핵심 문제는 공식 문서가 분산되어 있고 용어가 많아 초보자가 어디서부터 시작해야 할지 모르고, 에이전트가 작업을 실제로 완료했는지 검증하는 방법도 모른다는 것입니다. 이 책은 실제로 실행 가능한 학습 경로를 통해 독자가 먼저 작은 작업을 완료하고 결과를 독립적으로 확인한 다음, 세션, 컨텍스트, 확장 기능 및 장기 워크플로우를 점차 이해하도록 합니다. 단순히 기능 목록을 암기하는 것이 아닙니다.

How it works

전체 책은 "시나리오 → 개념 → 실습 → 검증" 구조로 구성되어 있으며, 각 수업은 독자가 직접 명령을 실행하고 출력을 확인하도록 요구하며, 에이전트가 "완료했다"고 스스로 말하는 것을 완료로 간주하지 않습니다. 메인 라인은 macOS를 기반으로 하며, Windows 사용자를 위해 별도의 Git Bash 중국어 설치 경로도 제공합니다. 내용은 서론, 프롤로그, 5개 모듈(총 14과), 원리를 연결하는 1개 글과 8개의 부속 사례로 구성되어 있으며, 설치, 로그인, 첫 번째 작업, 세션 및 컨텍스트 관리, Skill과 Extension, 하위 에이전트 역할 분담, 장기 작업 및 안전 검증을 다룹니다. 변경되기 쉬운 버전, 인증, 모델 및 명령 정보에는 모두 검증 날짜가 표시되며, Pi 공식 문서와 소스 코드를 기준으로 합니다. 저장소 자체는 VitePress 웹사이트로, 로컬에서 실행하여 미리 볼 수 있으며 Pi나 모델 계정을 설치할 필요가 없습니다.

Who it’s for

주로 중국어 초보자, 특히 Pi Coding Agent를 처음 접하거나 터미널 조작에 익숙하지 않거나 에이전트 워크플로우에 혼란을 느끼는 사람을 대상으로 합니다. 또한 Pi를 시작할 수는 있지만 세션, 컨텍스트, 확장 기능 및 안정적인 워크플로우를 체계적으로 보완하려는 독자에게도 적합합니다. 코드를 작성할 수 없어도 문제를 피드백하거나 실습 기록을 추가하여 이 책을 개선하는 데 참여할 수 있습니다.

Highlights

• 실제 학습 경로: 추상적인 기능 목록이 아닌 설치, 로그인 및 첫 번째 검증 가능한 작업부터 시작합니다
• 독립적 검증 강조: 각 수업은 "시나리오 → 개념 → 실습 → 검증"으로 전개되며 결과를 직접 확인하도록 요구합니다
• 중국어 친화적: macOS와 Windows Git Bash 경로를 모두 제공하며 명령과 조작 설명을 분리하여 배치합니다
• 지속적인 검증 및 업데이트: 버전, 인증, 모델, 명령 등 변경되기 쉬운 정보에 검증 날짜를 표시하고 공식 문서와 소스 코드를 기준으로 합니다
• 완전한 경로: 5개 모듈, 14과, 1개의 원리 글, 8개의 부속 사례로 입문부터 안전 검증까지 모두 다룹니다
• 커뮤니티 유지 관리: 막힌 위치, 작동하지 않는 명령, 누락된 자료 또는 잘못된 링크를 지적하는 것을 환영하며, 기여자는 코드를 작성할 필요가 없습니다