Prototype

概要

Chrome・ChromeOS・Android向けの設定、コンテンツブロックフィルタ、UserScript、ChMate用正規表現、更新・変換ツール、技術メモをまとめた個人用の試作リポジトリです。

Important

学習・検証結果の記録とバックアップを目的としています。ChatGPTで推敲・整理した内容や環境依存の情報を含むため、正確性・完全性は保証しません。

フィルタ、スクリプト、設定、技術メモは自分の環境で確認したもので、一般向けの手順書・配布物を想定していません。

Workflow

Category	Workflow	Status
Quality	Repository Quality Checks
Build / Sync	Sync and Convert uB-filter-by-kdroidwin (AdGuard Optimized)
Version	Check AdGuard Version Timestamp
Version	Update Version Timestamps (JST)
Maintenance	Update AdGuard Changelogs
Maintenance	Update ChMate NG Version

リポジトリ案内

主要なディレクトリ、原本、生成物、関連資料への導線をまとめています。

項目	主な内容	参照先
AdGuard Custom Rules	AdGuard向けの個人用コンテンツブロックルール、DNSルール、関連CHANGELOG	README / コンテンツブロックフィルタ / DNSフィルタ / ChangeLog
uB-filter-by-kdroidwin (AdGuard Optimized)	上流フィルタをAdGuard向けに変換した自動生成物	README / 生成フィルタ
UserScript	𝕏・YouTubeなどの表示や挙動を調整する個人用UserScript	README / ディレクトリ
NG Word Regex for ChMate	ChMateで使用するJava正規表現	README / 正規表現
Markdown Notes	ChromeOS、Android、GitHub、コンテンツブロックなどの学習・調査メモ	README / ディレクトリ
config / upstream	変換能力の定義、上流情報の追跡・ミラー	config / upstream
scripts / tests	フィルタ変換・更新処理、整合性検査、回帰テスト	scripts / tests
GitHub Actions	品質確認、同期、変換、CHANGELOG追跡などのWorkflow	Actions
License	リポジトリ全体のライセンス情報	LICENSE / LICENSES.md

Note

ルートのdist/にあるフィルタは自動生成物です。生成物を直接編集せず、元ルールまたは変換スクリプトを修正して再生成します。

編集・更新の原則

• AdGuard Custom Rules / AdGuard DNS Custom Rulesの変更時は、変更したファイルの! Version:をJSTの現在時刻（YYYYMMDDHHMM）へ同じコミット内で更新します。
• ルートのdist/は自動生成物のため、直接編集せず、原本または変換処理を修正して再生成します。
• AdGuard Custom Rules/ChangeLog/とupstream/は上流情報の追跡・ミラー用で、取得スクリプトや追跡設定から更新します。
• Markdown Notes/やChatGPTで推敲した内容は、重要な技術情報を可能な限り一次情報・公開ソース・対象バージョン・実環境で再確認します。

自動更新と品質確認

GitHub Actionsで、更新処理・変換・品質確認を自動化しています。

• フィルタ・コードの整合性、回帰テスト、構文・Lintを自動検査します。
• 対象ディレクトリの変更をmainへpushします。
• push後、対応するVersionメタデータをGitHub ActionsでJSTの現在時刻へ同期します。
• AdGuard Custom Rules / AdGuard DNS Custom Rulesでは、Pull Request時にルール変更と! Version:の更新が同じコミットに含まれていることをCIで検証します。
• Workflow失敗時は原因を確認して修正し、必要に応じて再発防止策を反映します。
• uB-filter-by-kdroidwin (AdGuard Optimized)の定期同期・変換を行います。
• AdGuard公式CHANGELOGを定期確認します。

ローカルで主要な検査を実行する場合：

npm ci
python -m pip install -r requirements-ci.txt
python scripts/check_adguard_filter_integrity.py
python scripts/check_adguard_user_rule_edit.py
python -m unittest discover -s tests -v
npm run lint:markdown
npm run lint:adguard

方針

• このリポジトリは、個人の学習記録、検証ログ、設定バックアップとして維持します。
• 技術情報を確認する際は、対象プロジェクトの公式ドキュメント、公式リポジトリ、公開ソース、CHANGELOG、Issuesなどの一次情報を優先します。
• 互換性を推測だけで拡張せず、必要な検証や回帰テストを行ってから変換処理・設定を変更します。
• 誤ブロック、互換性、視認性、性能、保守性、プライバシーなどのトレードオフを考慮します。
• 自動生成物は原則として直接編集せず、原本または変換処理を修正して再生成します。
• 製品のUI名や機能名を記載する場合は、可能な限り対象バージョンの公式表記に合わせます。