Files
EJClaw/docs/slimming-plan.md
2026-10-01 16:35:25 +09:00

251 lines
17 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# EJClaw 경량화·최적화 계획 (v3 — 사용자 결정 반영 완료)
- 최초 조사: 2026-10-01 (기준 커밋 af28bae), 결정 반영: 2026-10-01 16시, 최종 결정: 2026-10-01 16시 30분
- 번호는 첫 조사 문서와 같다. 빠진 번호는 "제외"로 표시했다.
- 상태 표기
- **확정**: 결정이 끝나 바로 진행
- **추천**: 결정은 필요 없지만, 진행하겠다고 확인만 받으면 됨
- **결정 필요**: 아래 설명을 보고 골라 주셔야 함
- **제외**: 하지 않음
## 0. 한눈에 보기
| 번호 | 내용 | 상태 |
|---|---|---|
| 1 | 중재자가 판정 규칙을 못 받는 버그 수정 | 확정 (버그) |
| 2 | 리뷰어가 owner 규칙을 받는 버그 수정 | 확정 (버그) |
| 3 | 사용자에게 묻는 경우(NEEDS_CONTEXT) 중재 없이 바로 전달 | 확정 (버그) |
| 4·17 | Claude 한도 소진 시 답변이 사라지는 failover 경로 제거 | 확정 (버그) |
| 5 | Codex 사용량 조회가 구버전·잠금 없이 실행되는 문제 | 확정 (버그) |
| 6 | owner 세션을 작업 단위로 새로 시작 | 추천 (효과 가장 큼) |
| 7 | 공용 메모리 다이어트 | 추천 |
| 8 | owner가 "리뷰 필요 없음"을 스스로 표시하면 리뷰 생략 (시스템이 변경 여부를 다시 확인) | 확정 (사용자 제안 방식, 아래 설계) |
| 9 | 리뷰 효과 낮은 방을 single로 | 제외 (요청 시에만 전환) |
| 10 | 마무리 턴 비용 줄이기 | 확정 (C안) |
| 11~15 | 폴링·로그·IPC 정리 | 추천 |
| 16 | 웹 대시보드·Android·Glasses 전부 삭제 | 확정 |
| 18~21, 23, 24, 29 | 안 쓰는 기능·죽은 코드·의존성 삭제 | 추천 |
| 22 | `/stop` 등 명령어 → 대화 중 "그만해"로 중단 | 확정 (새 기능으로 교체) |
| 25 | DB 마이그레이션 정리 | 추천 (백업 후) |
| 26 | 서비스 ID 단일화 | 보류 (위험 높음) |
| 27 | main 방 개념과 방 간 관리 기능 삭제 | 확정 ((다)안) |
| 28 | 계정 로테이션 단순화 (계정 1개 고정) | 확정 |
| 30~35 | 디스크 정리 약 3.3GB | 추천 |
| 36 | 런처 이전 버전 설치 파일 삭제 약 10.5GB | 확정 |
---
## 결정한 3가지 — 설명 (8번은 아래 B절의 확정 설계 참고)
### 8. "리뷰 생략"이 뭔가요?
지금은 어떤 질문이든 이렇게 3번 돌아갑니다.
1. Claude(owner)가 답을 만든다
2. Codex(리뷰어)가 그 답을 검토한다 (평균 1분 30초)
3. Claude가 최종 정리를 한다 (평균 20초)
그런데 "이 채널 왜 답 안 해?", "main 방 역할이 뭐야?"처럼 **파일을 하나도 고치지 않고 설명만 하는 작업**이 전체의 약 44%입니다. "리뷰 생략"은 이런 경우에 2·3번을 건너뛰고 1번 답을 바로 보내는 것입니다.
| | 지금 | 리뷰 생략 시 |
|---|---|---|
| 코드를 고친 작업 | 3단계 그대로 | 3단계 그대로 (변화 없음) |
| 설명만 한 작업 | 3단계 (약 2분 더 걸림) | 1단계 (약 2분 빨라짐) |
| 잃는 것 | — | 설명 답변의 사실 오류를 리뷰어가 잡아줄 기회 |
- 참고: 오늘도 리뷰어가 설명형 답변에서 실수를 잡은 적이 있습니다(KAclaw 로그인 미확인 상태로 완료 처리하려던 것). 리뷰 품질을 중시하시면 **하지 않는 것**을 권합니다.
- 선택지: (가) 하지 않음 / (나) 설명만 한 작업은 리뷰 생략
### 10. 마무리 턴, 다른 해결책
마무리 턴이 생긴 이유(말씀하신 것): owner와 리뷰어가 서로 대화만 하고, 마지막에 "해결했어요"만 남기는 경우가 많아서 전체를 정리해 보여달라고 하신 것.
지금 문제: 마무리 턴이 **owner의 거대한 대화 세션 전체(수십만 토큰)를 다시 읽고** 정리합니다. 정리 자체는 몇 천 토큰이면 되는데, 매번 수십만 토큰을 씁니다(30일 178회).
| 안 | 방법 | 결과물 | 비용 |
|---|---|---|---|
| A | 리뷰어가 **수정 요청 없이 바로 승인**하면, owner의 첫 답변을 그대로 최종 답변으로 보냄 (owner 규칙상 첫 답변도 이미 "사용자용 완결 답변" 형식) | 수정 없이 끝난 작업은 그대로 / 수정이 있었던 작업만 마무리 턴 | 작업의 약 80%에서 마무리 턴 0회 |
| B | 마무리 턴은 유지하되, 거대한 세션 대신 **이번 작업의 owner·리뷰어 답변(최대 6개, 수천 토큰)만 넣은 가벼운 호출**로 정리 | 지금과 같은 정리 형식 | 마무리 1회당 수십만 → 수천 토큰 |
| C | A + B 함께: 바로 승인 → A, 수정 있었음 → B | 같음 | 가장 적음 |
- **결정: C안.** 보여지는 최종 답변 형식은 지금과 같고, 비용만 줄어듭니다.
- 참고: 6번(세션을 작업 단위로 새로 시작)을 하면 마무리 턴이 읽는 세션도 작아져서 B의 효과 일부가 자동으로 생깁니다.
### 27. main 방의 역할
main 방은 "관리자 방"입니다. 코드상 main 방만 할 수 있는 일은 다음과 같습니다.
| main 방만 가능한 것 | 근거 |
|---|---|
| 다른 방의 예약 작업 보기·취소·일시정지·새로 만들기 | `src/ipc-task-processor/tasks.ts`, `schedule.ts` |
| 채널 등록·설정 변경 도구(`assign_room`) | `src/ipc-task-processor/rooms.ts` |
| 다른 방으로 메시지 보내기 | `src/ipc-message-forwarding.ts` |
| 전체 방 목록, 모든 방의 DB 기록 조회 | `agent-runner-snapshot.ts`, `db-evidence.ts` |
| 트리거 없이 항상 응답, 세션 명령 허용 | `message-runtime-rules.ts`, `session-commands.ts` |
| (부작용) 공용 메모리를 받지 않음 | `agent-runner-environment.ts:671` |
현재 상황:
- main 방이 하나도 없어서 위 기능은 **모든 방에서 꺼져 있습니다.**
- 대신 base_all 방에서 셸 명령으로 같은 관리 작업(채널 등록, 다른 방 작업 중단, 서비스 재시작 등)을 해 왔습니다. 에이전트가 호스트 셸을 직접 쓸 수 있어서 main 권한이 사실상 필요 없었습니다.
| 선택지 | 내용 | 장점 | 단점 |
|---|---|---|---|
| (가) 지금처럼 둠 | main 없음, 관리는 base_all에서 셸로 | 변경 없음 | main 관련 코드 163곳이 쓸모없이 남음 |
| (나) base_all을 main으로 지정 | base_all에서 관리 도구를 정식으로 사용 | 다른 방 예약 작업 관리 등이 도구로 깔끔해짐 | base_all이 공용 메모리를 못 받게 됨(코드 수정 필요). 위험한 관리 도구가 한 방에 열림 |
| (다) main 개념과 방 간 기능 삭제 | 관련 코드 제거 | 코드 정리, 지금 실제 사용 방식 그대로 | 방 간 관리 도구는 영구히 없어짐(셸로는 계속 가능) |
- **결정: (다)안.** 지금도 쓰지 않고 있고, 셸로 다 하고 있기 때문입니다.
---
## A. 버그 수정 (확정)
### 1. 중재자가 판정 규칙을 받지 못함
- 근거: 규칙 파일을 읽는 코드가 꺼져 있는 경로(unsafe 모드, MoA)에서만 호출된다. 중재자 세션 폴더에 규칙 파일이 없다.
- 영향: 30일간 중재 23회 중 20회가 판정을 해석하지 못하고 사용자에게 그냥 넘어감.
- 수정: 일반 경로의 중재자 세션에 중재자 규칙을 넣는다.
### 2. Codex 리뷰어가 owner 규칙을 받음
- 근거: 실제 리뷰어 세션 `AGENTS.md`에 "You are the owner"가 들어 있다.
- 수정: 리뷰어 세션에는 리뷰어 규칙만 넣는다.
### 3. NEEDS_CONTEXT가 중재자를 거침
- 근거: 중재 23회 중 13회가 이 경우. 중재자 규칙상 항상 사용자에게 넘기는 경우다.
- 수정: 중재 없이 바로 사용자에게 보낸다. 중재 호출 -57% 이상.
### 4·17. 받을 곳 없는 Claude→Codex failover 제거
- 근거: Claude 한도 소진 시 이 배포에 없는 `codex-main`으로 작업을 넘긴다. 5월에 넘긴 2건이 아직 `pending`.
- 수정: 체인 제거(코드 약 -2천 줄), 한도 소진 시 "한도 소진, ○시 재개 예정"을 바로 보냄.
- 주의: DB 스키마와 엮여 있어 백업 후 진행.
### 5. Codex 사용량 조회
- 근거: 구버전 전역 Codex(0.128)를 계정 잠금 없이 실행 → 토큰 충돌 위험.
- 수정: 저장소에 고정된 0.159.3 사용 + 계정 잠금 + 주기 5~10분(12번과 함께).
## B. 토큰·속도
### 6. owner 세션을 작업 단위로 새로 시작 (추천, 효과 가장 큼)
- 근거: 방마다 한 세션을 몇 주씩 이어 써서 호출 1회에 중앙값 26만, 최대 100만 토큰을 읽는다. Claude 5시간 사용량 89%의 주원인.
- 수정: 새 작업이 시작되면 세션을 새로 연다. 직전 최종 답변은 이미 자동으로 넘겨주고 있어 맥락 손실이 작다.
- 효과: Claude 입력 토큰 -50~70% (추정).
### 7. 공용 메모리 다이어트 (추천)
- 근거: 모든 세션에 공용 메모리 약 1.1만 토큰이 들어간다. 세탁기 앱 배포, Windows CI, .5 docker, EJClaw 운영 절차 등 대부분 방과 무관한 내용.
- 수정: 공통 규칙만 남기고, 프로젝트·운영 내용은 해당 방 메모리나 "필요하면 이 문서를 읽어라" 링크로 옮긴다.
- 효과: 호출당 -7~8K 토큰.
### 8. 리뷰 필요 여부를 owner가 표시 (확정 — 사용자 제안 방식)
**가능 여부: 가능합니다.** owner 답변 뒤에 무엇을 할지 정하는 곳이 한 군데(`src/paired-completion-signals.ts`의 `resolveOwnerCompletionSignal`)라서, 여기에 "owner가 리뷰 불필요라고 표시했고, 안전 조건도 통과하면 바로 끝낸다"는 분기를 넣으면 됩니다.
동작 방식:
1. owner가 답을 만들 때, 정말 설명·조사만 했고 아무것도 바꾸지 않았으면 답변 끝에 `리뷰 불필요: (이유)` 한 줄을 붙인다. 애매하면 붙이지 않는다(기본값은 리뷰).
2. 시스템이 그 표시를 그대로 믿지 않고 다시 확인한다. 아래 중 **하나라도 해당하면 표시를 무시하고 평소처럼 리뷰**한다.
- 작업 폴더에 코드 변경이나 커밋이 있음 (이미 있는 `hasCodeChangesSinceRef`로 확인)
- 파일을 고치는 도구(Edit, Write 등)를 썼음
- 셸 명령 중에 무언가를 바꾸는 명령이 있었음: 삭제·이동, 서비스 재시작, 프로세스 종료, DB 쓰기, git 커밋·푸시, crontab 수정, 외부 API 쓰기 요청 등
3. 통과하면 리뷰어와 마무리 턴 없이 owner 답변이 바로 최종 답변이 된다. 답변 끝에 "검토 생략(변경 없는 설명형 답변)"을 작게 표시하고, 사용자가 "검토해줘"라고 하면 그때 리뷰를 돌린다.
왜 안전한가:
- 오늘 리뷰어가 실수를 잡은 경우(KAclaw 로그인 미확인 상태로 완료 처리)는 서비스 재시작·설정 변경이 있었던 작업이라 2번 조건에 걸려 **어차피 리뷰를 받습니다.**
- 이 방(base_all)의 최근 세션은 셸 명령 415개 중 77개가 변경 명령이었습니다. 운영 작업은 거의 항상 리뷰를 거치고, 순수 질문·설명만 리뷰를 건너뜁니다.
남는 한계: owner가 설명 내용 자체를 틀리게 말하는 경우(변경 없이 잘못된 정보만 준 경우)는 리뷰어가 못 잡습니다. 그래서 owner가 확신이 없거나 사실 확인이 중요한 답이면 표시하지 않도록 규칙에 넣습니다.
예상 효과: 30일 기준 단순 질답 83건 중 상당수에서 리뷰어(평균 1분 30초)와 마무리 턴(20초)이 빠짐.
### 9. single 전환 — 제외 (요청하신 방만 전환)
### 10. 마무리 턴 — C안 확정 (위 표의 C: 바로 승인이면 owner 답변 그대로, 수정이 있었으면 가벼운 정리 호출)
- 리뷰어 effort를 xhigh → high로 낮추는 것은 별도로 추천(리뷰 평균 97초 단축 예상).
## C. 실행 자원 (추천)
| 번호 | 내용 | 효과 |
|---|---|---|
| 11 | 대시보드 중복 정리: 2초마다 Discord 메시지 100개 조회 → 시작 시 1회 + 5분 주기 | Discord 호출 하루 4.3만 건 → 수백 건 |
| 12 | Codex 사용량 조회: 1분마다 프로세스 생성 → 5~10분 + 리뷰 직후 | 프로세스 생성 -80~90% |
| 13 | Claude 사용량 조회: 1분 → 5분 | 호출 -80%, 429 오류 거의 0 |
| 14 | 로그 한 줄 출력 + 반복 로그 4종 debug로 | 로그 줄 수 -90% |
| 15 | IPC 고아 폴더 7개 삭제 | 1초 폴링 부담 -20% |
## D. 코드 덜어내기
| 번호 | 내용 | 줄어드는 코드 | 상태 |
|---|---|---|---|
| 16 | 웹 대시보드·Android 앱·Glasses·관련 설정/스크립트·의존성(react, vite, playwright 등) | 약 -2.4만 줄 (+테스트 -5.8천) | 확정 |
| 18 | MoA + Kimi 사용량 | 약 -600 | 추천 |
| 19 | auto-paired-mode | 약 -370 | 추천 |
| 20 | 참조 0인 코드 28개 + 고아 파일 3개 | 약 -500 | 추천 |
| 21 | 엉뚱한 계정을 갱신하는 6시간 Codex 갱신 루프 | 약 -150 | 추천 |
| 22 | `/compact`·`/clear`·`/stop` 명령 삭제 → 아래 새 기능으로 교체 | 약 -280 (+테스트 -324) | 확정 |
| 23 | macOS·launchd·nohup 설치 경로, repo-tokens | 약 -150 | 추천 |
| 24 | 쓰지 않는 의존성, 루트 dist 빌드 | — | 추천 |
| 25 | DB 마이그레이션 정리 | 약 -4천 | 추천 (백업 후) |
| 26 | 서비스 ID 단일화 | 약 -1천 | 보류 (위험 높음) |
| 27 | main 방 개념과 방 간 관리 기능 | 163곳 정리 | 확정 ((다)안) |
| 28 | 계정 로테이션을 계정 1개 기준으로 단순화 (Codex 잠금은 유지) | 약 -400~600 | 확정 |
| 29 | Codex warmup 설정을 primer로 합침 | 약 -200 | 추천 |
- 전부 진행하면 운영 코드 약 7.6만 줄 중 약 3만 줄(약 40%) 감소.
### 22번 새 기능: 대화 중 "그만해"로 작업 중단 (확정)
| 항목 | 설계 |
|---|---|
| 언제 멈추나 | 방에서 작업이 돌고 있을 때 사용자가 중단 의사만 담긴 짧은 메시지를 보내면 |
| 멈추는 말 | "그만", "그만해", "멈춰", "중단", "하지마", "하지 마", "취소", "스톱", "stop" 등 |
| 멈추지 않는 경우 | "그거 하지 말고 이걸 해줘"처럼 **다른 지시가 함께 있는 메시지**는 방향 수정으로 보고 평소처럼 처리 |
| 멈출 때 하는 일 | ① 그 방에서 돌던 owner·리뷰어·중재자 실행 종료 ② 진행 중이던 작업 종료 처리 ③ 대기 중이던 메시지까지 처리 완료로 표시(지난번 pdf 방처럼 저절로 다시 시작되는 것 방지) ④ "진행 중이던 작업을 중단했습니다"라고 답장 |
| 다시 시작 | 다음에 보내는 메시지부터 평소처럼 새 작업으로 처리 |
| 오작동 방지 | 짧은 메시지만 대상, 판단이 애매하면 멈추지 않고 평소처럼 처리 |
## E. 디스크 정리
| 번호 | 대상 | 크기 | 상태 |
|---|---|---|---|
| 30 | DB 백업 23개 중 최근 3개만 남김 | 약 555MB | 추천 |
| 31 | Codex 임시 플러그인 복제본 등 | 약 1.2GB | 추천 |
| 32 | 세션별 Codex 로그 DB | 약 536MB | 추천 |
| 33 | 등록 안 된 방의 폴더 | 약 560MB | 추천 |
| 34 | 리뷰용 임시 폴더 | 약 208MB | 추천 |
| 35 | 30일 지난 작업 첨부 | 일부 | 추천 |
| 36 | 음악퀴즈 런처 `release` 폴더의 이전 버전 설치 파일 0.4.9~0.4.30 (6종 × 22버전). 최신 1.0.0 설치 파일 6개(474MB)와 `win-unpacked`는 남김 | 약 10.5GB | 확정 |
| 36-참고 | unifi-site 작업공간의 `.venv` 7.7GB | — | 남김 (이전 버전이 아니라 지금 쓰는 개발 환경. 실제 사이트는 `/home/claude/unifi-site/.venv`를 씀. 지우길 원하시면 말씀해 주세요, 다시 만들 수 있음) |
- 30·31·32·35는 주기적으로 정리하는 cron도 함께 추가(추천).
## F. 유지
| 대상 | 이유 |
|---|---|
| Tribunal(owner·리뷰어·중재자) 구조, 방별 모드 | 사용자 결정. 리뷰가 결과를 바꾼 비율 13~16% |
| Discord 상태 대시보드 | 사용량 확인용으로 실제 사용 중 (웹 대시보드와 별개) |
| usage primer, evidence·verification 도구, 재시작 복구 등 안전장치 | 실제 동작 기록 있음 |
| DB 보존 정책 | 37MB, 증가 완만. 당장 불필요 |
## G. 진행 순서 (제안)
| 단계 | 번호 | 내용 |
|---|---|---|
| 1단계 | 1, 2, 3, 5, 11~15 | 버그 수정 + 폴링·로그 정리 (작은 수정, 바로 효과) |
| 2단계 | 16, 18~21, 22, 23, 24, 27, 28, 29 | 삭제·단순화 일괄(main 방 포함) + "그만해" 중단 기능 |
| 3단계 | 6, 7, 8, 10 | 토큰 절감 (세션 교체, 공용 메모리, 리뷰 필요 여부 표시, 마무리 턴 C안) |
| 4단계 | 4·17, 25 | DB와 엮인 구조 정리 (백업 후) |
| 5단계 | 30~36 | 디스크 정리 + 주기 정리 cron |
| 보류 | 26 | 서비스 ID 단일화 |
## H. 결정 현황
모든 결정이 끝났다.
| 번호 | 결정 |
|---|---|
| 8 | owner가 리뷰 필요 여부 표시 + 시스템 재확인 (사용자 제안) |
| 10 | C안 |
| 27 | (다)안: main 방 개념 삭제 |
| 16 | 웹 대시보드·Android·Glasses 전부 삭제 |
| 22 | 명령어 대신 대화 중 "그만해"로 중단 |
| 28 | 계정 1개 기준으로 단순화 |
| 36 | 런처 이전 버전 삭제 |
| 9 | single 전환 안 함 (요청 시에만) |