AI 채팅

작동 방식

AI → AI 채팅…는 자신의 노트를 컨텍스트로 사용해 답하는 채팅을 창 오른쪽 패널의 탭으로 엽니다. 모든 것을 클라우드로 보내는 대신, LightNote는 볼트에서 가장 관련 있는 발췌를 로컬로 가져와(ripgrep 사용, 임베딩이나 외부 서비스 불필요) 그 발췌로 질문을 구성한 뒤, 등록해 둔 API AI 제공자에게 보냅니다. 답변에는 출처 노트가 클릭 가능한 인용으로 함께 제공되며, 클릭하면 노트가 열립니다. “두 번째 뇌와 대화하며” 이미 적어 둔 내용을 다시 찾기에 좋습니다. 대화는 폴더별로 저장되어 나중에 다시 열 수 있으며(아래 참고), 이 기능은 설정 → 일반 → 기능에서 끌 수 있습니다.

탭과 창. 채팅은 읽고 있는 내용 옆, 오른쪽 패널의 탭에서 열립니다. 창마다 하나씩이며, 창마다 각자의 대화가 있습니다. 탭에서는 그 창의 폴더에 있는 노트를 사용하고, 현재 편집기 컨텍스트는 활성 탭을 따라갑니다(아래 참고). 상단에는 AI, 컨텍스트, 모드(AI가 할 수 있는 일)와 파일을 첨부하는 버튼, 새 대화를 시작하는 버튼이 있습니다. 좁은 탭에서는 두 줄로 나뉩니다. 첫 질문 전에는 채팅이 무엇에 대해 답할지를 화면이 알려 주고, 이 폴더 요약 같은 한 번의 클릭 단축키를 제공합니다. 질문 칸에서는 Enter가 보내기, Shift+Enter가 줄바꿈입니다. 답변이 오는 동안에는 보내기 버튼이 중지로 바뀝니다. 탭을 닫으면 새 대화처럼 대화가 목록에 보관됩니다.

이동, 분리와 다시 붙이기. 이 탭은 다른 탭처럼 끌어서 기본 영역이나 아래 영역으로 옮기거나 다시 오른쪽으로 되돌릴 수 있으며, 폴더를 다시 열면 마지막으로 둔 영역으로 돌아옵니다. 대화 작업이나 모서리 버튼의 창으로 분리는 같은 대화를 폴더, 첨부, 도움말 섹션, 그 대화에서 허용한 내용과 함께 별도 창으로 옮기고, 탭은 닫힙니다. 별도 창에서는 창에 다시 붙이기로 원래 창(또는 같은 폴더를 연 다른 창)의 탭으로 되돌립니다. 대화는 한 곳에서만 열리며, AI가 답하는 동안에는 옮길 수 없습니다. 트레이 아이콘의 AI → AI 채팅…은 별도 창을 열고, 그 창에는 폴더를 고르는 노트 위치: 선택기가 있습니다.

누가 답했는지와 답변 비교. 각 답변 아래에 그 답을 쓴 어시스턴트와 모델이 눈에 띄지 않게 표시됩니다 — 대화 중에 어시스턴트를 바꿨거나 목록의 첫 모델이 실패했을 때 유용합니다. 채팅은 창과 폴더별로 마지막에 고른 어시스턴트를 기억합니다. 같은 질문을 여러 어시스턴트에 보내려면 채팅 메뉴의 답변 비교…를 쓰거나 질문 앞에 /compare를 쓰세요. 답변 비교를 참고하세요.

도구와 권한

모드: AI가 할 수 있는 일. 상단 막대의 모드 선택기에는 세 가지 값이 있습니다. 노트만은 용어 검색으로 찾은 발췌만으로 답하고, 아무것도 실행하지 않습니다. 읽기는 모델이 답하기 전에 스스로 찾아보게 합니다(파일 읽기, 노트 검색, 작업 목록 보기, 이 도움말 참조). 아무것도 바꾸지 않습니다. 승인 후 변경은 여기에 노트와 작업 만들기, 속성 바꾸기, 오늘의 노트에 기록하기를 더하며, 언제나 확인을 받습니다. 한 번도 고른 적이 없으면 읽기로 시작합니다. 읽기는 안전하기 때문입니다. 답변 끝에는 사용된 도구 목록이 나오므로, 답을 그냥 믿지 않고 판단할 수 있습니다.

