tchmaterial-parser: TCH素材データを読むための解析範囲

tchmaterial-parserで見る対象と設計上の焦点

README は、tchMaterial-parser を国家中小学智慧教育平台（basic.smartedu.cn）の電子教科書コーナー向けのダウンロードツールだと説明している。使い方は、電子教科書のプレビューページの URL をツールに貼り付けると、その URL を解析して PDF ファイルをダウンロードし、各ファイルに教科書名をデフォルトのファイル名として付ける。プロジェクト自身の免責事項には、このツールはダウンロードの便宜を提供するだけで、リソース自体を保存せず、すべてのコンテンツはプラットフォームから直接取得されるとある。README はまた、2025 年 5 月に GitHub Trending 総合ランキングで 3 位（1 日で約 400 スター増）になり、Trendshift の Python 日次ランキングでも 3 位になったと記している。リポジトリのメタデータには、5,977 スター、741 フォーク、未解決の Issue が 4 件と記録されている。

このプロジェクトの判断軸は、TCH形式の素材をどこまで解析し、どの構造を利用側へ返すかです。READMEに書かれた対応対象とサンプルの入力、出力形式を分けて読み、拡張子が同じでも作成元や版が違うデータを同一視しないことが重要です。 tchMaterial-parserでは第1節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

tchmaterial-parserで見る導入条件と依存関係

README には 8 つの機能が列挙されている。一括ダウンロードは、複数のプレビューページ URL を一度に入力できる。ファイル名は教科書名が自動的にデフォルトとして使われる。"PDF しおりを追加"オプションを有効にすると、ダウンロード完了後にしおりが追加され、閲覧時に指定した位置へジャンプしやすくなる。Access Token は手動で入力でき、自動保存され、次回起動時に自動で読み込まれる。リソース検索は、リソース名または"学段・学科・学年"などの分類の組み合わせで行え、結果は自動的に展開され、長い名前は横スクロールに対応し、ホバーすると完全な情報と大きな表紙画像が表示される。UI は高 DPI 画面に対応し、ダークモードは起動時にシステムに追従し、右上のボタンで手動切り替えもでき、選択は記憶される。Windows、Linux、macOS に対応し、GUI が必要。

パーサーでは正常な素材だけでなく、空の項目、未知のタグ、壊れた参照、文字コードの違いが結果を左右します。素材に含まれるフィールド名と、ライブラリが返すオブジェクトの対応を小さな fixture で確認し、READMEにない補完動作は機能として扱いません。 tchMaterial-parserでは第2節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

tchmaterial-parserで見る処理経路と設定項目

README には 4 つのインストール経路が記載されている。GitHub Releases は Windows、Linux、macOS 向けに x86_64 と Arm64 のビルドを提供し、ダウンロード後に追加のインストール手順は不要。macOS では署名がないため、システムがファイルを破損と報告するので、最初に xattr -cr /path/to/tchMaterial-parser.app を実行して隔離属性を解除する必要があり、Access Token の永続化のためには /Applications ディレクトリに移動することが推奨されている。WinGet は Windows 10、11、Windows Server 2025 に対応し、コマンドは winget install tchMaterial-parser。Arch Linux ユーザーは AUR から yay -S tchmaterial-parser でインストールできる。ソースから実行するには Python 3.10 以上が必要で、README の手順は git clone、cd、pip install .、python ./src/main.py。GUI は Tkinter ベースで、一部の Linux ディストリビューションでは python3-tk の個別インストールが必要。最小構成のシステムでは中国語フォントと絵文字フォントが不足している場合もある。自分で実行可能ファイルをパッケージ化する場合は、pyinstaller をインストールして pyinstaller ./tchMaterial-parser.spec を実行し、出力は dist ディレクトリに置かれる。

導入前はリポジトリのサンプルを1件ずつ読み、入力ファイル、標準出力または戻り値、例外の発生箇所を保存します。大量変換に進む前に、元ファイルと再出力の差分を比較できるテストを用意するのがこのプロジェクトに合った確認手順です。 tchMaterial-parserでは第3節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

tchmaterial-parserで見る出力と運用記録

使い方は 3 つのステップに分かれている。最初に、電子教科書のプレビューページ URL をテキストボックスに貼り付ける。複数 URL に対応し、1 行に 1 つ入力する。2 番目に、必要に応じて Access Token を設定する。v3.1 以降、このステップは必須ではなくなり、設定しない場合はツールが別の方法でダウンロードするが、README はその方法が長期的には有効でないと警告し、Token の設定を推奨している。Token の取得方法は、ブラウザでプラットフォームにログインし、開発者ツールのコンソールを開いて、提供された JavaScript スニペットを貼り付ける。スニペットは localStorage のキー名が ND_UC_AUTH で始まるエントリから access_token を読み取り、コンソールに出力してコピーできるようにする。README は、コードを貼り付ける前にログインすること、"フィルタ"や"フィルター"ではなく">"の後に貼り付けること、警告が出たら"允许粘贴"と入力してから貼り付けることを注意点として挙げている。3 番目に"下载"ボタンをクリックすると、ツールが自動的に解析してダウンロードし、教科書名でファイルを保存する。PDF しおり設定を有効にしていれば、ダウンロード完了後にしおりも追加される。

