TL;DR

AstrBot에 연속적 생활 시뮬레이션과 주도적 멀티모달 행동을 더하는 플러그인으로, 상태·일정·관계·일기·능력 등을 하나의 상시 런타임으로 통합해 자연스러운 '사생활 기반'主动 메시지와 멀티모달 반응을 만든다. 설치 요구조건은 AstrBot >= 4.22.0이며 기본 저장은 JSON이고 선택적으로 SQLite를 사용할 수 있으며, 이미지·TTS·외부 장치 등 고비용 기능은 기본 비활성화라 단계적 활성화가 권장된다. 장기적 교차회차 기억은 외부 메모리 플러그인(예: 我会牢牢记住你)과 연동해야 하며, 운영비용·토큰 한도 관리를 신경 쓸 수 있다. AstrBot 환경에서 지속적 페르소나·주도 행동·관리 UI가 필요하다면 우선 도입을 권장하며, 초기 운영 시에는 최소 기본 기능만 켜서 동작과 비용을 확인한 후 추가 연동을 진행하는 편이 실용적입니다.

핵심 포인트

• 이 저장소는 AstrBot용 플러그인으로, 지속적인 생활 시뮬레이션을 바탕으로 Bot의 상태·일정·관계·일기·능력 등을 하나의 런타임으로 통합합니다. 내부적으로 생활 상태와 후보 생성 파이프라인을 만들어 시간창·우선도·관계 경계·토큰 한도 등으로 발송 여부를 결정하며, 발송 전 복수 단계의 검토와 로그(전송 사유·토큰 소모)를 남깁니다. 이런 구조로 인해 단순한 정시 인사형 플러그인이 아니라 장기적 일관성을 유지하는 '생활 기반 동반'을 구현하려는 경우에 적합합니다.
• 운영 비용과 모델 구성이 명확히 분리되어 있어 빠른모델·복잡모델·창작모델·시각모델 같은 카테고리로 역할을 나눕니다. 각 모델 카드별로 단일 호출 토큰 상한을 설정할 수 있고 플러그인 전체에 하드·소프트 토큰 한도를 걸어 초과 시 저우선 작업을 지연시키는 방식으로 비용 통제를 구현합니다. 이미지 생성, TTS, 심층 복구(DeepSeek) 같은 기능은 기본적으로 비활성화 상태이므로 실제 운영 전 기능별로 단계적 활성화와 비용 모니터링을 권장합니다.
• 확장성은 외부 플러그인/서비스 연동과 개발자용 API를 통해 확보되어 있습니다. get_private_companion_api()로 외부 능력을 등록하거나 Proactive Chat 등 외부 플러그인과 후보·복구·전송 결산을 연동할 수 있으며, 여러 동봉된 시나리오(예: 생기능 이미지 백엔드, ComfyUI/SDGen 백업, 다양한 온라인 이미지 엔드포인트)로 백엔드 대체가 가능합니다. 이런 설계 때문에 이미 존재하는 AstrBot 생태계 플러그인들과 단계적으로 결합해 기능을 확장하려는 환경에 적합합니다.
• 설치·운영·문제해결용 UI가 잘 갖춰져 있어 관리판(陪伴面板)에서 총괄 상태·모델 분류·토큰·활동 후보·디버깅 정보를 확인할 수 있습니다. 데이터는 기본 JSON 저장을 사용하며 필요 시 섹션 기반 SQLite로 전환할 수 있고 마이그레이션·백업·복원 도구를 제공합니다. 깃허브 이슈와 QQ 그룹으로 커뮤니티 지원이 가능하고 CHANGELOG 및 tests 디렉토리가 있어 버전·변경 이력과 기본 회귀 검증 정보를 확인할 수 있습니다.