Ganhuo Textbook Downloader
使用此技能,將自然語言描述的教材需求轉換為排行候選,並在安全的情況下,從 TapXWorld/ChinaTextbook 下載教材 PDF 檔案。
工作流程
- 提取省份/城市、階段、年級、科目、版本、學期/冊別、版次、出版社/學校線索,以及任何精確的書名線索。
- K-12 範例:
江蘇九上譯林英語、安徽合肥三年級語文上冊。 - 大學範例:
大一同濟高數第七版上冊、本科線代同濟第五版、概率論浙大四版。 - 封面/頁面圖片範例:可 OCR 讀取的文字,如
新版譯林 九上教材、Know yourself、Welcome to the unit。
- K-12 範例:
- 先進行搜尋。省份和城市字詞用於排行,而非作為必要的路徑標記:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
search "安徽 合肥 小學 三年級 語文 上冊" --explain
- 如果使用者提供封面/頁面截圖,將其作為 OCR 線索傳入:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
search "新版譯林 九上 英語" \
--cover-image "/absolute/path/to/screenshot.png" \
--explain
- 如果使用者已提供提取出的封面文字,直接傳入:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
search "九上英語" \
--ocr-text "新版譯林 九上教材 Know yourself Welcome to the unit" \
--explain
- 如果某個候選項目明顯符合使用者需求,則下載該項目:
python3 "${CLAUDE_SKILL_DIR:-.}/scripts/china_textbook_downloader.py" \
download "安徽 合肥 小學 三年級 語文 上冊" \
--out "$HOME/Downloads/ChinaTextbook" \
--auto
- 如果有多個候選項目看似合理,則顯示編號列表並詢問使用者要下載哪一個。省份偏好與封面/OCR 線索是排行提示。
- 回傳本地檔案路徑、上游 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 檔案。不得繞過登入、付費、版權或存取限制。
- 不得保證省份排名對每所學校都具有權威性或時效性。
- 當年級、科目或冊別不明確且存在多個候選項目時,不得自動下載。
- 不得自動下載近似但錯誤的大學版次,例如使用者要求第六版時下載第五版。
- 分割檔案(如
.pdf.1和.pdf.2)是位元組區塊;腳本會按數字順序下載它們並拼接成一個.pdf檔案。