Repository navigation
Releases
v0.9.7
MARP v0.9.7
이번 업데이트 한눈에 보기
MARP v0.9.7 · 새 테마와 채팅 화면 진행 표시
설정 화면 색감을 바꾸고, 분석이 어디까지 진행됐는지 채팅 화면에서 바로 볼 수 있게 했습니다.
달라진 점
- 새 테마. 설정 화면을 심해 네이비 + 골드로 바꿨습니다. 켜고 끄는 항목은 스위치로, 탭은 알약 모양으로 바뀌었습니다. 기능과 설정 항목은 그대로입니다.
- 채팅 화면 진행 표시. 공통 탭의 채팅 화면 진행 표시를 켜면 채팅 화면 오른쪽 위에 작은 표시가 뜹니다. 기본값은 꺼짐입니다.
- 점 세 개는 세계관 · 플롯 · 등장인물입니다. 골드 = 진행 중, 초록 = 성공, 빨강 = 실패, 회색 = OFF.
- Lite는 단계별로 갱신되고, Full은 진행 중 경과 시간만 보이다가 끝나면 결과를 표시합니다.
- 결과(주입 · 실패 · 결과 없음 · 캐시 재사용)는 4초 뒤 사라집니다. 표시를 누르면 MARP 설정이 열립니다.
- NMOS 진행 표시가 오른쪽 위에 있으면 그 아래에 붙습니다. RisuAI 요청 상태 알림이 떠 있는 동안에는 가려질 수 있습니다.
- 권한. 처음 켤 때 RisuAI가 "메인 Document 접근" 권한을 묻습니다. MARP는 이 권한으로 표시 하나를 그리고, 겹치지 않도록 NMOS 표시의 위치만 읽습니다. 거부했다면 설정 → 플러그인 → MARP 줄 메뉴 → 권한 응답 초기화 후 다시 켜세요.
- 진행 표시에 문제가 생겨도 분석과 메인 응답에는 영향이 없습니다. 끄고 다시 켜면 재시도합니다.
다운로드·업데이트
- Lite: multiagent-lite-v0.9.7.js를 RisuAI에서 가져오거나 기존 플러그인과 교체합니다.
- Full: multiagent-full-v0.9.7.zip. 기존
.env,data/와 Docker 볼륨을 유지하고 업데이트합니다. 서버 동작은 v0.9.6과 같으며 플러그인만 바꿔도 새 기능이 적용됩니다.
MULTIAGENT_VERSION=v0.9.7 docker compose pull
MULTIAGENT_VERSION=v0.9.7 docker compose up -d설정과 프리셋 마이그레이션은 필요하지 않습니다. SHA256SUMS로 파일을 확인할 수 있습니다.
검증 범위
- 진행 표시 상태·그리기·런타임 연동을 단위 테스트로 검사합니다. 권한 거부, 화면 접근 실패, 멈춘 연결, 겹친 요청, 플러그인 해제 정리를 포함합니다.
- Chromium·WebKit 모의 RisuAI 호스트에서 토글, NMOS 표시 아래 배치, 결과 표시, 끄기와 리스너 정리를 검사합니다.
- JS·Go·패키지·Docker 검증을 릴리즈 CI에서 실행합니다.
- 실제 모바일 기기와 실제 RisuAI 화면은 자동 검사 범위에 포함하지 않습니다.
어떤 파일을 받으면 되나요?
multiagent-lite-v0.9.7.js: Lite판 사용자용 단일 플러그인 파일입니다.multiagent-full-v0.9.7.zip: Full판 사용자용 서버 파일과 플러그인 묶음입니다.
누가 업데이트하면 되나요?
- Lite판만 쓰는 경우:
multiagent-lite-v0.9.7.js파일을 받아 RisuAI 플러그인에서 교체하면 됩니다. - Full판을 쓰는 경우:
multiagent-full-v0.9.7.zip을 받아 서버 파일과 플러그인을 함께 업데이트하는 것을 권장합니다.
업데이트 방법
- Lite판을 업데이트하는 경우:
multiagent-lite파일을 내려받아 RisuAI의 플러그인 가져오기/교체 기능으로 넣으면 됩니다. - Full판을 업데이트하는 경우:
multiagent-full압축 파일을 풀고, 기존.env파일은 보존한 뒤 Docker 컨테이너를 다시 빌드해서 실행하면 됩니다. - Full판 플러그인도 함께 바뀌었을 수 있으니, 압축 파일 안의
plugin폴더에 있는 새 플러그인을 RisuAI에 다시 가져오는 것을 권장합니다.
업데이트 전 참고
- API 키와 개인 설정은 릴리즈 파일에 포함되지 않습니다.
- Full판을 쓰고 있다면 기존
.env와data/config.json을 지우지 마세요. - 문제가 생기면 이전 릴리즈 파일로 되돌릴 수 있게 기존 파일을 잠시 보관해 두는 것이 좋습니다.
개발자용 변경 기록
범위: v0.9.6..v0.9.7
- chore: release MARP v0.9.7
- chore: polish progress display cleanup and docs
- build: bundle theme and progress display; document it
- fix: keep the progress toggle in sync across tab switches
- test: progress display on Chromium and WebKit layouts
- ui: progress display toggle in common settings
- fix: keep the progress display steady across overlapping requests
- fix: harden the progress display against bridge failures and notched screens
- feat: drive the progress display from the beforeRequest hook
- feat: report Lite agent progress
- feat: hud setting for the progress display
- feat: draw the progress display top-right and stack below NMOS
- feat: progress display state
- ui: deep navy and gold theme with shell color tokens
변경된 파일 보기
.github/release-notes/v0.9.7.md
MOBILE_TESTING.md
README.md
RELEASE_NOTES.md
full/internal/marp/store.go
full/plugin/risu-multiagent-full.js
full/run.sh
lite/risu-multiagent.js
package-lock.json
package.json
src/config.js
src/core.js
src/diagnostics-ui.js
src/full.header.txt
src/hud-host.js
src/hud.js
src/lite.header.txt
src/pipeline.js
src/runtime.js
src/ui.js
tests/browser.mjs
tests/diagnostics.test.mjs
tests/fake-root.mjs
tests/harness.js
tests/hud-host.test.mjs
tests/hud.test.mjs
tests/install_package.py
tests/runtime.test.mjs
tests/theme.test.mjs
v0.9.6
MARP v0.9.6 · 메인 재시도 때 분석비를 두 번 내지 않게
메인 generation이 실패했는데 같은 요청을 다시 보낼 때마다 World/Plot/Character 분석까지 세 번 더 호출되던 비용 문제를 고쳤습니다.
달라진 점
- 같은 요청의 성공 분석을 재사용합니다. 메인 모델 오류나 네트워크 장애 뒤 그대로 재전송하면 보조 LLM을 다시 호출하지 않고 앞선 분석 메모를 다시 넣습니다.
- 동시에 들어온 같은 요청도 한 번만 분석합니다. 먼저 시작된 분석 작업을 함께 기다립니다.
- 바뀐 문맥은 재사용하지 않습니다. 사용자 입력, 최근 대화, system 자료, 분석 언어, 모델, 프롬프트 등 분석 조건이 달라지면 새 분석을 실행합니다.
- 실패를 굳혀 두지 않습니다. 분석 실패, 부분 실패, 빈 결과는 캐시하지 않으므로 다음 요청에서 다시 시도합니다.
- 워터폴과 호출 기록에서 확인할 수 있습니다.
분석 캐시 재사용과 경과 시간, 또는동일 분석 요청에 합류가 표시됩니다.
캐시는 현재 플러그인 세션의 메모리에만 최대 10분·최근 8건까지 유지됩니다. 설정을 저장하거나 플러그인을 재로드·해제하면 지워지며 대화나 플러그인 저장소에는 남기지 않습니다.
Full은 설정 revision을 제공하는 현재 Go 서버에서 캐시를 사용합니다. revision이 없는 구버전 서버와 연결하면 설정 변경을 안전하게 구분할 수 없어 기존처럼 매번 분석합니다.
다운로드·업데이트
- Lite: multiagent-lite-v0.9.6.js를 RisuAI에서 가져오거나 기존 플러그인과 교체합니다.
- Full: multiagent-full-v0.9.6.zip. 기존
.env,data/와 Docker 볼륨을 유지하고 업데이트합니다.
MULTIAGENT_VERSION=v0.9.6 docker compose pull
MULTIAGENT_VERSION=v0.9.6 docker compose up -d설정과 프리셋 마이그레이션은 필요하지 않습니다. SHA256SUMS로 파일을 확인할 수 있습니다.
검증 범위
- Lite와 Full에서 동일 입력 재전송 시 보조 분석 요청이 추가되지 않는지 검사합니다.
- 입력·설정 변경, 분석 실패·부분 실패·빈 결과, 동시 동일 요청, TTL·개수 제한을 자동 검사합니다.
- Chromium·WebKit 모의 RisuAI 호스트와 JS·Go·패키지·Docker 검증을 릴리즈 CI에서 실행합니다.
- 실제 유료 공급자의 청구 화면과 실제 모바일 기기는 자동 검사 범위에 포함하지 않습니다.
v0.9.5
MARP v0.9.5 · PDF Pod 안에서도 헷갈리지 않게
"PDF Pod에 넣었더니 MARP가 안 돌아가요" 하셨던 분들을 위한 업데이트입니다.
한눈에 보기
- 🆕 PDF Pod 안에서 MARP Lite를 열면 지금 설정으로 잘 돌아가는지 알려 줍니다. 안 된다면 PDF Pod에서 무엇을 바꾸면 되는지 PDF Pod 화면에 보이는 이름 그대로 알려 줘요.
- 🔍 실패했을 때 해결 방법이 함께 나옵니다. 워터폴·호출 기록·연결 테스트에 조치 안내가 붙어요.
- 📖 화면 순서대로 따라 하는 안내 문서를 새로 만들었습니다: PDF Pod 안에서 MARP Lite 쓰기
- 🙌 PDF Pod를 쓰지 않는 분은 달라지는 게 없습니다.
왜 안 됐나요?
PDF Pod는 대화를 PDF로 압축해서 토큰을 아껴 주는 플러그인이에요. 그런데 기본 설정(API 형식 변환: 자동)에서는 MARP가 보내는 분석 요청을 모두 Gemini 방식으로 바꿔서 보냅니다.
그래서 MARP 분석 에이전트에 OpenAI, OpenRouter, Vercel, 로컬 모델 같은 걸 쓰면 API 키가 엉뚱한 곳(Google)으로 가서 분석이 실패했어요. 채팅 답변은 정상으로 나오니 MARP가 조용히 꺼져 있는 것처럼 보였습니다. 게다가 연결 테스트는 PDF Pod가 건드리지 않는 방식이라 테스트만 성공으로 나왔어요.
내 설정은 괜찮을까요?
| MARP 분석 에이전트로 쓰는 것 | PDF Pod 설정 그대로 두면? |
|---|---|
| Google AI Studio (Gemini) | ✅ 잘 돌아가요 |
| Vertex AI | ✅ 잘 돌아가요 |
| Anthropic (Claude) | ✅ 잘 돌아가요 |
| OpenAI · OpenRouter · Vercel · 로컬 모델 등 |
헷갈리면 MARP를 열어 보세요. 공통 탭 맨 위의 PDF Pod 연동 카드가 대신 판단해 줍니다.
해결 방법 (설정 필요일 때)
PDF Pod를 열고 왼쪽 목록에서 MultiAgent RP Pipeline을 누른 뒤 두 가지를 바꿔 주세요. 바꾸는 즉시 적용됩니다.
| 항목 | 기본값 | 바꿀 값 |
|---|---|---|
| API 형식 변환 | 자동 | 끄기 |
| PDF 압축 수준 | 표준 | 끄기 |
채팅을 한 번 보낸 뒤 MARP 워터폴 탭에 분석 주입 완료가 보이면 끝입니다. 단계별 화면은 안내 문서에 있어요.
자주 묻는 질문
Q. PDF Pod에 넣었더니 API 키 같은 설정이 사라졌어요.
PDF Pod는 안에 넣은 플러그인마다 저장 공간을 따로 씁니다. 공통 탭에서 한 번만 다시 입력하고 설정 저장을 눌러 주세요.
Q. 연결 테스트는 성공인데 빨간 안내가 떠요.
키는 올바르다는 뜻이에요. 하지만 지금 PDF Pod 설정으로는 실제 분석이 실패합니다. 위 해결 방법대로 바꿔 주세요.
Q. Full판도 업데이트해야 하나요?
아니요. Full판 서버 요청은 PDF Pod를 거치지 않아서 이번 변경과 상관없습니다. 올려도 동작은 같습니다.
다운로드·업데이트
- Lite: multiagent-lite-v0.9.5.js를 RisuAI에서 가져오거나 기존 플러그인과 교체합니다. PDF Pod 안에서 쓰고 있다면 PDF Pod에서 MARP 항목을 새 파일로 교체해 주세요.
- Full: multiagent-full-v0.9.5.zip. 기존
.env,data/와 Docker 볼륨을 유지하고 업데이트합니다.
MULTIAGENT_VERSION=v0.9.5 docker compose pull
MULTIAGENT_VERSION=v0.9.5 docker compose up -d설정과 프리셋은 그대로 유지됩니다. SHA256SUMS로 파일을 확인할 수 있습니다.
확인한 것과 남은 것
- 실제 PDF Pod 0.17.10 파일 안에 MARP Lite v0.9.5를 넣어 확인했습니다. RisuAI 플러그인 API는 테스트용 모의 환경으로 대신했습니다.
- 기본 설정에서는 분석 요청이 Google 주소로 바뀌어 실패하고 조치 안내가 나타났습니다.
- 설정을 바꾼 뒤에는 원래 주소로 전송되어 분석이 주입됐습니다.
- JS·Go 자동 테스트도 통과했습니다.
- 실제 RisuAI 앱과 실제 휴대전화 화면은 아직 직접 확인하지 못했습니다. 이상한 점이 있으면 알려 주세요.
v0.9.2
MARP v0.9.2 · 메뉴 아이콘을 채팅 입력창 쪽으로 이동
MARP Lite / MARP Full 아이콘을 캐릭터 목록 쪽 햄버거 메뉴에서 채팅 입력창 왼쪽 햄버거 메뉴로 옮겼습니다. 대화 중 가까운 위치에서 MARP UI를 열 수 있습니다.
바뀐 위치
| 위치 | v0.9.2 동작 |
|---|---|
| 채팅 입력창 왼쪽 햄버거 메뉴 | MARP Lite / MARP Full을 선택해 UI 열기 |
| 캐릭터 목록 쪽 햄버거 메뉴 | MARP 항목 제거 |
| 플러그인 설정 | 기존처럼 UI 열기 가능 |
Lite·Full 모두 동일하게 적용됩니다. 플러그인을 해제하면 메뉴 항목도 정리합니다. 분석 순서·설정·호출 기록 동작은 v0.9.1과 같습니다.
다운로드·업데이트
- Lite: multiagent-lite-v0.9.2.js를 RisuAI에서 가져오거나 기존 플러그인과 교체합니다.
- Full: multiagent-full-v0.9.2.zip의
plugin/multiagent-full-v0.9.2.js를 가져옵니다. 서버가 v0.9.1이면 이번 메뉴 이동은 브라우저 플러그인만 업데이트해도 적용됩니다.
RisuAI 자동 업데이트도 같은 파일을 제공합니다. 업데이트 후 플러그인을 다시 로드하고 채팅 입력창 왼쪽 메뉴를 확인합니다. 설정과 프리셋은 유지하며, 메모리에 보관한 호출 기록은 재로드 시 초기화됩니다.
Full 서버까지 함께 맞추려면 기존 .env, data/와 Docker 볼륨을 유지하고 설치 폴더에서 실행합니다.
MULTIAGENT_VERSION=v0.9.2 docker compose pull
MULTIAGENT_VERSION=v0.9.2 docker compose up -dZIP에는 Linux amd64·arm64 실행 파일과 안내 문서가 포함됩니다. SHA256SUMS로 파일을 확인할 수 있습니다.
검증과 안내
Lite·Full 실제 배포 번들의 채팅 메뉴 콜백, 기존 메뉴 항목 제거와 해제 처리를 Chromium·WebKit 자동 검사에 포함했습니다. 필수 CI 통과 후 릴리즈와 Docker 이미지를 게시합니다. 실제 휴대전화의 RisuAI 화면 점검은 자동 검사와 구분합니다.
설치·업데이트 안내 · UI 사용법 · 전체 변경 내역
v0.9.1
MARP v0.9.1 · 워터폴·연결 테스트·호출 기록 복원
Lite·Full 모두에서 분석이 얼마나 걸렸는지, 어디서 실패했는지, 어떤 결과가 나왔는지 화면으로 확인할 수 있습니다. 기존 설정과 프리셋을 유지하면서 업데이트할 수 있습니다.
달라진 점
| 기능 | 이번 버전에서 제공하는 내용 |
|---|---|
| 워터폴 | 세계관 → 플롯·등장인물 병렬 분석의 시작 시각·소요 시간과 성공·실패·OFF 표시 |
| 연결 테스트 | 전체·개별 에이전트의 인증·모델 조회 API 검사, Full 서버 상태 확인 |
| 호출 기록 | 최근 50건, 종류·실패 필터, 모델·사용량·오류·결과 미리보기, JSON 내보내기·비우기 |
| 진단 | 텍스트/PDF 분석 테스트 결과를 워터폴과 상세 기록으로 확인 |
시간 초과도 기록하며, 테스트 중 다른 탭으로 이동해도 늦은 결과가 현재 화면을 덮어쓰지 않습니다. Full의 실패한 연결 검사에는 HTTP 오류 코드가 표시됩니다.
다운로드
| 사용자 | 파일 |
|---|---|
| Lite | multiagent-lite-v0.9.1.js |
| Full | multiagent-full-v0.9.1.zip |
| Full 실행 파일만 · Linux x86-64 | marp-v0.9.1-linux-amd64 |
| Full 실행 파일만 · Linux ARM64 | marp-v0.9.1-linux-arm64 |
| 파일 무결성 확인 | SHA256SUMS |
Full ZIP에는 브라우저 플러그인, 두 아키텍처의 Linux 실행 파일, Docker 구성과 사용 문서가 포함됩니다.
업데이트 방법
Lite: 새 JS를 RisuAI 플러그인에서 가져오거나 기존 MARP Lite와 교체합니다.
Full: 새 ZIP의 서버 파일과 plugin/multiagent-full-v0.9.1.js를 함께 업데이트합니다. 기존 .env, data/config.json, data/presets.json과 Docker 데이터 볼륨은 유지합니다. 설치 폴더에서 실행합니다.
MULTIAGENT_VERSION=v0.9.1 docker compose pull
MULTIAGENT_VERSION=v0.9.1 docker compose up -d사용자 지정 이미지를 쓰고 있다면 해당 이미지 버전도 함께 확인합니다. 소스 직접 빌드는 docker compose up -d --build, Linux 실행 파일 설치는 sh ./run.sh를 사용합니다. 새 설치에서만 .env.example을 .env로 복사합니다.
플러그인 ID·자동 업데이트 주소·Docker 이미지 이름·데이터 경로는 유지합니다. Full 구버전 서버도 기존 응답으로 동작하지만 시작 시각이 없으면 워터폴 위치를 추정으로 표시합니다. 실측 위치를 보려면 서버도 업데이트하세요.
사용 전에 알아둘 점
- 기록은 현재 플러그인 세션의 최근 50건이며 재로드·해제 시 초기화됩니다. 다른 기기나 재시작 이전 기록은 제공하지 않습니다.
- 결과 미리보기는 에이전트당 앞 2,000자이며 JSON 내보내기에도 포함됩니다. 실제 대화에 주입하는 분석 결과는 이 미리보기 제한으로 잘리지 않습니다.
- 연결 테스트는 LLM 응답을 생성하지 않습니다. 모델 조회 API를 검사하고 Vertex는 OAuth 인증을 확인합니다. 실제 모델 권한·PDF 동작은 진단의 분석 테스트에서 확인합니다.
- 텍스트/PDF 분석 테스트는 실제 LLM 호출이 발생합니다. Lite는 현재 편집값, Full은 입력한 서버 URL에 저장된 공급자 설정으로 실행합니다.
- 자동 폴링·자동 저장은 없습니다. 목록은 탭 진입 또는 새로고침으로 갱신합니다.
- PDF Pod 설정은 API 감지
auto, OpenAI → Gemini 변환none을 유지합니다. Lite 내장 PDF를 쓰면 PDF Pod의 MARP 자식 PDF 수준은off로 둡니다.
안내 문서
JS 회귀 테스트, Go race/vet, Lite·Full의 Chromium/WebKit 자동 검사와 패키지 설치를 검증합니다. 릴리즈·Docker 게시도 필수 CI 검사를 통과한 뒤 실행됩니다. 실제 휴대전화와 유료 공급자 호출은 자동 검증과 구분한 미확인 항목입니다.
문제가 생기면 v0.9.0 플러그인과 Docker 이미지로 되돌릴 수 있습니다. 설정 파일과 데이터 볼륨은 유지합니다.
v0.9.0
MARP v0.9.0
이번 업데이트 한눈에 보기
MARP v0.9.0 — 2026-09-12
Full 서버를 Python에서 Go 1.27.1 + net/http로 전환하고 Lite/Full 브라우저 코드를 모듈화했습니다. 모바일의 시작 비용·메모리·대화 직렬화를 줄이면서 기존 3개 에이전트와 공급자를 유지합니다.
주요 변경
- 세계관 분석 후 플롯·등장인물 병렬 실행. 확정 사실·제약·추측을 구분하고 최종 RP 본문을 대신 작성하지 않는 기본 프롬프트.
- 자체 메모의 소유 마커 교체, 구조화 메시지·첨부·캐시 metadata 보존, 이어쓰기/재생성 최신 assistant와 Full system_context 누락 수정.
- Full은 서버 context_window에 맞춰 최근 이력만 전송. /runtime-config 최대 60초 활동 기반 캐시 및 구버전 /status 대체.
- 네이티브 DOM/CSS 설정 화면, 탭별 조회, DOM과 분리한 편집 상태. 유휴 네트워크·저장 타이머 제거.
- 두 에디션 모두 에이전트별 공급자·모델·credential·온도·출력 제한·추가 JSON·PDF override. 기존 설정·프리셋 import, credential을 제외한 export.
- Unicode 텍스트 PDF와 OpenAI/Custom file, Google/Vertex native PDF, Anthropic document 전송. Lite는 작업별 Worker와 분할 실행 대체 경로.
- PDF off/quality/standard/max. 기존 설치는 off, 활성화 권장값 quality. 280토큰 추정 이하 생략, 입력 1MiB/PDF 8MiB 제한, 실패 시 원래 자료로 텍스트 복귀. 명확한 PDF 미지원 응답에만 한 번 재시도.
- 기본 Lenient는 성공한 결과만 사용. 전체 OFF/전체 실패/빈 결과는 주입하지 않음. Strict는 분석 주입 중단을 표시하며 PDF Pod 환경의 메인 호출 차단을 보장하지 않음.
- 에이전트 60초/전체 120초, Full 대기열 포함, 기본 동시 분석 4. 연결·Vertex OAuth 토큰 재사용, 원자 저장과 분석별 설정 스냅샷.
- 실제 usage와 추정 진단 구분. 비교용 LLM 호출은 진단 테스트 버튼을 누를 때만 수행.
- 정적 Go 이미지, amd64/arm64 실행 파일·이미지, 기존 Lite JS/Full ZIP 이름과 SHA256SUMS. 필수 CI 뒤에만 정식 Release/Docker 게시.
측정 결과
Linux x86_64의 합성 자료·가짜 LLM·모의 RisuAI 호스트에서 측정했습니다. 기기·공급자별 실사용 성능을 뜻하지 않습니다.
| 항목 | v0.8.4 | v0.9.0 측정 |
|---|---|---|
| Lite 배포 JS, 비압축 | 125,540B | 48,969B |
| Full 배포 JS, 비압축 | 120,131B | 32,462B |
| 서버 준비 시간 | 286.33ms | 14.86ms |
| 서버 유휴 RSS | 49.7MiB | 8.5MiB |
| Chromium CPU 4배, 설정 틀 p95 | 미측정 | Lite 5.2ms / Full 2.7ms |
| WebKit 설정 틀 p95 | 미측정 | Lite 2ms / Full 1ms |
| 20회 분석 + PDF 반복 후 GC 잔류 증가 | 미측정 | Lite 90,188B / Full 51,832B |
| Worker / Object URL / abort 리스너 누적 | 미측정 | 0 |
| Chromium PDF 메인 스레드 50ms 이상 작업 | 미측정 | 0 |
| MARP 유휴 네트워크·저장 작업 | 미측정 | 0 |
1,000개 합성 대화의 Full JSON은 최근 10개만 전송할 때 7,045,594B에서 84,409B로 감소했습니다(기준 측정 98.8%). 원시 측정 조건은 tests/fixtures/v0.9.0-performance.json, 재현 절차는 MOBILE_TESTING.md를 참고하세요. 설정 p95는 20회 열기 기준이며 네트워크 완료는 제외합니다. WebKit의 힙/Long Tasks 수치는 측정하지 않았습니다. PDF Pod 자체 비용은 위 수치에 포함하지 않았습니다.
업데이트와 데이터 보존
Lite는 multiagent-lite-v0.9.0.js로 교체합니다. Full은 multiagent-full-v0.9.0.zip과 plugin 폴더의 JS를 함께 업데이트하고 컨테이너를 재생성합니다. Linux 실행 파일은 ZIP의 run.sh 또는 별도 다운로드를 사용할 수 있습니다.
기존 .env, config.json, presets.json, Docker 볼륨과 RisuAI 플러그인 저장소를 삭제하지 마세요. 기존 JSON 설정이 .env 초기값보다 우선합니다. Python 코드는 tests/legacy-python으로 이동했고 실행 패키지에 포함하지 않습니다. Go 모듈 캐시는 개발/빌드에만 필요합니다.
구버전 플러그인+Go 서버의 기존 API 필드를 유지하고, 새 Full 플러그인은 구버전 서버의 /status로 대체합니다. 내장 PDF·신규 진단은 새 서버가 필요합니다. Full max_concurrent_analyses는 변경 후 재시작합니다.
PDF Pod v0.17.10 병용 권장 설정은 API 감지 auto, OpenAI→Gemini 변환 none입니다. MARP 내장 PDF는 보조 분석 요청, PDF Pod의 메인 대화 압축은 별도 범위입니다. 기존 PDF를 다시 변환하지 않도록 해당 설정을 유지하세요.
검증 범위와 제약
MARP Lite에서 내장 PDF를 사용한다면 PDF Pod의 해당 자식 플러그인 PDF 수준은 off로 두세요. PDF Pod가 텍스트 복귀 요청까지 다시 압축하지 않도록 보조 요청의 압축 주체를 하나만 선택합니다. Full의 서버 LLM 요청은 PDF Pod를 통과하지 않습니다.
JS 회귀 검사, Go 테스트/race/vet, Chromium·WebKit 자동 검사, 독립 pypdf Unicode 추출, Docker amd64/arm64 교차 빌드 및 ZIP 구조/CRC를 검사했습니다. 실제 모바일 Safari·Android Chrome, 실제 RisuAI+PDF Pod 전체 실행, 유료 공급자별 품질·토큰 청구와 ARM64 실제 기기 실행은 자동 검사와 구분한 미확인 항목입니다.
PDF에는 Unicode 추출 매핑이 있지만 글꼴 파일을 내장하지 않습니다. 시각 렌더링은 뷰어의 대체 글꼴에 의존하며 CJK가 네모로 보이는 뷰어가 있습니다. 렌더링만 사용하는 공급자 경로의 품질과 비용 절감은 보장하지 않습니다. 처음에는 off를 유지하고 진단 탭에서 해당 모델의 텍스트/PDF 결과를 비교하세요.
호스트의 nativeFetch가 취소를 전달하지 못하면 이미 전송한 공급자 요청 자체는 끝까지 실행될 수 있습니다. MARP는 시간 제한·해제 후 결과를 폐기하고 Worker·리스너·타이머를 정리합니다. PDF Pod는 자식 훅 예외를 흡수할 수 있어 Strict에서도 메인 요청이 진행될 수 있습니다.
디렉터리와 복구
로컬 경로를 /home/grantkim725/data/docker/risuaiNode/MARP로 변경합니다. 상위 Compose는 ./MARP/full, 상위 .gitignore는 /MARP/로 바꿉니다. 상위 저장소의 기존 미커밋 작업과 미푸시 커밋은 그대로 보존하고 경로 변경만 원격 기준의 별도 작업 공간에서 커밋합니다. 기존 origin/github URL, 플러그인 식별자·업데이트 파일명, Docker 데이터 경로는 변경하지 않습니다.
문제 발생 시 PDF를 off로 되돌립니다. 전체 복구는 v0.8.4 JS/ZIP과 Docker 이미지 v0.8.4를 사용하고 기존 데이터 파일을 유지합니다. v0.9.0 추가 필드는 구버전이 사용하지 않으며 기존 데이터 구조는 유지됩니다.
어떤 파일을 받으면 되나요?
multiagent-lite-v0.9.0.js: Lite판 사용자용 단일 플러그인 파일입니다.multiagent-full-v0.9.0.zip: Full판 사용자용 서버 파일과 플러그인 묶음입니다.
누가 업데이트하면 되나요?
- Lite판만 쓰는 경우:
multiagent-lite-v0.9.0.js파일을 받아 RisuAI 플러그인에서 교체하면 됩니다. - Full판을 쓰는 경우:
multiagent-full-v0.9.0.zip을 받아 서버 파일과 플러그인을 함께 업데이트하는 것을 권장합니다.
업데이트 방법
- Lite판을 업데이트하는 경우:
multiagent-lite파일을 내려받아 RisuAI의 플러그인 가져오기/교체 기능으로 넣으면 됩니다. - Full판을 업데이트하는 경우:
multiagent-full압축 파일을 풀고, 기존.env파일은 보존한 뒤 Docker 컨테이너를 다시 빌드해서 실행하면 됩니다. - Full판 플러그인도 함께 바뀌었을 수 있으니, 압축 파일 안의
plugin폴더에 있는 새 플러그인을 RisuAI에 다시 가져오는 것을 권장합니다.
업데이트 전 참고
- API 키와 개인 설정은 릴리즈 파일에 포함되지 않습니다.
- Full판을 쓰고 있다면 기존
.env와data/config.json을 지우지 마세요. - 문제가 생기면 이전 릴리즈 파일로 되돌릴 수 있게 기존 파일을 잠시 보관해 두는 것이 좋습니다.
개발자용 변경 기록
범위: v0.8.4..v0.9.0
- docs: clarify PDF Pod compression ownership and text fallback
- test: load actual minified release plugins in both browsers
- build: ship Go binaries and gate release publication on full validation
- docs: document v0.9.0 migration, measurements and release limitations
- fix: preserve provider options and harden PDF compatibility
- perf: bundle lightweight lazy settings and safe browser lifecycle
- feat: expose runtime diagnostics and validate inherited agent settings
- feat: run Lite PDF jobs in workers with all-provider overrides
- fix: preserve structured messages and migrate browser settings
- feat: add Unicode PDF input and provider-specific text fallback
- feat: implement Go provider clients and three-agent pipeline
- feat: add Go configuration store and compatible HTTP API
- test: capture v0.8.4 API and plugin compatibility baseline
변경된 파일 보기
.github/release-notes/v0.9.0.md
.github/scripts/build_release_notes.py
.github/workflows/ci.yml
.github/workflows/docker.yml
.github/workflows/release.yml
.gitignore
MOBILE_TESTING.md
README.md
RELEASE_NOTES.md
full/.dockerignore
full/.env.example
full/Dockerfile
full/cmd/marp/main.go
full/go.mod
full/go.sum
full/internal/marp/auth_test.go
full/internal/marp/engine.go
full/internal/marp/engine_test.go
full/internal/marp/legacy.json
full/internal/marp/llm.go
full/internal/marp/pdf.go
full/internal/marp/pdf_test.go
full/internal/marp/server.go
full/internal/marp/server_test.go
full/internal/marp/store.go
full/plugin/risu-multiagent-full.js
full/run.sh
lite/risu-multiagent.js
package-lock.json
package.json
scripts/build.mjs
scripts/check-size.mjs
scripts/package.py
src/config.js
src/core.js
src/full.header.txt
src/full.js
src/lite.header.txt
src/lite.js
src/pdf.js
src/pipeline.js
src/prompts.json
src/providers.js
src/runtime.js
src/ui.js
tests/baseline.cjs
tests/browser.mjs
tests/capture_legacy.py
tests/check_pdf.py
tests/core.test.mjs
tests/fixtures/v0.8.4-helpers.json
tests/fixtures/v0.8.4.json
tests/fixtures/v0.9.0-performance.json
tests/harness.js
tests/install_package.py
tests/legacy-python/app/__init__.py
tests/legacy-python/app/agents/__init__.py
tests/legacy-python/app/agents/base.py
tests/legacy-python/app/agents/character.py
tests/legacy-python/app/agents/plot.py
tests/legacy-python/app/agents/worldbuilding.py
tests/legacy-python/app/config.py
tests/legacy-python/app/config_store.py
tests/legacy-python/app/llm_client.py
tests/legacy-python/app/main.py
tests/legacy-python/app/models.py
tests/legacy-python/app/pipeline.py
tests/legacy-python/app/prompt_defaults.py
tests/legacy-python/requirements.txt
tests/legacy.test.cjs
tests/measure_server.py
tests/pdf.test.mjs
tests/runtime.test.mjs
v0.8.4
risu-multiagent v0.8.4
이번 업데이트 한눈에 보기
- Lite판 플러그인: RisuAI에 바로 가져다 넣는 단일 플러그인 파일이 바뀌었습니다. (1개 파일)
- Full판 플러그인: RisuAI 안에서 보이는 Full판 플러그인 화면이나 동작이 바뀌었습니다. (1개 파일)
- Full판 서버: Docker로 실행하는 멀티에이전트 분석 서버가 바뀌었습니다. (5개 파일)
- 설치/실행 설정: Docker, 환경변수 예시, Python 의존성 같은 실행 준비물이 바뀌었습니다. (1개 파일)
- 문서: README나 사용 설명이 바뀌었습니다. (2개 파일)
- 배포 자동화: GitHub/Gitea 릴리즈 자동화나 백업용 workflow가 바뀌었습니다. (1개 파일)
어떤 파일을 받으면 되나요?
multiagent-lite-v0.8.4.js: Lite판 사용자용 단일 플러그인 파일입니다.multiagent-full-v0.8.4.zip: Full판 사용자용 서버 파일과 플러그인 묶음입니다.
누가 업데이트하면 되나요?
- Lite판만 쓰는 경우:
multiagent-lite-v0.8.4.js파일을 받아 RisuAI 플러그인에서 교체하면 됩니다. - Full판을 쓰는 경우:
multiagent-full-v0.8.4.zip을 받아 서버 파일과 플러그인을 함께 업데이트하는 것을 권장합니다.
업데이트 방법
- Lite판을 업데이트하는 경우:
multiagent-lite파일을 내려받아 RisuAI의 플러그인 가져오기/교체 기능으로 넣으면 됩니다. - Full판을 업데이트하는 경우:
multiagent-full압축 파일을 풀고, 기존.env파일은 보존한 뒤 Docker 컨테이너를 다시 빌드해서 실행하면 됩니다. - Full판 플러그인도 함께 바뀌었을 수 있으니, 압축 파일 안의
plugin폴더에 있는 새 플러그인을 RisuAI에 다시 가져오는 것을 권장합니다.
업데이트 전 참고
- API 키와 개인 설정은 릴리즈 파일에 포함되지 않습니다.
- Full판을 쓰고 있다면 기존
.env와data/config.json을 지우지 마세요. - 문제가 생기면 이전 릴리즈 파일로 되돌릴 수 있게 기존 파일을 잠시 보관해 두는 것이 좋습니다.
개발자용 변경 기록
범위: v0.8.3..v0.8.4
- Release v0.8.4
- Strip thinking blocks from multiagent context
- Add preset libraries with lean mobile loading
- Build Full Docker image for arm64
- Publish Full Docker image to GHCR
변경된 파일 보기
.github/workflows/docker.yml
README.md
RELEASE_NOTES.md
full/app/config_store.py
full/app/llm_client.py
full/app/main.py
full/app/models.py
full/app/pipeline.py
full/docker-compose.yml
full/plugin/risu-multiagent-full.js
lite/risu-multiagent.js
v0.8.3
risu-multiagent v0.8.3
이번 업데이트 한눈에 보기
- 프리셋에 provider와 URL도 함께 저장되도록 개선했습니다. 이제 Claude, OpenAI, Gemini 같은 공급자 선택까지 한 번에 옮길 수 있습니다.
- 프리셋에 추가 JSON body도 포함됩니다. Vercel AI Gateway의 캐싱이나 Zero Data Retention 같은 옵션을 같이 백업하고 복원할 수 있습니다.
- API 키와 Vertex 서비스 계정 같은 민감한 정보는 프리셋에 넣지 않습니다. 프리셋을 공유해도 비밀 키는 같이 나가지 않습니다.
- Full판은 에이전트별 provider, URL, 모델, 온도, 추가 JSON override까지 프리셋에 포함합니다.
- Lite판은 모바일에서도 부담이 적도록 파일 import/export 방식만 유지했습니다. 프리셋 목록을 계속 들고 있거나 무거운 저장소를 만들지 않습니다.
- 기본 프롬프트 복구 버튼은 그대로 유지됩니다. 실수로 프롬프트를 바꿔도 언제든 기본값으로 되돌릴 수 있습니다.
어떤 파일을 받으면 되나요?
multiagent-lite-v0.8.3.js: Lite판 사용자용 단일 플러그인 파일입니다.multiagent-full-v0.8.3.zip: Full판 사용자용 서버 파일과 플러그인 묶음입니다.
누가 업데이트하면 되나요?
- Lite판만 쓰는 경우:
multiagent-lite-v0.8.3.js파일을 받아 RisuAI 플러그인에서 교체하면 됩니다. - Full판을 쓰는 경우:
multiagent-full-v0.8.3.zip을 받아 서버 파일과 플러그인을 함께 업데이트하는 것을 권장합니다.
업데이트 방법
- Lite판을 업데이트하는 경우:
multiagent-lite파일을 내려받아 RisuAI의 플러그인 가져오기/교체 기능으로 넣으면 됩니다. - Full판을 업데이트하는 경우:
multiagent-full압축 파일을 풀고, 기존.env파일은 보존한 뒤 Docker 컨테이너를 다시 빌드해서 실행하면 됩니다. - Full판 플러그인도 함께 바뀌었을 수 있으니, 압축 파일 안의
plugin폴더에 있는 새 플러그인을 RisuAI에 다시 가져오는 것을 권장합니다.
업데이트 전 참고
- API 키와 개인 설정은 릴리즈 파일에 포함되지 않습니다.
- Full판을 쓰고 있다면 기존
.env와data/config.json을 지우지 마세요. - 문제가 생기면 이전 릴리즈 파일로 되돌릴 수 있게 기존 파일을 잠시 보관해 두는 것이 좋습니다.
개발자용 변경 기록
범위: v0.8.2..v0.8.3
- Expand preset exports to include provider settings
변경된 파일 보기
.github/release-notes/v0.8.3.md
README.md
full/plugin/risu-multiagent-full.js
lite/risu-multiagent.js
v0.8.2
risu-multiagent v0.8.2
이번 업데이트 한눈에 보기
- Lite판과 Full판 설정 화면에 프리셋 export/import를 추가했습니다.
- 프리셋에는 현재 쓰는 모델, 온도, 직접 수정한 프롬프트만 들어갑니다. API 키는 들어가지 않습니다.
- 실수로 프롬프트를 잘못 바꿔도 괜찮습니다. 기본 프롬프트는 플러그인/서버 안에 그대로 들어 있고, 설정 화면의 기본값으로 되돌리기 버튼으로 다시 복구할 수 있습니다.
- Lite판은 모바일에서도 부담이 적도록 프리셋 파일을 가볍게 만들었습니다.
- RisuAI 플러그인 목록에서 새 버전을 확인하고 업데이트 버튼으로 갱신할 수 있도록 업데이트 정보를 추가했습니다.
- Lite판 사용자는 플러그인만 업데이트하면 됩니다.
- Full판 사용자는 Full 플러그인을 업데이트하고, 서버 zip을 새로 받아 Docker 컨테이너를 다시 빌드하는 것을 권장합니다.
어떤 파일을 받으면 되나요?
multiagent-lite-v0.8.2.js: Lite판 사용자용 단일 플러그인 파일입니다.multiagent-full-v0.8.2.zip: Full판 사용자용 서버 파일과 플러그인 묶음입니다.
누가 업데이트하면 되나요?
- Lite판만 쓰는 경우:
multiagent-lite-v0.8.2.js파일을 받아 RisuAI 플러그인에서 교체하면 됩니다. - Full판을 쓰는 경우:
multiagent-full-v0.8.2.zip을 받아 서버 파일과 플러그인을 함께 업데이트하는 것을 권장합니다.
업데이트 방법
- Lite판을 업데이트하는 경우:
multiagent-lite파일을 내려받아 RisuAI의 플러그인 가져오기/교체 기능으로 넣으면 됩니다. - Full판을 업데이트하는 경우:
multiagent-full압축 파일을 풀고, 기존.env파일은 보존한 뒤 Docker 컨테이너를 다시 빌드해서 실행하면 됩니다. - Full판 플러그인도 함께 바뀌었을 수 있으니, 압축 파일 안의
plugin폴더에 있는 새 플러그인을 RisuAI에 다시 가져오는 것을 권장합니다.
업데이트 전 참고
- API 키와 개인 설정은 릴리즈 파일에 포함되지 않습니다.
- Full판을 쓰고 있다면 기존
.env와data/config.json을 지우지 마세요. - 문제가 생기면 이전 릴리즈 파일로 되돌릴 수 있게 기존 파일을 잠시 보관해 두는 것이 좋습니다.
개발자용 변경 기록
범위: v0.8.1..v0.8.2
- Add v0.8.2 release notes
- Add preset import export for multiagent plugins
변경된 파일 보기
.github/release-notes/v0.8.2.md
README.md
full/plugin/risu-multiagent-full.js
lite/risu-multiagent.js
v0.8.1
risu-multiagent v0.8.1
이번 업데이트 한눈에 보기
- Lite/Full 플러그인과 Full 사이드카 내부 표시 버전을 v0.8.1로 통일했습니다.
- Lite판과 Full판에 프롬프트 JSON import를 추가했습니다. export한 파일을 그대로 불러올 수 있습니다.
- 전체 import와 에이전트별 import를 지원하며, Lite ↔ Full export 파일도 호환됩니다.
- import 후에는 설정 화면에서 저장을 눌러야 vault/사이드카에 반영됩니다.
- Lite판 사용자는
risu-multiagent.js를 다시 Import하면 됩니다. - Full판 사용자는 새 zip으로 서버를 다시 빌드하고 Full 플러그인을 다시 가져오는 것을 권장합니다.
어떤 파일을 받으면 되나요?
multiagent-lite-v0.8.1.js: Lite판 사용자용 단일 플러그인 파일입니다.multiagent-full-v0.8.1.zip: Full판 사용자용 서버 파일과 플러그인 묶음입니다.
누가 업데이트하면 되나요?
- Lite판만 쓰는 경우:
multiagent-lite-v0.8.1.js파일을 받아 RisuAI 플러그인에서 교체하면 됩니다. - Full판을 쓰는 경우:
multiagent-full-v0.8.1.zip을 받아 서버 파일과 플러그인을 함께 업데이트하는 것을 권장합니다.
업데이트 방법
- Lite판을 업데이트하는 경우:
multiagent-lite파일을 내려받아 RisuAI의 플러그인 가져오기/교체 기능으로 넣으면 됩니다. - Full판을 업데이트하는 경우:
multiagent-full압축 파일을 풀고, 기존.env파일은 보존한 뒤 Docker 컨테이너를 다시 빌드해서 실행하면 됩니다. - Full판 플러그인도 함께 바뀌었을 수 있으니, 압축 파일 안의
plugin폴더에 있는 새 플러그인을 RisuAI에 다시 가져오는 것을 권장합니다.
업데이트 전 참고
- API 키와 개인 설정은 릴리즈 파일에 포함되지 않습니다.
- Full판을 쓰고 있다면 기존
.env와data/config.json을 지우지 마세요. - 문제가 생기면 이전 릴리즈 파일로 되돌릴 수 있게 기존 파일을 잠시 보관해 두는 것이 좋습니다.
개발자용 변경 기록
범위: v0.8.0..v0.8.1
- Fix Lite plot prompt self-reference
- Align plugin and sidecar display version with v0.8.1 release.
- Add release notes for v0.8.1 prompt import patch.
- Add prompt JSON import to Lite and Full plugins.
변경된 파일 보기
.github/release-notes/v0.8.0.md
.github/release-notes/v0.8.1.md
README.md
full/app/main.py
full/plugin/risu-multiagent-full.js
lite/risu-multiagent.js

