Skip to content

또렷 v0.2.0

Choose a tag to compare

@207studio-founder 207studio-founder released this 07 Nov 23:19
· 4 commits to main since this release

또렷 0.2.0입니다. 쪽마다 구성 요소의 이름과 자리를 묻는 기능과, HWPX의 짧은 글 한 군데를 서식 그대로 바꾸는 기능을 더했습니다.

새로 된 것

  • 구성 요소 질의. render_with_components와 to_pdf_with_components가 쪽마다 문단·표·칸·개체·머리말 같은 구성 요소의 종류, 이름, 자리(pt)를 돌려줍니다. 기존 render, to_pdf의 출력은 그대로입니다.
  • HWPX 짧은 글 바꾸기. hwp_core::hwpx::edit의 find_text, replace_text로 HWPX의 짧은 글 한 군데를 바꿔 새 HWPX로 씁니다. 글자·문단 속성과 줄 간격은 건드리지 않습니다. 같은 글이 여러 군데면 바꾸지 않고 알리며, 여러 서식에 걸친 글, 암호 문서, 변경 추적이 있는 문서, 이진 HWP는 거절합니다.
  • MCP replace_text 도구. 원본은 고치지 않고 확장자가 .hwpx인 새 파일만 만듭니다.

받는 법

또렷은 창이 뜨는 앱이 아닙니다. 터미널에서 쓰는 명령줄 도구 ttoryeot와, Claude Desktop·Claude Code 같은 AI 도구가 부르는 MCP 서버 ttoryeot-mcp입니다. 운영체제에 맞는 파일 하나를 받으세요. 어느 파일에나 두 실행 파일이 함께 들어 있습니다.

Windows 10·11 (64비트)

  • 설치 파일(권장): ttoryeot-v0.2.0-windows-x64-setup.exe
    관리자 권한 없이 %LOCALAPPDATA%\Programs\ttoryeot에 설치하고, 그 폴더를 사용자 Path에 더합니다. 설치한 뒤 새로 연 명령 프롬프트나 PowerShell에서 ttoryeot --help를 입력하세요. 지울 때는 설정 › 앱 › 설치된 앱에서 또렷 (ttoryeot)을 제거합니다.
  • 휴대용 zip: ttoryeot-v0.2.0-windows-x64.zip
    설치하지 않고 원하는 폴더에 풀어서 씁니다.
  • Windows 코드 서명을 하지 않았습니다. 그래서 처음 실행할 때 SmartScreen이 "Windows의 PC 보호" 창을 띄울 수 있습니다. 해시를 확인했다면 추가 정보 → 실행을 누르세요. PowerShell에서는 Get-FileHash <파일> -Algorithm SHA256으로 해시를 봅니다.

macOS

  • Apple 실리콘(M1 이후): ttoryeot-v0.2.0-macos-apple-silicon.tar.gz
  • Intel: ttoryeot-v0.2.0-macos-intel.tar.gz
  • 어느 쪽인지는 Apple 메뉴 › 이 Mac에 관하여에서 확인합니다. "칩"이 Apple M1·M2 같은 이름이면 Apple 실리콘이고, "프로세서"가 Intel이면 Intel입니다. 터미널에서 uname -m을 입력해 arm64가 나오면 Apple 실리콘, x86_64가 나오면 Intel입니다.
  • 207 Studio Developer ID(팀 H32W23F7UW)로 서명했고 Apple 공증을 받았습니다. 압축을 풀고 두 실행 파일을 /usr/local/bin처럼 PATH에 있는 폴더로 옮기세요.

Linux

  • x86_64(glibc 2.17 이상): ttoryeot-v0.2.0-linux-x64.tar.gz
    대부분의 배포판에서 돌아갑니다. Arm Linux용 파일은 아직 없으니 소스에서 설치하세요.

확인과 그 밖의 방법

  • 해시. SHA256SUMS로 받은 파일을 확인하세요.
  • 파일 이름. 처음 올린 0.2.0 파일은 aarch64-apple-darwin 같은 대상 이름을 썼습니다. 지금은 운영체제 이름으로 바꿨고, 안의 실행 파일은 그때와 같습니다.
  • 소스. git clone https://github.com/207studio-oss/ttoryeot 뒤 cargo install --path ttoryeot-cli --locked, cargo install --path ttoryeot-mcp --locked로 설치합니다.
  • crates.io. 아직 올리지 않았습니다.

라이선스

  • 엔진 라이브러리(ttoryeot-hwp-core, ttoryeot)는 AGPL-3.0-only 또는 또렷 상용 라이선스 중 선택입니다. 상용 라이선스 일부 조항은 아직 확정 전이고, 구매 창구는 아직 열리지 않았습니다.
  • CLI와 MCP 서버는 AGPL-3.0-only입니다. 할당자와 krilla는 MIT OR Apache-2.0입니다.
  • 자세한 내용은 LICENSING.md를 보세요.

변경 내용은 CHANGELOG.md에 있습니다.