vrc-mod-guide: VRChat アバター改変の中国語リソース集
vrc-mod-guide は VRChat アバター改変の中国語リソース集だ。素体、衣装、アップロード最適化、人気ワールドに入るためのガイド、こういうものは B站、reddit、Booth に散らばっていて、今日開けるリンクが明日には死んでいる。AI を使って2日かけてクロールし、まだ生きている資料を一つのページにまとめた。
純粋な静的単一ページで、ビルドもフレームワークも npm もない。一つの index.html に CSS と JS を全てインライン化し、データは data.js、covers.js、guides.js から <script src> で読み込む。ローカルでは python -m http.server で動き、オンラインでは https://dwgx.github.io/vrc-mod-guide/ を直接開けばいい。リソースは種類ごとに整理してある: 動画、素体、衣装、ワールド、プラットフォーム、コミュニティドキュメント、ツール、記事、上級。さらに自分で書いた中国語ガイド60本を詰め込み、外部リンクにせず全文をページに埋め込んだ——外部リンクは予告なく消える。検索とカテゴリフィルタ付きで、レンダリングは完全にクライアントサイドなので、オフラインでも読める。
ネット上の改変ガイドは互いにコピーし合っていて、クリックすると空リンクだらけということがよくある。だから各項目に信頼性マーカーを付けた: high は公式または生存確認済み、mid は存在は確認できるが逐一照合していない、low は製品 ID か作者が要確認。不確かなものを表に出しておくほうが、かえって安心して使える。
アーカイブが肝だ。Python 標準ライブラリ(urllib、json、サードパーティ製ゼロ)だけを使ったクローラを2つ書いた。一つは B站の web-interface/view エンドポイントを叩き、1473本の動画のタイトル、UP主、再生時間、再生数、概要、サムネイルを全て archive-bili.json にスナップショットする。もう一つは Wayback Machine の CDX エンドポイントを叩き、1039件の reddit 投稿それぞれに statuscode:200 のアーカイブのタイムスタンプと URL を1件ずつ保存する。本文は取らずポインタだけを保存するので、元投稿が削除されてもアーカイブをたどって見返せる。どちらもレート制限と再開機能付きで、クロールが途中で止まっても続きから再開できる。
データ構造は素朴で、1件はだいたいこんな形だ:
{ t:"标题", ch:"频道/UP", id:"视频ID", url:"链接", tag:"分类", v:"high" }
サムネイルは covers.js でマッピングし、B站は公式サムネイルを使い、Booth はリンクだけで作者の画像は転載しない。コンテンツは全て公開検索と公式 API から得たもので、今も少しずつメンテナンスしている。リポジトリ: https://github.com/dwgx/vrc-mod-guide.