Kilotest

Kilotest

フロントエンドのウェブ品質をテストし、レポートするアンサンブルサービス

機能

このアプリケーションでは、12種類のルールエンジンを組み合わせてウェブページのフロントエンド品質（アクセシビリティ、ユーザビリティ、HTML、CSS、ARIA、WCAGを含むウェブ標準など）をテストします。

Kilotestが採用するテスト手法については、以下の論文で解説しています。

• 千件のアクセシビリティテストを実行する方法
• Testaro：ウェブアクセシビリティのための効率的なアンサンブルテスト
• アクセシビリティのメタテスト：9つのテストツールの比較

Kilotestは、人間のユーザー向けのウェブサーバー、AIプラットフォーム向けのMCPサーバー（ストリーミング可能なHTTP、認証なし）、プログラムからアクセスするためのAPIとして機能します。

Kilotestのテストは、1つ以上のワーカー（テストエージェント）がKilotestからジョブを取得して実行し、結果のレポートをKilotestに返送することで行われます。これらのエージェントは、Testaroパッケージのインスタンスです。そのため、Kilotestがテストするページは、パブリックインターネット上にある必要はありません。Kilotestのテストを実行するTestaroワーカーからアクセスできれば十分です。したがって、プライベートイントラネット内で稼働する1つ以上のTestaroワーカーは、内部ページだけでなく、イントラネット内からアクセスできる外部ページもテストできます。

Kilotestの本番インスタンスを稼働させるには、負荷に対応するために複数のTestaroワーカーが必要になる場合があります。ウェブページ1つのテストには通常2～4分かかり、ワーカーは一度に1ページしかテストできないためです。

1つのワーカーでローカルに始める

インストール

以下の手順では、ホスト T と K は同じホストでも、異なる2台のホストでも構いません。ホスト T は、Debian stable、Ubuntu LTS、Windows、または macOS のホストを使用できます。ホスト K は、最新の LTS バージョンの Node.js を実行できるサーバーホストであれば使用できます。ホスト T と K が異なる場合は、両方のホストで https トラフィックを許可し、ホスト K でホスト T からの https リクエストを許可する必要があります。

1. ホスト T 上の新しいディレクトリに Testaro プロジェクトをクローンします。
2. そのディレクトリで、Testaro の依存関係をインストールします：npm install。
3. Testaro の依存関係を更新して再ビルドします：npm run deps。
4. ホスト K 上の新しいディレクトリに Kilotest リポジトリをクローンします。
5. そのディレクトリで、Kilotest の依存関係をインストールします：npm install。
6. kilotest ディレクトリにある env.testaro ファイルを testaro ディレクトリ内の .env にコピーし、.env 内の __placeholder__ の値を実際の値に置き換えます。
7. kilotest ディレクトリにある env.example ファイルを、同じディレクトリ内の新しい .env ファイルにコピーし、.env 内の __placeholder__ の値を実際の値に置き換えます。TESTARO_WORKERS は、各 Testaro ワーカーの ID を、その secret と name を含むオブジェクトに対応付ける JSON オブジェクトです。ワーカーの ID と secret は、そのワーカーの .env にある NETWATCH_URL_WORKER_ID と NETWATCH_URL_AUTH の値に一致する必要があります。ワーカーは HTTP Basic の Authorization ヘッダー（id:secret を Base64 エンコードしたもの）を使って各リクエストを認証します。現時点では、このヘッダーは公開済みの Testaro パッケージからはまだ送信されないため、この方式を使うには Testaro の netWatch.js のリクエストコードを更新し、ヘッダーを送信する必要があります（ジョブやレポートの処理方法を変更する必要はありません）。ID は認証情報であり、公開されることはありません。name は Kilotest によってジョブの sources.worker プロパティとレポートの sources.worker プロパティに書き込まれますが、Testaro はこれを読み取ったり変更したりしません。そのため、これは sources.agent（Testaro 独自の、信頼できない自己申告ラベルであり、Kilotest は無視します）とは別のプロパティです。Kilotest が提供するすべてのレポートに表示されても問題のない name を選んでください。ALLOW_INTERNAL_TARGETS は、このデプロイ環境がプライベートアドレス、ループバックアドレス、またはリンクローカルアドレスにあるページをテストするよう誘導されることを許可するかどうかを制御します。既定値から変更する前に、SERVICE.md を参照してください。

