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
- 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.
- Ejemplos K-12:
- 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
- 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
- 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
- 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
- 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.
- 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.1y.pdf.2son fragmentos de bytes; el script los descarga en orden numérico y los concatena en un solo.pdf.