MeteorNOX/DeepSeek-Balance-Whale-Widget
DeepSeek Harness（DSH）一只住在 DSH 界面右下角的小鲸鱼娘，帮你盯着DeepSeek账户余额。QQ弹弹，支持拖拽吸附、左吸附翻转、数字滚动动画，随界面自动启用，建议直接喊来你的dsh安装
DeepSeek Balance Whale Widget 기능
이 저장소에는 DeepSeek 웹/데스크톱 클라이언트(DSH)용 플러그인이 포함되어 있습니다. 항상 화면에 표시되는 작은 "고래" 위젯을 추가하여 다음을 표시합니다:
- DeepSeek API 잔액 (60초마다 자동 새로고침, 부드러운 롤링 숫자 포함).
- 오늘의 지출 – 잔액 변화와 턴당 토큰 사용량에서 계산됩니다.
- 현재 턴의 비용 – 각 모델 응답 후 턴 비용 금액을 표시하는 버블이 팝업됩니다.
- 사용자 정의 가능한 버블 – 텍스트를 편집하고, 임의 문장, 이미지, GIF를 추가하거나 잔액/가격 정보를 표시할 수 있습니다.
- 피크/오프피크 가격 – 위젯은 DeepSeek의 "피크" 일정을 알고 적절한 가격을 표시할 수 있습니다.
- 예산/잔액 부족 알림 – 잔액이 임계값 아래로 떨어지거나 오늘의 지출이 한도를 초과할 때 팝업됩니다.
- 오디오 피드백 – 누르기/놓기 사운드, 턴 종료 사운드, 질문/승인을 위한 선택적 프롬프트.
- 드래그 앤 드롭 위치 지정 – 고래를 화면 가장자리에 스냅하거나, 미러링하거나, 자유롭게 배치할 수 있습니다.
작동 방식
- 데이터 소스 – 플러그인은 먼저 DSH 자격 증명 저장소에서
DEEPSEEK_API_KEY를 읽으려고 시도합니다. 키가 없으면 DSH가 내부적으로 쿼리할 수 있는 로그인된 DeepSeek 계정으로 폴백합니다. - 회계 코어 –
lib/accounting.mjs는 잔액 엔드포인트를 모니터링하고, 모든 증감을 기록하며, 원장을 유지합니다(90일 롤업, 최대 20,000개 항목). 또한 토큰 사용량(input,cache,output,reasoning)을 DeepSeek의 내장 가격 테이블(또는 모델별로 설정할 수 있는 사용자 정의 가격)을 사용하여 금전적 비용으로 변환합니다. - UI –
assets/whale-widget.js는 DSH UI의 오른쪽 하단 모서리에 고래와 버블을 그립니다. 모든 시각적 설정(크기, 색상, 글꼴, 미러링 등)은$DSH_HOME/.dshw-size.json에 저장됩니다. - 확장성 – 위젯에는 텍스트, 링크, 임의 문장, 이미지/GIF 또는
{balance},{cost},{quota}와 같은 내장 자리 표시자에서 버블 행을 구성할 수 있는 "모듈 라이브러리"가 포함되어 있습니다. 모듈은 저장하고 재사용할 수 있습니다. - 다중 공급업체 지원 – "사용자 정의 API" 패널을 통해 다른 공급업체(OpenRouter, Kimi, OpenAI 호환 게이트웨이 등)를 추가할 수 있습니다. 각 공급업체에는 자체 잔액/할당량 모듈이 있으며, DeepSeek와 함께 표시할 수 있습니다.
설치 경로
| 대상 | 브랜치 | 설치 명령 |
|---|---|---|
| DSH 웹 UI (오른쪽 하단 위젯) | main |
dsh plugin --profile web add dsh-whale-widget (npm) 또는 … add github:MeteorNOX/DeepSeek-Balance-Whale-Widget |
| DSH 데스크톱(Electron) 클라이언트 | main |
데스크톱 클라이언트가 직접 설치하도록 합니다: DSH 세션에서 *"把 dsh-whale-widget 裝上"*를 입력하거나 내장 플러그인 관리자를 사용합니다. |
| Codex 데스크톱 앱 (다른 코드 경로) | For-Codex |
%USERPROFILE%\plugins\api-balance-whale에 압축을 풀고 브랜치별 문서를 따릅니다. |
두 제품 라인 중 하나만 동시에 사용할 수 있습니다 – 완전히 독립적입니다.
구성 파일 ($DSH_HOME에 저장)
| 파일 | 용도 |
|---|---|
.dshw-size.json |
UI 크기, 스냅 포인트, 오디오 그룹 선택, 피크 가격 스타일 |
.dshw-usage.json |
잔액 관찰 원장, 턴당 비용, 알림 임계값, 오디오 설정 |
.dshw-bubble.json |
사용자 정의 버블 시퀀스 및 모듈 라이브러리 |
.dshw-api.json |
추가한 추가 공급업체 목록(엔드포인트 URL, JSON 경로, 선택적 토큰별 가격) |
.dshw-usage-archive.json |
이전 원장 데이터(턴별 90일, 일일 집계 365일) |
.dshw-codex.json |
Codex 모드 브랜치용 로컬 Codex 세션 로그 캐시 |
사용 시기
- 많은 DeepSeek 호출을 실행하고 지출 금액을 빠르게 시각적으로 확인하려는 경우.
- 잔액이 소진되기 전에 경고하는 예산 가드가 필요한 경우.
- 재미있는 "고래" UI를 좋아하고 버블 메시지를 사용자 정의하려는 경우(예: 임의 동기 부여 인용구, GIF 또는 일일 예산 알림).
- 여러 LLM 공급업체를 사용하고 각 공급업체의 남은 할당량을 표시할 수 있는 단일 위젯이 필요한 경우.
결론: 이 저장소는 DeepSeek 클라이언트를 귀엽고 고도로 사용자 정의 가능한 고래 위젯이 있는 작은 회계 대시보드로 바꾸는 완전한 기능을 갖춘 설치 가능한 DSH 플러그인입니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트