AiGoodBro · AgentHub (3.0.0)
크레딧(额度), 사용량, 재설정 메시지 및 로컬 작업을 한 페이지에서 명확하게 확인하고; 필요할 때 작업이 자체 Codex 계정 풀을 사용하도록 합니다.
AiGoodBro는 개인 사용자를 위한 macOS AI 워크스테이션입니다. Codex 다중 계정, Claude 구독, 연결된 CLI의 크레딧 및 상태를 한 곳에서 확인하고, Token 사용량을 통계 내며, 공개 재설정 메시지를 수신하고, 선택적 로컬 프록시(反代) 기능을 제공합니다. 인터페이스는 중국어와 English를 지원하며, 메인 페이지 이름은 AgentHub입니다.
[中文] | English
현재 출시 버전: 3.0.0 (161) · 1028v1. 메인 페이지 통계 및 사용 시간 표시를 수정하고, 프록시 중지 및 정리 기능을 백그라운드 제한 시간 처리로 변경했으며, 두 번의 확인 후 강제 종료가 가능합니다. 기존 계정, 규칙 및 외관을 유지하며, 이전에 검토된 사용량 분석, 메시지 자격 증명 복구 및 상위 호환성(上游适配)을 포함했습니다. 소프트웨어 내 업데이트 소개와 동기화됩니다. 릴리스 및 다운로드 · 전체 변경 사항 및 검증 경계.
Windows 3.0.0 독립 출시. 로컬 워크스테이션, 디렉토리 연관, 크레딧 읽기 및 격리 터미널 워크플로우를 제공하며, Windows용으로 빌드 및 테스트되었으므로 macOS 기능과 완전히 일치할 필요는 없습니다. Windows 기능 및 설치 설명.
다운로드: DMG (Apple Silicon) · macOS ZIP 백업 패키지 · Windows MSI · Windows EXE
홍보 영상 및 인터페이스 시연 · 1012v1: 중국어 원본 영상 (48초 MP4) · English (48초 MP4) · 영어 시연 소스코드 · 영어 전체 자료 패키지 (ZIP, 영어 원본 비디오 포함)
영어 시연 페이지는 메인 인터페이스 순회, 재설정 카운트다운, Feishu/WeChat 메시지, 화면 가장자리 사이드바, 프록시 플로팅 창 및 다중 계정 카드를 정리했으며, 재현 가능한 소스코드도 첨부했습니다.
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
메인 인터페이스 · 리셋 메시지 · 프록시 · 계정 · Claude · 토큰 사용량 모니터링 · 기타 CLI · 카드 자동 리셋 · 초대 · 위챗 · Feishu · 사이드바 · 작업 할당량 · 설정 및 업데이트 · 테마 · 다운로드 및 빌드 · 소스 코드 및 문서 · 실제 소프트웨어 스크린샷
<a id="main"></a>
01 · 메인 인터페이스: 한눈에 작업 상태 파악하기
기능: 메인 인터페이스는 가장 자주 사용되는 상태들을 모아 놓았습니다. 상단에는 공지사항과 리셋 메시지가, 중앙에는 연결된 도구와 추천 진입점이, 하단에는 토큰 사용량 통계가, 최하단에는 Codex 계정, Claude 구독 및 기타 도구의 상태가 표시됩니다. 공개 공지사항, 계정 실제 한도, 사용량 통계, 작업 할당량을 분리하여 표시함으로써 출처가 다른 숫자들을 혼동하는 것을 방지합니다.
사용 방법: AiGoodBro를 실행한 후 AgentHub 메인 페이지로 진입합니다. 구역 제목을 클릭하면 펼치거나 접을 수 있으며, 계정 영역은 '카드/목록' 사이에서 전환할 수 있고, 구역 너비 및 일부 축소 설정은 로컬에 저장됩니다.
이미지 설명: 전면 이미지는 홍보 영상의 데모 화면에서 가져온 것이며, 계정 별명, 한도 및 상태는 스크립트 내용입니다. 실제 소프트웨어 스크린샷에는 본문 하단에 집중적으로 전시되어 있습니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/dashboard.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/dashboard.png" width="1000" alt="메인 인터페이스 개요: 공지사항, 사용량 히트맵, 추세 및 Codex 계정 카드."></a>
</p>
메인 인터페이스의 각 숫자가 의미하는 바:
- 리셋 메시지: 공개 메시지 출처의 공지사항과 기록이며, 특정 계정이 이미 읽은 공식 한도를 의미하지 않습니다.
- 사용 가능한 포인트(점): 읽어온 계정의 포인트 스냅샷입니다. **사용 가능한 금액(달러)**은 동일한 포인트가 현재 비율로 환산된 것이며(1 달러 = 25 점), 별도의 잔액이 아닙니다. 알 수 없는 값은 0으로 표시하지 않습니다.
- 토큰 총량, 비용 및 추세: 로컬 사용량 기록에서 가져온 것입니다. 비용은 추정치이며 공급업체의 청구서가 아닙니다.
- 계정 카드: 계정 신원, 5시간/7일 창(window), 리셋 시간, 리셋 카드 및 작업 할당량을 표시합니다. 신뢰할 수 있는 반환 값이 부족하면 “—” 또는 이전 스냅샷으로 표시됩니다.
<a id="reset-messages"></a>
02 · 리셋 메시지: 먼저 공개 공지 확인 후 계정 대조하기
기능: “리셋 메시지”는 공개된 할당량 리셋 공지를 수신하고 확인하는 데 사용됩니다. 최근에 새로운 리셋, 공지 내용 및 확인 대기 상태가 발생했는지 판단하는 데 도움을 줍니다. 이는 계정 한도 읽기와 분리되어 있으며, 공지로 계정을 대체할 수 없고, 공지를 봤다고 해서 자동으로 리셋 카드가 교환되지는 않습니다.
사용 방법: 메인 페이지의 “리셋 메시지” 구역에서 메시지 목록을 엽니다. “최근 3개”는 빠른 탐색에 사용되며, 펼치면 공지 출처, 시간 및 상태를 확인할 수 있습니다. 최초로 역사적 기준선을 구축하며, 이후에는 새 메시지만 알림이 표시됩니다. 과거 읽기 실패 시에는 이미 확인된 내용을 유지하고 누락된 부분을 표시합니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/reset.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/reset.png" width="1000" alt="리셋 공지, 리셋 카드 수량 및 확인 상태."></a>
</p>
메시지와 계정 데이터의 경계: 공개 메시지는 계정 공식 리셋 기록을 수정하지 않으며, 스케줄링 참여, 우선순위 또는 포인트 하한선을 변경하지도 않고, 작업을 자동으로 전송하지도 않습니다. 리셋 카드를 실행하려면 아래쪽 “카드 자동 리셋” 진입점을 사용하고, 계정별로 명확하게 활성화해야 합니다.
<a id="proxy"></a>
03 · 로컬 리버스 프록시: 요청을 자신의 계정 큐에 맡기기
기능: 로컬 리버스 프록시는 선택적인 로컬 서비스입니다. 클라이언트가 모델 요청을 로컬 엔드포인트로 전송하면, AiGoodBro는 해당 계정의 참여 상태, 우선순위, 마지막 사용 및 저장 순서에 따라 자신이 연결한 계정을 선택합니다. 이는 공용 프록시가 아니며 개인 계정 풀과 로컬 작업을 위해 적합하며, 계정이나 한도 재판매를 제공하지 않습니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/proxy.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/proxy.png" width="1000" alt="프록시 상태 플로팅 창: 계정 목록, 할당량, 포인트 및 사이드바."></a>
</p>
활성화 방법:
- AiGoodBro의 프록시 패널에서 수동으로 “프록시 활성화”를 클릭해야 합니다. 애플리케이션 재시작 후에는 자동으로 시작되지 않습니다.
- 연결 정보가 준비될 때까지 기다린 후, Codex를 종료하고 “데스크톱에 접속”을 사용하여 로컬 라우팅에 다시 연결하고 시작합니다. 이미 실행 중인 Codex 프로세스는 프록시 설정을 자동으로 변경하지 않습니다.
- 작업을 완료한 후 패널에서 “프록시 중지”를 클릭합니다. 메인 창을 닫는 것은 단순히 창을 숨기는 것이며, 애플리케이션을 종료할 때 서비스 중지 여부를 묻습니다.
큐(Queue) 작동 방식: 참여, 우선순위, 마지막 사용 순서 및 정렬은 새로운 요청에만 영향을 미치며 계정 페이지와 동기화됩니다. 이미 확인된 Pro 계정은 기본적으로 마지막 사용 순서로 설정되어 있으며 조정 가능하며, 수동 배율 태그는 라우팅을 결정하지 않습니다. 일반 그룹은 일시적으로 바쁠 경우 원래의 제한 시간 내에 기다리며 즉시 마지막 사용 계정을 전환하지 않습니다. 할당량이 부족하거나 참여하지 않은 계정은 계속 건너뜁니다. 신원, 냉각(Cooling), 할당량 검사는 유지됩니다. 구독 할당량(Subscription Quota)이 포인트보다 우선하며, 포인트는 기본적으로 비활성화되어 있다가 사용자가 수동으로 활성화해야만 할당량이 소진될 때 진입합니다. 바쁘거나 알 수 없는 계정은 할당량 소진으로 간주되지 않습니다.
실행 중 참여를 취소하면 아직 접속하지 않은 대기 및 재시도는 해당 계정을 건너뛰고, 이미 연결된 스트리밍 응답은 계속 완료됩니다. 게이트웨이 거부(Gateway Reject), 시간 초과(Timeout), 취소(Cancel) 및 일반 포워딩 실패는 각각 알림을 제공합니다. HTTP 503 코드는 유지되며, 전송된 요청은 실패했다고 해서 자동으로 재전송되지 않습니다. 2.5 버전에서는 블로킹 리드(blocking read)를 협업 스레드 풀에서 제거하고 연결 끊김 시 패킷 복구를 보호했습니다. 명확한 출처가 있는 할당량 냉각은 확인된 구독 할당량이 업데이트된 후에만 해제됩니다. 출처가 불분명한 이전 냉각은 프록시 중지 후 해당 계정에서 “이전 버전 냉각 정리…”를 선택하여, 최신 할당량 및 신원 검증, 백업 확인을 거쳐 정리하고 수동으로 프록시를 다시 활성화할 수 있습니다. Plus의 사용자 지정 5시간 사용 상한은 저장된 값을 기준으로 실행되며, 규칙 요약과 편집 상자는 일치합니다. Pro는 이전 값을 유지하지만 해당 상한을 접속에 사용하지 않습니다. 확인되어 종료된 자식 프로세스가 임대(lease)를 정리할 때, 바쁜 잠금(busy lock)은 최대 3회까지 짧게 재시도하며 새로운 실행 및 여전히 활성인 자식 프로세스를 보호합니다. 본 버전에서는 공유 상태 잠금 경쟁과 실제 점유를 더욱 구분하고, 대기 및 재시도는 원래의 기간 및 취소 신호를 준수하며, 시간 초과는 나중에 다시 시도할 수 있다는 알림을 제공합니다. 전송된 응답은 자동으로 재전송되지 않습니다. CLIProxyAPI는 8.0.38로 업데이트되었으며, 다중 라인 스트리밍 응답 파싱 및 연결 종료 분류를 유지하고, 동시 냉각 보호 및 도구 호출 호환성 수정이 추가되었습니다. 과거에 “반드시 재시작해야 복구 가능”했던 오류의 근본 원인은 여전히 완전히 확인되지 않았으므로, 이번 수정을 영구적인 안정 보장으로 작성할 수 없습니다.
선택적 자동 복구: 기본적으로 비활성화되어 있습니다. 활성화하면 식별된 내부 오류에 대해서만 원래 실행 상태를 확인하고, 현재 보유한 이전 인스턴스를 정리한 후 고정 포트 및 연결 구성을 따라 복구합니다. 10분 이내 최대 3회까지 시도할 수 있습니다. 수동으로 중지하거나 종료하면 복구가 취소되며 이미 전송된 모델 요청은 재전송되지 않습니다. 중지 및 정리는 백그라운드에서 시간 제한적으로 실행됩니다. 두 번의 확인을 거쳐 “강제 종료”를 시작하면 5초 강제 종료 안전장치가 작동하며, 시스템 스케줄링에 약간의 지연이 있을 수 있습니다.
본 버전에서는 Plus 계정의 통합된 5시간 사용 상한을 제공하여 일괄 적용 후 개별 계정 조정이 가능합니다. 100% 미만일 때 상한에 도달하면 새 요청은 중지되지만, 이미 응답 중인 것은 계속 완료됩니다. 100%는 기존 포인트 연속 규칙을 따르며, Pro 규칙은 유지됩니다.
<a id="accounts"></a>
04 · Codex 계정: 할당량, 재설정 카드 및 작업 점유
기능: 계정 섹션은 여러 개의 Codex 신원을 한 페이지에 배치하며, 5시간/7일 할당량, 재설정 시간, 포인트, 재설정 카드, 최근 만료 시간 및 작업 점유량을 표시합니다. 카드는 빠른 탐색에 적합하고, 목록은 줄 단위 조정에 적합합니다. 새로고침, 정렬, 메모, 초대 및 독립적인 CLI 진입점 기능이 유지됩니다.
사용법: 계정 섹션의 “카드/목록”을 클릭하여 전환합니다. 새로고침을 클릭하여 최신 스냅샷을 읽습니다. 계정 카드 내 정보, 설정 또는 더 보기 버튼을 클릭하여 동작을 확인합니다. 참여, 스케줄링, 우선순위 및 마지막 사용 등의 진입점은 기존 기능에 따라 각각 저장되며, 프록시 참여와 우선순위는 프록시 패널과 동기화되어 이후의 새 요청에 사용됩니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/accounts.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/accounts.png" width="1000" alt="Codex 계정 카드: 5시간 및 7일 할당량, 재설정 시간, 포인트 및 작업 진입점."></a>
</p>
본 버전에서는 Codex 전용 목록의 “프록시/스케줄링”과 “우선순위/마지막 사용” 그룹을 배열했으며, 폭이 좁은 창에서는 전체 그룹이 줄 바꿈됩니다. 카드 모드, 기존 토글 및 저장 동작은 유지됩니다.
<a id="claude"></a>
05 · Claude 구독: 공식 로그인, 저장 및 전환
이 기능은 무엇을 하는가: Claude 섹션은 Claude Code 구독 상태, 할당량 새로고침 및 수동 전환 관리에 사용됩니다. 5시간, 7일, 그리고 공식적으로 반환된 독립 모델별 할당량을 분리하여 표시하며, 누락된 할당량은 '알 수 없음'으로 유지합니다.
사용 방법: 먼저 공식 Claude Code CLI에서 로그인한 후, AiGoodBro에서 상태를 확인하고 “현재 로그인 계정 추가/구독 저장”을 클릭합니다. 기존의 Claude-swap 구독은 연결할 수 있습니다. 다른 계정을 추가하려면, 먼저 현재 구독을 저장한 다음, 공식 CLI로 돌아가 다른 계정에 로그인한 후 추가해야 합니다. /logout을 먼저 실행하지 마십시오. 그렇지 않으면 이미 저장된 자격 증명이 무효화될 수 있습니다. 저장 후에는 할당량을 수동으로 전환하고 새로고침할 수 있습니다.
활성 상태이거나 상태를 알 수 없는 구독은 연결 해제할 수 없으며, 만료 목표는 사용자가 명시적으로 전환할 때만 Claude-swap 프로세스에 따라 갱신됩니다. 본 버전은 Claude-swap 0.27.1의 설정 경로 규칙을 따릅니다: 빈 이전 설정이 현재 설정을 가리지 않게 되었으며, 저장 및 전환 시 동일한 파일과 상태를 확인하고, 실패 복구는 이번 세션에서 보유한 쓰기 작업만 처리합니다.
<a id="usage"></a>
06 · 토큰 모니터 (Token Monitor): 사용량, 히트맵, 추세 및 TPM
이 기능은 무엇을 하는가: 내장된 Token Monitor는 토큰 사용량, 예상 비용, 활동 히트맵, 추세, 모델, 프로젝트 및 세션을 한 곳에서 집중적으로 확인하는 데 사용됩니다. 상위 레벨에서는 35개 이상의 도구의 토큰 사용량 추적과 28개 이상의 제공업체의 할당량 감지를 지원합니다. 이는 상위 레벨의 지원 범위일 뿐이며, 본 기기의 모든 도구가 로그인되었거나 할당량을 읽을 수 있다는 것을 의미하지는 않습니다.
사용 방법: 메인 페이지에서 “사용량 통계”를 펼쳐 총량, 비용, 히트맵 및 추세를 확인합니다. 사이드바 또는 메뉴바의 통계 진입점에서 더 세부적인 도구, 모델, 프로젝트, 세션 및 할당량 뷰를 열고 시간 범위나 데이터 소스를 선택할 수 있습니다. 본 버전은 Token Monitor 0.68.0 인터페이스와 기존 설정을 유지하며, 0.70의 로그 읽기 및 과금 수정 기능과 0.71의 아카이브 백엔드 인계, 읽기 실패 시 전체 통계 보존 및 메뉴바 플로팅 창 종료 수정 기능을 선택적으로 되돌렸습니다. 0.71로 완전히 업그레이드된 것은 아닙니다. TokScale은 4.18.0 기준선을 유지하며 고정 수정 스캐너를 사용합니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/usage.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/usage.png" width="1000" alt="사용량 통계: 활동 히트맵, 예상 비용 및 추세 막대 그래프."></a>
</p>
상단, 플로팅 창 하단, 사이드바에서 공통으로 캐싱되는 TPM(분당 토큰 소비량)은 표시 속도를 위해 과도하게 자주 새로고침되지 않습니다.
<a id="other-cli"></a>
07 · 기타 CLI: 연결 상태와 할당량 분리 확인
이 기능은 무엇을 하는가: 이 그룹의 진입점들은 이미 연결된 Kimi, Grok, OpenCode, WorkBuddy, ZCode 및 TRAE SOLO를 한 곳에 모아 보여줍니다. 이를 통해 “로그인 여부”와 “할당량 실제 읽기 여부”는 별개의 문제임을 알 수 있습니다. 상위 레벨의 지원 개수가 본 기기가 실제로 연결된 개수와 같지는 않습니다.
사용 방법: “사용 안내” 또는 도구 진입점에서 해당 제품을 선택하고, 그 제품의 공식 로그인 방식으로 로그인을 완료한 다음, AiGoodBro로 돌아가 할당량을 새로고침합니다. Kimi CLI의 이전 스냅샷을 사용하려면 먼저 새로고침해야 합니다. Grok은 공식 grok login --oauth를 사용하고, OpenCode는 opencode auth login을 사용합니다. WorkBuddy, ZCode 및 TRAE SOLO는 각자의 공식 데스크톱 또는 CLI 진입점만 사용합니다. 알 수 없거나 만료되었거나 신뢰할 수 있는 반환값이 없는 경우, 인터페이스에는 “—” 또는 이전 스냅샷이 유지되며, 종료 코드를 할당량 성공으로 간주하지 않습니다.
본 기기의 인증 설정 발견, 할당량 읽기 및 후속 모델 호출은 각각 별도로 확인됩니다. 상세 경계는 본 기기 CLI 할당량 범위를 참조하십시오.
<a id="reset-cards"></a>
08 · 리셋 카드 자동 사용: 만료 직전 깜빡하는 것을 줄임
이 기능은 무엇을 하는가: 계정 옆에는 가장 최근 리셋 카드의 만료일만 표시되며, 마우스를 올리면 모든 알려진 만료일을 확인할 수 있어 카드 행의 증가를 방지합니다. 만료 임박 자동 사용 기능은 “카드가 만료된 후에야 기억해내는” 낭비를 줄이는 데 사용되며, 진입점을 열었다고 해서 자동으로 카드를 차감하지 않습니다.
사용 방법: 메인 페이지 또는 Codex 계정 영역에서 “리셋 카드 N”, 만료일 또는 정보 버튼을 클릭하여 “만료 자동 사용”으로 들어갑니다. 계정별로 활성화 여부를 선택하고 사전 시간을 설정합니다. 기본값은 비활성화이며, 기본 사전 시간은 30분입니다. 이는 1~1440분까지 조정 가능합니다. 데스크톱 계정이나 동일한 상태의 미러는 독립적인 진입점, 신뢰할 수 있는 상태, 그리고 유휴 상태가 모두 확인된 경우에만 시도됩니다. 결과가 불명확하면 일시 중지되고 수동 확인을 요청하며, 반복적으로 재전송되지 않습니다.
사용 전에는 계정별로 개별 승인이 필요하며, 애플리케이션을 실행 상태로 유지해야 합니다. 설정 페이지 자체에서는 카드를 교환할 수 없습니다. 본 버전은 검증된 사용 횟수의 증가 및 감소를 기록하며, 만료일이 24시간 이내로 접근하는 카드에 대해서는 사용자가 이미 활성화한 메시지 채널 알림을 계속 적용합니다. 최초 동기화 시 과거 변경 사항은 보충되지 않습니다. 알림 기능은 카드를 교환하지 않으며, 전송 결과가 불확실할 경우 재전송이 일시 중단됩니다. 상세 경계는 재설정 카드 설명을 참조하십시오.
<a id="referrals"></a>
09 · 친구 초대: 초대 및 포인트 통합 확인
기능: 계정 카드는 초대를 위한 진입점(entry point)을 유지하여, 여러 명의 사람을 일괄적으로 초대하고 공식적인 초대 상태와 포인트를 한 곳에서 확인할 수 있어 다른 페이지로 전환할 필요가 없습니다.
사용 방법: 목표 계정의 초대 버튼이나 작은 아이콘을 클릭한 후, 공식 페이지에 따라 수신자 작성 및 확인을 완료하고 새로고침하여 상태를 확인합니다. 한 번에 최대 5개의 주소까지 가능하며, 계정 또는 로그인 상태가 변경되면 초대 창을 닫았다가 다시 여는 것이 좋습니다. 보상은 공식 조건과 반환 결과에 따르며, 초대를 수락했다고 해서 포인트가 즉시 지급되는 것은 아닙니다.
<a id="wechat"></a>
10 · 위챗(WeChat): 크레딧 및 재설정 알림
기능: 개인 위챗은 크레딧, 재설정, 그리고 재설정 카드 메시지를 수신하는 데 사용되며, 사용자가 명확하게 활성화한 경우 지정된 Codex 원본 채팅을 계속할 수도 있습니다. 연결 상태와 메시지 실제 도달 여부는 분리하여 표시됩니다.
사용 방법: '설정 → 알림/위챗'으로 이동하여 연결 안내를 따라 텐센트 공식 iLink로 QR 코드를 스캔하여 바인딩합니다. 확인된 세션 후 수신할 메시지 유형을 선택합니다. 최초에 역사적 기준선(historical baseline)이 설정되며, 이후에는 새 메시지만 전송됩니다. 캐시 상태를 조회하는 것은 계정 크레딧을 소모하지 않습니다. 위챗의 세션이 완료되지 않은 경우 인터페이스는 대기 상태를 표시하며, '설정됨'으로 '도달함'을 표기하지 않습니다. 본 버전은 시작 시 알림 내용 조정 중단으로 인해 저장된 연결을 읽지 못하는 문제를 수정했으며, 전체 작업 응답은 바이트 단위로 안전하게 분할됩니다. 업그레이드 후에도 위챗이나 Feishu는 macOS 키체인(Keychain) 승인이 필요할 수 있으며, 승인 자체만으로는 테스트 메시지가 전송되지 않습니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/notifications.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/notifications.png" width="1000" alt="Feishu 카드와 WeChat 메시지: 재설정 카드, 크레딧 업데이트 및 공지 알림."></a>
</p>
<a id="feishu"></a>
11 · Feishu(飞书): 선택적 메시지 전달
기능: Feishu는 Agent, 계정 메모, 크레딧, 재설정 날짜, 재설정 카드 만료 상세 내역 및 공식 잔액 등의 메시지를 수신하는 데 사용됩니다. 기본적으로 간결하게 유지되어 긴 작업 번호를 카드 본문에 넣지 않습니다.
사용 방법: 알림 안내에서 봇 주소를 붙여넣고 '저장 및 연결'을 클릭합니다. 이미 연결된 경우 키체인 승인이 필요할 때 '연결 승인'을 클릭하십시오. Webhook은 macOS Keychain에 저장되며, 인터페이스나 로그에 다시 채워지지 않습니다. 실제 테스트 전송은 사용자가 명확하게 클릭해야 합니다. 본 기기의 승인 상태와 메시지 실제 도달 여부는 각각 확인해야 합니다.
Feishu 카드와 WeChat 메시지의 이미지는 위챗 섹션을 참조하십시오.
<a id="dock"></a>
12 · 사이드바 및 상태 플로팅 창: 언제든 확인
기능: 화면 가장자리의 사이드바는 선택된 계정의 크레딧, 재설정 카운트다운, Token 통계, 프록시(反代) 상태 등을 빠르게 확인할 수 있습니다. 플로팅 창을 펼치면 계정 목록, 5시간/7일 원형 그래프 및 포인트를 볼 수 있습니다. 기존 스냅샷을 재활용하므로 애니메이션을 위해 지속적으로 폴링하지 않습니다.
사용 방법: 기본적으로 ⌘I를 사용하여 호출하거나 숨길 수 있습니다. 사이드바 상단의 핀 아이콘으로 고정할 수 있으며, 다시 클릭하여 숨깁니다. 마우스를 올리면 상세 정보가 펼쳐지고, 상단을 드래그하여 위치를 조정할 수 있습니다. 설정에서 원형 그래프 또는 작은 물고기 스타일, 75–150% 확대/축소 비율, 새로고침 버튼, 실행 표시 및 터치패드 가벼운 접촉 피드백을 선택할 수 있습니다. 크레딧이 부족하면 '—'를 표시하며, 0으로 계산하지 않습니다.
<p align="center">
<a href="docs/images/1012v1-promo/zh/sidebar.png"><img src="https://raw.githubusercontent.com/BLACKIELF/AgentHub-AiGoodBro/HEAD/docs/images/1012v1-promo/zh/sidebar.png" width="1000" alt="화면 가장자리 사이드바: 금일 사용량, 5시간 및 7일 크레딧 원형 그래프."></a>
</p>
<a id="tasks"></a>
13 · 작업 점유, 스케줄링 및 계정 워밍업: 상호 간 계정 충돌 방지
기능: 작업 점유는 준비, 실행, 유지보수, 대기 검수 상태를 로컬 기록에 작성하여, 계정 페이지와 스케줄러가 어떤 계정이 사용 중인지 알 수 있게 합니다. 스케줄링 참여 시간대, 우선순위 및 워밍업은 이미 존재하는 자동화 기능이며, 모든 계정을 새로운 작업에 자동으로 할당한다는 의미는 아닙니다.
사용 방법: 계정 자동화 또는 설정에서 '잔여 1% 자동 일시 중지 및 번호 변경' 또는 '번호 변경 성공 후 원본 작업 자동 계속'을 활성화합니다. 소프트웨어는 먼저 작업을 저장하고 라운드를 확인한 다음, 예비 계정과 작업 상태를 검증한 후 전환합니다. 워밍업(Warm-up) 계정은 한도 창 만료 후 먼저 새로 고침된 다음 조건에 따라 요청하며, 바쁘거나, 한도가 낮거나, 결과가 불분명할 경우 대기하거나 일시 중지됩니다. 신뢰할 수 있는 작업 상태가 없을 때는 닫힌 상태를 유지하고 성공 알림을 생성하지 않습니다.
<a id="setup"></a>
14 · 도구 연결, 설치 가이드 및 업데이트 알림
기능: 식별 가능한 새 설치 또는 덮어쓰기 설치에 대해 로그인, 알림 연결 및 새로운 기능 설정을 분리하여 안내하고, 신규 사용자/기존 사용자에게 질문합니다. 신규 사용자는 전체 기능을 확인하고, 기존 사용자는 WeChat, Feishu(飞书) 및 새로운 설정에 중점을 두고 기존 구성을 유지해야 합니다. 신규 설치로 확실하게 식별되지 않는 원위치 대체는 강제로 팝업을 반복하지 않습니다. 수동 Claude 안내는 설치 가이드의 진행 상황을 덮어쓰지 않습니다.
사용 방법: '사용 가이드'를 열고 단계별로 공식 도구를 연결합니다. Claude, Kimi, Grok, OpenCode, WorkBuddy, ZCode 및 TRAE SOLO 모두 각자의 공식 진입점을 통해 로그인해야 합니다. 업데이트 팝업은 버전을 표시하고 업데이트 포인트를 보여주며, 사용자가 클릭하면 다운로드하고 크기 및 SHA256을 검증한 후 직접 덮어쓰기 설치를 진행합니다. 다운로드가 자동으로 종료되거나 현재 앱을 대체하지 않으며, 선택적 기능을 자동으로 활성화하지도 않습니다.
최초 설치 기본값: 시스템 테마, 계정 카드, 사이드바 자동 숨김, 메뉴 바에 잔여 한도 및 카운트다운 표시, K-라인(K线) 전체 기록 표시, 유리 투명도 74% / 깊이 84%, 메인 창 ⌘U, 사이드바 ⌘I를 따릅니다. 신규 사용자는 여전히 가이드로 진입하며, 기존 사용자의 모든 기존 설정은 유지됩니다. 일반적인 인터페이스 기본 설정만 정리할 뿐, 계정, 자격 증명, 개인 경로, 엔드포인트 또는 권한을 포함하지 않습니다. 알림 전송 및 리셋 카드의 자동 사용은 여전히 사용자 선택과 승인이 필요합니다. 자세한 내용은 최초 설치 환경설정을 참조하십시오.
선택된 구역(精选区)에는 REA, JEV 등 필요에 따른 설치 진입점이 유지되며, 식별 가능한 새 설치 또는 덮어쓰기 후 본래의 설치 상태를 읽기 전용으로 한 번만 확인합니다. 항목별로 숨기거나 수동으로 재확인할 수 있습니다. 탐지(Detection)가 도구가 연결되었다는 것을 의미하지 않으며, 사용자의 설치나 호출을 대체하지도 않습니다. 소개 페이지에 구독 할인 진입점이 추가되며, 버전 제목은 실제 설치 정보를 읽습니다.
<a id="themes"></a>
15 · 테마 및 네이티브 글래스
기능: 외관 설정을 통해 다크 모드, 테마 색상, 유리 투명도 및 계층 구조를 통합 관리하여, 다양한 테마에서 문자가 흐릿하게 보이는 문제를 해결합니다. 시스템의 '투명도 감소'와 '대비 강화'가 우선 적용됩니다.
사용 방법: '설정 → 표시 및 아이콘'을 열고 테마, 언어 및 유리 농도를 선택합니다. 현재 아홉 가지 테마를 유지하고 있습니다: 기본 회색(默认灰), 액체 키캡(液态键帽), 청화백자(青花瓷), 몬트리 에스샤(蒙特雷曙霞), 천리강산(千里江山), 돈황 비천(敦煌飞天), 고궁 홍벽(故宫红墙), 자남 유광(紫蓝流光), WAICY 물결(WAICY 流彩). WAICY 테마는 색상 값만 사용하며, 브랜드 그래픽, 글꼴 또는 마스코트를 복사하지 않습니다.
<a id="downloads"></a>
16 · 다운로드, 업그레이드 및 빌드
macOS 패키지는 macOS 13+ 및 Apple Silicon ARM64용이며, 고정된 로컬 서명 신원을 사용하고 Apple 공증을 거치지 않았습니다. Windows x86_64는 MSI / NSIS EXE를 개별적으로 제공하며, 기능 범위는 Windows 설명을 참조하십시오. 기존 릴리스 및 설치 패키지는 유지됩니다. 9.6.x 구형 클라이언트는 여전히 수동으로 다운로드하여 덮어써야 합니다. 업그레이드를 준비할 때는 먼저 작업을 종료하고, 프록시를 중지하며, 정상적으로 종료한 후 이전 앱과 로컬 데이터를 백업해야 합니다. macOS 덮어쓰기 후 3.0.0 (161) / 1028v1을 확인하십시오.
빌드, 패키지 내용, 서명 및 검증 값은 이번 산출물에 대해 독립적으로 검증되며, 결과는 3.0.0 릴리스 노트와 GitHub Actions에서 확인할 수 있습니다. 이번 배포는 실행 중인 설치 버전을 대체하지 않습니다. 과거 프록시 단절의 근본적인 현장 원인, 장기간 실제 호출, 모든 로그인 및 알림 전달은 여전히 실기 검증을 거쳐야 하며, 구 버전 테스트로 이 패키지를 대체할 수 없습니다.
다음과 같이 이번 버전 태그로 빌드되었습니다:
git clone --branch v3.0.0 https://github.com/BLACKIELF/AgentHub-AiGoodBro.git AiGoodBro-3.0.0
cd AiGoodBro-3.0.0
make build
macOS 빌드는 Go 1.26+ 및 SHA256 검증이 완료된 Token Monitor 0.68.0 macOS 런타임을 필요로 합니다. 본 버전은 해당 인터페이스 기준선에서 특정 수정 사항을 되돌렸으며, Intel Mac 패키지는 제공하지 않습니다. Windows는 자체 Rust / Tauri / Node 빌드 프로세스를 사용하며, Windows 빌드 설명을 참조하십시오.
<a id="sources"></a>
17 · 소스 코드, 라이선스 및 문서
아래 표에는 실제로 재사용, 적응 또는 정적 연구를 참고한 프로젝트들이 나열되어 있습니다. 해당 라이선스와 저작권 고지 또한 저장소에 그대로 유지됩니다. 상위(upstream) 기능을 참조한다고 해서 상위의 테스트 케이스나 브랜드 자료가 AiGoodBro의 실제 기능으로 구현된다는 의미는 아닙니다.
문서 진입점: 상세 사용 설명 · 로컬 CLI 할당 범위 · 프록시 구현 및 검증 · 3.0.0 릴리스 노트 · 2.5.2 릴리스 노트 · 2.5.1 릴리스 노트 · 2.5.0 릴리스 노트 · 이미지 출처 및 검증 · 문제 피드백 · 보안 설명
<a id="actual-screenshots"></a>
18 · 실제 소프트웨어 스크린샷
