Smart Connections로 관련 Obsidian 노트 찾기

같은 문제를 다룬 노트라도 서로 다른 단어를 쓰면 키워드 검색으로 찾기 어려울 수 있습니다. Smart Connections는 문장의 의미가 비슷한 노트를 후보로 보여줍니다. 후보의 관련성과 적용 조건은 원문에서 확인해야 합니다.

Smart Connections는 Obsidian 플러그인입니다. 문장의 의미를 숫자 배열로 표현하는 임베딩을 만들고 배열 사이의 유사도를 계산해 관련 노트와 문단을 보여줍니다.

설치 후 관련 노트 열기

Obsidian 설정의 커뮤니티 플러그인에서 Smart Connections를 찾아 설치하고 활성화합니다. 이 글에서 참고한 v4 공식 안내는 기본 로컬 모델로 임베딩을 만드는 절차를 설명합니다. 설치한 버전에 따라 메뉴와 설정이 다를 수 있습니다. 이 단계에서는 외부 API 키를 입력할 필요가 없습니다. 초기 인덱싱이 끝나기 전에는 결과가 적거나 아직 나오지 않을 수 있습니다.

설명이 몇 문단 있는 노트를 열고 왼쪽 리본의 Connections 아이콘을 선택합니다. 명령 팔레트에서 Open: Connection view를 실행하는 방법도 있습니다. 현재 노트와 관련된 후보가 목록에 나타나면 하나를 펼쳐 내용을 읽고 원본 노트로 이동합니다. 필요한 결과를 편집 중인 노트로 드래그하면 링크를 만들 수 있습니다.

“외부 API 비용” 노트에 호출량과 단가의 관계를 적었다면 “호출 횟수별 과금” 기록을 후보에서 찾아봅니다. 같은 태그가 없어도 설명이 비슷하면 후보가 될 수 있습니다. 원본을 펼쳐 호출량의 정의가 현재 계산과 맞는지 읽습니다. 검색어를 직접 입력하려면 Open: Lookup view를 사용할 수 있습니다.

Smart Connections 공식 저장소의 관련 노트 목록 예시입니다. 사용자는 후보 노트를 열어 현재 노트와 어떤 내용이 관련되는지 확인할 수 있습니다. 공식 예시의 설명

정확한 문자열과 비슷한 의미

키워드 검색은 정확한 이름이나 오류 메시지를 찾는 데 적합합니다. ECONNRESET처럼 그대로 기록한 문자열을 찾을 때는 의미가 비슷한 문장보다 정확한 일치가 중요합니다.

사용자는 원문을 확인해 실제로 관련된 노트에 직접 링크를 남길 수 있습니다. 관련 자료를 찾기 위해 기존 폴더와 태그를 모두 바꿀 필요는 없습니다.

로컬 모델과 원격 연결의 범위

Smart Connections는 로컬 임베딩 모델을 활용할 수 있습니다. 노트의 임베딩과 유사도를 계산하려고 외부 API 키를 반드시 준비해야 하는 것은 아닙니다. 다만 로컬 임베딩을 사용한다는 설명만으로 모든 부가 기능의 통신 방식까지 확정할 수는 없습니다.

설치된 버전에서 선택한 모델과 제공자, 원격 서비스 연결 여부를 확인합니다. 모델 파일을 내려받는 과정과 노트 내용을 원격 서비스에 보내는 과정도 구분합니다. 민감한 자료를 다룬다면 실제 설정과 사용할 기능을 기준으로 전송 범위를 판단해야 합니다.

처리가 끝난 뒤에도 필요한 노트가 나오지 않으면 제외 설정을 확인합니다. 아직 인덱싱 중인 상태와 검색 대상에서 제외된 상태를 구분해야 원인을 찾을 수 있습니다.

과거의 검토와 현재의 결정

관련 노트 목록에서 점수가 높다고 내용이 정확하거나 최신인 것은 아닙니다. 같은 용어를 다루는 오래된 기록이 높은 유사도로 나올 수 있습니다. 반대로 현재 결정에 중요한 짧은 노트는 후보에 잘 나타나지 않을 수 있습니다.

관련 노트를 읽을 때는 작성일과 적용 환경을 확인합니다. 과거에 고려했던 방법과 실제로 채택한 방법을 구분해야 합니다. 예를 들어 “유료 도구 도입 검토” 노트는 구매가 완료됐다는 근거가 아닙니다.

확인한 관계에는 “이 비용 계산에 사용한 호출량 정의”처럼 링크의 이유를 적습니다. 이후 원본의 단가나 정의가 바뀌면 어떤 계산을 다시 검토해야 하는지 찾을 수 있습니다.

알고 있는 사례로 검색 평가하기

플러그인의 효과를 보려면 찾고 싶은 사례를 먼저 정합니다. 작성 중인 기술 노트 하나를 선택하고 이미 알고 있는 관련 기록이 후보로 나오는지 확인합니다. 제목만 비슷한 노트가 과도하게 나오거나 필요한 문단을 찾지 못하면 제외 범위와 모델 설정을 살펴봅니다.

검색 결과를 모두 연결하지 않고 현재 글에서 실제로 사용하는 자료를 선택합니다. “호출 횟수별 과금” 노트를 읽었더라도 과거 요금제를 다룬다면 현재 계산의 근거로 쓰기 전에 적용 시점을 확인해야 합니다.

검색을 평가한 뒤에는 사용한 모델, 찾으려던 노트와 실제 결과를 기록합니다. 필요한 노트가 후보에 나타나는지와 현재 글의 근거로 사용할 수 있는지는 따로 확인합니다.