Communitygithub.com

yuanyuanyuan430/ganhuo-textbook-downloader

Habilidad de Claude para clasificar y descargar libros de texto chinos (PDF) de ChinaTextbook con reconocimiento de provincia.

¿Qué es ganhuo-textbook-downloader?

Esta habilidad permite a un agente de IA (como Claude) convertir una solicitud en lenguaje natural sobre un libro de texto chino en una lista clasificada de candidatos y, cuando sea seguro, descargar el archivo PDF directamente desde el repositorio upstream `TapXWorld/ChinaTextbook`. Es especialmente útil para desarrolladores y educadores que necesitan acceder rápidamente a materiales educativos de China, desde primaria hasta universidad. La habilidad extrae automáticamente información como provincia, ciudad, etapa, grado, materia, versión editorial, semestre y volumen, y utiliza esas pistas para clasificar los resultados. Soporta búsqueda con inferencia de provincia, descarga automática cuando la coincidencia es clara, y permite al usuario elegir entre múltiples candidatos. Además, integra reconocimiento OCR (a través de Tesseract) para procesar capturas de portadas o páginas, lo que mejora la precisión del ranking. La habilidad se ejecuta mediante scripts de Python y está diseñada para usarse con Claude Code, aunque su lógica es transferible a otros entornos de agente que puedan ejecutar scripts locales.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add yuanyuanyuan430/ganhuo-textbook-downloader

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Descargador de Libros de Texto Ganhuo

Usa esta habilidad para convertir una solicitud en lenguaje natural sobre un libro de texto en una lista clasificada de candidatos y, cuando sea seguro, descargar un archivo de libro de texto desde TapXWorld/ChinaTextbook.

Flujo de trabajo

  1. Extrae pistas de provincia/ciudad, etapa, grado, materia, versión, semestre/volumen, edición, editorial/escuela y cualquier pista exacta del título.
    • Ejemplos K-12: 江苏九上译林英语, 安徽合肥三年级语文上册.
    • Ejemplos universitarios: 大一高数同济第七版上册, 本科线代同济第五版, 概率论浙大四版.
    • Ejemplos de imágenes de portada/página: texto OCR legible como 新版译林 九上教材, Know yourself, Welcome to the unit.
  2. Busca primero. Las palabras de provincia y ciudad se usan para la clasificación, no como tokens de ruta obligatorios:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "安徽 合肥 小学 三年级 语文 上册" --explain
  1. Si el usuario proporciona una captura de pantalla de portada/página, pásala como pista OCR:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "新版译林 九上 英语" \
  --cover-image "/absolute/path/to/screenshot.png" \
  --explain
  1. Si el usuario ya ha proporcionado texto extraído de la cubierta, pásalo directamente:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "九上英语" \
  --ocr-text "新版译林 九上教材 Know yourself Welcome to the unit" \
  --explain
  1. Si un candidato coincide claramente con la solicitud del usuario, descárgalo:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "安徽 合肥 小学 三年级 语文 上册" \
  --out "$HOME/Downloads/ChinaTextbook" \
  --auto
  1. Si hay varios candidatos plausibles, muestra la lista numerada y pregunta al usuario cuál descargar. Las preferencias de provincia y las pistas de cubierta/OCR son sugerencias de clasificación.
  2. Devuelve la ruta del archivo local, la ruta upstream de GitHub, la URL de origen, el estado de archivos divididos y las razones de clasificación.

Comandos

Búsqueda con inferencia de provincia:

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

Anular provincia cuando el usuario implique una ubicación fuera del texto:

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

Descargar por número de resultado:

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

Buscar libros de texto universitarios:

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

Ejecutar la autocomprobación incorporada después de editar el script:

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

Coincidencia de provincia

El script usa pistas de provincia/ciudad para potenciar las versiones de libros de texto probables. No afirma una asignación oficial de provincia a libro de texto.

  • Para 语文, 道德与法治 y 历史, prefiere 统编版 porque son materias comúnmente unificadas.
  • Para otras materias, usa pistas de preferencia de provincia/ciudad como 江苏 -> 苏教版/译林版, 北京 -> 北京版/外研版/北师大版, 上海 -> 沪教版, 深圳/广东 -> 北师大版/沪教版/人教版 y alternativas más generales de 人教版.
  • Si el usuario nombra explícitamente una versión, la versión explícita tiene prioridad sobre las preferencias de provincia.
  • Si la solicitud es vaga o las clasificaciones de candidatos son cercanas, pide al usuario que elija.

Lee references/province-preferences.md solo cuando necesites explicar la limitación al usuario o actualizar la tabla de preferencias de provincia.

Coincidencia universitaria

El repositorio upstream almacena actualmente recursos universitarios bajo 大学/, principalmente materias relacionadas con matemáticas como 高等数学, 线性代数, 离散数学 y 概率论.

  • Mapea lenguaje natural como 本科, 高校, 大一, 高数, 线代, 离散, 数统 y 概率统计 a términos del repositorio.
  • Usa pistas de edición y fuente como 同济, 浙大, 第五版, 第六版, 第七版, 四版 y 原书 como términos de coincidencia fuertes.
  • Degrada materiales no principales como 答案, 习题, 全解, 解析, 学习辅导, 附册 y 指南 a menos que el usuario los solicite explícitamente.
  • Si la edición universitaria solicitada está ausente, informa los candidatos más cercanos en lugar de pretender que una aproximación es correcta.

Coincidencia de cubierta y OCR

El script puede usar texto legible de una captura de pantalla de portada o página. Ejecuta OCR local tesseract cuando está disponible y acepta --ocr-text cuando el texto ya ha sido extraído.

  • Pistas útiles: título, versión/editorial, grado/volumen, título de unidad, edición, autor/editor, nombres de escuela/editorial.
  • Las pistas ruidosas de la interfaz de usuario del teléfono/visor de PDF se filtran cuando es posible.
  • Las pistas OCR ayudan a la clasificación; no son prueba de que la edición exacta exista en el repositorio upstream.

Límites

  • Solo descarga archivos de GitHub upstream de acceso público. No eludas restricciones de inicio de sesión, pago, derechos de autor o acceso.
  • No prometas que la clasificación por provincia sea autoritativa o actual para todas las escuelas.
  • No descargues automáticamente cuando el grado, la materia o el volumen del libro no estén claros y existan varios candidatos.
  • No descargues automáticamente una edición universitaria aproximada, como una quinta edición cuando el usuario pidió la sexta edición.
  • Los archivos divididos como .pdf.1 y .pdf.2 son fragmentos de bytes; el script los descarga en orden numérico y los concatena en un solo .pdf.

Skills relacionados