kone
AI 채팅 - LLM
AI 채팅 - LLM

FolderManager v3.0 (Plugin API 3.0)

02/22/2026, 22:57:32
플러그인
1517 views · 4 likes

**-- Main Container --**

RisuAI Extension Plugin

Folder Manager
v3.0

RisuAI API 3.0 환경에 맞춰 전면 재설계된 로컬 기반 캐릭터 폴더 관리 시스템입니다.
캐릭터 목록의 시각적 분류, 일괄 이동, 커스텀 썸네일 및 홈 화면 네이티브 연동을 지원합니다.
(그렇게 대단한거 아닙니다.)

개요 (Overview)

Folder Manager v3.0은 RisuAI의 캐릭터 목록을 효율적으로 관리하기 위한 플러그인입니다.
(1월 초에 이미 마이그레이션 작업을 완료했습니다.)
v3.0 업데이트를 통해 RisuAI의 API 3.0 규격을 준수하며, 브라우저의 IndexedDB를 활용한 안전한 이미지 저장소(Inlay Manager)를 구축했습니다.

상세 기능 설명 (Features)

1. 홈 화면 네이티브 연동 (Root Document Observer)

별도의 관리 창을 열지 않아도 홈 화면(캐릭터 목록)에서 직접적인 상호작용이 가능합니다.

  • 롱 프레스 팝업: 홈 화면의 폴더 아이콘을 0.5초 이상 길게 누르면 설정 팝업이 호출됩니다. 이 팝업에서 폴더 색상, 썸네일, 이름 변경 및 삭제를 바로 수행할 수 있습니다. (모바일 기준 일부 환경에서만 가능합니다.)

  • 드래그 앤 드롭: 홈 화면 내에서 폴더의 순서를 드래그하여 직관적으로 재배치할 수 있습니다.(플러그인 자체 기능으로는 이것도 미구현)

  • 실시간 렌더링: risuai.createMutationObserver 를 통해 홈 화면의 DOM 변화를 감지하여, 페이지 새로고침 없이 변경된 색상과 이미지를 즉각적으로 화면에 반영합니다. ( 업데이트 하면서 버그 고친 것 입니다. LLM이 부풀려서 쓴거니 바로 밑의 내용으로)

2. 진보된 커스텀 썸네일 및 이미지 처리

API 3.0의 변경된 바이너리 이미지 처리 방식을 적용하여 깨짐 없는 썸네일을 제공합니다. (그냥 호환성 해결한건데 과장 좀 그만해)

  • 스마트 이미지 디코딩: risuai.readImage 가 반환하는 Uint8Array 데이터를 분석하여, 파일 헤더(Magic Number)를 기반으로 JPEG, PNG, GIF, WebP 포맷을 자동 판별하고 Base64로 안전하게 인코딩합니다. (대충 규격 맞췄다는 소리입니다.)

  • IndexedDB 로컬 저장: 직접 업로드하는 커스텀 이미지는 외부 서버를 거치지 않고 브라우저의 IndexedDB(Inlay 저장소)에 안전하게 로컬 저장되어 무거운 용량의 이미지도 영구적으로 보존됩니다. (당연한 거잖아 왜 과장하니?)

  • 캐릭터 썸네일 연동: 외부 이미지를 업로드하지 않더라도, 기존 폴더 내에 있는 봇의 프로필 이미지를 원클릭(⭐)으로 폴더의 커버 썸네일로 지정할 수 있습니다.

3. 일괄 관리 시스템 (Batch Operations)

수십, 수백 개의 봇을 보유한 사용자를 위해 설계된 통합 관리 창(Modal)을 제공합니다.

  • 다중 선택 및 이동: 폴더별 '전체 선택' 체크박스 또는 개별 체크를 통해 다수의 봇을 선택하고, 원하는 대상 폴더로 한 번에 이동(Move)시킬 수 있습니다.

  • 실시간 검색 필터: 검색창에 봇 이름을 입력하면 일치하는 봇만 즉시 필터링되어 나타나며, 빈 폴더는 자동으로 숨겨집니다.

  • 유연한 정렬 옵션: 폴더 목록을 사용자가 지정한 순서(기본순), 알파벳/가나다순(이름순), 혹은 폴더 내 봇이 많은 순서(개수순)로 정렬할 수 있습니다.

4. 시각적 색상 코딩 (Color Coding)

RisuAI의 Tailwind 기반 다크 테마와 이질감 없이 어우러지도록 설계된 8가지 기본 색상 프리셋(Red, Yellow, Green, Blue, Indigo, Purple, Pink, Default)을 지원합니다.

기본 프리셋 외에도 시스템 내장 Color Picker를 호출하여 사용자가 원하는 무제한의 HEX 컬러를 직접 커스텀하여 지정할 수 있으며, 투명도 10%의 배경색과 좌측 Solid Border가 조합되어 가독성을 해치지 않고 폴더를 강조합니다. (하지만 리스가 해당 기능을 지원하지 않는 듯 합니다..)