모델 테스트. 읽기와 승인 후 변경에는 API 제공자가 필요합니다(로컬 CLI는 도구를 받을 수 없습니다). 이 모드를 고르면 LightNote가 모델이 도구를 호출할 수 있는지 바로 테스트합니다. 많은 제공자가 요청을 받아들이고도 도구를 그냥 무시하는데, 이 확인이 없으면 찾아본 것처럼 보이는 지어낸 답변이 됩니다. 결과는 제공자와 모델의 조합마다 7일 동안 기억됩니다. 테스트에 실패하면 노트만만 고를 수 있고, 메시지 옆의 다시 확인 버튼으로 저장된 결과를 무시하고 다시 테스트할 수 있습니다. 그 순간에만 제공자가 응답하지 않았을 수도 있으니까요.

모든 변경은 확인을 받습니다. 변경 내용은 대화 안에 알기 쉬운 말로 표시되며("작업 빵 사기 만들기"), 답은 세 가지입니다. 허용은 이번 한 번만, 이 대화에서 허용은 대화가 끝날 때까지 같은 도구를 묻지 않고 통과시킵니다(그때마다 대화에 대화에서 허용됨이 표시됩니다). 거부해도 대화는 끝나지 않으며, 모델은 이를 전달받고 설명을 이어 가거나 다른 방법을 제안합니다. 삭제에는 이 허용이 주어지지 않아, 삭제할 때마다 묻습니다. 대화 작업의 이 대화의 권한 초기화를 쓰면 모든 것을 다시 묻게 되며, 새 대화나 다른 폴더에서도 마찬가지입니다. 임의 파일 덮어쓰기와 네트워크 접근은 의도적으로 제외했습니다. 변경이 오늘의 노트에 들어갈 때는 요청에 어느 폴더인지도 표시됩니다.

AI가 묻거나 멈출 때. 답에 필요한 정보가 빠져 있으면(어느 보드인지, 두 노트 중 어느 것인지) AI가 직접 물어볼 수 있습니다. 질문은 대화 안에 선택지마다 링크로 표시되고, 필요하면 다른 답변… 칸도 함께 나옵니다. 답하지 않음을 고르면 모델은 그 정보 없이 계속합니다. 답한 질문은 텍스트로 바뀌고, 예전 질문의 선택지는 아무 동작도 하지 않습니다. 여러 단계를 거쳐도 끝나지 않으면 대화가 멈추고 같은 작업에 단계를 더 주는 계속이 표시됩니다. 모델이 같은 조회를 세 번 반복하며 진척이 없으면 멈추고 어떤 조회였는지 알려 줍니다. 각 단계의 텍스트는 모델이 쓰는 대로 조금씩 나타납니다.

무엇에 대해 답하는지

메모냐, 열려 있는 파일이냐. 채팅 상단의 컨텍스트: 콤보에서 대화의 대상을 선택합니다. Vault 노트(기본값, 아래 설명)이거나 현재 편집기입니다. 후자는 vault 대신 편집기에서 열린 파일에 대해 답하며, 선택 영역과 주변 줄(또는 전체 파일 체크 시 파일 전체)을 사용합니다. 탭에서는 현재 편집기가 창의 활성 탭을 따라갑니다. 탭을 바꾸면 파일도 바뀌고, 채팅 자신의 탭은 세지 않으며, 활성 탭이 텍스트 편집기가 아니면 선택은 그대로 둔 채 그 항목을 사용할 수 없게 됩니다. 별도 창에서는 채팅을 연 편집기입니다. 또한 빠른 어시스턴트(Ctrl+K)에서는 결과에 채팅에서 계속 → 버튼이 있어, 현재 편집기 범위로 채팅을 열고 그 회차의 질문과 답변을 이어받습니다 — 처음부터 다시 하지 않고 더 깊이 파고들 수 있습니다.

