AI Context: Markdown, 토큰, 폴더 묶음

문서를 Markdown으로 바꾸고, 토큰을 세고, 긴 파일을 나누고, 폴더 전체나 Git diff를 비밀 정보를 가린 하나의 번들로 묶어 어떤 AI 모델에든 넘깁니다. 모든 작업은 내 컴퓨터 안에서만 실행되며 아무것도 업로드되지 않습니다.

AI Context 섹션은 언어 모델에 넘길 파일을 여러분의 컴퓨터에서 직접 준비합니다: 깔끔한 Markdown, 정직한 토큰 수, 컨텍스트 창에 들어가는 조각, 또는 폴더 전체를 하나로 묶은 번들까지. 아무것도 어디로도 전송되지 않으며, 무엇을 붙여 넣을지는 여러분이 정합니다. 1FileTool 1.11.1에서 추가되었습니다.

Convert to Markdown

Convert to Markdown은 Word, Excel, PowerPoint, PDF, HTML, EPUB, CSV, JSON, XML을 받아 모델이 읽기 좋은 Markdown으로 씁니다. 텍스트 레이어가 없는 PDF와 이미지에 OCR을 돌리려면 Read scanned pages를 켜세요. 훨씬 느려집니다.

결과가 준비되면 Copy text는 클립보드에 복사하고, Ask an agent는 이미 여러분의 머신에 있는 어시스턴트와 함께 AI Chat에서 엽니다.

Token Counter

Token Counter는 파일 하나가 토큰을 얼마나 쓰는지, 어떤 모델의 컨텍스트 창에 들어가는지 보여 줍니다. 쓰는 모델에 맞는 Token model을 고르세요: GPT-4o (o200k), GPT-4 (cl100k), Claude (closest match), Rough (chars ÷ 4). Claude의 토크나이저는 공개되어 있지 않으므로 Claude 수치는 추정값입니다.

Split for Context

Split for Context는 긴 문서를 각 조각이 Tokens per part 아래에 머물도록 나누고, 앞 조각의 토큰을 Overlap만큼 반복해 경계에서 맥락이 끊기지 않게 합니다. 나누는 지점은 문단 경계를 먼저, 그다음 줄바꿈을 우선하므로 조각이 문장 중간에서 끝나지 않습니다.

Pack Folder for AI

Pack Folder for AI는 폴더 하나를 번들 하나로 바꿉니다: 파일 트리, 모든 파일의 내용, 전체 토큰 수, 그리고 완료되면 토큰 기준으로 가장 큰 파일 목록까지. 기본적으로 .gitignore(중첩된 것 포함)를 따르고, 무엇이든 쓰기 전에 개인 키, 클라우드와 API 키, 액세스 토큰, 비밀번호 같은 비밀 정보를 가립니다. Respect .gitignore와 Redact secrets는 끌 수 있습니다.

What to pack은 Git 저장소 안에서 범위를 좁힙니다:

Everything: 폴더 안의 모든 텍스트 파일.
Uncommitted changes: 바꿨지만 아직 커밋하지 않은 것.
Staged changes: 인덱스에 올라간 것.
This branch vs its base: 브랜치가 바꾼 모든 것(Compare against를 지정하거나, 비워 두면 main, master, develop을 사용).
Recent commits: 최근 N개의 커밋(How many commits로 지정).

Include the diff를 켜면 unified diff가 번들 맨 위에 들어갑니다.

How much of each file은 큰 프로젝트를 예산 안에 담습니다:

Full contents: 모든 파일의 모든 줄.
Auto (full, then code maps): Token budget의 절반을 쓸 때까지는 전체 파일, 그다음부터는 개요.
Code maps only: 줄 번호가 붙은 선언부만, 토큰은 대략 10분의 1.

Bundle format은 Markdown(기본값), XML(Claude가 읽기 좋음), 일반 텍스트 중에서 고릅니다. Token budget은 그 토큰 수에서 번들을 멈추고(0이면 전부 묶음), Skip files over는 파일 하나의 크기 상한을 정합니다. Copy bundle은 결과를 복사합니다.

어시스턴트에서 쓰거나 자동으로 돌리기

여러분의 AI 어시스턴트도 AI Access를 통해 filetool_to_markdown, filetool_count_tokens, filetool_pack_context로 같은 작업을 실행할 수 있습니다. Convert to Markdown은 Folder Monitor 액션이고, Convert to Markdown과 Split for Context 둘 다 워크플로 레시피의 단계가 될 수 있습니다. Doc to Markdown과 Pack folder for AI는 Home의 빠른 작업이고, 네 도구 모두 메뉴 바의 Tools › AI Context 아래에 있습니다.