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
- 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.
- Exemplos K-12:
- 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
- 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
- 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
- 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
- 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.
- 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.1e.pdf.2, são fragmentos de bytes; o script os baixa em ordem numérica e os concatena em um único.pdf.