Herbarium - 봇 메이커&진단 유틸리티 v0.14.0 (17705

Herbarium
세계관 봇을 이해하고 확장하는 봇 메이커 유틸리티
한 줄 요약
한 문장에서 시작해
새 봇을 기획
하고, 카드를 읽어
구조 분석 보고서
를 만들고, 숨은 결함을
진단
하고, 세계관에 맞는 로어북을
생성
하고, 트리에서 골라
세밀하게 수정
하거나
에이전트에게 위임
하되, 확인 후에만
적용
하는 제작 도구입니다. 여러분이 쓰는 모델(Claude, Gemini, GPT) 그대로 동작합니다.
기조: 왜 만들었나
대형 카드 제작의 실제 병목
로어북이 수십 개를 넘어가면 전체 구조를 한눈에 볼 수 없고, 죽은 변수나 끊긴 배선은 에러 없이 조용히 실패하며, 세계관에 맞는 엔트리를 늘리는 일은 전부 수작업이 됩니다.
Herbarium의 접근
하바리움이 표본을 병에 담아 보존하듯, 카드를 이해하고, 진단하고, 확장하고, 확인 후 적용합니다. 생성은 전부 스키마 검증을 통과해야 하고, 적용은 전부 여러분의 확인을 거칩니다.
핵심 기능
1. 카드 분석 (구조 보고서)
프롬프트 슬롯별 토큰, 로어북 항상 활성화(constant) 부담, 스크립트와 변수 인벤토리, 에셋 명명 체계를 한 장으로 정리합니다. 원하면 LLM이 세계관 개요와 인물 관계 요약까지 붙입니다.
2. 진단 (조용한 실패 검출)
등록되지 않아 영원히 실행되지 않는 Lua 함수, 정의 없이 참조되는 변수, 어디서도 안 쓰이는 변수, 존재하지 않는 에셋 호출, 항상 활성화 토큰 비대 같은 결함을 룰 기반으로 찾아냅니다. 실제 배포 카드에서 실결함을 잡아낸 룰셋입니다.
3. 확장 (세계관을 따르는 생성)
기존 엔트리 하나를 원본으로 같은 문체와 설정을 따르는 파생 엔트리를 생성합니다. 출력은 JSON 스키마 검증을 통과해야만 제안이 되고, 기존 이름과 겹치면 자동으로 걸러집니다.
4. 적용 (확인 없이는 아무것도 쓰지 않음)
모든 변경은 제안서로 만들어져 바뀌는 내용의 요약된 변경 내역를 먼저 보여줍니다. 승인해야만 적용되고, 적용 직전 원본 백업이 자동으로 생기며, 백업에서 복원으로 언제든 되돌릴 수 있습니다.
5. 에셋 정리 (대량 임포트)
외부 툴로 뽑은 에셋 폴더를
{인물}.{감정}
같은 명명 규약으로 일괄 매핑합니다. 적용 전에 원본과 정규화 이름, 충돌 여부를 표로 먼저 보여줍니다.
6. 새 봇 만들기 (기획 인터뷰)
아직 카드가 없어도 됩니다. "이런 걸 만들고 싶어" 한 문장을 넣으면 기획 인터뷰가 시작되고, 질문마다 제안 답이 붙어 엔터만으로도 진행됩니다. 기획서를 승인하면 카드 골격이 charx 파일로 만들어져 평소 임포트로 불러오면 됩니다.
7. 구조 탐색과 세밀 수정
카드를 트리로 펼쳐 프롬프트, 로어북(엔트리별 토큰 수), 스크립트, 변수, 에셋을 훑고, 엔트리를 골라 폼에서 직접 고치거나 "이 엔트리, 이렇게 고쳐줘"라고 말로 지시합니다.
8. 에이전트 지시 (위임)
여러 엔트리에 걸친 작업은 에이전트에게 맡깁니다. 에이전트가 카드를 목록, 읽기, 검색 도구로 직접 탐색한 뒤 수정안을 제출합니다. 호출 상한(기본 8회)을 미리 정하고, 에이전트는 카드를 직접 고칠 수 없으며 수정안은 반드시 여러분의 승인을 거칩니다.
신뢰 원칙
1.
키 비접촉 기본.
기본 모드는 Risu가 이미 아는 모델 설정을 그대로 쓰며 키를 보지도 저장하지도 않습니다. 독자 프로바이더를 직접 등록하는 경우에만 키가 이 기기의 플러그인 저장소에 저장되고, 해당 프로바이더 외 어디로도 전송되지 않습니다.
2.
외부 전송 없음.
카드 데이터는 여러분의 LLM 프로바이더 외 어디로도 가지 않습니다. 텔레메트리 없습니다.
3.
비파괴.
변경 내역 확인 없는 쓰기 없음, 적용 전 자동 백업.
4.
콘텐츠 중립.
여러분이 만드는 카드의 내용과 장르를 판정하거나 차단하지 않습니다.
5.
오픈소스.
GPL-3.0, 소스 전체 공개.
설치와 지원 환경
플러그인
: 설정의 플러그인 메뉴에서
herbarium.plugin.js
임포트. RisuAI 정본과 PocketRisu 모두 지원(플러그인 API 3.0).
CLI
: git 관리형 제작자를 위한 동일 기능 명령줄 도구. API 키 환경변수로 Claude, Gemini, GPT, OpenAI 호환 프록시 사용.
다운로드
:
프로톤
버전
: [ 0.14.0 ]
Herbarium. 표본을 병에 담아 오래 보존하는 공예에서 이름을 따옴.
안녕 심심해서 만들어봤어
써보고 문의있으면 여기 댓글로 연락줘
사용방법은 여기있다
Herbarium 이용 가이드
세계관 표본실. 카드를 이해하고, 진단하고, 확장하는 봇 메이커 유틸리티 (v0.14 기준)
보시는 기기에 맞는 판을 펼쳐 주세요. 내용은 같고 화면 배치만 다릅니다. 아래 화면들은 스크린샷이 아니라 플러그인과 동일한 스타일로 재현한 목업입니다.
전부 이 기기 안에서 동작합니다.
카드와 API 키가 서버로 올라가지 않고 계정도 없습니다. 바깥으로 나가는 통신은 여러분이 등록한 AI 프로바이더 호출뿐입니다.
데스크탑에서 보시는 분 (펼치기)
차례: 1 설치 / 2 패널 열기 / 3 카드 분석 / 4 진단 실행 / 5 로어북 확장 / 6 파괴적 변경 보호 / 7 템플릿 대량 생성 / 8 새 봇 만들기 / 9 구조 탐색과 세밀 수정 / 10 에이전트 지시 / 11 액션 버튼과 디자인 시안 / 12 작업 모델과 프로바이더 / 13 CLI / 14 백업과 복구 / 15 문제 해결
1. 설치
모든 파일은
배포 폴더(프로톤 드라이브)
에서 받습니다. 쓰는 환경에 맞는 파일 하나만 받으면 됩니다.
플러그인
: RisuAI 설정의 플러그인 메뉴에서
herbarium-risu-v3.plugin.js
파일을 임포트합니다 (PocketRisu는 pocketrisu 판). 플러그인 API 3.0.
단독 앱
(선택): Risu 없이 같은 기능 전체를 브라우저에서(안드로이드 포함) 씁니다. Windows는 데스크탑 설치본(Herbarium_x64-setup.exe, 약 3MB)이 가장 쉽습니다. 설치하면 독립 창 앱으로 실행되고 브라우저도 Node도 필요 없습니다(SmartScreen 경고 시 추가 정보, 실행). 무설치판 exe와 브라우저에서 바로 여는 herb-web.html도 있습니다. 카드 파일을 끌어다 놓아 열고 원본 형식 그대로 저장하며, 내장 프록시로 어떤 프로바이더든 호출됩니다.
CLI
(선택): 터미널에서 카드를 다루는 제작자용입니다.
herb-cli.cjs
파일 하나를 받아 Node 18 이상에서 실행합니다(설치 불필요). API 키는 환경변수(ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY 중 하나)로 넣습니다.
2. 패널 열기
햄버거 메뉴에서
Herbarium
버튼을 누르면 전체화면 패널이 열립니다.
● ● ●
Herbarium
세계관 표본실
읽기
카드 분석
진단 실행
구조 탐색
활성화 미리보기
콘텐츠 리뷰
기획서 대조
심층 분석
쓰기
로어북 확장
템플릿 대량 생성
키 보강
제작
새 봇 만들기
액션 버튼
디자인 시안
카드 아이콘
위임
에이전트 지시
설정
작업 모델
백업에서 복원
사용량
닫기
왼쪽에서 작업을 선택하세요.
처음 열었을 때의 패널. 왼쪽 사이드바에 읽기, 쓰기, 제작, 위임 그룹으로 작업이 정리되어 있고, 실행 중인 작업은 강조색으로 표시됩니다.
3. 카드 분석
현재 열려 있는 봇을 읽어 구조 보고서를 만듭니다. 프롬프트 슬롯별 토큰, 로어북의 항상 활성화(constant) 부담, 상태 변수, 에셋 명명 체계가 한 화면에 나오고, 아래에 진단 요약이 붙습니다. 항상 활성화 토큰이 비대하면 여기서 바로 보입니다.
심층 분석
은 LLM이 로어북을 요약해 세계관 개요, 톤, 주요 인물, 진행 중인 갈등을 종합합니다(스포일러는 추상 서술).
콘텐츠 리뷰
는 목표 구조, 보상 루프, 톤 균형, 스포일러 노출, 일관성 5개 관점의 소견을 확신도와 함께 냅니다. 여러 번 호출하는 작업 중에는
중단
버튼이 나타납니다.
4. 진단 실행
룰 기반으로 조용한 실패를 찾습니다. 등록되지 않은 Lua 함수, 정의 없는 변수 참조, 죽은 변수, 존재하지 않는 에셋 호출, 상시 토큰 비대 같은 결함이 심각도(P0, P1, P2, info)와 위치, 수리 제안과 함께 나옵니다. 발견