TabbitBlog

DeepSeek Harness 브라우저 플러그인 설치와 검증

dsh-tabbit을 설치하고 로컬 연결과 Tabbit 화면에 표시된 결과를 확인합니다.

이 글의 목차
  1. 설치 전에 버전 확인하기
  2. Web 프로필에 설치하기
  3. 브라우저 연결 경로 확인하기
  4. 화면 결과 하나 확인하기
  5. 실험에서 확인한 범위
  6. 권한과 런타임 문제 분리하기
  7. Feishu Base 행을 읽고 사람 검토 초안 만들기

DeepSeek Harness(DSH)는 dsh-tabbit을 통해 로컬 Tabbit을 제어할 수 있습니다. Web 프로필에 설치한 뒤 지원되는 안정 버전에서 연습 페이지를 엽니다. 이 글은 0.4.1의 네이티브 tabbit_browser 도구를 기준으로 갱신했습니다. 이전 글은 Skill을 중심으로 한 패키지를 다뤘습니다.

공식 README에 현재 적힌 요구사항은 안정판 Tabbit 1.9.0 이상, Node.js 22.19 이상, DSH 0.1.1-rc.2 이상입니다. 요구사항은 바뀔 수 있으므로 설치 전에 다시 확인하세요. 아래 DEMO-D09는 로컬 실습 페이지의 결과이며 Feishu Base 실측이 아닙니다.

설치 전에 버전 확인하기

공식 문서는 한 번 이상 실행한 Tabbit 안정 버전 1.9.0 이상을 요구합니다. 이 구성에서는 DSH와 브라우저를 같은 호스트에서 사용합니다. 설치할 DSH 패키지의 Node 요구 사항을 확인하고 문제 해결 시 네 버전을 기록합니다.

구성요소사전 점검
DeepSeek Harness 0.2.2-rc.1Node.js ≥ 24.9
dsh-tabbit 0.4.1Tabbit stable ≥ 1.9.0
Tabbit 1.21.21.0macOS

DeepSeek Harness · AI 브라우저 · 자동화 에이전트

Web 프로필에 설치하기

npm에서 배포하는 패키지를 사용합니다. 공식 저장소는 Tabbit-Browser/dsh-tabbit입니다. 이전 패키지에서 옮겼다면 프로필에서 dsh-tabbit을 확인하고 dsh web을 다시 실행합니다. 직접 올바른 브라우저에서 열 때는 --no-open을 사용합니다.

dsh --version
dsh plugin --profile web add dsh-tabbit
dsh web --no-open

dsh-tabbit · 에이전트용 브라우저 · 브라우저 에이전트

브라우저 연결 경로 확인하기

네이티브 tabbit_browser가 코드 요청을 로컬 Tabbit 런타임에 전달합니다. tabbit Skill은 사용법을 안내하고 tabbit_browser_install은 환경을 확인합니다. 브라우저 기반 web_fetch와 탭 참조도 포함됩니다. Web 화면, 페이지 읽기, 클릭 결과를 각각 확인합니다.

구성요소역할
DeepSeek Harness브라우저 요청
tabbit_browser브라우저 요청 → 로컬 실행
tabbit_browser_install사전 점검
Tabbit Runtime Service로컬 실행

브라우저 자동화 · 에이전트 브라우저 보안

이전 경로는 DSH에서 Skill과 tabbit-cli를 거쳐 로컬 런타임에 연결했습니다. 아래 표지는 당시 자료입니다.

이전 Skill 표지의 /tabbit-browser 표기

화면 결과 하나 확인하기

새 작업에서 연습 페이지를 열고 제목을 읽은 뒤 Show source details를 한 번 클릭합니다. 표시된 ID와 URL을 반환합니다. 예상 결과는 Source ID: DEMO-D09입니다. 로그인 요청이 나오거나 요소가 없으면 중지하고 상태를 기록합니다.

tabbit Skill을 사용해 환경을 먼저 점검합니다. 새 작업으로 연습 URL을 열고 제목과 주소를 반환합니다. Show source details를 한 번 누르고 표시된 ID를 읽습니다. 다른 페이지나 요소가 나오면 멈춥니다.