このプロジェクトの判断軸は、TCH形式の素材をどこまで解析し、どの構造を利用側へ返すかです。READMEに書かれた対応対象とサンプルの入力、出力形式を分けて読み、拡張子が同じでも作成元や版が違うデータを同一視しないことが重要です。 tchMaterial-parserでは第4節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

tchmaterial-parserで見る対応範囲の読み方

FAQ には、OS ごとの Token の保存場所が記載されている。Windows ではレジストリの HKEY_CURRENT_USER\Software\tchMaterial-parser の AccessToken 値に保存される。Linux では ~/.config/tchMaterial-parser/data.json ファイルに保存される。macOS では ~/Library/Application Support/tchMaterial-parser/data.json に保存される。他の OS ではまだ永続化に対応しておらず、README は汎用的な解決策を模索中だと述べている。プライバシーに関して、README はこのツールが Token をアップロードせず、クラウドにも保存せず、ローカルのリクエスト認証にのみ使用すると宣言し、公開の場で Token を共有しないよう注意を促している。Token は失効することがあり、通常は約 7 日間有効で、ダウンロードに失敗したら新しい Token を取得する必要がある。

パーサーでは正常な素材だけでなく、空の項目、未知のタグ、壊れた参照、文字コードの違いが結果を左右します。素材に含まれるフィールド名と、ライブラリが返すオブジェクトの対応を小さな fixture で確認し、READMEにない補完動作は機能として扱いません。 tchMaterial-parserでは第5節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

tchmaterial-parserで見る制約を切り分ける確認

FAQ は、ダウンロード失敗の原因として次の項目を挙げている。Access Token を設定していない場合、ツールが使う方法が無効になっている可能性がある。Token の有効期限切れ（通常約 7 日）。ネットワーク接続が不安定。入力した URL が無効で、古いリソースが削除されている可能性がある。macOS では、署名のないアプリケーションはシステムによって破損と報告され、実行前に xattr -cr で隔離属性を解除する必要がある。Linux の最小構成インストールでは中国語フォントや絵文字フォントが不足し、インターフェースに四角い文字が表示されることがあり、README は Debian/Ubuntu での fonts-noto-cjk と fonts-noto-color-emoji のインストールコマンドを挙げている。README は、ユーザーに Token の再取得を求める以外に、自動復旧や再試行の仕組みについては説明していない。

導入前はリポジトリのサンプルを1件ずつ読み、入力ファイル、標準出力または戻り値、例外の発生箇所を保存します。大量変換に進む前に、元ファイルと再出力の差分を比較できるテストを用意するのがこのプロジェクトに合った確認手順です。 tchMaterial-parserでは第6節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

tchmaterial-parserで見るライセンスと採用判断

このプロジェクトは MIT ライセンスで公開されており、README と LICENSE ファイルの両方に記載されている。また、Microsoft Fluent Emoji の画像リソースの一部を同じ MIT ライセンスの下で使用している。MIT の条文は、ソフトウェアの使用、複製、修正、統合、公開、頒布、再許諾、販売の権利を認め、保証と責任を全面的に否認している。README の免責事項は加えて、このツールは国家中小学智慧教育平台とは一切の所属・協力関係がないこと、ダウンロードしたリソースの著作権は元のプラットフォームおよび関連権利者に帰属すること、個人の学習と教育の参考にのみ使用し、商業利用や二次頒布は禁止されていることを述べている。README は、セキュリティ保証、サポートの約束、本番環境への対応については何も述べていない。

このプロジェクトの判断軸は、TCH形式の素材をどこまで解析し、どの構造を利用側へ返すかです。READMEに書かれた対応対象とサンプルの入力、出力形式を分けて読み、拡張子が同じでも作成元や版が違うデータを同一視しないことが重要です。 tchMaterial-parserでは第7節の確認対象を独立させ、入力、結果、失敗時の記録を同じ単位で残します。READMEに明記された値と、手元で観測した値を分けて記録することで、tchMaterial-parser固有の判断材料になります。

編集部の結論

このプロジェクトは、READMEが示すPDF. The National Smart Education Platform for Primary and Secondary Schools electronic textbook download tool helps you obtain the PDF file URL of the electronic textbook from the smart education platform and download it, allowing you to obtain textbook content more conveniently.という対象と、記載された環境・権限・入力条件が一致するチームに向きます。採用前には導入前はリポジトリのサンプルを1件ずつ読み、入力ファイル、標準出力または戻り値、例外の発生箇所を保存します。大量変換に進む前に、元ファイルと再出力の差分を比較できるテストを用意するのがこのプロジェクトに合った確認手順です。を実際の小さな構成で確認し、READMEにない性能や互換性を前提にしないでください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes