Visual Studio Code 확장 (Beta)
저희 VS Code 확장은 AI를 활용하여 수학 방정식에 대해 더 정확한 OCR을 수행하고, VS Code를 사용하여 LaTeX를 작성하는 사용자를 위해 문맥 인식 기능을 제공합니다. 이것은 사용 가이드입니다. 개발자분들은 저희 저장소를 방문해 주세요.
경고: 이 확장은 현재 활발히 개발 중이며 어떠한 보증도 제공하지 않습니다. 사용에 따른 책임은 사용자 본인에게 있습니다. 라이선스를 참조하십시오. 현재 이 확장을 사용하려면 타사 제공업체의 유효한 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 인스턴스에 연결되도록 서버를 시작하십시오. 서버는 한 번에 하나만 실행할 수 있습니다. 한 VSCode 인스턴스에서 서버를 시작한 경우, 다른 인스턴스에서 시작하기 전에 먼저 중지해야 합니다.
확장에 연결
확장이 활성화되어 있고 서버가 실행 중인지 확인하십시오. 하나의 프로젝트만 확장 서버를 실행하고 있는지 확인하십시오.
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 창에서만 서버가 실행 중임
- 커서가 지원되는 파일 확장자(
.tex.latex.markdown.md.rmd.qmd.ipynb) 중 하나를 가진 열려 있는 편집기에 있음 - iPad/태블릿이 컴퓨터와 동일한 네트워크에 연결되어 있음
- 컴퓨터의 방화벽이 들어오는 연결을 허용함
- 네트워크가 장치 간 통신을 차단하지 않음
- 데스크톱에서 Obsidian 플러그인을 사용하는 경우 Obsidian이 닫혀 있는지 확인하십시오. 텍스트 에디터에서는 하나의 WriteTex 확장 인스턴스만 허용됩니다.
결과가 iPad에는 나타나지만 VS Code에는 나타나지 않음
VS Code 내에 커서가 놓여 있는지 확인하십시오. 확장 서버가 실행 중인 다른 VS Code 창이 열려 있는지 확인하십시오. 그렇다면 해당 창을 닫으십시오.
iPad의 발견 목록에서 장치를 찾을 수 없음
iPad/태블릿이 컴퓨터와 동일한 네트워크에 연결되어 있는지 확인하십시오.
장치가 여전히 목록에 없으면 기타...에 컴퓨터의 IP 주소를 입력하여 수동 연결을 시도하십시오.