docs: clarify watchdog dependency as Windows-specific issue

Update all README files (EN/ZH/JA) to specify that the watchdog installation
requirement is primarily a Windows compatibility issue. Based on testing,
macOS and Linux users typically don't encounter file watcher problems with
uvx environments.

Changes:
- Updated warning sections to specify "(Windows)" in issue titles
- Clarified that macOS/Linux users usually don't need manual watchdog installation
- Updated troubleshooting sections with platform-specific findings
- Improved user experience by reducing unnecessary setup steps for Unix-like systems

Author: johnhuang316

README.md

@@ -136,7 +136,7 @@ The easiest way to get started with any MCP-compatible application:
 
 **Prerequisites:** Python 3.10+, [uv](https://github.com/astral-sh/uv), and [watchdog](https://pypi.org/project/watchdog/) for file monitoring
 
-> **⚠️ Auto-refresh Issue:** If automatic index updates don't work after setup, try `pip install watchdog`. This may be due to environment isolation preventing file system monitoring. See [Troubleshooting](#troubleshooting) for details.
+> **⚠️ Auto-refresh Issue (Windows):** If automatic index updates don't work after setup on Windows, try `pip install watchdog`. This is a known Windows-specific issue with environment isolation preventing file system monitoring. macOS and Linux users typically don't encounter this issue. See [Troubleshooting](#troubleshooting) for details.
 
 1. **Add to your MCP configuration** (e.g., `claude_desktop_config.json` or `~/.claude.json`):
    ```json
@@ -318,11 +318,11 @@ If the automatic index updates aren't working when files change, this may be rel
 pip install watchdog
 ```
 
-**What we suspect is happening:**
-- The `uvx` environment provides isolated dependency management
-- On some systems (particularly Windows), environment isolation may prevent `watchdog` from accessing the file system monitoring APIs properly
-- Installing `watchdog` in your system Python environment appears to resolve this issue while maintaining all other benefits of `uvx` isolation
-- This is still under investigation, but the workaround above should get you working immediately
+**What we've found:**
+- **Windows**: Environment isolation may prevent `watchdog` from accessing file system monitoring APIs properly
+- **macOS/Linux**: File watcher typically works out-of-the-box with `uvx` without additional setup
+- Installing `watchdog` in your system Python environment resolves Windows issues while maintaining `uvx` isolation benefits
+- This appears to be a Windows-specific compatibility issue with `uvx` environments
 
 **Alternative solutions:**
 - Use manual refresh: Call the `refresh_index` tool after making file changes

README_ja.md

@@ -136,7 +136,7 @@ Code Index MCPは、AIモデルと複雑なコードベースの橋渡しをす
 
 **前提条件：** Python 3.10+、[uv](https://github.com/astral-sh/uv)、ファイル監視用の [watchdog](https://pypi.org/project/watchdog/) がインストール済み
 
-> **⚠️ 自動リフレッシュの問題：** セットアップ後に自動インデックス更新が動作しない場合、`pip install watchdog` を試してください。これは環境分離によりファイルシステム監視が妨げられることが原因の可能性があります。詳細は [トラブルシューティング](#トラブルシューティング) をご覧ください。
+> **⚠️ 自動リフレッシュの問題（Windows）：** Windows でセットアップ後に自動インデックス更新が動作しない場合、`pip install watchdog` を試してください。これは環境分離によりファイルシステム監視が妨げられる Windows 固有の既知の問題です。macOS と Linux ユーザーは通常この問題に遭遇しません。詳細は [トラブルシューティング](#トラブルシューティング) をご覧ください。
 
 1. **MCP設定に追加**（例：`claude_desktop_config.json` または `~/.claude.json`）：
    ```json
@@ -318,11 +318,11 @@ Pythonファイルのみで "API_ENDPOINT" を検索してください
 pip install watchdog
 ```
 
-**推定される原因：**
-- `uvx` 環境は分離された依存関係管理を提供します
-- 一部のシステム（特にWindows）では、環境分離により `watchdog` がファイルシステム監視APIに適切にアクセスできない場合があります
-- システムPython環境に `watchdog` をインストールすることで、`uvx` 分離の他のすべての利点を維持しながら、この問題が解決されるようです
-- これはまだ調査中ですが、上記の回避策ですぐに動作するはずです
+**調査結果：**
+- **Windows**：環境分離により `watchdog` がファイルシステム監視APIに適切にアクセスできない場合があります
+- **macOS/Linux**：ファイルウォッチャーは通常 `uvx` 環境で追加設定なしに動作します
+- システムPython環境に `watchdog` をインストールすることで、`uvx` 分離の利点を維持しながらWindows の問題が解決されます
+- これは `uvx` 環境での Windows 固有の互換性問題のようです
 
 **代替解決策：**
 - 手動リフレッシュを使用：ファイル変更後に `refresh_index` ツールを呼び出す

README_zh.md

@@ -136,7 +136,7 @@
 
 **先決條件：** Python 3.10+、[uv](https://github.com/astral-sh/uv) 和用於檔案監控的 [watchdog](https://pypi.org/project/watchdog/) 已安裝
 
-> **⚠️ 自動刷新問題：** 如果設定後自動索引更新無法運作，請嘗試 `pip install watchdog`。這可能是由於環境隔離導致檔案系統監控無法正常運作。詳情請參閱 [故障排除](#故障排除)。
+> **⚠️ 自動刷新問題（Windows）：** 如果在 Windows 上設定後自動索引更新無法運作，請嘗試 `pip install watchdog`。這是已知的 Windows 特定問題，環境隔離會阻止檔案系統監控。macOS 和 Linux 用戶通常不會遇到此問題。詳情請參閱 [故障排除](#故障排除)。
 
 1. **新增到您的 MCP 配置**（例如 `claude_desktop_config.json` 或 `~/.claude.json`）：
    ```json
@@ -318,11 +318,11 @@ pip install code-index-mcp
 pip install watchdog
 ```
 
-**我們懷疑發生的情況：**
-- `uvx` 環境提供隔離的依賴管理
-- 在某些系統上（特別是 Windows），環境隔離可能會阻止 `watchdog` 正確存取檔案系統監控 API
-- 在系統 Python 環境中安裝 `watchdog` 似乎可以解決此問題，同時維持 `uvx` 隔離的所有其他優點
-- 這仍在調查中，但上述解決方法應該能讓您立即恢復工作
+**我們的發現：**
+- **Windows**：環境隔離可能會阻止 `watchdog` 正確存取檔案系統監控 API
+- **macOS/Linux**：檔案監控器通常可以在 `uvx` 環境中直接運作，無需額外設定
+- 在系統 Python 環境中安裝 `watchdog` 可以解決 Windows 問題，同時維持 `uvx` 隔離的優點
+- 這似乎是 `uvx` 環境的 Windows 特定相容性問題
 
 **替代解決方案：**
 - 使用手動刷新：在檔案變更後呼叫 `refresh_index` 工具