使用方法

1. testaro ディレクトリで、Testaro にジョブの待ち受けを開始させます：node call netWatch true nn true。ここで nn は、新しいジョブを確認する間隔を秒単位で指定します。Kilotest は、テストと再テストの「注文」をほぼ即座に審査し、承認後すぐに実行することを約束しています。通常、合計所要時間は2～4分です。この約束を実現するには、nn を小さく保つ必要があります。10～20が適切な値です。
2. kilotest ディレクトリで、Kilotest サービスを起動します：node index。

貢献

貢献を歓迎します！GitHub の issue を使って、議論を始めたり変更を提案したりできます。コードで貢献したい場合は、リポジトリをフォークしてプルリクエストを作成してください。

Kilotest をサービスとして稼働させる

Kilotest をサービスとして稼働させる方法については、SERVICE.md ファイルを参照してください。

Kilotest を AI ツールとして使用する

Kilotest はウェブアプリケーションであるだけでなく、API と MCP サーバーでもあります。AI プラットフォームやモデルは、これらのインターフェースを通じて Kilotest を利用できます。

kilotest.com の MCP サーバーを使用するモデル向けの公開 URL は https://kilotest.com/mcp です。MCP サーバーは複数のレジストリに登録されています。詳細については、AI-TOOLS.md をご覧ください。

関連ドキュメント：

• チュートリアル：AI アシスタントが Kilotest を使用するための認証
• AI-TOOLS.md：Kilotest による MCP プロトコルの実装方法
• Kilotest の機能概要
• llms.txt：LLM 向けの基本ドキュメント
• llms-full.txt：LLM 向けの包括的なドキュメント
• lhm.plugin.json：LobeHub MCP Market への登録に関するドキュメント

メンテナンス

現在デプロイされている Kilotest をメンテナンスする際の通常の手順です。

API の変更がない場合

機能ブランチで API またはツールの契約に変更を加えずに変更を行う場合：

1. すべての変更をステージングしてコミットし、必要に応じてプッシュします。
2. npm run prePR -- <level>（major、minor、または patch）を実行します。
3. プルリクエストを作成します。
4. すべてのチェックが成功したら、main にスカッシュマージし、GitHub で機能ブランチを削除します。
5. npm run postPR を実行します（ブラウザーでの対話型認証が必要です）。
6. npmjs.com で公開処理が完了するまで待ちます。
7. git pull、npm ci、pm2 restart kilotest を使用して、公開サーバーに更新された main ブランチをデプロイします（ただし、npm audit fix は実行しないでください）。

API に変更を加える場合

機能ブランチで API またはツールの契約に変更を加える 場合：

1. lhm.plugin.json：api/schemas.ts と mcp.ts に合うように変換します。
2. llms.txt、llms-full.txt、capability.md、README.md：パラメーター名とパス名を更新します。
3. すべての変更をステージングしてコミットし、必要に応じてプッシュします。
4. npm run prePR -- <level>（major、minor、または patch）を実行します。
5. プルリクエストを作成します。
6. すべてのチェックが成功したら、main にスカッシュマージします。
7. npm run postPR を実行します（ブラウザーでの対話型認証が必要です）。
8. npmjs.com で公開処理が完了するまで待ちます。
9. git pull、npm ci、pm2 restart kilotest を使用して、公開サーバーに更新された main ブランチをデプロイします（ただし、npm audit fix は実行しないでください）。
10. RapidAPI Studio にアクセスし、再生成した openapi-3.0.yaml をアップロードして、Hub Listing → Definitions → CI/CD → Import OpenAPI から API 定義を更新します。

いずれかの手順で問題が発生した場合は、トラブルシューティングの手順について docs/AI-TOOLS.md の詳細をご覧ください。