어떤 노트인가요? 탭에서는 그 창의 폴더에 있는 노트입니다. 창의 폴더를 바꾸면 채팅의 폴더도 바뀌고, 진행 중인 대화는 목록에 보관됩니다. 별도 창은 한 번에 한 폴더에 대해 답하며, 폴더는 노트 위치: 콤보에서 고릅니다. 지금 열려 있는 폴더와 그 뒤에 최근 폴더가 나열되고, 폴더 선택…으로 그 밖의 폴더도 지정할 수 있습니다. 다른 프로젝트에서 작업하면서 어떤 프로젝트의 노트에 대해 질문할 수 있습니다. 직접 고른 폴더는 다시 바꿀 때까지 유지됩니다. 질문이 진행 중인 동안에는(확인을 기다리며 멈춰 있을 때도 포함) AI·컨텍스트·폴더 선택기가 잠깁니다. 돌아오는 답은 질문할 당시의 모델과 폴더에 속하기 때문입니다.

질문하는 방법. 검색은 지시가 아니라 주제로 이루어집니다. LightNote는 질문에서 단어를 뽑아 그 단어가 들어 있는 노트를 찾습니다. "Postgres에 대해 무엇을 적었지?"처럼 노트에 나오는 주제를 말하세요. "요약해 줘" 같은 막연한 요청은 검색할 내용 단어가 없어 아무것도 검색되지 않으며, 답변이 노트를 사용하지 않았다고 채팅이 알려 줍니다. .md/.markdown 노트만 읽으며, 그런 파일이 하나도 없는 폴더에서는 채팅이 이를 알리고 AI 호출을 소비하지 않습니다.

더 나은 검색·요약·다시 쓰기. 검색은 BM25 순위의 로컬 색인을 사용해 악센트를 무시하고("configuração"로 "configuracao"를 찾음), 단어 사이에 공백이 없는 언어(일본어·중국어·한국어)에서도 작동합니다 — 색인을 만드는 동안에는 ripgrep이 보조합니다. 이 폴더 요약 버튼과 탐색기에서 아무 폴더나 오른쪽 클릭했을 때 나오는 AI로 요약…은 노트를 묶음으로 읽어 하나의 문서를 돌려줍니다. 그리고 설정 → 일반 → 기능의 AI로 질문 다시 작성 옵션은 검색 전에 질문을 키워드로 확장합니다(질문마다 API 호출 1회).

키와 대화

키 하나면 됩니다. 처음 실행할 때 LightNote는 OpenAI, Google Gemini, Anthropic (Claude)를 설정 → AI 어시스턴트에 이미 등록해 둡니다. 사용하는 제공자에 API 키만 붙여넣으면 됩니다. 키가 있는 제공자가 없으면 창에 지금 설정 버튼이 나타나 해당 화면을 바로 엽니다.

대화가 보관됩니다. 상단의 시계 버튼을 누르면 해당 폴더의 이전 대화 목록이 열립니다. 하나를 누르면 그 대화로 돌아갑니다. 새 대화는 현재 대화를 지우지 않고 보관하며, 목록에서 오른쪽 버튼을 누르면 하나를 완전히 삭제합니다(확인 후). 대화는 폴더별로 저장되므로 노트 폴더를 바꾸면 목록도 바뀝니다. 폴더를 다시 열면 열려 있던 대화와 함께 채팅 탭이 돌아옵니다.

답변으로 할 수 있는 일

답변으로 무엇을 할까. 각 답변 아래에 복사(서식을 그대로 유지한 마크다운 텍스트를 클립보드로)와 노트에 담기(인용된 노트 링크와 함께 오늘의 노트로)가 있습니다. 대화 작업 메뉴에는 대화 복사, 대화를 노트로 저장…(조회한 폴더에 .md 기록), 마지막 답변 다시 생성, 마지막 질문 편집이 있습니다.

파일 첨부하기. 검색이 생각하던 것을 찾지 못할 때는 + 버튼으로 파일을 첨부하세요. 첨부한 것은 검색 순위 경쟁과 무관하게 항상 질문에 들어갑니다. 노트, 코드, 텍스트, PDF를 지원합니다(PDF는 텍스트를 추출). 바이너리는 그 자리에서 거부되어 컨텍스트의 잡음이 되지 않습니다. 첨부는 알약 모양으로 표시되며(클릭하면 해제) 새 대화를 시작하면 사라집니다. 지원하는 제공자에서는 답변도 모델이 쓰는 대로 조금씩 나타납니다.

