|

DeepSeek Chat Demo: 브라우저에서 API로 대화하는 정적 채팅 앱

별도 애플리케이션 서버 없이 브라우저에서 DeepSeek API에 직접 연결해 대화하는 정적 웹 앱이에요. 채팅 화면과 기록 관리는 로컬에서 처리하지만, 답변 생성·검색·파일 처리·음성 기능에는 외부 API와 본인 API 키가 필요해요.

주요 기능

  • 여러 대화를 만들고 제목을 자동 생성하거나 이름을 바꿀 수 있어요. 질문 수정, 답변 재생성, 메시지 분기 전환과 생성 중단을 제공해요.
  • 스트리밍 답변, 깊이 생각하기, 웹 검색·링크 읽기와 출처 표시를 지원하도록 구현되어 있어요. 실제 동작에는 연결한 API 서비스의 해당 기능 지원이 필요해요.
  • 파일을 선택하거나 붙여 넣기·끌어 놓기로 첨부하고, 마이크 음성 입력과 답변 읽어주기를 사용할 수 있어요. 파일 선택 후 전송 대기 단계에서도 업로드가 시작될 수 있어요.
  • Markdown, 코드 구문 강조, KaTeX 수식과 Mermaid 다이어그램을 표시해요. 프로그램이나 코드를 실행하는 도구는 아니에요.
  • 영어·중국어 간체 UI, 밝은 화면·어두운 화면, 모바일 배치와 위치 설정을 제공해요. 확인한 번역 파일에는 한국어 UI가 없어요.
  • 대화 기록을 ZIP으로 내보내거나 가져올 수 있어요. 가져오기는 병합이 아니라 검증 후 전체 로컬 기록을 교체하는 방식이에요.

구조

React 18·TypeScript 프런트엔드에 Zustand 상태 관리, idb 기반 IndexedDB 저장, Markdown·수식·다이어그램 렌더링 모듈을 결합했어요. Rspack 2가 정적 dist 파일을 만들고, 기본 API 주소는 빌드 설정의 https://api.deepseek.com이에요. 채팅은 기본 모델 deepseek-flash를 사용하며 /anthropic/v1/messages의 SSE 응답을 읽어요. 첨부파일은 /anthropic/v1/files, 음성 인식·합성은 /v1/tools/asr 및 /v1/tools/tts로 요청해요. 자체 서버나 로컬 모델 가중치를 포함한 추론 엔진은 아니에요.

누구에게 쓸모 있나요

본인 DeepSeek API 키로 간단한 채팅 화면을 사용하거나 정적 프런트엔드의 API 연결·대화 분기·로컬 저장 구조를 살펴보려는 사용자와 개발자에게 적합해요. 여러 사용자의 계정·권한·과금을 관리하는 완성형 조직용 서비스로 보기는 어려워요.

설치 전 준비

  • 완성된 정적 배포본을 사용할 때와 소스에서 개발할 때의 준비물이 달라요. README는 배포 ZIP의 index.html을 여는 경로를 안내하지만, 소스 개발에는 Node.js 22.12 이상과 pnpm이 필요해요.
  • 사용 가능한 본인 DeepSeek API 키, API 접근 권한·잔액과 네트워크 연결이 필요해요. Settings에서 키를 저장하기 전 GET /models로 유효성을 검사하는 코드가 있어요. 이 조사에서 키 입력이나 검증 요청을 실행하지 않았어요.
  • IndexedDB·localStorage·스트리밍 응답을 사용할 수 있는 브라우저가 필요해요. 빌드 대상에는 Chrome 105+, Edge 105+, Safari 16+, Firefox 110+가 명시돼 있지만, 이는 설정값이며 기기별 실제 호환성 검증 결과는 아니에요.
  • file://로 직접 열려면 브라우저의 파일 페이지 저장소 지원과 API 서비스의 교차 출처 요청 허용이 필요해요. 마이크 기능은 브라우저 권한과 실행 환경에 따라 제한될 수 있어요.
  • 다른 API 주소로 바꾸려면 빌드 설정의 createConfig를 수정해야 해요. Messages·Files·음성·검색·링크 읽기 확장을 사용하는 구조라서 일반적인 OpenAI 호환 주소만 넣으면 모든 기능이 동작한다고 보장할 수 없어요.
  • 최신 데스크톱·모바일 브라우저의 정적 웹 앱
  • 개발: Node.js 22.12+와 pnpm, 기본 개발 주소 http://localhost:8090
  • 배포: 정적 웹 서버 또는 조건부 file:// 실행 · OS별 실제 실행은 미검증

