wyglore-leaf / user-guide.json
Release WygLore Leaf 3.4.4 updates and public sources
8d34b6d verified 1 day ago
33 kB
{
  "schemaVersion": 2,
  "product": "WygLore Leaf",
  "version": "3.4.4",
  "updated": "2026-11-02",
  "title": "처음 쓰는 WygLore Leaf",
  "intro": "아래 순서는 기본 로컬 모드 안내입니다. 처음 설치했다면 위에서 아래로 따라오세요. 개인 뿌리 서버에 기억 처리를 맡기는 순서는 다섯째 절에 있고, 옮긴 채팅의 메뉴는 [서버에서 기억을 처리하는 채팅]에서 설명합니다.",
  "imageBaseUrl": "https://huggingface.co/m6dd8m/wyglore-leaf/resolve/main/user-guide-assets/3.4.4/",
  "walkthroughs": [
    {
      "id": "setup",
      "title": "처음 한 번만 설정하기",
      "lead": "텍스트 생성 모델 하나만 연결하면 기억을 만들 수 있습니다. 임베딩과 보조 검색은 나중에 켜도 됩니다.",
      "steps": [
        {
          "title": "플러그인 설치",
          "body": "사용 중인 RisuAI에 맞는 zip을 받아 압축을 풉니다. RisuAI의 플러그인 화면에서 안의 WygLoreLeaf 파일을 설치하거나 기존 파일 위에 덮어씁니다.",
          "actions": [
            "보통의 최신 RisuAI라면 V3 빌드를 받습니다.",
            "설치 뒤 RisuAI 설정이나 햄버거 메뉴에서 WygLore Leaf를 엽니다."
          ],
          "success": "왼쪽에 개요, 기억뜰, 프로바이더 탭이 보이면 설치가 끝났습니다."
        },
        {
          "title": "텍스트 생성 모델 고르기",
          "body": "프로바이더 탭 맨 위의 [텍스트 생성]이 사건 기억을 만드는 필수 슬롯입니다.",
          "actions": [
            "[텍스트 생성] 첫 칸에서 사용할 프로바이더를 고릅니다.",
            "오른쪽 칸에서 모델을 고릅니다. 임베딩과 보조 검색은 비워 둬도 됩니다."
          ],
          "success": "텍스트 생성 두 칸에 프로바이더와 모델 이름이 보이면 됩니다.",
          "image": {
            "file": "guide-01-provider-slot.png",
            "alt": "프로바이더 탭의 텍스트 생성 슬롯과 연결 테스트 버튼",
            "caption": "프로바이더 탭 맨 위에서 텍스트 생성 프로바이더와 모델을 고릅니다."
          }
        },
        {
          "title": "API 키 넣고 연결 확인하기",
          "body": "같은 탭을 아래로 내려 선택한 프로바이더 카드를 엽니다. API 키는 이 카드에 넣습니다.",
          "actions": [
            "API Key 칸에 키를 붙여 넣습니다.",
            "필요하면 [테스트 모델 고르기]를 열어 시험할 모델을 바꿉니다.",
            "카드의 [모델 호출 테스트]나 맨 위 슬롯의 [연결 테스트]를 누릅니다."
          ],
          "success": "테스트가 성공하면 기본 연결은 끝났습니다. Vertex JSON 오류는 연결 단계의 실패이고, 기억 시험은 호출이 성공한 뒤에만 형식과 기억을 검사합니다.",
          "image": {
            "file": "guide-02-provider-key.png",
            "alt": "프로바이더 카드의 API 키와 모델 호출 테스트",
            "caption": "키는 점으로 가려집니다. 실제 사용 모델은 위쪽 활성 슬롯에서 고르고, 이 카드는 연결 상태를 시험합니다."
          }
        }
      ]
    },
    {
      "id": "existing-chat",
      "title": "이미 대화가 쌓인 채팅이라면",
      "lead": "지난 대화는 맥락 따라잡기로 한 번 읽습니다. 봇 설명과 로어북도 기억뜰에 담고 싶다면 인덱싱을 이어서 실행합니다.",
      "steps": [
        {
          "title": "맥락 따라잡기 실행",
          "body": "의미 추출 → 맥락 따라잡기에서 아직 읽지 않은 범위를 확인합니다. [실행 방식]에서 캐릭터 전체나 현재 채팅의 자동 실행을 끌 수 있습니다. 채팅에 따로 지정한 값이 캐릭터 설정보다 우선하며, 꺼 두어도 수동 실행은 가능합니다.",
          "actions": [
            "의미 추출 → 맥락 따라잡기로 이동합니다.",
            "남은 대화 수와 예상 안내를 확인한 뒤 [맥락 따라잡기 실행]을 누릅니다.",
            "끝날 때까지 같은 채팅을 유지합니다. 중단됐다면 같은 화면에서 이어서 실행합니다."
          ],
          "success": "상태가 완료로 바뀌고 기억뜰에 사건 기억이 생기면 됩니다.",
          "image": {
            "file": "guide-03-catch-up.png",
            "alt": "의미 추출의 맥락 따라잡기 실행 버튼과 남은 대화 수",
            "caption": "남은 대화 수를 확인하고 [맥락 따라잡기 실행]을 누릅니다."
          }
        },
        {
          "title": "봇 설명과 로어북 인덱싱",
          "body": "이 단계는 선택입니다. 캐릭터 설명과 로어북을 이름, 역할, 단서로 찾아 쓰고 싶을 때 실행합니다. 캐시에 남은 결과는 재사용하며, 새 내용이나 캐시에 없는 항목은 모델 호출 비용이 듭니다.",
          "actions": [
            "의미 추출 → 로어북 기억 만들기로 이동합니다.",
            "[인덱싱 실행]을 누르고 처리할 항목과 예상 호출 수를 확인합니다."
          ],
          "success": "[미인덱싱] 표시가 사라지고 현재 인덱스가 만들어지면 됩니다.",
          "image": {
            "file": "guide-04-index.png",
            "alt": "로어북 기억 만들기 화면의 인덱싱 실행 버튼",
            "caption": "의미 추출 → 로어북 기억 만들기에서 [인덱싱 실행]을 누릅니다."
          }
        }
      ]
    },
    {
      "id": "new-chat",
      "title": "새 채팅에서 시작한다면",
      "lead": "처음부터 맥락 따라잡기를 누를 필요는 없습니다. 연결만 끝낸 뒤 평소처럼 대화하면 됩니다.",
      "steps": [
        {
          "title": "약 4턴까지 대화하기",
          "body": "1턴은 내가 한 번 말하고 캐릭터가 한 번 답하는 왕복입니다. 기본값에서는 약 4턴이 쌓인 뒤 다음 메시지를 보낼 때 사건 기억을 만들기 시작합니다.",
          "actions": [
            "채팅으로 돌아가 평소처럼 대화합니다.",
            "첫 메시지 직후 기억이 없더라도 그대로 이어 갑니다."
          ],
          "success": "약 4턴 뒤 다음 전송부터 기억 확인 기록이 생기기 시작합니다."
        },
        {
          "title": "개요에서 작동 확인하기",
          "body": "메시지를 보낸 뒤 개요를 열면 마지막 요청에 기억이 들어갔는지 볼 수 있습니다. [작동이 안 되나요?]에서 자동 실행 조건과 모델 시험, 기억 원문을 확인하는 순서를 안내합니다.",
          "actions": [
            "메시지를 한 번 보낸 뒤 WygLore Leaf의 개요를 엽니다.",
            "마지막 요청 결과와 [이번 요청] 표시를 확인합니다.",
            "연결이나 저장 상태가 궁금하면 [기억 환경]을 펼칩니다."
          ],
          "success": "마지막 요청에 넣은 기억 수가 표시되면 주입된 것입니다. 모델 답변이 그 기억을 정확히 사용했는지는 답변과 함께 확인합니다.",
          "image": {
            "file": "guide-05-overview.png",
            "alt": "개요 화면의 마지막 요청과 기억 환경",
            "caption": "개요에는 마지막 요청 결과가 먼저 보이고, 연결과 저장 상태는 [기억 환경]에서 펼쳐 봅니다."
          }
        }
      ]
    },
    {
      "id": "move-chat",
      "title": "채팅을 새로 팠다면",
      "lead": "기억뜰은 채팅별로 나뉩니다. 같은 캐릭터의 옛 채팅을 이어 쓰려면 새 채팅에서 한 번 가져옵니다.",
      "steps": [
        {
          "title": "옛 채팅의 기억 가져오기",
          "body": "가져오기는 지금 열어 둔 새 채팅에 기억과 손요약을 합칩니다. 옛 채팅과 옛 기억은 그대로 남습니다.",
          "actions": [
            "먼저 이어서 사용할 새 채팅을 엽니다.",
            "옮기기 · 복구 → [옛 채팅 찾기]를 누릅니다.",
            "목록에서 옛 채팅의 맥락 따라잡기 상태를 확인하고 가져옵니다."
          ],
          "success": "새 채팅의 기억뜰에 옛 기억이 합쳐지면 됩니다. 같은 기억은 하나로 정리되며, 새 기억과 중복 정리 수는 개요에서 다시 볼 수 있습니다.",
          "image": {
            "file": "guide-06-move.png",
            "alt": "옮기기 복구 탭의 옛 채팅 찾기 버튼",
            "caption": "새 채팅을 연 상태에서 옮기기 · 복구 → [옛 채팅 찾기]를 누릅니다."
          }
        }
      ]
    },
    {
      "id": "server-run",
      "title": "기억 처리를 뿌리 서버에 맡기려면",
      "lead": "개인 뿌리 서버가 있고 운영자에게 연결 파일을 받았을 때의 순서입니다. 서버는 선택이며, 없으면 이 절은 건너뜁니다. 옮긴 채팅의 기억 추출과 검색은 서버가 맡고, 리스의 답변 생성은 그대로 리스가 합니다.",
      "steps": [
        {
          "title": "서버에 모델 등록하기",
          "body": "서버는 자기에게 등록된 모델만 씁니다. 리프의 키를 그대로 복사하거나 Vertex를 직접 등록합니다. 한 번 등록하면 모든 채팅이 같은 연결을 씁니다.",
          "actions": [
            "프로바이더 탭 아래 [서버 연결·모델·기기]에서 [뿌리 서버 관리]를 누르고 연결 파일로 관리 권한 연결을 합니다.",
            "[API 키와 모델] → [리프 연결 설정 복사]에서 기억 추출 모델을 골라 동의 뒤 복사합니다.",
            "임베딩을 쓰는 기억뜰이면 임베딩 모델도 등록합니다. Vertex는 gemini-embedding-2만 받으므로 다른 모델이면 [Vertex AI 직접 등록·교체]에서 그 모델로 등록합니다."
          ],
          "success": "[등록된 연결] 목록에 기억 추출 모델이 보이면 됩니다. 임베딩을 쓰면 임베딩 용도 연결도 함께 보여야 합니다.",
          "image": {
            "file": "guide-07-server-manage.png",
            "alt": "뿌리 서버 관리 창의 리프 연결 설정 복사",
            "caption": "관리 권한으로 연결한 뒤 리프의 연결을 서버에 복사합니다. 키는 서버에 저장됩니다."
          }
        },
        {
          "title": "현재 채팅을 서버로 이전",
          "body": "옮기고 싶은 채팅을 연 채로 시작합니다. 창 위의 단계 줄(연결 · 준비 · 백업 · 올리기 · 모델 · 시작)이 지금 어디인지 보여 줍니다. 백업 파일은 되돌릴 때 쓰이므로 보관합니다.",
          "actions": [
            "프로바이더 탭 맨 아래 [서버 연산으로 이전] 카드에서 [현재 채팅을 서버로 이전]을 누릅니다.",
            "연결 파일을 가져와 지문을 확인하고 [이전 준비 시작]을 누릅니다.",
            "[백업 파일 저장]으로 파일을 받은 뒤 같은 파일을 다시 골라 [이전 준비 계속], 그다음 [기억뜰 올리기]를 누릅니다."
          ],
          "success": "\"현재 기억뜰과 같은 백업입니다\"가 뜨고 올리기가 끝나면 모델 단계로 넘어갑니다.",
          "image": {
            "file": "guide-08-migrate-backup.png",
            "alt": "이전 창의 단계 줄과 백업 파일 저장",
            "caption": "백업 파일을 저장하고 같은 파일을 다시 골라야 다음 단계가 열립니다."
          }
        },
        {
          "title": "모델 배정하고 서버 실행 시작",
          "body": "이 기억뜰이 서버에서 쓸 모델을 고릅니다. 기억 추출은 필수이고, 임베딩 사용을 켜 둔 기억뜰은 임베딩 모델도 골라야 합니다. 비어 있으면 저장과 시작이 막히고 등록 경로를 안내합니다.",
          "actions": [
            "[모델 배정]에서 기억 추출 모델을 고르고, 필요하면 임베딩 모델도 고른 뒤 [모델 배정 저장]을 누릅니다.",
            "고를 모델이 없으면 칸 아래 [서버 관리 열기]로 등록한 뒤 목록이 다시 읽히는 것을 확인합니다.",
            "[서버 실행 시작]을 누릅니다."
          ],
          "success": "\"이 기억뜰의 서버 실행을 시작했습니다\"가 나오면 끝입니다. 임베딩을 쓰지 않으려면 [이전 준비 취소] 뒤 고급설정에서 임베딩 사용을 끄고 다시 준비합니다.",
          "image": {
            "file": "guide-09-migrate-models.png",
            "alt": "이전 창의 모델 배정과 서버 실행 시작 버튼",
            "caption": "필요한 기능의 모델이 비어 있으면 서버 실행 시작이 막힙니다."
          }
        },
        {
          "title": "옮긴 채팅의 메뉴 확인",
          "body": "옮긴 채팅에서 위그로어를 열면 평소 패널이 열리고 첫 탭이 [뿌리 실행]입니다. 개요·기억뜰·의미 추출·옮기기 탭은 이 채팅에서는 서버가 대신하므로 없고, 프로바이더·고급설정·정보 탭은 그대로입니다.",
          "actions": [
            "채팅에서 위그로어를 열어 [뿌리 실행] 탭의 \"서버 연결됨\"과 기억 수를 확인합니다.",
            "메시지를 한 번 보내고 [서버 작업 기록]에서 처리 결과를 봅니다."
          ],
          "success": "상태 줄이 \"서버 연결됨 · 주소\"이고 기억뜰 목록이 보이면 이 채팅은 서버에서 기억을 처리합니다.",
          "image": {
            "file": "guide-10-server-tab.png",
            "alt": "옮긴 채팅의 위그로어 패널과 뿌리 실행 탭",
            "caption": "옮긴 채팅에서는 첫 탭이 뿌리 실행이고 전역 설정 탭은 그대로입니다."
          }
        }
      ]
    }
  ],
  "referenceSections": [
    {
      "id": "updates-and-translations",
      "title": "업데이트와 번역 플러그인",
      "summary": "확인 뒤 교체, 기억은 원문으로",
      "items": [
        {
          "title": "공식 업데이트",
          "body": "첫 설치는 받은 zip으로 합니다. 이후 새 버전이 나오면 RisuAI 플러그인 화면이 허깅페이스의 공식 파일을 확인해 업데이트 단추를 보여 줍니다. 사용자가 확인한 뒤에만 같은 빌드 계열로 교체합니다."
        },
        {
          "title": "Yumi Translator",
          "body": "화면에 번역문이 보여도 Yumi가 따로 보존한 모델 원문이 있으면 그 원문으로 기억을 만듭니다. 보존 원문이 없거나 손상된 메시지만 화면의 현재 내용을 그대로 읽습니다. 출력 언어 옆의 [번역 플러그인을 쓰고 있나요?]에서 이 안내를 다시 볼 수 있습니다."
        },
        {
          "title": "요약과 인용의 언어",
          "body": "출력 언어는 새로 만드는 요약 설명에 적용됩니다. 원문 인용·검색어·말투 표기는 원래 언어를 유지할 수 있으며 기존 기억은 일괄 번역하지 않습니다."
        },
        {
          "title": "구버전으로 되돌리기 전",
          "body": "새 버전이 저장한 기억을 구버전이 직접 읽는 것은 지원하지 않습니다. 버전을 내리기 전에는 기억뜰을 파일로 내보내 따로 보관해 주세요."
        }
      ]
    },
    {
      "id": "provider-slots",
      "title": "프로바이더 슬롯 셋의 차이",
      "summary": "텍스트 생성만 필수",
      "items": [
        {
          "title": "텍스트 생성",
          "body": "사건 기억과 맥락 따라잡기를 담당하는 필수 슬롯입니다. 이 칸이 비어 있으면 사건 기억이 생기지 않습니다."
        },
        {
          "title": "임베딩",
          "body": "비슷한 기억끼리 미리 이어 두는 선택 슬롯이며 기본값은 꺼짐입니다. 프로바이더의 임베딩 칸에서 사용 여부와 최근 호출 결과를 따로 확인합니다. 실패 사유는 같은 칸과 정보 → 로그이력에 남습니다. 서버로 옮길 기억뜰이라면 서버에도 같은 용도의 모델을 등록해야 합니다."
        },
        {
          "title": "보조 검색",
          "body": "인덱싱과 후보 선별에 쓰는 선택 슬롯입니다. 비워 두면 텍스트 생성 슬롯의 모델을 사용합니다."
        }
      ]
    },
    {
      "id": "daily-check",
      "title": "평소에는 무엇을 하나요",
      "summary": "대화하고 가끔 개요만 확인",
      "items": [
        {
          "title": "매번 버튼을 누르지 않습니다",
          "body": "첫 설정 뒤에는 평소처럼 대화하면 됩니다. 새 대화가 쌓이면 다음 메시지를 보낼 때 이어서 읽습니다."
        },
        {
          "title": "최근 채팅은 지우지 않습니다",
          "body": "오래된 배경 기억은 최근 두 턴보다 앞에 두고, 최근 대화와 현재 입력은 그 뒤에 그대로 남깁니다. 개요의 [이번 요청]에서 실제 적용 여부를 확인할 수 있습니다."
        },
        {
          "title": "기억 환경 확인",
          "body": "개요의 [기억 환경]을 펼치면 텍스트 생성, 임베딩, 저장 위치, 최대 컨텍스트를 함께 볼 수 있습니다. 다른 플러그인 이름은 [함께 켠 플러그인 확인]을 눌렀을 때만 읽습니다."
        },
        {
          "title": "삭제와 리롤 결과 확인",
          "body": "메시지를 삭제하거나 리롤한 뒤에는 개요에서 되돌린 메시지, 다시 읽은 메시지, 정리 대기 기억을 확인할 수 있습니다. 큰 삭제는 확인이 필요하다고 따로 표시합니다."
        },
        {
          "title": "기억을 직접 보고 싶을 때",
          "body": "기억뜰 탭에서 검색하고 카드를 열면 내용, 원문 근거, 아는 인물, 연결 관계를 확인할 수 있습니다."
        },
        {
          "title": "원문을 고쳤을 때",
          "body": "저장된 인용이 현재 원문과 달라진 기억은 주입에서 제외합니다. 기억뜰의 [이력]에서 열고 [원문에서 다시 뽑기]로 후보를 확인해 주세요. 출처 없는 기억이나 삭제된 원문은 자동 판정하지 않습니다."
        },
        {
          "title": "기억 속 이름 정정",
          "body": "기억 편집의 [이 기억에서 이름 정정]을 열고 찾을 이름과 바꿀 이름을 적습니다. 이름·본문·키워드·별칭·맥락의 변경 내용을 미리 본 뒤 편집 칸에 반영하고 저장합니다. 원문 인용과 다른 기억은 바꾸지 않습니다."
        },
        {
          "title": "본체 모듈 토글 연동",
          "body": "RisuAI 2026.10.21 이상이면 위그로어가 본체의 토글 값을 그대로 읽습니다. 토글은 리스 토글 패널에서 바꾸고, 위그로어의 [의미 추출 → 흡수 설정 → 토글 관리]에는 [본체 설정]으로 표시된 읽기 전용 값이 보입니다. 그보다 오래된 본체에서는 그 화면에서 직접 바꿉니다. 토글마다 아래 줄에 그 토글이 여는 로어북 항목 이름이 보입니다."
        },
        {
          "title": "오류가 반복될 때",
          "body": "정보 → 로그이력에서 직전 실패를 확인합니다. \"모델이 본문 없이 응답했습니다\"가 보이면 연결은 됐지만 모델이 아무 글도 돌려주지 않은 경우입니다. 함께 적힌 사유(finishReason·blockReason)로 안전 차단·출력 한도·모델 이름을 확인하세요. 맥락 따라잡기가 \"JSON 형식을 읽지 못함\"으로 끝났다면 같은 줄의 \"응답 끝\"에서 응답이 끊긴 자리를 볼 수 있습니다. 제보할 때는 로그이력의 내보내기 파일을 함께 보내 주세요."
        }
      ]
    },
    {
      "id": "delete-and-backup",
      "title": "대화를 자르거나 기기를 옮길 때",
      "summary": "먼저 읽고 백업",
      "items": [
        {
          "title": "대화를 지우기 전",
          "body": "가능하면 자르기 전 복사본에서 맥락 따라잡기를 끝냅니다. 그다음 잘라낸 채팅으로 돌아와 복사본의 기억을 가져옵니다."
        },
        {
          "title": "다른 기기 또는 다른 캐릭터 카드",
          "body": "옮기기 · 복구 → 백업 · 정리에서 기억뜰을 JSON으로 내보낸 뒤 새 환경에서 가져옵니다. 봇 스크립트가 따로 관리하는 호감도와 상태창 값은 포함되지 않습니다."
        },
        {
          "title": "설정과 현재 기억뜰 백업",
          "body": "옮기기 · 복구 → 백업 · 정리 → 설정 · 현재 기억뜰 백업에서 저장합니다. 프로바이더와 모델 슬롯을 포함하며, 기억뜰은 현재 채팅 하나만 담습니다. 다른 채팅과 서버에만 있는 기억은 포함하지 않습니다."
        },
        {
          "title": "인증정보를 포함하려면",
          "body": "[API 키·뿌리 백업 토큰 포함]을 선택하면 인증정보를 평문으로 저장합니다. 파일을 공개하거나 제보에 첨부하지 마세요. 서버 실행의 기기 인증은 별도로 연결해야 합니다."
        },
        {
          "title": "이전 백업 파일을 가져올 때",
          "body": "파일에 없는 프로바이더·모델 슬롯과 제외된 인증정보는 현재 값을 유지합니다. 예전 파일에 빠진 설정을 복원할 수는 없습니다. 복원 미완료가 표시되면 백업을 보관하고 오류를 확인하세요."
        },
        {
          "title": "로컬 저장 상태 확인",
          "body": "옮기기 · 복구 → 백업 · 정리에서 [저장 상태 확인]을 누르면 이 기기의 추정 사용량과 5MB를 넘는 항목을 볼 수 있습니다. 저장 조각 수만으로 용량 문제를 뜻하지는 않습니다."
        },
        {
          "title": "저장 실패로 전환이 멈췄다면",
          "body": "이전 채팅으로 돌아가 옮기기 · 복구 → 백업 · 정리 → 채팅과 함께 보내기 / 임베드에서 [파일로 내보내기 (JSON)]를 눌러 기억을 보관해 주세요. 리스 채팅도 별도로 내보냅니다. 위그로어의 저장 성공과 뿌리 백업은 리스 채팅 전체의 디스크 자동저장 완료를 뜻하지 않습니다."
        },
        {
          "title": "실행 순서를 바꾸면 해결되나요?",
          "body": "목록 순서만으로 실행 순서가 정해지지 않습니다. 최신 본체는 플러그인 목록 변경도 제한하므로 순서 변경을 복구 절차로 쓰지 마세요. 여러 플러그인이 함께 멈췄다면 본체 버전과 복원한 백업 종류를 알려 주세요."
        },
        {
          "title": "플러그인을 꺼도 기억은 남습니다",
          "body": "리스 본체에서 WygLore가 켜져 있는지 확인하세요. 위그로어의 자동 실행 설정과 현재 채팅의 기억뜰 연결은 별도입니다. 꺼진 플러그인은 자체 상태 알림도 표시할 수 없습니다."
        }
      ]
    },
    {
      "id": "root-backup",
      "title": "뿌리 서버에 백업만 맡길 때",
      "summary": "백업과 서버 실행은 다른 연결",
      "items": [
        {
          "title": "백업용 접속 토큰",
          "body": "프로바이더 탭의 뿌리 서버 카드에 주소·포트·백업용 접속 토큰을 넣습니다. 이 토큰은 백업에만 쓰이며 서버 실행용 기기 토큰·연결 파일과 다릅니다. 주소나 포트만 고칠 때 토큰 칸을 비워 두어도 저장된 토큰은 그대로 남고, 토큰을 지우려면 그 칸을 직접 비웁니다."
        },
        {
          "title": "백업·자동 절감",
          "body": "기존 뿌리 백업 연결을 새로 켜면 자동 절감도 켜집니다. 서버 백업과 내용이 일치한 지난 기억뜰만 이 기기에서 비우며, 다시 열 때 서버 연결이 필요합니다. 로컬 사본을 계속 보관하려면 [자동 절감 · 지금 쓰는 기억뜰만 보관]을 끄세요."
        },
        {
          "title": "이미 뿌리를 쓰고 있다면",
          "body": "기존에 자동 절감을 꺼 두셨다면 업데이트 뒤에도 그대로입니다. 뿌리 설정에서 켜면 누적된 지난 기억뜰도 확인합니다. 현재 기억뜰과 확인에 실패한 사본은 기기에 남습니다."
        },
        {
          "title": "기억과 모델 전송",
          "body": "로컬 모드의 기억뜰은 RisuAI 플러그인 저장소에, 서버 실행으로 옮긴 기억뜰은 개인 뿌리 서버에 남습니다. 맥락 따라잡기와 인덱싱 등에 필요한 대화나 로어북 내용은 해당 모드에 설정한 모델 제공자로 전송됩니다. RP 답변 생성은 리스가 계속 맡습니다."
        }
      ]
    },
    {
      "id": "server-run",
      "title": "서버에서 기억을 처리하는 채팅",
      "summary": "첫 탭이 뿌리 실행",
      "items": [
        {
          "title": "옮긴 채팅의 메뉴",
          "body": "옮긴 채팅에서 위그로어를 열면 평소 패널이 열리고 첫 탭이 [뿌리 실행]입니다. 개요·기억뜰·의미 추출·옮기기 탭은 이 채팅에서는 서버가 대신하므로 보이지 않습니다. 프로바이더·고급설정·정보 탭은 그대로이며, 고급설정에는 이 기기의 전역 기본값만 보입니다. 다른 채팅은 평소 메뉴가 그대로 열립니다."
        },
        {
          "title": "데이터베이스 접근 허용 창",
          "body": "옮긴 채팅에서 메시지를 보내면 RisuAI가 위그로어의 데이터베이스 접근 허용 창을 띄울 수 있습니다. 위그로어를 업데이트한 뒤와 마지막 허용에서 3일이 지난 뒤 뜨며, 허용을 눌러야 메시지가 서버로 갑니다. 오류 창에 거절된 상태라는 안내가 나오면 RisuAI를 새로고침한 뒤 메시지를 다시 보내고, 허용 창에서 허용을 눌러 주세요."
        },
        {
          "title": "뿌리 실행 탭에서 하는 일",
          "body": "상태 줄에 서버 연결과 주소가 보이고, 기억뜰 목록에서 기억을 검색·열람·편집합니다. 아래 접기는 세 묶음입니다. [이 기억뜰]에 처리 설정·모델 배정·페르소나 전환, [서버]에 서버 작업 기록·서버 관리, [되돌리기·옮기기]에 초기화·복원 전 보관본과 [이 기기로 옮기기]가 있습니다."
        },
        {
          "title": "옮긴 채팅의 토글",
          "body": "[이 기억뜰 → 캐릭터·모듈 토글]에 이 채팅의 캐릭터·모듈 토글이 모듈별로 보이고, 토글마다 여는 로어북 항목 이름이 함께 보입니다. RisuAI 2026.10.21 이상에서는 \"본체 토글 연동 중\"으로 읽기 전용이며 리스 토글 패널에서 바꾼 값이 다음 메시지부터 서버에 들어갑니다. 그보다 오래된 본체에서는 이 접기에서 바꿉니다. 저장이 실패하면 스위치가 바꾸기 전 값으로 돌아가니 같은 스위치를 다시 눌러 주세요."
        },
        {
          "title": "서버 모델 요청이 실패했다면",
          "body": "리스 오류 창에 실패 사유와 다음 할 일이 보입니다. 자세한 단계와 HTTP 상태는 [뿌리 실행 → 서버 작업 기록]에서 확인하세요. 실패한 작업은 만든 지 1시간 안에만 재시도할 수 있습니다. 기한이 지나면 [재시도] 대신 안내가 보이니 [진행 중인 작업]에서 [작업 정리]를 누른 뒤 메시지를 다시 보내세요. 새 요청은 처음부터 다시 처리하므로 모델 호출 비용이 다시 들 수 있습니다. 429는 기다린 뒤 재시도하고, 응답 미확인은 추가 비용 가능성을 확인해야 합니다."
        },
        {
          "title": "필요한 기능의 모델이 없다면",
          "body": "임베딩 사용을 켜 둔 기억뜰은 서버에 임베딩 모델이 배정돼야 서버 실행을 시작할 수 있습니다. 모델 배정 칸이 비어 있으면 칸 아래 [서버 관리 열기]로 등록합니다. 리프에서 쓰던 임베딩 모델이 Vertex의 gemini-embedding-2가 아니면 복사가 되지 않으므로 [Vertex AI 직접 등록·교체]에 그 모델로 등록합니다. 임베딩을 쓰지 않으려면 [이전 준비 취소] 뒤 고급설정에서 임베딩 사용을 끄고 다시 준비합니다."
        },
        {
          "title": "임베딩 확인이 필요하다고 나오면",
          "body": "기억뜰 제목 아래 메타 줄에 임베딩 상태가 한 단어로 보입니다. 기존 임베딩의 생성 모델을 알 수 없거나 서버 모델과 다를 때만 [임베딩 확인이 필요합니다] 절이 위에 나타납니다. 그때 남은 작업을 정리한 뒤 [임베딩 다시 준비]를 누르면 현재 상태를 서버에 보관하고 임베딩만 비웁니다. 기억 본문·관계·손요약은 유지하며 이후 재생성에는 비용이 들 수 있습니다."
        },
        {
          "title": "이전 준비가 멈췄다면",
          "body": "\"본문을 복원하지 못한 설정 기억\"으로 멈추면 이전 준비를 취소하고 이 채팅에서 메시지를 한 번 주고받은 뒤 다시 시도합니다. 서버가 모델 미배정으로 활성화를 거절했을 때는 [이전 상태 확인]을 한 번 누르면 대기 표식이 풀리고 배정이나 취소를 이어서 할 수 있습니다. 기억뜰을 비우거나 다시 추출할 필요는 없습니다."
        },
        {
          "title": "서버 연결이 끊기면",
          "body": "서버 실행으로 옮긴 기억뜰은 연결되어야 처리할 수 있습니다. 옛 로컬 기억으로 자동 전환하지 않습니다. 다른 창이나 기기는 확인 후 인수하며, 서버가 받지 않은 원문까지 옮겨지지는 않습니다. 로컬로 돌아오려면 [되돌리기·옮기기 → 이 기기로 기억 처리 옮기기]에서 최신 서버 자료를 확인해 새 기억뜰로 복귀하세요."
        },
        {
          "title": "복귀 때 재생성 확인이 뜬다면",
          "body": "채팅을 새로 하지 않았어도 기존 벡터의 생성 모델 기록이 없으면 호환을 확인할 수 없습니다. 화면에서 출처 미확인과 설정 불일치를 구분합니다. 확인된 같은 설정의 벡터는 유지합니다."
        },
        {
          "title": "여러 채팅을 한 번에 옮기려면",
          "body": "[프로바이더 → 뿌리 서버 관리]에서 관리 권한으로 연결한 뒤 [채팅 일괄 이전]을 엽니다. [대상 읽기]로 옮길 수 있는 채팅과 제외 사유를 확인하고, 선택한 채팅이나 전체를 고른 다음 [백업 묶음 만들기]로 파일을 저장하고 다시 골라 확인하면 [이전 시작]이 열립니다. 한 채팅씩 차례로 옮기며, 진행 중에는 채팅 요청을 보낼 수 없습니다. 지금 열려 있는 채팅은 그 채팅의 [이전 준비]에서 옮깁니다."
        },
        {
          "title": "일괄 이전이 중간에 멈췄다면",
          "body": "완료된 채팅은 그대로 서버에서 처리합니다. 실패한 채팅은 사유를 확인하고 [실패 항목 다시 진행]을 누르세요. 창을 닫았다 열면 그때 저장한 묶음 파일을 다시 골라 [이어서 진행]할 수 있습니다. 압축된 채팅이나 오래된 설정 형식은 그 채팅을 한 번 연 뒤 다시 시도합니다. 포켓리스는 이번 실행에서 열지 않은 채팅을 모두 압축 상태로 두므로, 옮길 채팅을 먼저 열어 본 뒤 다른 채팅으로 옮겨 가서 [대상 읽기]를 누릅니다."
        },
        {
          "title": "서버 관리 창",
          "body": "[뿌리 서버 관리]는 채팅을 고르지 않아도 관리 권한 토큰으로 연결합니다. 리프에 저장한 기억 추출·임베딩·재순위 연결을 동의 후 서버에 복사하고, Vertex 등록·교체, 기기 토큰 발급·회수, 서버 정보를 확인합니다. 서버 전체 백업·복구는 다른 기기의 토큰과 모델 비밀키가 들어 있어 운영자만 할 수 있습니다. 리프의 기억뜰 내보내기는 서버 전체 백업이 아닙니다."
        }
      ]
    }
  ]
}