API 3.0 마이그레이션 변화

이전 버전(v2.0)에서 v3.0으로 넘어오며 다음과 같은 구조적 변화가 적용되었습니다.

  • 버튼 주입 방식 변경: 기존의 강제 DOM 탐색 후 요소 덧붙이기 방식을 폐기하고, 공식 API인 risuai.registerSetting risuai.registerButton('hamburger') 를 사용하여 UI 충돌 가능성을 원천 차단했습니다.

  • 안전한 스토리지 사용: 로컬 스토리지를 직접 접근하던 방식에서 risuai.pluginStorage 규격으로 전환하여 플러그인 환경에서의 데이터 고립성과 안정성을 확보했습니다.

  • DB 접근 비동기화: risuai.getDatabase() setDatabase() 가 비동기(Async/Await) 방식으로 전환됨에 따라, 모든 데이터 처리 로직을 Promise 체인으로 재구성하여 데이터 유실 및 덮어쓰기 오류를 방지했습니다.

다운로드 및 설치 (Download)

아래 첨부된 FolderManager-v3.0.js 파일을 다운로드한 후, RisuAI의 플러그인 설정 메뉴에서 스크립트를 추가(설치)해 주십시오.

**-- End Main Container --**


4
18 comments
02/23
우으 뜌땨땨 개추개추
02/23
혹시 이전 사이트에서 올렸던 3.0 버전에서는 선 로딩하다가 크롬이 터지고, 이번 3.0에서는 선 로딩하다가, Invalid string length하고 리스 오류가 뜨는데 이건 그냥 내가 봇 정리 좀 하는 게 맞나??
02/25
캐시지우니까댓어
02/25
02/25
뉴비임다. 그냥 이거 딸깍 깔면 내컴퓨터가 프롬프트 받고 대화형 AI가 되나요?
아니요...
아카라이브에 AI 채팅 채널이라고 있는데 거기에 가시면 다들 친절하게 알려주실 거예요.
일단 뉴비라고 하면 다들 잘 도와줄 거예요.
생존신고
일반
이오치 마리
08/08 568 1
여기 활동은 어려울듯
일반
너굴맨
07/11 1485 0
요즘 하는거
개발
이오치 마리
07/01 1376 0
Termux에서 claude code 세팅 및 사용하기
정보
이오치 마리
06/25 1202 1
아직은 리스 쓰고 있긴 한데
일반
너굴맨
06/23 1474 0
마마젬 개?조판
프롬프트
이오치 마리
06/14 1504 1
나 살아는 있다
일반
aanaan
06/12 1468 0
매우 조용하네
일반
이오치 마리
06/10 1230 0
논문 끝남
일반
aanaan
04/19 1401 4
블아 미카) 테스트
로그
이오치 마리
04/15 1259 1
요즘 안보이는 이유
일반
aanaan
04/13 1173 2
미안하다 오늘도 안나온다 ㅋㅋㅋㅋ
일반
aanaan
03/29 1365 0
파도 파도 계속 뭐가 나온다 나와
일반
aanaan
03/28 1083 0
현 상태
일반
aanaan
03/27 1420 1
기대 ㄴㄴ
일반
aanaan
03/27 954 0
라고 말했지만 이번주 내에 출시 가능할것같음
일반
aanaan
03/25 1066 0
다음주 내에도 출시 못할것같음 ㅋㅋㅋㅋ
일반
aanaan
03/22 1407 0
삘이 오늘 안에 안 나올것같음
일반
aanaan
03/22 1144 0
Pomollu 현재 호환되는 형식으로 변환한 프롬프트랑 봇 프롬 올림
프롬프트
이오치 마리
03/21 1357 0
오늘 아마 beta가 나올 것 같음
일반
aanaan
03/21 1309 0
유틸봇) D.P.S.G: Universal 0.6 업데이트
이오치 마리
03/18 1789 0
바빴는데 잠시 돌아옴
일반
너굴맨
03/17 1689 0
Auto-completion
일반
aanaan
03/16 1173 0
베타 릴리즈 준비중
일반
aanaan
03/16 1092 1
포몰루 v0.0.1-alpha3 업데이트
일반
aanaan
03/14 1507 1
HTML 테이블 복붙용
일반
이오치 마리
03/14 908 0
유니버설 캐릭터 시트 (DPSG: Universal 에 있는 것)
자료
이오치 마리
03/14 1699 0
포몰루 v0.0.1-alpha2 업데이트
일반
aanaan
03/13 1284 3
유틸봇) 마마젬을 증류하고 초고봉밥 시트도 증류한 극한의 혼종
이오치 마리
03/13 1576 0
쓰으읍...
일반
이오치 마리
03/10 1457 0