어시스턴트 기억. 위쪽 ☰ 버튼의 대화 작업 메뉴에서 어시스턴트 기억…을 누르면 선택한 폴더의 루트에 있는 기억.md 노트가 열립니다(처음에는 새로 만듭니다). 그 안의 내용은 그 폴더에 대한 모든 질문에, 찾아낸 발췌보다 먼저 들어갑니다. 취향, 이미 내린 결정, 무엇을 왜 제외했는지 같은 것들입니다. 평범한 .md이므로 언제든 편집하고 Git으로 버전 관리하며, 지우면 기억이 꺼집니다. 쓰기 도구를 켜 두면 어시스턴트가 거기에 사실을 남기자고 제안할 수도 있고, 다른 쓰기와 마찬가지로 승인을 기다립니다.

폴더 요약하기. 작업 공간 전체도, 어떤 하위 폴더도 됩니다. 탐색기에서 폴더를 오른쪽 클릭하고 AI로 요약…을 고르세요. 비용이 발생하기 전에 LightNote가 몇 개의 노트를 읽고 AI 호출이 몇 번 발생하는지(각각 제공자가 요금을 부과합니다) 알려 주고, 형식을 고르게 합니다. 개요는 이어지는 글이고, 지식 정리는 결정, 남은 일, 아이디어, 모순, 열린 질문이라는 고정된 절을 갖습니다(내용이 없는 절은 지어내어 채우지 않고 생략합니다). 비용 상한보다 노트가 많으면 답변이 몇 개가 빠졌는지 밝힙니다. 마지막으로 노트로 저장을 누르면 요약이 요약한 폴더 안에 기록되며, 머리말에 날짜와 노트 수가 들어가고 이전 요약을 덮어쓰지 않습니다.

명령, 도움말, 링크

어시스턴트는 LightNote를 압니다. 노트뿐 아니라 자신이 LightNote 안에서 동작한다는 것을 압니다. 이 도움말의 목차와 앱 Markdown의 요약(위키링크, 콜아웃, 다이어그램, 수식, 달력)을 받고, 질문할 때마다 조회 중인 폴더, 활성 탭, 날짜도 받습니다. 노트에 대해 묻듯이 “작업 보드는 어떻게 만드나요?”라고 물어보세요.

/로 시작하는 명령. 빈 입력란의 맨 앞에서 /를 입력하면 명령 목록이 열리고, 입력하는 대로 걸러집니다. Enter로 고르고 Esc로 닫습니다. /help 뒤에 주제를 쓰면(/help 표) 제목이 그 주제와 맞는 이 도움말의 섹션이 대화에 첨부됩니다. 주제가 없으면 채팅을 연 화면의 섹션이 들어갑니다. 주제 대신 질문을 쓰면(/help 표 만드는 법) 답이 될 만한 섹션이 목록에 나옵니다. 고른 섹션이 첨부되고 질문도 함께 보내집니다.

첨부된 섹션. 섹션은 첨부 파일 옆에 도움말: … 알약으로 표시되고, 질문할 때마다 노트 발췌보다 앞에 들어갑니다. 알약을 클릭하거나 새 대화를 시작하면 빠집니다. 빈 화면의 채팅은 어떻게 작동하나요?는 이 섹션으로 이 작업을 하고 바로 질문합니다.

다른 명령. /summarize는 폴더를 요약하고 /new는 새 대화를 시작합니다. Prompts 폴더의 프롬프트도 같은 목록에 나오며, 하나를 고르면 본문이 입력란에 들어가 보내기 전에 검토할 수 있습니다.

