Communitygithub.com

yuanyuanyuan430/ganhuo-textbook-downloader

Habilidade do Claude para classificar e baixar PDFs de livros didáticos chineses (ChinaTextbook), ciente da província.

O que é ganhuo-textbook-downloader?

Esta habilidade do Claude permite que um desenvolvedor ou agente de IA traduza solicitações em linguagem natural sobre livros didáticos chineses (K-12 e universitários) em uma lista ordenada de candidatos e, quando seguro, realize o download do arquivo PDF diretamente do repositório `TapXWorld/ChinaTextbook`. Ela otimiza a busca usando pistas de província, cidade, série, disciplina, volume e edição, além de suportar OCR a partir de capturas de tela da capa ou página. A habilidade é útil para localizar rapidamente a versão correta do livro didático (ex: '江苏九上译林英语', '大一高数同济第七版上册') sem navegar manualmente por grandes repositórios, e evita downloads automáticos quando a correspondência é ambígua ou há múltiplos candidatos. Baseada em scripts Python que rodam localmente, ela se integra ao ambiente `CLAUDE_SKILL_DIR` e oferece explicações detalhadas sobre o ranking, garantindo transparência e controle ao usuário.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Ganhuo Textbook Downloader

Use esta habilidade para transformar uma solicitação em linguagem natural de livros didáticos em candidatos classificados e, quando seguro, em um arquivo de livro didático baixado do TapXWorld/ChinaTextbook.

Fluxo de Trabalho

  1. Extraia pistas de província/cidade, etapa, série, disciplina, versão, semestre/volume, edição, editora/escola e quaisquer pistas exatas de título.
    • Exemplos K-12: 江苏九上译林英语, 安徽合肥三年级语文上册.
    • Exemplos universitários: 大一高数同济第七版上册, 本科线代同济第五版, 概率论浙大四版.
    • Exemplos de imagem de capa/página: texto legível por OCR como 新版译林 九上教材, Know yourself, Welcome to the unit.
  2. Pesquise primeiro. Palavras de província e cidade são usadas para classificação, não como tokens de caminho obrigatórios:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "安徽 合肥 小学 三年级 语文 上册" --explain
  1. Se o usuário fornecer uma captura de tela da capa/página, passe-a como uma pista de OCR:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "新版译林 九上 英语" \
  --cover-image "/absolute/path/to/screenshot.png" \
  --explain
  1. Se o usuário já forneceu texto extraído da capa, passe-o diretamente:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  search "九上英语" \
  --ocr-text "新版译林 九上教材 Know yourself Welcome to the unit" \
  --explain
  1. Se um candidato corresponder claramente à solicitação do usuário, faça o download:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
  download "安徽 合肥 小学 三年级 语文 上册" \
  --out "$HOME/Downloads/ChinaTextbook" \
  --auto
  1. Se vários candidatos forem plausíveis, mostre a lista numerada e pergunte ao usuário qual deles baixar. Preferências de província e pistas de capa/OCR são dicas de classificação.
  2. Retorne o caminho do arquivo local, o caminho upstream no GitHub, a URL de origem, o status de arquivo dividido e os motivos da classificação.

Comandos

Pesquisar com inferência de província:

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

Sobrescrever província quando o usuário implica uma localização fora do texto:

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

Baixar por número de resultado:

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

Pesquisar livros didáticos universitários:

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

Executar a verificação integrada após editar o script:

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

Correspondência de Província

O script usa pistas de província/cidade para impulsionar versões prováveis de livros didáticos. Ele não afirma uma atribuição oficial de província para livro didático.

  • Para 语文, 道德与法治 e 历史, prefira 统编版 porque são disciplinas comumente unificadas.
  • Para outras disciplinas, use dicas de preferência de província/cidade, como 江苏 -> 苏教版/译林版, 北京 -> 北京版/外研版/北师大版, 上海 -> 沪教版, 深圳/广东 -> 北师大版/沪教版/人教版 e alternativas mais amplas 人教版.
  • Se o usuário nomear explicitamente uma versão, a versão explícita vence sobre as preferências de província.
  • Se a solicitação for vaga ou as classificações dos candidatos forem próximas, peça ao usuário para escolher.

Leia references/province-preferences.md apenas quando precisar explicar a limitação ao usuário ou atualizar a tabela de preferências de província.

Correspondência Universitária

O repositório upstream atualmente armazena recursos universitários sob 大学/, principalmente disciplinas relacionadas à matemática, como 高等数学, 线性代数, 离散数学 e 概率论.

  • Mapeie linguagem natural como 本科, 高校, 大一, 高数, 线代, 离散, 数统 e 概率统计 para termos do repositório.
  • Use pistas de edição e origem como 同济, 浙大, 第五版, 第六版, 第七版, 四版 e 原书 como termos de correspondência fortes.
  • Rebaixe materiais não principais, como 答案, 习题, 全解, 解析, 学习辅导, 附册 e 指南, a menos que o usuário os solicite explicitamente.
  • Se a edição universitária solicitada estiver ausente, relate os candidatos mais próximos em vez de fingir que uma aproximação está correta.

Correspondência de Capa e OCR

O script pode usar texto legível de uma captura de tela de capa ou página. Ele executa tesseract OCR local quando disponível e aceita --ocr-text quando o texto já foi extraído.

  • Pistas úteis: título, versão/editora, série/volume, título da unidade, edição, autor/editor, nomes da escola/editora.
  • Pistas ruidosas da interface do usuário do telefone/visualizador de PDF são filtradas quando possível.
  • Pistas de OCR ajudam na classificação; não são prova de que a edição exata existe no repositório upstream.

Limites

  • Baixe apenas arquivos upstream do GitHub publicamente acessíveis. Não burle login, pagamento, direitos autorais ou restrições de acesso.
  • Não prometa que a classificação por província é autoritativa ou atual para todas as escolas.
  • Não faça download automático quando a série, disciplina ou volume do livro não estiver claro e houver múltiplos candidatos.
  • Não faça download automático de uma edição universitária aproximada, como uma quinta edição quando o usuário pediu a sexta edição.
  • Arquivos divididos, como .pdf.1 e .pdf.2, são fragmentos de bytes; o script os baixa em ordem numérica e os concatena em um único .pdf.

Habilidades Relacionadas