Visual Studio Code 拡張機能 (Beta)
私たちの VS Code 拡張機能は、AI を活用して数学の方程式に対してより正確な OCR を実行し、VS Code を使用して LaTeX を作成するユーザーに文脈を考慮した認識を提供します。 これは使用ガイドです。開発者の方は、私たちのリポジトリをご覧ください。
警告: この拡張機能は現在開発中であり、いかなる保証も提供されません。自己責任で使用してください。LICENSE を参照してください。現在、この拡張機能を使用するには、サードパーティプロバイダーからの有効な API 設定が必要です。
機能
WriteTex の VSCode 拡張機能は、AI モデルに現在のドキュメントの文脈を提供することで、より正確な OCR 結果を提供します。ユーザーは iPad やタブレットに書き込むだけで、その結果が VSCode のカーソル位置に配置されます。文脈はカーソルの周囲一定範囲内の行から構築されます。
インストール
警告: デバイスがファイアウォールで保護されている場合にのみ、この拡張機能をインストールしてください。信頼できるネットワーク内でのみ拡張機能を有効にしてください。サーバーにはインストールしないでください。
- Microsoft Visual Studio Code ユーザーの場合: 拡張機能ページで「WriteTex」を検索するか、VS Code Marketplace からインストールします。
- VSCode のフォーク版（Cursor, Trae, Antigravity, Kiro, Qoder, Void, VSCodium, Windsurf, Codex など）ユーザーの場合: フォーク版の拡張機能ページで「WriteTex」を検索してみてください。見つからない場合は、リリースプロジェクト から
.vsixファイルをダウンロードし、拡張機能 -> 右上の 3 つの点 -> VSIX からインストール を選択して手動でインストールしてください。
VSCode 拡張機能を使用するために、デスクトップ版の WriteTex をインストールする必要はありません。iPad やタブレットのモバイルアプリのみが必要です。
設定
インストールすると、サイドバーにアイコンが表示されます。それをクリックして設定を行います。
AI API の設定
この部分は他のプラットフォームの設定と同様です。簡単な例を以下に示します：
| 設定項目 | 値 |
|---|---|
| API エンドポイント | https://api.openai.com/v1 |
| モデル | gpt-5 |
| API キー | sk-... |
カスタム指示 (Custom Instructions) AI モデルをガイドするための追加のプロンプトです。例えば、「虚数単位には \mathbb{i} を使用してください」といった指示を追加できます。
文脈 (Context)
- Context Line Radius 文脈の範囲を制御します。10 を指定すると、カーソルの前後 10 行から文脈が構築されます。
- Context Char limit 文脈に含まれる最大文字数です。1000 を指定すると、文脈は 1000 文字に制限されます。
サービス管理
サーバーの状態が上部に表示されます。対応するボタンをクリックしてサーバーを開始/停止できます。モバイルアプリの WriteTex をこの VSCode インスタンスに接続するには、サーバーを開始してください。サーバーは一度に 1 つしか実行できません。 別の VSCode インスタンスでサーバーを開始する場合は、現在のインスタンスのサーバーを停止する必要があります。
拡張機能への接続
拡張機能が有効で、サーバーが実行されていることを確認してください。拡張機能サーバーを実行しているプロジェクトが 1 つだけであることを確認してください。
iPhone/iPad から
拡張機能が有効で、サーバーが実行されていることを確認します。iOS デバイスで、[AI API 設定] -> [VSCode 拡張機能] に移動します。「VSCode を使用」をオンにし、検出リストからお使いのデバイス名を探して選択します。デバイスが表示されない場合は、「その他...」にコンピュータの IP アドレスを入力して手動接続を試みてください。
v2.1 未満の iOS アプリバージョンの場合: VSCode 拡張機能を実行しているコンピュータの IP アドレスを取得します。タスクマネージャー を開き、ネットワークをクリックして IPv4 アドレス を確認します。 設定で、AI API を以下のように設定します：
設定項目 値 API エンドポイント http://あなたのコンピュータのIP:50905/v1 モデル あなたのモデル API キー writetex
Android から
VSCode 拡張機能を実行しているコンピュータの IP アドレスを取得します。タスクマネージャー を開き、ネットワークをクリックして IPv4 アドレス を確認します。 設定で、AI API を以下のように設定します：
| 設定項目 | 値 |
|---|---|
| API エンドポイント | http://あなたのコンピュータのIP:50905 |
| モデル | あなたのモデル |
| API キー | writetex |
Windows/MacOS から
設定で、AI API を以下のように設定します：
| 設定項目 | 値 |
|---|---|
| API エンドポイント | http://127.0.0.1:50905 |
| モデル | あなたのモデル |
| API キー | writetex |
使い方
- サポートされている拡張子のドキュメントを開きます：
.tex.latex.markdown.md.rmd.qmd.ipynb - ドキュメント内にカーソルを置きます
- iPad やタブレットを VS Code 拡張機能に接続します
- 書き始めると、OCR 結果が VS Code のカーソル位置に表示されます
デバッグ
全般的なチェックリスト
- VS Code 拡張機能が有効になっている
- サーバーを実行している VS Code ウィンドウが 1つだけ である
- カーソルが、サポートされている拡張子（
.tex.latex.markdown.md.rmd.qmd.ipynb）の開いているエディタ内にある - iPad やタブレットがコンピュータと同じネットワークに接続されている
- コンピュータのファイアウォールが着信接続を許可している
- ネットワークがデバイス間の通信をブロックしていない
- デスクトップで Obsidian プラグインを使用している場合は、Obsidian を閉じていることを確認してください。テキストエディタ内での WriteTex 拡張機能のインスタンスは 1 つだけ許可されます。
結果が iPad には表示されるが VS Code には表示されない
カーソルが VS Code 内に置かれていることを確認してください。 拡張機能サーバーを実行している別の VS Code ウィンドウが開いていないか確認してください。開いている場合は閉じてください。
iPad の検出リストにデバイスが表示されない
iPad やタブレットがコンピュータと同じネットワークに接続されているか確認してください。
それでもデバイスが表示されない場合は、「その他...」にコンピュータの IP アドレスを入力して手動接続を試みてください。