[[ 또는 @로 노트 첨부. 입력 칸에 [[ 또는 @를 입력하면 폴더의 노트 목록이 열리고, 입력하는 대로 걸러집니다(악센트가 있어도 없어도 됩니다). Enter로 고르면 노트가 첨부로 들어갑니다. + 버튼과 같은 알약으로, 질문할 때마다 다시 읽히며 검색 순위 경쟁에는 끼지 않습니다. 찾으려고 입력한 글자는 입력 칸에서 사라집니다. Esc, 스페이스 또는 바깥 클릭으로 아무것도 첨부하지 않고 목록을 닫습니다.

도구로서의 도움말과 Markdown. 읽기와 승인 후 변경 모드에서는 모델이 이 도움말(help_lookup)과 LightNote가 그리는 구문의 참조(markdown_reference)를 스스로 찾아봅니다. 그래서 메뉴 경로와 다이어그램의 펜스를 정확히 맞힙니다. 정보가 부족하면 직접 묻습니다(ask_user). 앞의 두 가지는 AI CLI를 위해 MCP 서버에도 있습니다. 질문은 화면 앞에 사람이 있어야 하므로 채팅에서만 쓸 수 있습니다.

화면으로 가는 링크. 답변에 앱의 화면이 필요하면 메뉴를 설명하는 대신 링크를 붙입니다. lightnote://settings/ai는 설정의 AI 어시스턴트 섹션을, lightnote://help/…는 이 도움말의 섹션을, lightnote://wizard/clone은 복제 마법사를, lightnote://open?file=…은 폴더 안의 파일을 열고, lightnote://new?type=lnt는 새 파일을 만듭니다.

저절로 열리지 않습니다. 클릭이 곧 동의입니다. 폴더 밖, 꺼진 기능, 존재하지 않는 대상으로 가는 링크는 아무것도 열지 않으며, 상태 줄에 이유가 표시됩니다. 같은 링크는 노트 안에서도 작동합니다.

앱 설정과 연결 만들기

설정 바꾸기. 승인 후 변경 모드에서 사람에게 부탁하듯 말하세요("다크 테마로 바꿔 줘", "편집기 글꼴을 14로", "미니맵을 꺼 줘"). 요청은 변경 전 → 변경 후("테마: 밝게 → 어둡게")로, 같은 항목이 있는 설정 섹션으로 가는 링크와 함께 표시되며 허용한 뒤에만 적용됩니다. 적용되면 대화에 새 값과 함께 적용됨이 표시됩니다.

변경할 때마다 확인. 설정에는 이 대화에서 허용이 적용되지 않습니다. 인터프리터와 AI CLI도 같은 방법으로 추가·변경·삭제할 수 있으며, 프로그램은 항상 이름으로 지정하고 폴더로는 지정하지 않습니다. 셸(pwsh, bash)은 pwsh -File {file}처럼 파일을 여는 인터프리터로만 받아들이며, 줄 자체에 쓴 명령은 받지 않습니다.

범위 밖의 것. 정해진 옵션 목록만 바꿀 수 있습니다(테마, 언어, 편집기 글꼴, Markdown 여는 방식, 기능, 일일 노트, AI 옵션 등). API 키, 제공자 주소, 프로그램 경로, 터미널은 채팅으로 바뀌지 않으며, 도우미는 알맞은 섹션의 링크로 답합니다. 노트의 글이 대화에 들어가므로, 밖에서 온 노트가 AI를 다른 주소로 돌리지 못하게 하려는 것입니다.

HTTP 테스트나 연결 만들기. "GET https://…용 테스트를 만들어 줘", "deploy@server SSH 연결을 저장해 줘", "판매 데이터베이스에 연결해 줘"라고 하면 허용한 뒤 도우미가 앱과 같은 형식으로 .lnh, .lns, .lnc를 만들고, 대화에 파일을 여는 링크와 함께 생성됨이 표시됩니다. 파일을 덮어쓰지 않고 폴더 안에만 만들며, 설정의 기능 섹션에서 끈 유형은 만들지 않습니다.

정보가 부족하면 질문. 결과를 바꾸는 정보(데이터베이스, 서버, 인증 방식)가 없으면 만들기 전에 선택지와 함께 묻습니다.

비밀번호는 채팅을 거치지 않습니다. 데이터베이스 연결과 SSH 연결은 비밀번호 없이 만들어지며, 연결할 때 묻습니다. 데이터베이스 연결에 대한 AI 접근은 허용할 때까지 꺼져 있습니다. HTTP 테스트에서는 토큰이나 비밀번호가 빈 변수({token})가 되고, 테스트나 http-client.private.env.json에서 채웁니다. 그대로 적은 비밀은 거부됩니다. 세 가지 생성 도구는 MCP 서버에도 있으며, 설정 변경은 채팅에서만 됩니다.