docs: add learning data guide

This commit is contained in:
Miwa
2025-06-04 09:37:26 +09:00
parent a30e8b27a8
commit 8de2b49974
2 changed files with 31 additions and 0 deletions

View File

@ -5,4 +5,5 @@
azooKey本体については[azooKey/docs](https://github.com/ensan-hcl/azooKey/tree/develop/docs/overview.md)をご覧ください。 azooKey本体については[azooKey/docs](https://github.com/ensan-hcl/azooKey/tree/develop/docs/overview.md)をご覧ください。
開発ガイドは[development_guide.md](./development_guide.md)をご覧ください。 開発ガイドは[development_guide.md](./development_guide.md)をご覧ください。
学習データの保存先やリセット方法については[learning_data.md](./learning_data.md)を参照してください。

30
Docs/learning_data.md Normal file
View File

@ -0,0 +1,30 @@
# 学習データについて
AzooKeyKanaKanjiConverter では、ユーザが変換候補を選択した結果を学習して、次回以降の変換候補の並び替えに利用します。学習結果は `memoryDirectoryURL` で指定したディレクトリに保存されます。
## 保存されるファイル
学習データは内部的に辞書形式のファイルとして保持されます。主なファイルは以下の通りです。
- `memory.louds`
- `memory.loudschars2`
- `memory.loudstxt3`
更新時には一時的に `.2` の拡張子が付いたファイルを作成し、安全に置き換える仕組みになっています。更新処理の詳細は [conversion_algorithms.md](./conversion_algorithms.md) を参照してください。
## ディレクトリの指定
`ConvertRequestOptions``memoryDirectoryURL` に書き込み可能なディレクトリを指定してください。通常はアプリの書類フォルダなどを指定します。英語用と日本語用など、キーボードのターゲットごとに学習データを分けたい場合は、言語ごとに別のディレクトリを指定してください。
```swift
let options = ConvertRequestOptions.withDefaultDictionary(
keyboardLanguage: .ja_JP,
learningType: .temporary,
memoryDirectoryURL: .documentsDirectory,
sharedContainerURL: .documentsDirectory
)
```
## 学習データのリセット
変換候補の長押しから個別に学習をリセットできます。ディレクトリを削除することで全ての学習内容を消去することも可能です。