설치 방법

배포본을 사용하는 경로

공식 저장소의 Releases에서 배포 ZIP과 버전을 확인하고 압축을 푼 뒤 index.html을 여는 방식이 README에 안내돼 있어요. 현재 확인한 공개 릴리스는 v0.1.1이에요. 파일 직접 실행은 저장소·CORS 조건을 충족해야 하며, 이 조사에서는 배포 ZIP을 설치하거나 실행하지 않았어요.

공식 자료 확인

소스에서 개발하는 경로

Node.js와 pnpm을 준비한 뒤 공식 소스를 복제하고 의존성을 설치해 개발 서버를 여는 문서상 절차예요. frozen-lockfile 옵션은 공식 CI에서도 사용하는 잠금 파일 고정 설치 방식이에요. 아래 명령은 사용 안내이며 이번 조사에서 의존성 설치나 개발 서버 실행은 하지 않았어요.

git clone https://github.com/deepseek-ai/chat-demo.git
cd chat-demo
pnpm install --frozen-lockfile
pnpm dev

공식 자료 확인

정적 파일로 빌드하기

빌드 결과는 dist에 생성되며 정적 서버로 제공할 수 있어요. package.json의 빌드 명령은 rm -rf와 NODE_ENV=production 형태의 셸 문법을 사용하므로 Windows 기본 셸에서의 호환성은 별도 확인이 필요해요. API 주소를 변경했다면 다시 빌드해야 해요.

pnpm build

공식 자료 확인

사용 방법

  • 공식 온라인 데모 또는 본인이 신뢰하는 배포 화면을 열고 Settings에 본인 API 키를 입력해요. 공유 PC에서는 키가 브라우저에 남는다는 점을 먼저 확인해요.
  • 새 대화에서 질문을 입력하고 필요할 때 생각하기·검색 옵션을 선택해요. 답변을 재생성하거나 질문을 수정하면 메시지 분기를 전환할 수 있어요. 대화는 브라우저 프로필과 사이트 출처별로 분리돼요.
  • 첨부할 자료는 전송 권한을 확인하고 선택해요. 클라이언트에는 파일 수 50개, 일반 파일 64 MiB, user_data 유형 32 MiB 검사값이 있지만, 최종 허용 형식·용량·계정 할당량은 서버 검증에 따라 달라질 수 있어요.
  • 음성 입력은 마이크 권한과 API 음성 인식을 사용하고, 답변 읽어주기도 API 음성 합성을 이용해요. 브라우저 안에서만 처리되는 오프라인 음성 기능으로 해석하면 안 돼요.
  • 기록을 옮기기 전 Settings의 ZIP 내보내기 범위를 확인해요. 대화와 로컬에 남아 있는 이미지 원본은 포함하지만 API 키·설정·비이미지 첨부 원본은 포함하지 않아요. 가져오기는 확인과 검증 후 기존 대화·첨부를 교체해요.
  • 모든 대화 삭제는 로컬 대화·첨부·미전송 초안을 지우며 API 키와 설정은 남겨요. API 서비스에 이미 업로드된 파일은 별도 삭제 대상이에요.

비용과 API 키

앱 코드는 MIT로 사용할 수 있지만 API 이용이 무료라는 뜻은 아니에요. 공식 요금 문서는 모델 입력·출력 토큰과 검색·웹 읽기, 문서 파싱·OCR, 음성 인식·합성을 별도 과금 항목으로 안내해요. 사용 전 본인 계정의 모델 접근 권한·잔액·현재 요금을 확인해야 해요. 정적 서버를 운영한다면 호스팅 비용도 별도예요. 이번 조사에서는 API 호출·충전·결제나 실제 사용료 측정을 하지 않았어요.

