【ITニュース解説】I Built a Privacy-First Open-Source Spell Checker in Flutter — Here’s What I Learned

SpellCheckerというプロジェクトは、プライバシーを最優先に考え、オープンソースとして開発されたスペルチェッカーおよび文章作成アシスタントである。プログラミング言語DartとUIフレームワークFlutterを使って構築されており、Android、iOS、Windows、Linux、macOS、そしてWebといった多様なプラットフォームで動作するように設計されている。一見するとシンプルなスペルチェック機能も、深く掘り下げると多くの複雑な問題に直面する。例えば、どのように誤りを検出し、修正候補を順位付けするか、Unicode文字を含むテキストをどう扱うか、そして最も重要なのが、ユーザーのテキストを外部サービスに送信することなく、完全にローカルで処理する方法をどう実現するかといった問いが、このプロジェクトの根幹にある。

既存のスペルチェッカーが多く存在する中で、なぜあえて新しいものを開発したのか。その動機は、「単に誤った単語を検出する」だけでなく、「完全で、説明可能で、オフライン優先、かつ修正動作が予測可能で、他のDartアプリケーションにも再利用できる文章作成ツールを構築する」という、より挑戦的な目標にあった。一般的なスペルチェッカーが辞書引きで単語の正誤を判断するのに対し、SpellCheckerは、まず入力されたテキストをUnicode文字を考慮して単語に分解し、言語に応じた辞書で照合し、修正候補を生成し、その候補を優先順位付けし、問題を表現し、安全な範囲で修正を適用するという一連の複雑なパイプラインを処理する。このパイプラインを構築する過程で、一見些細な決定が、全体のアーキテクチャに大きな影響を与えることが判明した。

このプロジェクトの主要な設計原則の一つが「プライバシー第一」である。ユーザーが入力または貼り付けたテキストは、個人の日記、機密性の高いビジネス文書、未公開のコンテンツなど、極めて個人的な情報を含みうる。SpellCheckerは、これらのテキストがユーザーのデバイスから外部に送信される必要はないと考え、リモートのスペルチェックAPI、文法API、AI書き換えサービス、クラウドストレージ、ユーザーアカウント、クラウド同期、テレメトリーなどを一切使用しない。すべての分析処理はデバイス内で完結する。永続的な設定はローカルで保存されるが、エディタの内容、検出された問題、無視された単語、修正履歴などはクラウドに保存されることはなく、ユーザーのプライバシーを徹底的に保護するように設計されている。

修正の安全性も重要な課題の一つだ。例えば、「Helo world」というテキストで「Helo」が誤字と検出され、「Hello」と修正候補が出たとする。しかし、その間にユーザーがテキストを編集し、元の「Helo」の位置が変わってしまった場合、古い分析結果に基づいて修正を適用すると、意図しない場所のテキストが変更されてしまう可能性がある。これを防ぐため、SpellCheckerは修正を適用する前に、元の分析結果が示していたテキストの「範囲」と「内容」が、現在のテキストでまだ一致しているかを確認する「ソース範囲検証」を行う。もし一致しなければ、不用意な修正は行われない。この考え方は、キャッシュされた分析結果が、ソースが変更された後も常に正しいとは限らないという、ソフトウェアエンジニアリングにおける重要な教訓を示している。また、複数の修正が同時に適用される場合でも、それらが互いに干渉したり、後続の修正の位置をずらしたりする可能性があるため、予測可能で安全な修正順序を確立している。

テキスト処理において、「Hello world」のような単純なASCII文字だけを想定することはできない。現実世界のテキストには、アクセント付き文字、非ラテン文字、結合文字、Unicode記号など、多様な文字が含まれる。SpellCheckerは、これらの「Unicode文字」を正しく認識し、処理するための特別なトークン化（単語に分解する処理）メカニズムを組み込んでいる。これにより、「どの単語が間違っているか」だけでなく、「テキストのこの正確な範囲が間違っている」という情報を正確に特定し、それがFlutterのエディタ内で意味を持つように管理している。

多言語対応もこのプロジェクトの重要な特徴だ。特定の言語に偏ることなく、英語（米国、英国）、ヒンディー語、スペイン語、フランス語、ドイツ語、ポルトガル語（ブラジル）、イタリア語、ベンガル語、マラーティー語、タミル語、テルグ語、ロシア語の13種類のオフラインスペル言語パックが内蔵されている。これにより、ユーザーは明示的に使用言語を選択でき、例えば英語で許容された単語が、他の言語の個人辞書に自動的に追加されるような、不必要な挙動を防ぐことができる。

また、SpellCheckerのアーキテクチャでは、「スペル分析」と「文章分析」を明確に区別している。スペル分析は単語の正誤に焦点を当てるのに対し、文章分析は「重複した単語があるか」「スペースの使い方が正しいか」「文頭が大文字で始まっているか」といった、より広範な文章構造やスタイルに関する問題を探す。現在、重複語、文頭の大文字化、スペースの誤用、句読点の配置など、10の文章ルールが含まれている。ただし、例えばカッコの閉じ忘れのような問題の場合、アプリケーションは問題は検出できるものの、ユーザーがカッコを追加したいのか、それとも元のカッコを削除したいのかを確実に判断することはできない。そのため、このような一部のルールは自動修正ではなく、「助言」として提示される。これは、「検出できたからといって、常に安全に自動修正できるわけではない」という、開発者ツールの設計における重要な原則を反映している。

SpellCheckerは単なるライブラリではなく、その分析エンジンをベースにしたFlutterアプリケーションとしても提供されている。ユーザーはテキストの入力、言語選択、スペル・文章分析の実行、検出された問題のレビュー、候補の確認、キーボードショートカットによる問題間の移動、個人辞書への単語追加、一時的な単語無視、設定のエクスポートなどを行える。特にキーボード操作による効率的なレビューワークフローが重視されている。

このプロジェクトのもう一つの目標は、分析エンジンをFlutterのUIから独立させ、再利用可能なDart APIとして公開することだ。これにより、他のDartやFlutterアプリケーション（デスクトップエディタ、メモ帳、教育ソフトウェアなど）が、SpellCheckerのコア分析機能を、そのUI全体を組み込むことなく利用できるようになる。また、大規模なドキュメントを処理する際には、あまりに多くの問題を一度に表示してもユーザーにとって有用ではないため、UIで表示する問題数を200件に制限する「バウンデッド・リザルト」機能も実装されている。これは、検出された「総問題数」と、現在UIに表示されている「対話可能な問題数」を区別することで、パフォーマンスとユーザー体験のバランスをとっている。

アプリケーションの設定と個人辞書は、エクスポートや転送の際に誤って機密性の高いエディタの内容が混入しないよう、明確に分離されている。アーキテクチャ的には、FlutterのUI層の下に、SpellCheckerEngineとWritingAnalyzerという独立したコアロジック層が存在し、それぞれが言語パック、ランカー、ルールレジストリなどと連携するモジュール化された構造になっている。このドメインロジックはFlutterウィジェットとは独立しているため、テストが容易で再利用性も高い。

複雑なテキスト処理を行うソフトウェアでは、テストが不可欠だ。「Helo」が「Hello」になるような単純なテストだけでなく、空のテキスト、Unicode文字、異なる言語、重複する修正、古いソース範囲、設定の永続性、UIのワークフローなど、多岐にわたるシナリオがテストされている。このプロジェクトでは、現代のAI技術に頼らず、入力、言語、ルール、設定が同じであれば常に同じ分析結果を返す「決定論的な挙動」を重視している。これにより、テストのしやすさ、バグ報告の再現性、修正の信頼性が向上し、ユーザーはアプリケーションがなぜ特定の箇所を指摘したのかをより理解しやすくなる。

Flutterは、このプロジェクトがAndroid、iOS、Linux、macOS、Windows、Webといった多様なプラットフォームで同じアプリケーションアーキテクチャを共有するために選ばれた自然な選択肢だ。これにより、デスクトップ、モバイル、ブラウザ環境を同じコードベースでターゲットにできる。

このプロジェクトの開発を通して、いくつかの重要な教訓が得られた。テキスト処理は表面上はシンプルに見えても、実際に正しくエンジニアリングするのは非常に複雑であること。プライバシーは単なる説明文ではなく、アーキテクチャ設計の中心に据えられるべきであること。予測可能な決定論的ツールは、テスト、デバッグ、信頼性において非常に価値があること。現代のテキスト処理ソフトウェアは、単純なASCIIだけでなく、現実世界の多様なUnicode文字に対応する必要があること。問題を検出することと、その問題を安全に修正することは、まったく異なるエンジニアリング上の課題であること。そして、オープンソースは、より理解しやすく再利用可能なプロジェクトを構築することで、他の開発者からのフィードバックと協力のループを生み出す素晴らしい手段であること。

SpellCheckerは現在も進化中のオープンソースプロジェクトであり、今後の改善点として、さらなる言語パックの追加、より多くの文章ルールの導入、他のDart/Flutterプロジェクトへの組み込みを容易にするためのAPI改善、そして非常に大規模なテキストに対するパフォーマンスの向上が挙げられている。ドキュメントの改善、バグ修正、テストの追加、言語サポートの拡張など、多様な貢献が歓迎されており、開発者はGitHubのリポジトリを通じてプロジェクトに参加できる。このプロジェクトは、単に便利なスペルチェックツールを作るというシンプルなアイデアから始まったが、その実現を通して、言語システム、Unicodeルール、修正の安全性、ドキュメントのサイズ制限、データ永続化の境界、公開API、プラットフォームの制約、テスト、ドキュメンテーション、アクセシビリティなど、広大なエンジニアリングの世界が広がっていることを示している。

SpellCheckerは、ローカル処理、決定論的な挙動、明確な境界、再利用可能なAPI、そしてオープンソース開発という核となる原則を維持しながら、今後も進化を続ける。Flutter、Dart、テキスト処理、開発者ツール、Unicode、オフライン優先ソフトウェア、あるいはオープンソースプロジェクトに興味があるシステムエンジニアを目指す初心者にとって、このプロジェクトは多くの学びと洞察を与えてくれるだろう。