サポート

使い方と、困ったとき

Nagi(iOS 版)の使い方とよくある質問です。現在は TestFlight で検証中の開発版で、画面や手順が変わることがあります。

キーボードを追加するには

  1. iPhone の「設定」アプリで、一般 > キーボード > キーボード > 新しいキーボードを追加 を開きます。
  2. 一覧から「Nagi」を選びます。
  3. 文字を入力できる画面で 🌐 キーを押し、「Nagi」に切り替えます。

Nagi アプリのホームにも、同じ手順の案内(初回起動時に表示。ホームの「セットアップの案内を表示」からいつでも開けます)と、 追加できているかの確認表示があります。追加後に一度キーボードを表示してからアプリに戻ると、確認が「OK」になります。

フルアクセスを許可するには(なぜ必要ですか)

  1. 設定 > 一般 > キーボード > キーボード > Nagi を開きます。
  2. 「フルアクセスを許可」をオンにします。

フルアクセスは、キーボードが本体アプリの保存した辞書・モデルを読むために必要です。 Nagi のキーボードは通信を行わず、入力内容を外部へ送信しません(プライバシーポリシー)。

許可しない場合に使える機能は、端末や iOS のバージョンにより異なる場合があります。辞書とモデルの利用に許可が必要になることがあります。入力した文字が失われることはありません。

辞書・モデルを取り込むには

Nagi は辞書とモデルを同梱せず、別途用意する方式です。現在の TestFlight 版では、本体アプリの取り込み機能を使います。

  • 辞書: アプリ内のファイル(バンドル)から、ホームタブの「データ」にある「辞書をバンドルからコピー」で配置します。
  • モデル: 「ファイル」アプリなどに置いた .gguf ファイルを、「モデルをインポート」で選びます。 コピーに数十秒かかることがあります。
  • 「データ」タブで、辞書・モデルの有無、サイズ、使用中のモデルを確認できます。 辞書がない場合は、読みをそのまま返します(モデルも読み込まれません)。

辞書とモデルの出典とライセンスは、アプリの About タブで確認できます。取得元のサイトからの自動取得機能は、準備中です。

変換が遅い・候補が出ないとき

  • 漢字に変換されない: フルアクセスが許可されているか、辞書が取り込まれているかを確認してください (上の 2 項目)。ホームの案内は、フルアクセスが「未設定」のときにその旨を表示します。
  • 候補が出るのに時間がかかる: モデル(LLM)による変換は、端末のメモリに余裕がないと使われず、辞書だけの変換になります。 「データ」タブで「LLM が使える見込み」を確認できます。 設定タブで、LLM の使用やプロファイルを軽い方へ変えると改善することがあります。
  • キーボードが突然閉じる・切り替わる: iOS のキーボード拡張にはメモリの上限があり、超えると OS が終了させます。 その場合は、モデルを小さいもの(xsmall)に替えるか、LLM を無効にしてください。
  • 部分変換(先頭の文節だけを選ぶ)で、残りの文字が二重に出る: 既知の不具合で、調査中です(再現する場合は、下のお問い合わせでお知らせください)。
  • 外付けキーボードでの入力は、キーボード拡張の仕組み上、対象外です(OS 標準の入力を使ってください)。

学習データを削除するには

  1. Nagi アプリの「設定」タブを開きます。
  2. 「学習データをすべて削除」を選び、確認ダイアログで実行します。

削除すると、以前の変換候補の順位は戻りません。学習データは端末内にのみあり、削除後は元に戻せません。 パスワード欄などでは、もともと学習しません。アプリを削除すると、端末内の Nagi のデータはすべて消えます。

キーボードのレイアウトを取り込むには

キーボードの配列は JSON で定義できます。編集ページで作成して書き出したものを、 本体アプリの「レイアウト」タブで取り込みます。

  • JSON の貼り付け、またはファイルから取り込みます。不正な JSON のときは、理由が日本語で表示されます。
  • nagi://layout?data=… 形式のリンクを Safari で開いても取り込めます。
  • 取り込んだレイアウトは、設定タブの「かな」「英字」などの割り当てで選びます。反映は、キーボードを開き直したときです。 不正なレイアウトは既定のものに戻ります。
  • レイアウトは一覧から削除できます(割り当て中のものを消すと、既定に戻ります)。

この機能は開発中で、仕様や画面は変わることがあります。

お問い合わせ

不具合のご報告やご質問は、GitHub の Issues (https://github.com/shiki-01/nagi)にお寄せください。GitHub のアカウントが必要です。

報告のときは、次の情報があると原因を調べやすくなります。

  • 端末の機種と iOS のバージョン、Nagi のバージョン(About タブ)
  • 何をしたら、どうなったか(再現手順)
  • 必要に応じて診断ログ(入力テストタブからコピーできます)

診断ログには、再現のために入力した文字列が含まれることがあります。公開の場に貼る前に内容を確認し、 個人情報やパスワードに当たるものは削除してください。