라이선스

루트 LICENSE는 MIT이며 저작권 표기는 2026 DeepSeek예요. 배포 시 저작권·허가 고지를 유지해야 하며, 빌드 설정도 dist/LICENSE로 라이선스를 복사해요. 외부 의존성의 라이선스와 DeepSeek API 서비스 약관·데이터 처리 조건은 별도예요.

주의사항과 알려진 이슈

  • API 키를 localStorage에 저장해요. 암호화된 비밀 보관함으로 설명할 수 없으며 같은 출처에서 실행되는 스크립트나 브라우저 환경의 영향을 받아요. 신뢰하지 않는 복제 사이트에 키를 입력하거나 공용 API 키를 배포 파일에 심지 않아야 해요.
  • 대화·파일·음성의 관련 내용은 구성된 외부 API 서비스로 전송돼요. 서버가 필요 없다는 설명은 애플리케이션 백엔드가 없다는 뜻이며, AI 처리가 오프라인이라는 뜻은 아니에요.
  • 기록은 브라우저 프로필·출처에 묶여 있어 도메인 변경이나 브라우저 데이터 삭제 시 접근 상태가 달라져요. ZIP 내보내기는 일부 정보와 비이미지 원본을 제외하므로 완전한 환경 백업으로 간주하면 안 돼요.
  • 기록 가져오기는 전체 교체이며 현재 형식만 지원해요. 문서는 구형 데이터베이스의 메시지 마이그레이션을 제공하지 않는다고 설명해요. 중요한 기록은 별도 사본을 유지하고 가져오기 범위를 확인해야 해요.
  • 로컬 채팅을 삭제해도 원격 파일과 API 키가 자동으로 함께 지워지지 않아요. 서비스 쪽 파일 보존·할당량 관리와 브라우저 키 삭제는 구분해야 해요.
  • 기본 모델과 API 확장에 대한 의존성이 있어 서버 정책·모델·요금·CORS가 바뀌면 일부 기능이 실패할 수 있어요. 소스에 오류 분류와 중단 처리가 있다고 해서 모든 네트워크·대용량 기록 상황이 검증됐다는 뜻은 아니에요.
  • Mermaid는 strict 보안 모드로 초기화하지만 Markdown·이미지·수식·링크 전체에 대한 독립 보안 감사는 수행하지 않았어요. 기기별 녹음·재생, 한글 응답 품질, 접근성·모바일 배치 역시 이번 조사에서 실행 검증하지 않았어요.

v0.1.1: 기록 가져오기 실패 안내 개선

2026-11-13 공개 릴리스가 가져오기 실패 안내 문구 수정을 기록하고 있어요. 확인한 소스 커밋과 package.json 버전은 v0.1.1에 대응해요. 가져오기 실패를 직접 재현하거나 수정 효과를 실행 검증하지 않았어요.

공개 이슈 목록 확인 범위

2026-11-16 조회에서 열린 이슈는 0건으로 표시됐어요. 이는 알려진 결함이 없거나 운영 안정성이 보장된다는 뜻은 아니에요.

확인 범위

확인 날짜: 2026-11-16

확인 커밋: 5d5dd754ebc1948e977ddb880a9eb5aa25f37b4c

확인한 범위: 공식 deepseek-ai/chat-demo의 main 커밋, README, package.json, Rspack·CI 설정, API 요청·로컬 설정·대화 저장·기록 가져오기와 내보내기·첨부·음성·Mermaid 관련 코드를 정적으로 읽었어요. LICENSE, v0.1.1 릴리스, 공개 이슈 목록과 공식 요금 문서도 확인했어요.

확인 한계: 소스 파일만 읽었으며 대상 앱의 의존성 설치·빌드·개발 서버·타입 검사·실행은 하지 않았어요. API 키 입력·모델 호출·계정 로그인·음성 녹음·파일 업로드·기록 교체·과금 테스트와 독립 보안 감사도 수행하지 않았어요. 설치·사용 단계는 문서와 코드상 절차이며 실제 기능 성공을 뜻하지 않아요.

출처

Similar Posts