[🔦라이트보드] DY-LIST v.test.6 컨택 다이나믹 모듈 (16

DYNAMIC-LIST
라이트보드 기반 컨택 다이나믹 모듈
원본: [
라이트보드] NPC LIST 4.2.3: NPC 기억+정보 관리 모듈
v.test.6
RisuAI Lightboard Module
변경 기록
`.v.test.1.fix1`: `.lb.format`CBS 망가짐 수정
`v.test.2`: 포멧 규격 완전 변경, 에셋이미지 모드 정상화
`v.test.2.fix`:
1. processParsedOutput에서 bglist 소스일 때 기존 엔티티 STATE 덮어쓰기 방지 (skipSave 가드)
2. `.lb.format`에 `<lb-XXlist>...<lb-XXlist>` 다시 첨부 (공식 권고사항에는 없는게 권장이긴 하지만 포멧 유지 보조로 다시 추가함)
`v.test.3`: 인서트 오더 고장 수리, 전용 플레이스홀더기능 추가, 로어북 라벨기능변경, 로어북 마감자 추가, 히스토리 로어북 최소 인서트오더 도달시 데코레이터 기능 제거,
로어북 데코레이터 기능 추가
`v.test.3.1`:
히스토리 로어북 최소 인서트오더 도달시 데코레이터 기능 다시 추가
`v.test.3.1.fix`: 프로젝트 오염으로 인한 파일 꼬임 문제로 롤백 후 리빌드
`v.test.3.1.fix2`: 포멧 유지력 강화
`v.test.3.2`: bglist의 BG범위, BG맥락 토글에 랜덤 토글 추가
`v.test.4`: 경고 전반적인 출력 지침이 변경되었습니다.
- 특히 수치 평가에 대한 지침이 변경되어 맥락 연속성에 문제가 있을 수 있습니다.
- 변경사항:
1. 히스토리 요약 기능 제거(사유: 해당 모듈의 작동구조를 근거로 불필요하다 판단됨)
2. 라벨 플레이스홀더 변경 및 확장
3. 최상위 아코디언은 각각 기본 펼침 상태를 정하는 새 커스텀 토글을 추가
4. 그룹 스탯 관련 `설명 보강 토글`추가: 활성 시 각 축 수치 뒤에 괄호 설명이 추가됨
5. 최신 채팅을 삭제했을 때 이전 char 턴이 새 현재턴이 되어도 Dynamic-List / BG-List UI가 비어 보이던 회귀를 수정
`v.test.5`: `
`버튼통합,
엔트리 편집 지원,
재생성 개선,
BG리스트 개선, 커스텀토글 배치 변경,
일출 지원, 특수 토글 추가
-
`
`버튼통합:
- 로어북 갱신과 변수 갱신이
`
`버튼에 통합됨
- 엔트리
편집 지원:
- 전용 엔트리 편집 팝업창에서 편집 후 `
`버튼을 눌러 갱신할 것
-
재생성 개선:
- 재생성 후 `
`버튼을 눌러 갱신할 것
- BG리스트 개선:
-
BG리스트 채팅 출력으로 오인 되는 문제 수정
- BG리스트 활성 조건을 DY리스트 출력 후 `
`버튼을 눌러 갱신되었을 때로 조정
-
특수 토글 추가:
- DY리스트를
BG리스트프롬으로 교체하는 기능과
BG리스트를
DY리스트 프롬으로 교체하는 토글 추가
`v.test.6`:
-
엔트리 편집기능 개선
- BG리스트 생성 버튼 조건 개선
- 모듈전용 커스텀 로어북 기능 추가
-
DY/
BGlist챗로어북주입 토글 (리수로어북 경로로 삽입되는 로어북 차단/사용)
-
DY/
BGlist용 로어북 내용 구성목적 커스텀 토글 추가 (.lb.universe 에 삽입됨 기본값 공백)
-
DY/
BGlist용 탈옥 지침 커스텀 토글 추가 (기본값 공백)
- 활성키 기능 추가: 자동 생성 활성키를 보다 구체화 하는 토글 (키더라도 확인 필수)
- 그룹리스트용 커스텀 필드 추가
Dynamic-List란?
Dynamic-List
는 RisuAI의 라이트보드(Lightboard) 프레임워크 위에 구축된
컨텍다이나믹 목적 엔티티 추적 모듈
입니다.
채팅 중 등장하는 캐릭터와 그룹(단체/조직)의 상태, 관계, 히스토리를 실시간으로 파싱·저장하고, 시각화된 UI 카드로 채팅창에 표시하며, LLM 맥락 주입을 위한 로어북을 생성
·분할
·배치
·갱신합니다.
하나의 모듈로 NPC 상태창, 관계 추적, 히스토리 기록, 성상태 시뮬레이션, 배경 세계 시뮬레이션까지 통합 제공합니다.
주요 기능
캐릭터 추적
이름, 나이, 성별, 외모, 복장, 성격, 관계, 의도 등 실시간 추적
그룹 추적
조직/단체의 체계, 역량, 수명, 규모, 멤버십 5개 통계 × 3축 게이지
8축 관계 시스템
인지·흥미·밀착·사랑·욕정·신뢰·존경·복종, 동적 시간 감쇠
히스토리 기록
시간순 이벤트, 관계 변화, 임신 이벤트, 분기 로어북
성상태 시뮬레이션
12종 기관, 월경주기, 임신·출산, 젖·정액 생산 자동 계산
배경리스트
화면 밖 캐릭터/그룹의 독립 행동 시뮬레이션
로어북 다이나믹
추적 데이터를 문서로 포멧으로 변환, 로어북 생성시 자동 분할, 인서트 오더 자동 조절
스크립트 기반 수치 갱신
스크립트기반 수치갱신 적극 위탁 및 로어북 속 수치 자동 갱신
작동 구조
데이터 흐름
사용자 입력
↓
LLM 응답 생성
← 로어북 프롬프트 + 포맷 템플릿 + 추론 가이드
↓
onOutput 핸들러
← 래퍼 태그 추출 + 파싱 + 데이터 저장
↓
UI 렌더러
게이지·카드 HTML 생성
로어북 생성
슬롯 관리 + 마크다운 포매팅
핵심 원리:
LLM이 구조화된 텍스트 형식으로 추적 데이터를 출력 → 스크립트가 파싱 후 state에 저장 → 매 턴마다 시각화 UI 생성 + 버튼 클릭 시 로어북으로 다시 LLM 맥락에 주입하는 피드백 루프
모듈 구성
구분
수량
역할
트리거 스크립트
1개 (통합)
파서 & 유틸리티, 코어 로직, 버튼 핸들러, UI 렌더러
메인 로어북 (lb-dylist)
8개
LLM 추적 지침, 포맷, 추론 과정, 출력 핸들러, 작업, 상호작용
배경리스트 로어북 (lb-bglist)
6개
화면 밖 엔티티 시뮬레이션 지침, 포맷, 추론, 출력 핸들러
CSS 스타일
5개
레이아웃, 게이지 시스템, 콘텐츠, 래퍼
Regex 스크립트
7규칙
태그 제거, lazy 버튼 생성, 디스플레이 정리
배경 임베딩
1개
전체 CSS 통합 스타일시트
커스텀 토글
108개
6개 카테고리: 기본, 캐릭터, 그룹, BG리스트, 동적관계, 고급
기본 설정 토글
모듈 활성화, 발동 방식, 언어, 성능 관련 핵심 설정 (10개)
읽는 법:
각 토글의
권장
뱃지가 추천 설정값입니다. 목적과 작동 방식을 읽고 상황에 맞게 조정하세요.
lb-dylist.mode
— 모드
권장: 메인
select: 끄기 / 메인 / 보조
목적:
Dynamic-List 모듈의 활성화 모드.
작동:
"메인"은 주 LLM 보조 모듈로 작동(매 턴 출력), "보조"는 다른 모듈 보조(빈도 낮음), "끄기"는 비활성화.
lb-dylist.lazy
— 발동
권장: 즉시
select: 즉시 / 누르면
목적:
모듈 발동 타이밍.
작동:
"즉시"는 LLM 응답마다 자동 실행(실시간 추적), "누르면"은 UI에 로드 버튼 표시 후 클릭 시 실행(토큰 절약). 실시간 추적이 핵심이므로 즉시 권장.
lb-dylist.language
— 언어
권장: 사용 언어
select: 영어 / 한국어
목적:
LLM 프롬프트 내 지침 언어 선택.
작동:
CBS 조건문이 토글 값에 따라 영어 또는 한국어 프롬프트를 선택. 채팅 언어와 동일하게 설정 권장.
lb-dylist.maxLogs
— 포함 채팅 수
권장: 1
text (숫자, 비우면 백엔드 설정 사용)
목적:
라이트보드가 참조할 이전 채팅 수.
작동:
1이면 최신 1개 메시지만 포함하여 토큰 절약. 높이면 맥락이 풍부해지지만 토큰 소모 증가.
lb-dylist.snapshotTurns
— 스냅샷 저장 턴수
권장: 50
text (숫자, 기본 50)
목적:
되돌리기/디버깅용 상태 스냅샷 유지 수.
작동:
매 턴 엔티티 상태의 스냅샷을 FIFO 큐로 저장. 50이면 최근 50턴의 스냅샷 보존.
lb-dylist.maxDisplayHistory
— 최대 표시 히스토리
권장: 비움
text (숫자, 비우면 전체 표시)
목적:
UI 히스토리 아코디언에 표시할 최대 이벤트 수.
작동:
렌더러가 히스토리 버퍼에서 최신 N개만 표시. 비우면 전체 표시. UI 성능이 느려질 때 10~20으로 제한.
lb-dylist.maxHistoryBuffer
— 히스토리 버퍼 최대 크기
권장: 비움
text (숫자, 비우면 무제한)
목적:
chatVar에 저장하는 히스토리 버퍼 항목 수 제한.
작동: