happycola233/tchMaterial-parser：README 來源編輯指南

happycola233/tchMaterial-parser 的 README 將專案描述為「国家中小学智慧教育平台 电子课本下载工具，帮助您从智慧教育平台中获取电子课本的 PDF 文件网址并进行下载，让您更方便地获取课本内容。」。本文只整理倉庫可直接核對的內容，不把 star、Fork 或宣傳語當成品質證明。README 在「tchMaterial-parser」下寫到：感谢每一位使用者与贡献者，本项目于 2025 年 5 月登上 GitHub Trending 总榜第 3 名（单日新增约 400 Stars），并获得 Trendshift Python 日榜第 3 名 🎉。這說明的是專案邊界，不是已完成的生產驗證。

從 README 的「✨ 工具特点」與相關條目，可以先判斷它是否處理你的實際問題：🔑 支持 Access Token：支持用户手动输入 Access Token 并自动保存，下次启动可自动加载。。若需求不同，不應只因專案熱度就採用。本文保留原始專案名、命令與元件名，方便回到一手來源核對。 README 另外列出一項可核對的資訊：🔖 自动添加书签：若开启 "添加 PDF 书签"，则会在下载完成后为电子课本添加书签，在查看 PDF 时可更方便地跳转到指定位置。。這類原文條目可用來設計試跑步驟，但不能取代實際環境測試。

README 將運作方式分散在「GitHub Releases」等段落。可確認的線索包括：本项目的 GitHub Releases 页面会发布适用于 Windows、Linux、macOS 的 x8664、Arm64 架构的程序。。本文不把未寫出的架構、效能或安全邊界補成結論；真正的執行鏈仍要配合目錄、設定檔與版本標籤檢查。

第一次安裝應從 README 指出的入口開始。目前可核對的命令是： git clone https://github.com/happycola233/tchMaterial-parser.git cd tchMaterial-parser pip install . python ./src/main.py 如果倉庫沒有命令，本文不會自行編造步驟，而是建議先閱讀「📖 目录」，確認系統依賴、預設埠與首次初始化。

日常使用取決於專案文件。README 的「GitHub Releases」段落提到：> [!WARNING] > 在 macOS 操作系统中，由于没有签名，系统会报告文件已被损坏，因此需要先运行 xattr -cr /path/to/tchMaterial-parser.app 来移除应用的 "隔离" 属性。为了保证 Access Token 的持久化，建议将应用移动到 /Applications 目录下再运行。。設定檔、環境變數、權限與資料目錄只在來源明確時才會記錄；沒有寫出的預設值，應在測試環境驗證並保留回滾副本。 同一部分也提到：🔎 资源快速搜索：可按资源名称或 "学段、学科、年级" 等分类组合搜索，结果会自动展开；长名称支持横向滚动，悬停时可查看完整信息和大尺寸封面。。

README 能確認的限制比宣傳頁更重要。現有來源沒有證明happycola233/tchMaterial-parser具備固定相容矩陣、服務等級、效能基準或長期支援承諾。README 只明確寫到「在 Windows 10、Windows 11 与 Windows Server 2025 上，您可以直接在终端中输入以下命令来安装本程序：」。這些未知項應列入選型紀錄，不要改成肯定句。