본문으로 건너뛰기

“이런 검색이 있으면 좋겠다”를 옵시디언 플러그인으로 옮기기까지

강희주

2026.10.22

“이런 검색이 있으면 좋겠다”를 옵시디언 플러그인으로 옮기기까지

1. 학습자 가이드에서 시작한 의미검색 실험

스터디의 야호심님이 공유한 PKM 검색, 제텔카스텐, LLM Wiki에 관한 학습자 가이드를 읽었다. 기록을 모으고 정리하는 데 관심은 있었지만, 가이드를 읽는 것만으로는 내 기록에 어떻게 적용하면 좋을지 잘 와닿지 않았다.

그래서 AI 에이전트인 후와고와 작은 실험부터 해봤다. 가상의 노트를 만들어 놓고, 내가 떠올린 표현으로 검색하면 어떤 글이 나오는지 확인하는 식이었다. 설명을 읽을 때와 달리 직접 검색어를 넣어보니 재미가 있었다. 같은 내용을 다른 말로 물어보기도 하고, 노트와 상관없는 질문도 던져봤다.

여기서 의미검색으로 할 수 있는 일과 기대하면 안 되는 일을 조금씩 구분하게 됐다. 결과가 나온다고 해서 내 질문에 답할 만한 글을 찾았다는 뜻은 아니었다. 검색기가 보여준 구절과, 그 구절을 읽고 AI가 덧붙인 해석도 같은 것은 아니었다.

그래도 내 기록에 적용해 보고 싶었다. 글에 썼던 정확한 단어가 기억나지 않아도, 지금 떠오르는 말로 예전 글을 다시 만날 수 있다면 좋겠다고 생각했다.

2. 검색은 됐지만, 다시 읽고 싶은 글을 찾지는 못했다

이후 실제 위키와 삼성노트에서 옮겨 온 기록에도 의미검색을 해봤다.

삼성노트에서는 ‘사랑하는 사람’으로 검색했다. 예전에 내가 좋아하는 사람의 특성에 관해 쓴 글이 있었는데, 그 글을 다시 읽고 싶었다. 꼭 그 글이 아니더라도 다른 주제처럼 보였던 기록에서 비슷한 생각을 발견할 수 있지 않을까 하는 기대도 있었다.

하지만 기억하던 글은 찾지 못했다. 다른 검색 결과를 읽어도 특별히 흥미가 생기지는 않았다. 검색 결과에 원본정보를 담은 관리용 문서가 섞이기도 했다.

그렇다고 이 경험만으로 의미검색이 쓸모없다고 결론 내릴 수는 없었다. 찾던 글이 검색 대상에 들어 있었는지, 왜 결과에 나오지 않았는지부터 더 확인해야 했다. 다만 검색 결과가 나오는 것과 내가 원하던 경험 사이에 차이가 있다는 점은 분명했다.

내가 바란 것은 검색이 정상적으로 실행되는 일만은 아니었다. 잊었던 글을 다시 읽거나, 생각하지 못했던 글 사이의 연결점을 발견하는 일이었다.

그리고 매번 후와고에게 검색을 부탁하는 대신, 옵시디언에서 직접 표현을 바꿔가며 찾아보고 싶었다. 결과를 누르면 바로 글을 열어 읽을 수 있으면 좋겠다고 생각했다. 여기서 의미검색 플러그인을 만들어 보자는 구상으로 이어졌다.

3. 인터뷰를 하면서 원하는 사용 방식을 정했다

바로 구현하기보다 후와고와 기획 인터뷰를 진행했다. ‘의미검색이 되는 플러그인’이라는 설명만으로는 정해지지 않은 부분이 많았다. 무엇을 찾고 싶은지, 어떤 결과를 보고 싶은지, 글을 찾은 다음 무엇을 하고 싶은지를 하나씩 정리했다.

인터뷰에서 구체화한 내용은 크게 다음과 같았다.

검색의 목적은 다시 읽고 싶은 글을 만나는 것

나는 검색 결과가 얼마나 예측 가능한지보다, 기록을 찾아 읽는 과정이 즐거운지를 중요하게 생각했다. 기억하던 글을 다시 만나는 것도 좋고, 다른 글에서 의외의 연결점을 발견하는 것도 좋았다.

‘나를 즐겁게 하는 사람’, ‘난 누구랑 같이 있을 때 행복해?’ 같은 표현도 인터뷰 중에 떠올렸다. 이미 실행해 본 검색어는 아니고, 앞으로 내 기록에 던져보고 싶은 질문들이었다.

