📁 폴더 마스터 v3.06 (169164438)

폴더 마스터 v3.06
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.06 NEW
v3.06 실수 방지 + 정보 배지
되돌리기 · 자동 정리 · 폴더 색상 · 봇 정보 배지 · 드래그 UX 개선
되돌리기
이동/삭제/정리 후
8초간
토스트 표시
클릭 한 번으로 직전 상태 복원
lock 내 snapshot으로 레이스 방지
대량 이동 확인
20개 이상 봇 이동 시
확인 모달
표시
전체선택 실수 방지
유령 봇 정리
중복 감지 모달에서
원클릭 자동 제거
characterOrder만 정리
중복 UUID 정리
같은 봇 여러 폴더 등록 시
첫 위치만 유지
나머지 자동 제거
폴더 색상
9색 팔레트
선택
폴더 테두리에 반영
시각적 분류 강화
빈 폴더 정리
봇이 0개인 폴더
id 기준
일괄 삭제
동명 폴더도 안전
봇 정보 배지
모듈 수 ·
에셋 수
그룹 ·
마지막 대화
폴더 헤더에도 대화 시간 표시
새로고침 /
취소
캐시 무효화 새로고침
자유 편집
취소 버튼
저장 없이 원상복구
드래그 UX 개선
봇 위
삽입 위치 표시
드래그 시 드롭존 ghost 표시
폴더 밖 초록 점선 테두리
터치 드래그 안정화
전역 터치 상태 관리
touchcancel
watchdog
방어
스크롤/드래그 충돌 해결
v3.06 SCREENSHOTS
v3.06 스크린샷
클릭하여 확대
되돌리기 토스트 + 정보 배지
폴더 색상 +
빈 폴더 정리
봇 정보 배지
드래그 드롭존 표시
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.06
— 실수 방지 + 정보 배지
•
되돌리기 — 이동/삭제/정리 후 8초 토스트 (lock 내 snapshot 캡처)
•
대량 이동 확인 — 20개+ 봇 이동 시 확인 모달
•
유령 봇 원클릭 정리 (중복 감지 모달 내)
•
중복 UUID 원클릭 정리 (첫 위치만 유지)
•
폴더 색상 — 9색 팔레트, 테두리 반영
•
빈 폴더 일괄 삭제 (id 기준, 동명 폴더 안전)
•
봇 배지 —
모듈
에셋
그룹
마지막대화
• 폴더 헤더 줄바꿈 — 이름/카운트+시간 분리
•
새로고침 버튼 (캐시 무효화)
•
자유 편집 취소 버튼
•
봇 드래그 삽입 위치 표시 (box-shadow)
• 드래그 시 드롭존 ghost + 폴더 밖 점선 테두리
•
터치 드래그 안정화 — 전역 터치 상태, touchcancel watchdog
• 성능: getDatabase(['characterOrder']) 경량 호출, characters 캐시
• Blob URL 누수 수정 (openManager 재호출 시 revoke)
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 시작 (초기 로딩 대폭 감소)