chenxiachan/textfold

Fold papers, web pages, files, and AI replies into five levels of detail. Zoom from an overview to the original text.

TextFold – 원하는 속도로 긴 문서 읽기

정의

  • 데스크톱 및 CLI 도구로, 모든 텍스트(연구 논문, 웹 기사, PDF, Word 문서, 코드 README, LLM 자체 응답까지)를 전체 단락에서 한 줄 주제 맵까지 5개의 점점 더 짧은 수준으로 접을 수 있습니다.
  • 접기는 이미 보유한 로컬 LLM(Claude, OpenAI, Anthropic, Ollama 등)에 의해 수행됩니다 – TextFold는 콘텐츠를 제3자 서버로 보내지 않습니다.

작동 방식

  1. 입력 – URL(arXiv, PubMed, Wikipedia, GitHub, 모든 웹 페이지)을 붙여넣거나 파일(PDF, Word, PowerPoint, Excel, EPUB, Markdown, CSV, 이미지)을 드롭합니다. Zotero 라이브러리에서 항목을 직접 읽을 수도 있습니다.
  2. 모델 기반 요약 – 연결된 LLM이 5개의 계층적 '레벨'을 생성합니다:
    • 1 전체 – 원본 텍스트.
    • 2 간결 – 1~3개의 핵심 문장(원문 그대로).
    • 3 핵심 – 주요 요점과 그 근거(간결한 문장에서 파생).
    • 4 핵심 메시지 – 섹션당 한 줄.
    • 5 주제 – 문서 전체를 탐색 가능한 지도로 만드는 몇 단어.
  3. 대화형 UI – 핀치 또는 스크롤로 확대/축소, 키 1-5로 레벨 이동, 단락 클릭하여 확장, 하이라이트 및 여백 메모 추가(레벨 간 유지).
  4. 에이전트 통합 – Claude Code 플러그인과 Pi 확장이 모든 LLM 응답을 동일한 5개 레벨로 자동 접어, 두 번째 요약 모델 없이 훑어보거나 깊이 들어갈 수 있습니다.
  5. 내보내기 – 페이지를 단일 HTML 파일(메모 포함, 선택적 PDF, 또는 Markdown/JSON)로 저장하거나 CLI textfold get을 사용하여 접힌 텍스트를 모든 스크립트로 스트리밍합니다.

주요 기능

  • 다중 소스 지원: arXiv, PubMed Central, bioRxiv, medRxiv, Wikipedia, GitHub README, 모든 웹 기사, PDF(내장 PDF 엔진을 통한 스캔 PDF 포함), Word/PowerPoint/Excel, EPUB, CSV, 이미지.
  • 언어 지원: 12개 언어, 수식을 보존하면서 문장 단위로 번역.
  • 로컬 전용: 컴퓨터(macOS, Windows, 또는 Python 패키지를 통한 모든 OS)에서 실행. 계정 불필요, API 키는 추가하지 않는 한 필요 없음.
  • Zotero 통합: Zotero 컬렉션 탐색, 항목 직접 열기, 원본 메타데이터 유지.
  • 에이전트 준비 CLI: python3 -m textfold get <source> --level <level> [--section N]로 문서의 거친-세밀한 뷰가 필요한 파이프라인용.
  • 개방형 형식: 접힌 문서는 문서화된 JSON 유사 스키마(docs/format.md)를 따르므로 다른 도구가 읽고 쓸 수 있습니다.

시작하기

  1. 데스크톱 앱 – GitHub Pages 사이트에서 서명된 macOS 또는 Windows 번들을 다운로드합니다. 자체 Python 런타임이 포함되어 있습니다.
  2. Python 패키지 – pip install textfold 후 python -m textfold serve로 http://localhost:3017에서 로컬 웹 UI를 시작합니다.
  3. 모델 연결 – UI가 Claude Code, Codex 또는 Pi를 자동으로 감지합니다. ChatGPT 플랜을 연결하거나, OpenRouter의 무료 모델을 사용하거나, 설정에서 OpenAI 호환 엔드포인트를 추가할 수도 있습니다.
  4. 시도 – 논문 URL을 붙여넣고, 언어를 선택하고, 1-5 키 또는 핀치 줌으로 탐색합니다.

일반적인 사용 사례

  • 연구자: 수십 개의 새 논문을 훑어보고, 하이라이트를 유지하고, 정확한 단락을 인용하는 LLM 질문을 합니다.
  • 학생: 긴 교과서 장을 탐색 가능한 지도로 바꾸고, 핵심 메시지 레벨만 공부한 후 필요에 따라 세부로 내려갑니다.
  • 개발자: Claude Code 또는 Pi에서 긴 README나 코드 생성 응답을 접어 원래 표현을 유지하면서 토큰 사용량을 줄입니다.
  • 자동화: CLI를 통해 접힌 섹션을 다운스트림 스크립트(예: 요약 파이프라인, 지식 베이스 수집)에 공급합니다.

라이선스

  • Apache 2.0 – 코드를 자유롭게 사용, 수정, 재배포할 수 있습니다.

링크

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트