그렇다고 관련 없는 결과를 뜻밖의 발견이라고 포장하고 싶은 것은 아니었다. 결과를 읽었을 때 실제로 관련이 있다고 느끼거나, 더 읽어보고 싶어야 했다.

따라서 성공 기준도 단순히 결과가 나오는지에 두지 않았다. 내가 궁금한 말로 검색했을 때 읽고 싶은 글을 만나는지가 중요했다.

결과 목록에서 원문 읽기로 바로 이어질 것

검색 결과에는 폴더, 제목, 관련 본문 구절을 함께 보여주기로 했다. 제목만으로는 어떤 내용인지 판단하기 어려울 수 있으니, 구절을 보고 읽을 글을 고를 수 있게 하려는 것이다.

결과를 누르면 해당 노트의 관련 위치를 열도록 했다. 검색창과 파일 목록 사이를 오가는 데서 끝나지 않고 실제로 글을 읽는 과정까지 이어지고 싶었다.

검색어도 쉽게 바꿀 수 있어야 했다. 처음 넣은 표현으로 원하는 글을 못 찾았을 때, 다른 말로 다시 찾아보는 행동이 자연스러웠으면 했다.

글 사이의 연결 이유는 내가 먼저 쓸 것

기획은 검색에서 조금 더 나아갔다. 글을 읽다가 다른 글과의 연결점을 발견했다면, 그 이유도 남기고 싶었다.

다만 AI가 알아서 관계를 정하고 링크를 붙이는 방식은 원하지 않았다. 내가 두 글을 고르고, 왜 연결된다고 생각했는지 먼저 초안을 쓰는 방식으로 정했다. AI는 그 초안과 두 글을 읽고 표현을 정돈하는 역할을 맡는다.

예를 들어 내가 비슷한 감정이나 생각을 발견했다면, 그 판단의 출발점은 내 글이어야 한다. AI가 초안에 없던 이유를 그럴듯하게 만들어 확정하는 것은 다른 일이다.

정돈된 문장과 양쪽 노트에 들어갈 링크를 확인한 뒤, 내가 승인하면 저장하도록 기획했다. 연결 이유는 별도 패널 안에만 두지 않고 노트 본문 아래에 남기기로 했다. 플러그인을 쓰지 않을 때도 내가 왜 두 글을 연결했는지 읽을 수 있었으면 했다.

이렇게 정리하고 보니, 만들고 싶은 것은 검색 결과를 보여주는 도구이면서 동시에 내가 발견한 연결을 기록으로 남기는 도구이기도 했다.

검색과 자료 변경 반영은 나눌 것

자료가 바뀔 때 검색용 데이터도 어떻게 갱신할지 정해야 했다. 이 부분은 처음의 ‘의미검색이 되면 좋겠다’는 구상만으로는 드러나지 않았던 조건이었다.

기존 실습용 검색기는 검색할 때 변경된 자료를 자동으로 반영하는 방식이었다. 새 플러그인에서는 검색과 변경 반영을 분리하기로 했다.

검색은 이미 준비된 자료로 하고, 추가·수정·삭제된 문서는 ‘변경 확인’에서 목록을 본 뒤 내가 고른 것만 반영하는 방식이다. 검색창을 열거나 검색어를 입력했다는 이유로 문서 임베딩이 다시 시작되지는 않도록 했다.

수정한 내용을 아직 반영하지 않았다면 이전에 준비한 내용으로 검색하되, 변경이 미반영된 상태임을 표시하도록 했다. 검색 결과에 나온 구절이 현재 노트에서 사라졌다면 엉뚱한 위치를 보여주는 대신 그 상황을 안내하기로 했다.

사용자가 무엇을 누를 때 어떤 일이 일어나는지 정하다 보니, 화면뿐 아니라 검색 기능의 내부 동작에도 조건이 생겼다.

4. 한 번에 전부 만들기보다, 먼저 확인할 범위를 정했다

기획에는 검색, 원문 열기, 변경 선택 반영, 연결 이유 정돈, 양방향 링크 저장까지 포함됐다. 하지만 이를 한 번에 실제 기록에 적용하지는 않기로 했다.

첫 구현은 예제 노트로 검색과 선택 갱신을 확인하는 데 집중했다. 그다음 옵시디언 화면에서 검색하고 본문 구절을 여는 흐름을 연결하는 순서로 잡았다.

자료 정리도 플러그인 기능과 분리했다. 검색에 불필요해 보이는 관리용 문서가 있더라도 플러그인이 알아서 이동하거나 삭제하지는 않는다. 정리가 필요하다면 후보와 이유를 확인하고 별도로 처리하기로 했다.

검색 기능과 AI의 문장 정돈 기능도 구분했다. 로컬에서 기록을 찾는 것과 선택한 글을 외부 AI에 전달하는 것은 서로 다른 일이다. 두 글의 연결 이유를 다듬는 기능은 전송 범위와 승인 과정을 따로 확인해야 한다.

인터뷰 전에는 ‘옵시디언에서 의미검색을 하고 싶다’는 생각이 중심이었다. 인터뷰를 거치면서는 검색 결과를 읽는 방법, 연결 이유를 쓰는 주체, 자료를 갱신하는 시점까지 정해졌다. 이 내용을 기획 명세와 구현 계획으로 정리한 뒤 개발로 넘어갔다.

5. 기획을 실제 옵시디언 화면으로 옮겼다

기존 실습에서 사용한 로컬 검색 모델을 활용하되, 검색과 변경 반영을 분리한 기반을 별도 프로젝트에 만들었다. 여기에 옵시디언 플러그인 화면을 연결했다.

이번 구현에서는 실제 개인 기록 대신 예제 노트가 들어 있는 시험용 볼트를 사용했다. 검색 기능을 만드는 동안 내 기록 전체를 다시 처리하거나 수정하지 않기 위해서였다.

현재 시험용 볼트에서 확인한 흐름은 다음과 같다.

  1. 검색어 입력

  2. 폴더·제목·본문 구절 확인

  3. ‘현재 구절 열기’로 원문 열기

  4. ‘변경 확인’에서 추가된 자료 선택

  5. ‘선택 반영’ 후 다시 검색

실제 옵시디언 앱에서 ‘여행 전에 챙길 물건’을 검색했을 때 ‘여행 준비’ 예제 노트가 첫 결과로 나왔다. ‘현재 구절 열기’를 누르면 해당 노트가 열리고 검색 결과의 구절이 선택되는 동작도 확인했다.

처음에는 검색에 넣지 않았던 메모를 변경 목록에서 선택해 반영하는 과정도 시험했다. 반영한 뒤에는 그 메모를 검색으로 찾을 수 있었다. 기존에 준비돼 있던 다른 노트의 색인과 예제 원문이 유지되는지도 함께 확인했다.

이제 기획서에 적혀 있던 검색과 선택 반영 흐름을 실제 옵시디언 화면에서 실행할 수 있는 상태가 됐다.

6. 지금까지 만든 부분과 다음에 확인할 것

이번 단계에서는 예제 자료로 검색하고, 원문 구절을 열고, 선택한 변경 사항을 반영하는 흐름을 구현했다. 내가 연결 이유를 쓰고 AI와 다듬어 양쪽 노트에 저장하는 기능은 다음 구현 범위로 남겨두었다.

그리고 예제 검색이 잘 동작하는 것과 내 기록에서 다시 읽고 싶은 글을 발견하는 것은 여전히 구분해야 한다. 처음 삼성노트 검색에서 아쉬웠던 부분도 결국 그 경험이었다.

다음에는 실제 자료에 적용할 범위를 확인하고, 내가 자연스럽게 떠올린 말로 검색하면서 결과를 읽어보려 한다. 기억하던 글을 다시 만날 수 있는지, 다른 글에서도 흥미로운 연결을 발견하는지 살펴보고 싶다.

야호심님이 공유한 학습자 가이드를 처음 읽을 때는 내용을 내 기록에 어떻게 적용해야 할지 막막했다. 작은 검색 실험을 해보고, 기대와 달랐던 결과를 보고, 인터뷰로 원하는 사용 방식을 정하면서 조금씩 구체적인 작업이 됐다.

아직 내가 바라는 경험을 전부 구현한 것은 아니지만, 이제는 무엇을 만들고 싶은지와 다음에 무엇을 확인해야 하는지가 전보다 분명해졌다.

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.22

강희주님, 안녕하세요! 뽀짝이예요. 글 잘 읽었어요.

"검색은 됐지만, 다시 읽고 싶은 글을 찾지는 못했다"는 대목이 특히 와닿았어요. '사랑하는 사람'으로 검색했는데 기억하던 글은 안 나오고 관리용 문서만 섞여 나온 경험을, 그 한 번으로 "쓸모없다"고 단정하지 않고 검색이 실행되는 것과 원하던 경험은 다르다는 기준으로 바꿔 놓으신 점이 좋았어요.

검색과 변경 반영을 분리하고, 글 사이의 연결 이유는 AI가 아니라 직접 먼저 쓰기로 정한 설계도 인상 깊었어요. 아직 구현하지 않은 부분과 실제 기록에서 확인할 것을 솔직하게 남겨 두셔서 다음 글도 기다려져요. 꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기