나이 드는 것과 남는 것
기억의 네 계층 가운데 감쇠하는 것은 하나뿐입니다. 고정된 페이지는 어느 계층에서든 예외입니다.
작업 기억
진행 중인 세션을 위한 메모입니다. 세션과 함께 끝납니다.
일화 기억
세션마다 페이지 하나가 생깁니다. 나이 드는 계층이 바로 여기입니다. 아무도 읽지 않는 페이지는 몇 달 안에 콜드 상태가 됩니다.
의미 기억
결정, 개념, 주의점입니다. 감쇠하지 않습니다.
절차 기억
규칙, 절차, 런북입니다. 감쇠하지 않습니다.
LLM 없는 경로
예약된 스윕이 고정되지 않은 일화 페이지 전체에 점수를 매깁니다. 점수는 시간이 지나면 내려가고 페이지가 읽힐 때마다 올라갑니다.
보존 점수
- 기본 설정에서 페이지 점수는 약 35일마다 절반으로 줄어듭니다. 0.20 아래로 내려가면 콜드로 분류됩니다.
- 읽을 때마다 점수가 더해지고, 오래된 읽기의 효과도 점차 옅어집니다.
Stale또는Wrong피드백을 받은 페이지는 가장 낮은 중요도로 떨어집니다.- 점수는 스윕이 할 일을 결정합니다. 검색 랭킹은 절대 바꾸지 않습니다.
# 셋 다 선택 사항입니다. 없으면 콜드 페이지는 하나의 공통 곡선에 따라 퇴출됩니다.
[decay]
compact_cold_episodic = true
dedup_cold_clusters = true
[decay.half_life_days]
working = 7
episodic = 365
항상 켜짐
읽으면 페이지가 살아남습니다
검색에 걸리는 것, 페이지를 여는 것, 링크를 따라 도달하는 것,
memory_explore가 모두 읽기로 집계됩니다. 읽기는 점수를 올리기만 합니다.기본값은 꺼짐
계층별 반감기
[decay.half_life_days]로 계층마다 옅어지는 속도를 정합니다. 예를 들어 임시 메모는 짧게, 세션 기록은 길게 둘 수 있습니다. 설정하지 않으면 점수는 이전과 똑같이 유지됩니다.기본값은 꺼짐
콜드 페이지 압축
compact_cold_episodic를 켜면 콜드 페이지는 초록, 첫 문단 요약, 남길 가치가 있는 토큰(파일 경로, URL, 코드 조각, 오류 코드, 식별자)만 유지하고 본문은 버립니다. 켜지 않으면 페이지는 퇴출됩니다.기본값은 꺼짐
유사 중복 병합
dedup_cold_clusters를 켜면 거의 같은 내용을 담은 콜드 페이지를 임베딩 기준으로 클러스터로 묶습니다. 점수가 가장 높은 페이지가 살아남아 나머지의 보존 토큰을 흡수합니다. 나머지는 대체 처리되어 생존 페이지를 가리킵니다.기본값은 꺼짐
빈 세션은 건너뜁니다
엔트로피 필터가 거의 비어 있거나 반복이 심한 세션 페이지를 경험 패스에서 걸러 냅니다. LLM 프롬프트를 만들기 전에 일어나는 일입니다.
memory_lint와 함께 실행
모순 가능성 표시
memory_lint는 같은 주제를 다루면서 중복은 아닌 지식 페이지 쌍을 보고하고, 어느 쪽이 더 최신인지 알려 줍니다. 이 보고는 참고용이며 어떤 페이지도 수정하지 않습니다.항상 켜짐
페이지별 신뢰도 점수
각 페이지는 0에서 0.95 사이의 신뢰도를 받습니다. 서로 다른 세션 몇 개가 뒷받침하는지, 마지막 세션이 얼마나 최근인지, 모순되는 페이지가 몇 개인지로 계산합니다.
explain출력에서 확인할 수 있습니다.belief_authority_weight를 0보다 크게 올린 경우에만 랭킹에 영향을 줍니다.
꿈 패스
중복 제거는 클러스터의 사실을 보존합니다. 꿈 패스는 같은 클러스터를 LLM에 넘기고, LLM은 이를 일관된 페이지 하나로 다시 씁니다. 자리를 비운 동안 실행되고 돌아오면 멈춥니다.
세 가지가 필요합니다
[dream] enabled = true, LLM 제공자, 임베더입니다. 제공자가 없어도 LLM 없는 중복 제거는 이전처럼 동작합니다.자리를 비울 때까지 기다립니다
클라이언트 활동이 300초 동안 없으면 실행을 시작합니다. 돌아오면 다음 클러스터에서 취소됩니다.
가장 새로운 내용의 클러스터부터
위키에 이미 있는 내용과 가장 거리가 먼 클러스터를 먼저 처리합니다. 이 순서와 유휴 트리거는 Honcho의 Dreamer를 따랐습니다.
원본은 대체 처리됩니다
점수가 가장 높은 페이지를 다시 씁니다. 병합된 각 페이지는 그 페이지를 가리키는 스텁이 되고, 원문은 버전 체인과 git에 남습니다.
모든 병합은 원본을 밝힙니다
어느 페이지가 각 병합에 들어갔는지 근거 행에 기록되므로, 지어낸 내용이 있으면 추적할 수 있습니다. 출력은 스키마로 검증한 JSON이고, 실행할 때마다 리포트가 남습니다.
# LLM 제공자와 임베더도 필요합니다.
[dream]
enabled = true
idle_window_secs = 300
max_clusters_per_run = 8
되돌릴 수 있는 것과 없는 것
압축, 중복 제거, 꿈 패스는 위키를 거쳐 페이지를 다시 쓰므로, 변경 하나하나가 새 버전이자 git 커밋입니다.
다시 쓰기는 되돌릴 수 있습니다
ai-memory restore-page는 위키의 git 히스토리에서 페이지 전체를 되살립니다.업그레이드는 아무것도 바꾸지 않습니다
압축, 중복 제거, 꿈 패스는 기본값이 꺼짐입니다. 업그레이드해도 점수는 바뀌지 않고 퇴출되는 페이지도 없으며, 서버는 마이그레이션 전에 데이터 디렉터리를 아카이브합니다.
남겨야 할 것은 고정하세요
고정된 페이지는 스윕 대상이 되지 않습니다. 의미 기억과 절차 기억 페이지는 감쇠하지 않습니다.
질의하는 다른 방법
각각 기존 도구의 선택 인자입니다.
인용이 붙은 답변
memory_query에answer: true를 주면 짧은 답변과 그 근거가 된 페이지 경로를 돌려줍니다. LLM 제공자가 필요하고 Honcho의 dialectic 엔드포인트를 따랐습니다. 품질은 아직 평가하지 않았으니 인용된 페이지를 직접 열어 보세요.추론 수준
reasoning인자는minimal부터max까지이며, 답변과memory_explore에 쓸 토큰 예산을 정합니다.고정된 페이지 먼저
pin_first는 고정된 페이지를 최대 10개까지 검색 결과 앞에 놓습니다. 세션 브리핑에도 이제 고정된 페이지가 나옵니다.관련 페이지
memory_read_page에include_related를 주면 링크와 백링크를 최대 세 단계까지 따라갑니다.요청하면 이전 버전도
include_superseded는 대체된 버전을 검색에 포함하고, 각각에 레이블을 붙입니다.어느 프로젝트가 답했는지
memory_status는 확정한 워크스페이스와 프로젝트, 그리고 그렇게 확정한 경로를 보고합니다.
자주 묻는 질문
ai-memory는 오래된 기억을 삭제하나요?
나이 드는 것은 일화 세션 페이지뿐입니다. 기본적으로 콜드 페이지는 퇴출되고 180일 뒤에 완전히 제거됩니다. 그 대신 콜드 페이지를 압축하거나 병합하게 할 수도 있고, 둘 다 복원할 수 있습니다. 고정된 페이지와 의미 기억, 절차 기억 페이지는 유지됩니다.
기억 노화에 LLM이 필요한가요?
아니요. 점수 계산, 계층별 반감기, 압축, 중복 제거, 모순 표시, 신뢰도 점수는 LLM을 쓰지 않습니다. 중복 제거와 모순 표시는 임베딩을 읽는데, 기본 로컬 임베더가 이를 만듭니다. LLM을 호출하는 것은 꿈 패스뿐이고 기본값은 꺼짐입니다.
꿈 패스란 무엇인가요?
옵트인 백그라운드 작업입니다. 유휴 상태가 5분 이어지면 서로 유사 중복인 콜드 페이지 클러스터를 가져와, LLM이 클러스터마다 페이지 하나로 다시 쓰게 합니다. 원본은 대체 처리되고, 사용자가 돌아오면 실행이 멈춥니다.
업그레이드하면 기존 기억이 바뀌나요?
아니요. 압축, 중복 제거, 꿈 패스는 기본값이 꺼짐이므로 업그레이드해도 점수는 바뀌지 않고 퇴출되는 것도 없습니다. 서버는 마이그레이션 전에 데이터 디렉터리를 아카이브합니다.
이 기능들이 검색 점수를 높여 주나요?
아직 아무도 측정하지 않았습니다. 프로젝트는 평가 하네스에서 향상이 확인되기 전까지 이 기능들을 출시됨, 옵트인, 미검증 상태로 취급합니다.