Visual Studio Code 擴充功能 (Beta)
我們的 VS Code 擴充功能可以利用 AI 對數學方程式進行更準確的 OCR，並為使用 VS Code 編寫 LaTeX 的用戶提供上下文感知。 這是一個使用指南，開發者請訪問 我們的倉庫。
警告：此擴充功能正在大力開發中，不提供任何保證。使用風險自負。請參閱 許可證。現階段您須使用第三方提供的 AI 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文件，並通過擴充功能 -> 右上角三個點 -> 從 VSIX 安裝手動安裝。
你不需要安裝桌面版本的 WriteTex 來使用 VSCode 擴充功能。您只需要在您的 iPad/平板電腦上安裝 WriteTex 移動應用程式。
配置設置
安裝後，我們的圖標將出現在您的側邊欄中。單擊它以配置設置。
AI API 配置
此部分類似於其他平台的設置。下面是一個簡單的示例：
| 設置 | 值 |
|---|---|
| API 端點 | https://api.openai.com/v1 |
| 模型 | gpt-5 |
| API 密鑰 | sk-... |
自定義指令 一些額外的提示來指導 AI 模型。例如，您可以添加「對虛數單位使用 \mathbb{i}。」
上下文
- 上下文行半徑 您可以在此處控制上下文的半徑。數字 10 表示上下文是根據光標前 10 行和光標後 10 行構建的。
- 上下文字符限制 上下文中的最大字符數。數字 1000 表示上下文限制為 1000 個字符。
服務管理
服務器狀態顯示在頂部。您可以通過單擊相應的按鈕啟動/停止服務器。啟動服務器以使 WriteTex 的移動應用程式連接到此 VSCode 實例。注意：一次只能運行一個服務器。 如果您想在另一個 VSCode 項目中使用 WriteTex，需要停止當前項目中的 WriteTex 擴充功能的服務器。
連接到擴充功能
確保您的擴充功能已啟用且服務器正在運行。確保只有一個項目正在運行擴充功能服務器。
從 iPhone/iPad
確保您的擴充功能已啟用且服務器正在運行。在您的 iOS 設備上，轉到 AI API 設置 -> VSCode 擴充功能。打開 使用 VSCode，在發現列表中查找您的設備名稱並選擇它。如果您的設備未列出，請嘗試通過在 其他... 中輸入您的計算機 IP 地址進行手動連接。
對於 v2.1 之前的 app 版本：獲取運行 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 擴充功能
- 開始書寫，識別結果將顯示在 VS Code 中的光標位置
調試
檢查清單
- VS Code 擴充功能已啟用
- 只有一個打開的 VS Code 窗口正在運行服務器
- 您的光標放置在具有以下文件擴展名的打開編輯器中：
.tex.latex.markdown.md.rmd.qmd.ipynb - 您的 iPad/平板電腦與您的計算機連接到同一網絡
- 您的計算機防火牆允許傳入連接
- 您的網絡沒有阻止設備之間的通信
- 如果您在桌面上使用 Obsidian 插件，請確保關閉 obsidian。一個文本編輯器中只允許一個 WriteTex 擴充功能實例。
結果出現在 iPad 上但不在 VS Code 中
確保您的光標放置在 VS Code 中。 檢查是否打開了另一個正在運行擴充功能服務器的 VS Code 窗口。如果是，請將其關閉。
在 iPad 的發現列表中找不到您的設備
檢查您的 iPad/平板電腦是否與您的計算機連接到同一網絡。
如果您的設備仍未列出，請嘗試通過在 其他... 中輸入您的計算機 IP 地址進行手動連接。