docs: explain Windows cursor and IME trade-off

refs #1637

1 files changed, 13 insertions, 0 deletions

diff --git a/website/src/content/docs/ja/troubleshooting.mdx b/website/src/content/docs/ja/troubleshooting.mdx
index 3b857512..d1769038 100644
--- a/website/src/content/docs/ja/troubleshooting.mdx
+++ b/website/src/content/docs/ja/troubleshooting.mdx
@@ -12,6 +12,19 @@ herdr status
 
 OS、外側のターミナル名とバージョン、ローカルまたはリモートのどちらか、tmux を使用しているかも記録してください。
 
+## Windows で CJK IME の UI 位置がずれる、またはカーソルがちらつく
+
+Herdr は、ConPTY ベースのマルチプレクサーによる画面再描画中にネイティブカーソルがちらついたり、ジャンプしたり、古い位置を表示したりすることを避けるため、ネイティブ Windows と WSL ではデフォルトでセル描画カーソルを使います。セル描画カーソルは、韓国語、日本語、中国語 IME の変換中テキストや候補 UI が使用するネイティブカーソルの基準位置を提供できません。
+
+IME の変換中テキストや候補ウィンドウが誤った位置に表示される場合は、ネイティブカーソルを有効にしてください:
+
+```toml
+[ui]
+host_cursor = "native"
+```
+
+ネイティブモードでは IME の基準位置が正しくなりますが、出力中にカーソル表示が乱れることがあります。視覚的に安定したカーソルへ戻すには `host_cursor = "drawn"` を設定するか、設定を削除して Windows のデフォルトを使ってください。現在の制限については [Windows ベータ](/ja/docs/windows-beta/) を参照してください。
+
 ## Enter、Tab、Backspace が 2 回入力される
 
 古いターミナルでは、アプリケーションが Kitty キーボードイベント報告を有効にすると、Enter、Tab、Backspace のリリースをプレスと同じバイトとして送ることがあります。送信後は Herdr から重複したバイトを区別できません。