연습 페이지 열기 · AI 에이전트로 브라우저 제어 · 기존 브라우저 연결

실험에서 확인한 범위

격리된 Web 프로필에 dsh-tabbit 0.4.1을 설치하고 서비스를 시작했습니다. 별도 headless 프로필에서 DSH 0.2.2-rc.1, Node 24.16.0과 Tabbit 안정 버전 1.21.21.0을 사용했습니다. 로컬 모의 모델이 네이티브 도구 호출을 요청했고 실제 도구는 페이지를 열어 클릭한 뒤 DEMO-D09를 반환하고 작업을 끝냈습니다.

현재 DSH 연결 경로와 DEMO-D09가 표시된 Tabbit 화면

첫 브라우저 작업 체크리스트

권한과 런타임 문제 분리하기

페이지 권한 거부, 등록되지 않은 인스턴스, 접근할 수 없는 런타임을 구분합니다. 권한과 대상 브라우저를 확인합니다. 런타임에 연결되지 않으면 안정 버전을 실행한 적이 있는지, DSH와 같은 호스트인지 확인합니다. 진행 중인 작업을 중단해도 되는 경우에만 해당 브라우저를 다시 엽니다.

결과다음 점검
페이지 접근 거부 · pageAccess: never페이지 접근 정책 확인
미등록 인스턴스 · not registered대상 버전과 오래된 고정값 확인
런타임 접근 불가 · BROWSER_RUNTIME_UNAVAILABLE런처를 확인하고 안전할 때만 대상 버전 재시작

API나 확장만으로 클릭할 수 있는지 질문한 사용자와 브라우저 작업용 플러그인을 추가한 사용자가 있었습니다. 연결 도구마다 설치와 권한을 확인합니다. Reddit 1 · Reddit 2

Feishu Base 행을 읽고 사람 검토 초안 만들기

다음은 작업 패턴 예시입니다. 열람 권한이 있는 Base 행을 열고 화면에 보이는 레코드 ID와 상태만 읽게 하세요. 이어서 URL, ID, 상태, Human check 줄을 담은 Base record GEO-104 review 초안을 작성하게 합니다. 레코드를 수정하거나 제출하지 않습니다. GEO-104는 예시이며 실제 Feishu ID가 아닙니다. 저장된 레코드와 필드는 사람이 Base에서 확인해야 합니다.

tabbit Skill을 사용해 내가 지정한 Feishu Base 페이지를 여세요. 읽기 전용입니다. 최종 URL, 화면에 보이는 레코드 ID, 상태만 반환하세요. 값과 "Human check" 줄을 포함한 "Base record GEO-104 review" 초안을 작성하세요. Base 레코드를 수정하거나 제출하지 마세요. 작업 공간이나 페이지가 다르면 중지하세요.

시작 전 브라우저 에이전트 첫 작업 체크리스트를 확인하세요. 프로필과 작업 구분은 브라우저 프로필, 워크스페이스, 탭 그룹을 참고하세요.

자주 묻는 질문

DSH가 자체적으로 브라우저를 제어하나요?

호환 플러그인과 접근 가능한 런타임이 필요합니다. DSH Web은 에이전트 인터페이스입니다.

어떤 패키지를 설치하나요?

사용 중인 DSH 프로필에 dsh-tabbit을 설치합니다.

어떤 Tabbit 버전이 필요한가요?

문서는 안정 버전 1.9.0 이상을 요구합니다. 실험은 1.21.21.0에서 진행했습니다.

로그인한 브라우저 세션을 쓸 수 있나요?

승인된 프로필을 사용하며 기본값은 페이지 접근 시 승인 요청입니다.

원격 DSH가 데스크톱과 자동 연결되나요?

이 구성에는 DSH 호스트에서 접근 가능한 브라우저 런타임이 필요합니다.

첫 작업의 성공은 어떻게 확인하나요?

도구 결과의 제목과 화면 ID를 확인합니다. 권한과 런타임 오류는 따로 진단합니다.

다음 단계

Tabbit 과 함께 일하세요.

탭 간 조사를 하고, 반복적인 브라우저 작업을 자동화하며, 모든 맥락을 손이 닿는 곳에 두세요.