Communitygithub.com

yuanyuanyuan430/ganhuo-textbook-downloader

지역(성/시)을 고려한 중국 교과서 PDF 검색 및 다운로드를 위한 클로드 스킬입니다.

ganhuo-textbook-downloader란 무엇인가요?

이 스킬은 TapXWorld/ChinaTextbook 저장소를 기반으로, 자연어로 표현된 교과서 요청을 분석하여 적합한 PDF 파일을 검색하고 다운로드합니다. K-12 및 대학 교과서, 표지/페이지 이미지 OCR 등 다양한 입력 방식을 지원하며, 지역(성/시) 정보를 활용해 적합한 교과서 버전을 우선 추천합니다. 주요 특징으로는 검색 결과의 순위를 매기고, 사용자에게 명확한 선택지를 제공하며, 자동 다운로드 전에 안전성을 검증하는 워크플로우가 있습니다. 이 스킬은 Claude Code 환경에서 Python 스크립트를 실행하며, 로컬 tesseract OCR 엔진을 활용해 이미지에서 텍스트를 추출할 수 있습니다. 사용자가 직접 명령어를 입력하거나, 표지 스크린샷을 제공함으로써 더 정확한 검색 결과를 얻을 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add yuanyuanyuan430/ganhuo-textbook-downloader

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Ganhuo Textbook Downloader (간화오 교과서 다운로더)

이 스킬을 사용하면 자연어로 된 교과서 요청을 순위가 매겨진 후보군으로 전환하고, 안전한 경우 TapXWorld/ChinaTextbook에서 교과서 파일을 다운로드할 수 있습니다.

워크플로우

  1. 성/시, 학제, 학년, 과목, 버전, 학기/권, 판본, 출판사/학교 관련 단서 및 정확한 제목 단서를 추출합니다.
    • K-12 예시: 江苏九上译林英语, 安徽合肥三年级语文上册.
    • 대학교 예시: 大一高数同济第七版上册, 本科线代同济第五版, 概率论浙大四版.
    • 표지/페이지 이미지 예시: OCR로 읽을 수 있는 텍스트 (新版译林 九上教材, Know yourself, Welcome to the unit).
  2. 먼저 검색합니다. 성(省)과 시(市) 단어는 순위를 매기는 데 사용되며, 필수 경로 토큰으로 사용되지 않습니다.
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "安徽 合肥 小学 三年级 语文 上册" --explain
  1. 사용자가 표지/페이지 스크린샷을 제공하는 경우, OCR 단서로 전달합니다.
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "新版译林 九上 英语" \
  --cover-image "/absolute/path/to/screenshot.png" \
  --explain
  1. 사용자가 이미 추출된 표지 텍스트를 제공한 경우, 직접 전달합니다.
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "九上英语" \
  --ocr-text "新版译林 九上教材 Know yourself Welcome to the unit" \
  --explain
  1. 하나의 후보가 사용자 요청과 명확히 일치하면 다운로드합니다.
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "安徽 合肥 小学 三年级 语文 上册" \
  --out "$HOME/Downloads/ChinaTextbook" \
  --auto
  1. 여러 후보가 가능성이 있을 경우, 번호가 매겨진 목록을 보여주고 사용자에게 어떤 것을 다운로드할지 물어봅니다. 지역 선호도와 표지/OCR 단서는 순위 힌트로 사용됩니다.
  2. 로컬 파일 경로, 업스트림 GitHub 경로, 소스 URL, 분할 파일 상태 및 순위 이유를 반환합니다.

명령어

지역 추론을 포함한 검색:

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "广东 深圳 七年级 数学 上册" --limit 5 --explain

사용자가 텍스트 외부의 위치를 암시할 때 지역 재정의:

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "七年级 数学 上册" --province 江苏 --explain

결과 번호로 다운로드:

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "上海 高一 英语 必修 第一册" --pick 1

대학교 교과서 검색:

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "大学 高等数学 同济 第七版 上册" --limit 5 --explain

스크립트 편집 후 내장 검사 실행:

python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" self-test

지역 매칭

스크립트는 성/시 단서를 사용하여 가능성 있는 교과서 버전을 우선 추천합니다. 공식적인 성-교과서 할당을 주장하지 않습니다.

  • 语文, 道德与法治, 历史의 경우 统编版을 선호합니다. 이는 일반적으로 통일된 과목이기 때문입니다.
  • 다른 과목의 경우, 성/시 선호 힌트를 사용합니다: 江苏 -> 苏教版/译林版, 北京 -> 北京版/外研版/北师大版, 上海 -> 沪教版, 深圳/广东 -> 北师大版/沪教版/人教版 및 광범위한 人教版 대비책.
  • 사용자가 명시적으로 버전을 지정하면 명시적 버전이 지역 선호도보다 우선합니다.
  • 요청이 모호하거나 후보 순위가 비슷하면 사용자에게 선택을 요청합니다.

references/province-preferences.md는 제한 사항을 사용자에게 설명하거나 지역 선호도 테이블을 업데이트해야 할 때만 참조하십시오.

대학교 매칭

업스트림 저장소는 현재 대학 자원을 大学/ 아래에 저장하며, 주로 高等数学, 线性代数, 离散数学, 概率论과 같은 수학 관련 과목입니다.

  • 本科, 高校, 大一, 高数, 线代, 离散, 数统, 概率统计과 같은 자연어를 저장소 용어로 매핑합니다.
  • 同济, 浙大, 第五版, 第六版, 第七版, 四版, 原书와 같은 판본 및 출처 단서를 강력한 매칭 용어로 사용합니다.
  • 사용자가 명시적으로 요청하지 않는 한 答案, 习题, 全解, 解析, 学习辅导, 附册, 指南와 같은 비주요 자료는 순위를 낮춥니다.
  • 요청한 대학 교과서 판본이 없으면, 근접한 결과를 정확한 것으로 가장하지 않고 가장 가까운 후보를 보고합니다.

표지 및 OCR 매칭

스크립트는 표지 또는 페이지 스크린샷에서 읽을 수 있는 텍스트를 사용할 수 있습니다. 가능할 경우 로컬 tesseract OCR을 실행하고, 텍스트가 이미 추출된 경우 --ocr-text를 허용합니다.

  • 유용한 단서: 제목, 버전/출판사, 학년/권, 단원 제목, 판본, 저자/편집자, 학교/출판사명.
  • 휴대폰/PDF 뷰어 UI에서 발생하는 잡음 단서는 가능한 한 필터링됩니다.
  • OCR 단서는 순위를 돕지만, 정확한 판본이 업스트림 저장소에 존재한다는 증거는 아닙니다.

경계

  • 공개적으로 접근 가능한 업스트림 GitHub 파일만 다운로드하십시오. 로그인, 결제, 저작권 또는 접근 제한을 우회하지 마십시오.
  • 지역 순위가 모든 학교에 대해 권위적이거나 최신이라고 약속하지 마십시오.
  • 학년, 과목 또는 교과서 권이 명확하지 않고 여러 후보가 존재할 경우 자동 다운로드하지 마십시오.
  • 사용자가 6판을 요청했는데 5판이 검색되는 등, 근접하지만 일치하지 않는 대학 교과서 판본을 자동 다운로드하지 마십시오.
  • .pdf.1, .pdf.2와 같은 분할 파일은 바이트 청크이며, 스크립트는 숫자 순서로 다운로드하여 하나의 .pdf로 연결합니다.

관련 스킬