deepseek-bot: DeepSeek Harness용 에이전틱 메모리 게이트웨이
대화형 에이전트는 매번 처음부터 시작할까, 아니면 지난 대화를 기억한 채 Slack까지 이어질까? deepseek-bot은 DeepSeek Harness 위에 메모리와 게이트웨이만 가볍게 얹는다고 소개된다.
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: DeepSeek Harness 위에서 기억하는 에이전트 게이트웨이
✦ KR 핵심 요약: deepseek-bot은 DeepSeek Harness(dsh)의 플러그인으로, 항상 켜진 단일 에이전트가 대화 간 기억을 유지하도록 돕는다. 터미널과 Slack·Discord·Telegram을 같은 기억 위에서 쓰게 하고, 명령은 샌드박스에서 실행하며 파괴적 작업은 대화 내 yes 확인을 기다린다. 다만 라이선스 종류와 Grok 봇·헤르메스 에이전트와의 정량 비교는 제공 자료에서 확인되지 않는다.
🌐 Global Takeaway: deepseek-bot is an open-source plugin for DeepSeek Harness that adds agentic memory and a messenger gateway rather than replacing the harness. It keeps durable sessions, persona and user/work memory files, and a recall index across restarts, while exposing the agent through dsh, Slack, Discord, and Telegram. Safety is framed as sandboxed command execution with an explicit yes gate for destructive actions; license type and benchmark comparisons remain unverified in the provided sources.
아래 그림은 DeepSeek Harness 코어 위에 deepseek-bot 플러그인이 메모리와 메신저 경로를 얹는 구조를 보여준다.
🚨 1. 딥시크 하네스 위에 얹는 '메모리+게이트웨이'
딥시크 하네스를 그록봇이나 헤르메스 에이전트처럼 쓰고 싶다는 문제의식에서 출발한 프로젝트가 deepseek-bot이다. 저장소 설명은 'The agentic memory & gateway for DeepSeek Harness'로, 핵심은 하네스를 새로 만드는 것이 아니라 DeepSeek Harness 위에 에이전틱 메모리와 메시지 게이트웨이를 가볍게 얹는 데 있다. Threads 공유 글도 '딥시크 하네스 위에 에이전틱 메모리와 메신저 게이트웨이만 가볍게 두고'라고 범위를 좁힌다.
이 구조의 의미는 단순하다. DeepSeek Harness가 실행 기반이라면 deepseek-bot은 그 위에서 기억을 유지하고, 여러 접속면을 열어 주는 층이다. 공식 저장소에는 agent, recall, service, transports, tui, tools, watch 같은 디렉터리와 index.ts, injection.ts, netPolicy.ts, safeWrite.ts 같은 TypeScript 파일이 보이며, package.json과 pnpm-lock.yaml을 쓰는 Node/TypeScript 기반 프로젝트로 확인된다.
1-1. 프로젝트 정의와 범위
공식 명칭은 deepseek-bot이고, 대상은 DeepSeek Harness다. README 수집분은 'Install once, then just type dsh'라고 안내하며, dsh가 설치 후 진입 명령이다. 즉 사용자는 별도 대시보드나 클라우드 콘솔보다 터미널 명령에 가깝게 시작한다. 다만 모델 프로바이더와 메신저 옵션은 별도 설정 문서가 있다고만 명시되어 있어, 어떤 모델을 붙이는지는 이 글에 나오지 않는다.
'The agentic memory & gateway for DeepSeek Harness.'
이 한 줄이 프로젝트의 경계를 잘 보여준다. 메모리는 대화 내용만 저장하는 장부가 아니라, 페르소나·사용자 기록·작업 맥락·과거 대화 회상 인덱스를 묶은 에이전트 상태다. 반대로 게이트웨이는 Slack, Discord, Telegram 같은 외부 채널과 터미널 TUI를 같은 에이전트에 연결하는 통로다.
1-2. 확인된 설치 경로
설치 방법은 저장소가 제공하는 install.sh 스크립트 한 줄이다. 이후 실행 명령은 dsh다. 이 명령은 공식 README 수집분에 그대로 있는 것이므로, 다른 패키지명이나 설정 키를 임의로 만들지 않는다.
curl -fsSL https://raw.githubusercontent.com/rlaope/deepseek-bot/master/install.sh | bash
dsh
설치 후에는 'Messengers, the model provider and other options' 문서로 안내된다고 되어 있다. 따라서 Slack·Discord·Telegram을 쓰려면 최소한 채널별 설정이 필요하다고 보는 것이 안전하다. 제공 자료에는 각 메신저의 토큰이나 개인 설정 예시가 없으므로, 본문에도 인증 값을 쓰지 않는다.
🧠 2. 기억이 남는 구조: 세션, 파일, 회상 인덱스
이 프로젝트의 차별점으로 제시된 것은 'Memory that survives'다. 모든 대화가 재시작 후에도 살아 있는 durable session으로 저장되고, 페르소나와 사용자·작업 관련 기록이 USER.md, MEMORY.md, memory/ 디렉터리에 남는다. 여기에 과거 대화에 대한 recall index가 붙어, 단순 채팅 로그가 아니라 다음 대화에서 다시 끌어올릴 수 있는 기억 장치가 된다.
2-1. '기억'을 세 층으로 나눠 읽기
deepseek-bot의 기억은 한 덩어리가 아니다. 첫째는 실행 상태인 durable session으로, 프로세스가 꺼져도 대화가 끊기지 않게 한다. 둘째는 사람이 읽고 고칠 수 있는 파일 기반 기록으로, USER.md와 MEMORY.md가 사용자·작업 맥락을 담고 memory/가 세부 노트를 보관한다. 셋째는 recall index로, 과거 대화 전체를 매번 훑지 않고 관련 맥락을 다시 찾는 색인 역할을 한다.
이 설계가 실용적인 이유는 검증 가능성이다. MEMORY.md 같은 파일이 있으면 에이전트가 무엇을 '기억한다'고 주장하는지 일부라도 열어볼 수 있다. 반대로 recall index가 블랙박스라면 좋은 기억도 설명하기 어렵다. 다만 자료에는 recall index의 정확한 알고리즘, 보존 기간, 삭제 정책이 없으므로 '영구 완벽 기억'으로 과장하면 안 된다.
🛠️ 3. 실제로 할 수 있는 일: 문서·브라우저·이미지·MCP
README 수집분은 deepseek-bot이 docx, xlsx, pptx 파일을 작성하고, headless 브라우저로 링크를 읽고, 이미지를 보고, MCP 도구를 사용한다고 설명한다. 이 기능들은 메신저 게이트웨이와 결합될 때 의미가 커진다. Slack에서 요청한 리서치 결과를 문서로 만들고, Telegram으로 진행 상황을 보내는 식의 흐름을 상정할 수 있기 때문이다.
| 항목 | 자료에서 확인된 내용 | 해석 |
|---|---|---|
| 실행 측면 | 풀스크린 터미널 dsh, 답변 스트리밍, 도구 호출 diff 표시 | 대화형 코딩·업무 에이전트에 가까움 |
| 파일 산출 | docx, xlsx, pptx 작성 | 보고서·표·슬라이드 생성 가능 |
| 읽기 능력 | headless 브라우저로 링크 읽기, 이미지 분석 | 웹 페이지와 이미지를 입력으로 사용 |
| 확장 | MCP 도구 사용 | 외부 도구 생태계 연결 여지 |
| 안전 | 명령은 샌드박스, 파괴적 작업은 yes 확인 | 자동 실행과 승인 사이 균형을 둠 |
여기서 주의할 점은 기능 목록이 곧 품질 보장이 아니라는 것이다. 파일을 '작성할 수 있다'는 것과 실제 문서 품질이 안정적이라는 것은 다르다. headless 브라우저와 MCP는 강력하지만 동시에 외부 페이지·도구 신뢰 문제를 끌어오므로, 실사용에서는 접근 범위와 권한을 좁히는 설정이 중요해진다.
🔌 4. Slack·Discord·Telegram으로 이어지는 경로
Threads 글의 핵심 표현은 '메신저 게이트웨이'다. deepseek-bot은 터미널 밖으로 나가 Slack, Discord, Telegram을 지원한다고 README 수집분에 명시한다. 즉 같은 always-on 에이전트가 터미널 TUI와 여러 메신저를 오가며, durable session과 memory 파일을 공유하는 그림이다.
4-1. 왜 '게이트웨이'인가
게이트웨이라는 단어가 중요한 이유는 모델 자체가 아니라 접속면을 바꾼다는 점이다. DeepSeek Harness가 계산·실행 기반이라면, deepseek-bot은 Slack 스레드든 Telegram 채팅이든 같은 기억 위에 올려놓는 어댑터에 가깝다. 사용자는 앱을 여러 개 켜는 대신 메시지 채널에서 요청하고, 결과가 문서나 링크로 돌아오는 흐름을 기대할 수 있다.
다만 제공 자료에는 메신저별 설치 명령, 필수 환경 변수, 권한 범위가 없다. README가 'Messengers, the model provider and other options'를 별도 문서로 안내한다는 사실만 근거로 삼고, 실제 설정은 저장소 문서를 확인해야 한다.
🛡️ 5. 샌드박스와 'yes' 확인이 의미하는 것
에이전트가 메모리와 메신저를 가지면 위험도 커진다. deepseek-bot은 이를 두 장치로 다룬다고 설명한다. 첫째, 명령은 샌드박스에서 실행된다. 둘째, 파괴적인 작업은 무엇이든 대화 안에서 'yes'를 기다린다. 저장소 문구로는 'anything destructive waits for a yes in the conversation'이다.
이 구조는 완전한 자율성과 무인 실행을 표방하기보다, 자동화를 허용하되 위험한 경계에서 사람에게 되돌리는 방식이다. 특히 메신저 채널은 언제나 사람이 읽는 공간이므로, 봇이 파일을 지우거나 외부 상태를 바꾸는 작업을 조용히 실행하면 신뢰가 무너진다. yes 확인은 그 지점을 대화 안에 남긴다는 뜻이다.
그럼에도 '파괴적'의 정확한 판정 기준, 샌드박스의 격리 수준, 네트워크 정책 범위는 제공 자료에 없다. 저장소에 netPolicy.ts와 safeWrite.ts가 있다는 사실은 안전 관련 코드가 따로 설계됐음을 시사하지만, 그것만으로 충분한 보안을 주장할 수는 없다. 실사용 전에는 저장소의 문서와 코드, 실행 환경 권한을 직접 확인해야 한다.
📊 6. 저장소가 보여주는 성숙도와 한계
GitHub 수집분 기준으로 저장소는 master 브랜치에 423개의 커밋이 있고, CHANGELOG.md와 LICENSE 파일이 존재한다. 디렉터리 구성은 agent, recall, service, transports, tui, tools, watch, test, docs, profile 등으로 나뉘어 있어 단일 스크립트보다는 구조화된 TypeScript 프로젝트에 가깝다. 다만 구체적 라이선스 종류와 최근 변경 내용은 근거가 없어 확인 불가로 둔다.
| 근거 | 확인된 사실 | 아직 모르는 것 |
|---|---|---|
| 저장소 | 423 commits, master 브랜치, LICENSE 존재 | 라이선스 종류·조항 세부 |
| 설치 | install.sh 한 줄, 실행 명령 dsh | 플랫폼별 의존성·실패 조건 |
| 기억 | durable session, USER.md, MEMORY.md, memory/, recall index | 보존 기간·삭제·동기화 정책 |
| 접속면 | dsh, Slack, Discord, Telegram | 채널별 권한·설정 순서 |
| 비교 | 그록봇·헤르메스처럼 쓸 수 있다는 사용자 설명 | 기능·성능·안정성 정량 비교 |
이 표가 보여주듯 deepseek-bot은 '설치 한 줄'의 접근성과 '상시 에이전트의 기억'이라는 문제의식이 명확하다. 반면 가격, 벤치마크, 프로덕션 운영 사례, 라이선스 세부는 자료에 없다. 따라서 지금 단계에서는 실험적 도입과 코드 리뷰 중심으로 접근하는 편이 정확하다.
🎯 7. 누구에게 맞고, 누구에게는 이른가
맞는 경우는 DeepSeek Harness를 이미 쓰거나 써보려는 개발자다. 터미널에서 스트리밍 답변과 diff를 보며 일하고, 문서 파일과 웹 페이지를 다루며, Slack·Discord·Telegram을 업무 접점으로 쓰는 사람에게 deepseek-bot은 하네스를 대체하지 않고 기억과 게이트웨이만 보강한다. 특히 '대화가 끝나도 같은 맥락을 이어가고 싶다'는 요구가 핵심이면 USER.md·MEMORY.md·memory/ 같은 파일 기반 기록이 검토 포인트가 된다.
이른 경우도 있다. 안전 장치의 세부 기준이 불명확한 상태에서 파괴적 명령을 허용하기보다, 먼저 샌드박스 범위와 네트워크 정책을 읽어야 한다. 메신저를 붙이는 순간 외부 노출면이 생기므로 개인 실험과 팀 도입을 구분해야 한다. 또한 Grok 봇이나 헤르메스 에이전트와의 우열은 제공 자료가 없으므로, 기능 비교표를 만들려면 직접 설치해 같은 작업을 시켜 보는 것이 맞다.
✅ 8. 결론: 하네스는 빌리고, 차이는 메모리와 게이트웨이에서 갈린다
deepseek-bot의 가치는 '새로운 에이전트'가 아니라 'DeepSeek Harness 위에 기억과 접속면을 얹는 얇은 층'에 있다. 설치는 install.sh 한 줄과 dsh로 시작하고, 기억은 durable session·개인 메모리 파일·recall index로 구성되며, 접속면은 터미널과 Slack·Discord·Telegram으로 확장된다. 안전은 샌드박스 실행과 파괴적 작업의 yes 확인으로 설명되지만, 세부 정책은 별도 확인이 필요하다.
앞으로 이 프로젝트를 평가할 때 볼 질문은 세 가지다. 첫째, recall index가 과거 대화를 얼마나 정확히 되찾는가. 둘째, 메신저 게이트웨이가 각 채널의 권한을 어떻게 다루는가. 셋째, LICENSE와 보안 문서가 실제 운영 요구를 만족시키는가. 제공 자료만으로는 deepseek-bot이 검증된 대체재가 아니라, DeepSeek Harness 생태계에 기억을 붙이는 실험적 오픈소스 플러그인으로 보는 것이 타당하다.
자주 묻는 질문
Q. deepseek-bot은 DeepSeek Harness를 대체하는가?
A. 아니다. 저장소 설명상 DeepSeek Harness용 플러그인으로, 에이전틱 메모리와 메시지 게이트웨이를 얹는 역할이다. 하네스가 실행 기반이라면 deepseek-bot은 기억과 접속면을 보강하는 층에 가깝다.
Q. 설치는 어떻게 하나?
A. README 수집분 기준으로 install.sh 스크립트를 한 줄로 실행한 뒤 dsh 명령을 입력한다. 메신저와 모델 프로바이더 옵션은 별도 문서에서 안내된다고 되어 있어 채널을 쓰려면 추가 설정이 필요하다.
Q. 어떤 메신저를 지원하는가?
A. 터미널 풀스크린 TUI 외에 Slack, Discord, Telegram을 지원한다고 명시되어 있다. 다만 각 채널의 구체적 설정 절차와 권한 범위는 제공 자료에 없으므로 저장소 문서를 확인해야 한다.
Q. 안전 장치는 무엇인가?
A. 명령은 샌드박스에서 실행되고, 파괴적인 작업은 대화 안에서 yes 확인을 기다린다고 설명한다. 샌드박스 격리 수준과 파괴 판정 기준은 자료에 없어 실사용 전 코드와 문서 확인이 필요하다.



댓글 0개