📁폴더 마스터 v3.05 (167176247)

폴더 마스터 v3.05
FOLDERMASTER · RISUAI PLUGIN · API 3.0
RisuAI의 봇 폴더를 직관적으로 관리할 수 있는 플러그인입니다.
기존
폴더 매니저
의 개발 중단 이후 불편함을 느껴 개인적으로, API 3.0 기반으로 처음부터 새로 제작되었습니다.
바둑판/큰 타일/리스트 3가지 뷰 모드, 폴더 생성·삭제·이름변경·이미지 변경,
봇 다중선택 후 원클릭 이동, 폴더 내 전체선택/해제, 검색 기능을 지원합니다.
스크린샷속 폴더아이콘
폴더 매니져용 SD 캐릭터 아이콘 몇개더추가. - AI 채팅 채널
FEATURES
주요 기능
폴더 관리
생성 · 삭제 · 이름변경
이미지 변경 · 기본복원
봇 이동
다중선택 + 원클릭 이동
폴더→폴더 · 폴더 밖 이동
검색
폴더 안 봇까지 검색
매칭 폴더 자동 열기
▦
3가지 뷰 모드
바둑판 · 큰 타일 · 리스트
폴더+봇 동시 변환
전체선택/해제
루트 · 폴더별 분리
토글 방식 전환
반응형 UI
PC · 태블릿 · 모바일
자동 레이아웃 전환
기술 사양
• RisuAI Plugin API
3.0
• DB 접근:
characterOrder
키만 사용
• 저장:
setDatabaseLite
(안전)
• 아바타:
readImage → Blob URL
• Container Mode: fullscreen
안전 설계
•
setDatabase 미사용
(플러그인 삭제 방지)
• characterOrder
단일 키만
전송
• plugins/characters 키
접근 안 함
• 외부 CDN/스크립트
없음
NodeOnly 서버 환경 지원
NodeOnly 서버 환경에서 아바타 이미지를 표시하기 위해
Risuai.readImage()
→
Blob URL
변환 방식을 사용합니다.
JPEG/PNG 자동 감지 지원.
개인 서버 빌드환경이라 테스트는 못해봤습니다.
v3.05 NEW
v3.05 성능 최적화
아바타 로딩 대폭 개선 · 메모리 누수 수정 · 검색 debounce
Lazy Avatar Loading
IntersectionObserver 기반
뷰포트에 보이는 아바타만 로드
닫힌 폴더 내부 봇은
로드 안 함
Blob URL 전환
base64 data URI 제거
createObjectURL
방식으로 전환
이미지당 CPU 50-80% 절감
검색 Debounce
150ms debounce 적용
타이핑 중 DOM 순회 감소
cancel/flush
지원
메모리 관리
닫기 시
revokeObjectURL
정리
shutdown guard — in-flight 로드 차단
loadQueue flush로 누수 방지
동시 로드 제한
MAX_CONCURRENT_LOADS = 8
뷰포트에 봇 많아도
8개씩
순차 로드
서버 부하 방지
전 환경 호환
업스트림 Web (IndexedDB)
NodeOnly 서버
Tauri 데스크톱 —
전부 OK
v3.05 SCREENSHOTS
v3.05 스크린샷
웹리스(업스트림) / 노드리스(NodeOnly) 비교
웹리스 (업스트림)
노드리스 (Node)
v3.04 NEW
v3.04 자율 편집 모드
순서 편집 모드의 드래그 앤 드롭 대폭 강화
열기 버튼
순서 편집 모드에서 폴더 카드에
초록색
"
열기"
버튼 표시
폴더를 열어 내부 봇도 드래그 가능
✓ 선택 토글 제거
순서 편집 모드에서
봇 체크박스
숨김
클릭 즉시 드래그 모드로 진입
→
봇→폴더 드롭
봇을 폴더 카드 위로 드래그하면
해당 폴더
안으로 이동
폴더가 열려있지 않아도 가능
→
봇→루트 드롭
폴더 안 봇을 루트 영역으로
드래그하면
폴더 밖으로 이동
드래그 한 번으로 이동 완료
폴더
폴더
열린 폴더 안 봇을
다른 봇 위에 드롭하면
해당
위치로 이동
안전성 강화
deep copy
— 원본 오염 방지
mutex
— 동시 저장 방지
safeAvatar chunk
— OOM 방지
INSTALL
설치 방법
1
아래 다운로드 버튼으로
folder_master_v3.js
파일 다운로드
2
RisuAI → 설정 → 플러그인 →
+
버튼으로 임포트
3
설정 메뉴 또는 햄버거 메뉴에서
폴더 마스터 v3
클릭
다운로드 (Proton Drive)
v3.04 SCREENSHOTS
v3.04 패치 자유 편집 스크린샷
클릭하여 확대
열기 버튼 & 봇→폴더 드롭
봇→루트 드롭 (폴더 밖으로)
폴더 간 봇 이동
v3.02 UPDATE
v3.02 패치 스크린샷
클릭하여 확대
폴더 순서 변경
중복 감지
같은 UUID 중복 등록
— 같은 chaId가 여러 폴더/루트에 있는 경우
같은 이름 다른 봇
— 이름은 같지만 UUID가 다른 봇들 (리리스봇 케이스). 각각의 UUID 앞 8자리 + 위치 표시
유령 봇
— characterOrder에는 있지만 characters에 실제 데이터 없는 봇
드래그 순서 편집 모드
SCREENSHOTS
기본 기능 스크린샷
클릭하여 확대
햄버거 메뉴 아이콘
설정 메뉴 아이콘
폴더 열기
봇 이동
뷰 모드 전환
폴더 내 검색
변경 이력
클릭하여 펼치기
v3.05
— 성능 최적화
• IntersectionObserver 기반 lazy avatar loading (뷰포트 진입 시만 로드)
• base64 data URI 제거 → URL.createObjectURL(Blob) 전환 (CPU 50-80% 절감)
• 검색 debounce 150ms 적용 (cancel/flush 지원)
• 동시 로드 큐 MAX_CONCURRENT_LOADS = 8 (서버 부하 방지)
• 닫기 시 revokeObjectURL + loadQueue flush (메모리 누수 방지)
• shutdown guard — 닫기 후 in-flight readImage 콜백 차단
• dock 영역 호환 — observer root를 viewport 기준으로 변경
• 폴더 열 때만 내부 봇 아바타 observe 시작 (초기 로딩 대폭 감소)
• 업스트림 Web / NodeOnly / Tauri 전 환경 호환
v3.04
— 자율 편집 모드
• 순서 편집 모드에서 폴더 카드에 초록색
"
열기"
버튼 표시
• 순서 편집 모드에서 봇 체크박스(✓) 숨김 — 클릭 없이 바로 드래그
• 봇→폴더 드롭: 봇을 폴더 카드 위에 드래그하면 해당 폴더 안으로 이동
• 봇→루트 드롭: 폴더 안 봇을 루트 영역으로 드래그하면 폴더 밖으로 이동
• 폴더
폴더: 열린 폴더 안 봇을 다른 봇 위에 드롭하면 해당 위치로 이동
• deep copy — characterOrder 수정 시 원본 오염 방지
• mutex — 동시 저장 방지
• 이동 안전 — 대상 폴더 확인 후 제거
• safeAvatar chunk — 대용량 이미지 OOM 방지
v3.03
— 패치
• 드래그 순서 저장 시 루트/폴더 혼합 배치 보존 안 되던 문제 수정
• 드래그 저장 후 data-fi 인덱스 불일치로 엉뚱한 폴더 수정/삭제되던 문제 수정 (저장 후 재렌더)
• 검색 중 숨겨진 카드가 선택 유지돼서 이동 시 딸려가던 문제 수정
• 폴더 내 전체선택이 검색으로 숨겨진 카드까지 포함하던 문제 수정
• contextmenu 리스너 누적 수정 (named function + removeEventListener)
• 모바일 터치 드래그 long-press 300ms threshold 추가 (스크롤 충돌 완화)
• 순서 편집 모드 중 다른 액션 버튼 잠금 추가
• 순서 편집 진입 시 검색 상태 자동 해제
• 저장 클릭 즉시 UI 잠금 (드래그/재클릭 차단)
• 아바타 로딩 병렬화 (동시 6개 제한)
• 순서 편집 모드 안내 문구 명확화
v3.02
— 패치
•
드래그 순서 편집 모드 추가 (폴더 + 봇 둘 다 드래그 가능)
•
폴더 순서 변경 버튼 추가 (폴더 도구바에)
•
중복 감지 기능 추가 (같은 UUID 중복 등록 + 유령 봇 감지, 읽기 전용)
• 모바일 터치 드래그 지원 (고스트 이미지 + 컨텍스트 메뉴 방지)
• 스크롤 위치 유지 (작업 후 화면 위치 복원)
v3.01
— 패치
• 폴더 내부 배치 최적화
v3.0
— 최초 배포
• API 3.0 기반 신규 제작
• setDatabaseLite 안전 저장 방식
• 바둑판/큰타일/리스트 뷰 모드
• 폴더 관리 (생성/삭제/이름변경/이미지변경)
• 봇 다중선택 이동, 폴더 밖 이동
• 폴더 내