poi：艦隊これくしょん用ブラウザおよびツールセット

艦隊これくしょん用ブラウザおよびツールセット

poi はゲーム「艦隊これくしょん」（KanColle）向けに設計されたブラウザおよびツールセットです。リポジトリの説明ではスケーラブルとされており、TypeScript で書かれています。プロジェクトのホームページは poi.moe です。リポジトリのメタデータによると、poi は 1,784 スター、353 フォーク、124 の未解決 issue を抱え、アーカイブされていません。README は「スケーラブル」の意味を測定可能な形で定義しておらず、その記述はプロジェクト自身の主張として読むべきであり、検証済みのベンチマークではありません。デフォルトブランチは master で、アーカイブされていないという意味ではプロジェクトはまだ活動していますが、リリース頻度は README に示されていません。

poi の README に記載された機能

README は5つの主要機能を列挙しています。HTTP、Socks5、PAC（実験的とマーク）をサポートするプロキシ、カスタムキャッシュを含むキャッシュシステム、データの合成と分析、通知、そして機能拡張のためのプラグインサポートです。README は利用可能なプラグインのリストへの wiki ページをリンクしています。これらの機能のさらなる技術的説明は README にはなく、正確な動作はソースに詳述されていません。スクリーンショットは別の wiki ページで提供され、README にはプレビュー画像が1枚含まれています。プロキシとキャッシュ機能は、プロトコルや性能の仕様なしに提示されています。

インストールオプションとコミュニティパッケージ

README は2つの公式配布経路を挙げています。GitHub releases と、中国本土向けの npmmirror バイナリパスです。また、AUR/Arch Linux、macOS の Homebrew Cask、Windows の Chocolatey と Scoop のコミュニティメンテナンスパッケージも挙げています。Homebrew コマンドは `brew update && brew cask install poi`、Chocolatey コマンドは `choco install poi` です。AUR と Scoop のエントリはそれぞれのページを指しています。ナイトリービルドは Windows 用が Appveyor、Linux と macOS 用が nightly.poi.moe でホストされており、アーティファクトが定期的に空にされる可能性があると警告されています。README はナイトリーの頻度や保持期間については述べていません。

このリポジトリから実行する

ソースから実行するには、README は3つのコマンドを示しています。`git clone https://github.com/poooi/poi && cd poi`、`npm install`、`npm start` です。詳細については「StartingRunFromThisRepo」というタイトルの wiki ページを参照しています。README は Node.js のバージョン要件、オペレーティングシステムの前提条件、またはこれらのコマンド以外のビルドステップを指定していません。ユーザーが npm をインストールしていることが暗黙の前提ですが、明示的には書かれていません。これらのコマンドがクイックスタートの全内容です。

開発スタックとプラグイン文書

開発セクションでは、poi を支える4つのライブラリが挙げられています。Electron、React、Blueprint、Redux です。README によると、プラグイン開発のドキュメントは dev.poooi.app で英語で提供されています。README はテスト、リンティング、パッケージングのワークフローについては説明していません。デフォルトブランチは master ですが、issue と pull request を開くよう一般的に招待されているだけで、具体的な貢献手順は示されていません。挙げられたライブラリはすべて JavaScript エコシステムでよく知られていますが、poi 内部でどのように使われているかは README では説明されていません。

コミュニティ、サポート、ライセンス

README は、GitHub issues、中国語話者向け Telegram グループ、世界中のユーザー向け Discord チャンネル、QQ グループ、新浪微博を通じて、バグ報告、提案、アイデア、プルリクエスト、開発者を歓迎しています。また、Open Collective を通じて貢献者、バッカー、スポンサーに感謝しています。ソフトウェアは MIT ライセンスでリリースされており、著作権表示を含めることを条件に、コピーの使用、複製、変更、結合、公開、配布、再許諾、販売を許可しています。ライセンスは、ソフトウェアが「現状のまま」提供され、保証がないと述べています。README の別の注記は、ソフトウェアアイコンと SVG アイコンが MIT ライセンスの対象外であり、poi に関連しないプロジェクトでは使用できないことを明確にしています。ライセンスの抜粋は、著作権が 2015 年から 2021 年まで「poi contributors」によって保持されていることも示しています。\n\nこのツールを読むときは、対象とするページやサービスの取得条件を最初に切り分けます。README に記載されたコマンドと設定値を小さな入力で試し、取得結果の形式、ページングの扱い、失敗時の表示を確認してください。外部サービス側の仕様変更やアクセス制限が発生した場合の保証は資料に書かれていないため、定期実行に組み込むなら再試行と保存先を利用側で決める必要があります。リポジトリの機能説明は実装の入口として有用ですが、対応範囲を未記載のサービスまで広げて判断する根拠にはなりません。

編集部の結論

README は poi を、明確なコミュニティ配布モデルを持つ艦これ向けプラグイン拡張ブラウザとして位置づけています。コードの寛容なライセンス、アイコンの制限付きライセンス、複数のコミュニティチャネルの組み合わせにより、利用者と貢献者にとって実用的な構造が与えられています。

公式情報源

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