프로젝트 소개

DSH for Vaults는 DeepSeek Harness(DSH) 네이티브 Web UI를 Obsidian 내부에 내장하는 Obsidian 데스크톱 플러그인입니다. README에 따르면 각 보관소(vault)는 완전히 격리된 자체 DSH 인스턴스를 갖게 됩니다. 보관소를 열면 해당 보관소가 워크스페이스로 설정된 DSH가 시작되며, 세션 기록은 보관소별로 유지되어 서로 섞이지 않습니다. 이 플러그인은 DSH 구현체를 번들링하는 것이 아니라 런처 및 내장 클라이언트 역할을 합니다. README에 설명된 주요 기능은 다음과 같습니다: - 내장 웹뷰 UI: 실제 DSH 인터페이스가 전용 Electron 웹뷰에서 실행되며, 보관소별 영구 세션 저장소와 쿠키 안전 토큰 인증을 지원합니다. - 양방향 브리지: 선택한 텍스트를 우클릭하여 파일 및 행/열 범위가 포함된 로케이터 라인을 DSH 컴포저로 보낼 수 있으며, DSH 채팅에서 보관소 파일 경로를 클릭하면 Obsidian에서 해당 노트를 엽니다. 파일이 없는 경우 알림이 표시되며, 보관소 외부 및 바이너리 경로는 DSH의 기본 동작을 유지합니다. - 단축키 패스스루: 설정 토글을 통해 DSH 패널에 포커스가 있는 동안에도 구성된 Obsidian 단축키가 계속 작동하도록 할 수 있습니다. - 터미널 없는 부트스트랩: Node.js나 DSH가 없는 경우, 패널에서 전용 휴대용 런타임(약 30MB, 관리자 권한 불필요, 시스템 영향 없음)을 설치한 후 DSH 커널을 자동으로 다운로드하고 시작할 수 있습니다. 실시간 진행 상황과 npm 미러 폴백을 지원합니다. - DSH 인스턴스 간 모델 설정 동기화: 증분 모드는 충돌 시 누락된 항목과 프롬프트를 복사하며, 덮어쓰기 모드는 선택한 소스에 맞춰 제공자와 자격 증명 참조를 정렬하고 파일을 자동 백업합니다. 동기화 항목에는 LLM 제공자와 API 자격 증명 참조가 포함되며, 인스턴스별 로그인 기록, 기본 모델 경로, 검색 모델 및 플러그인 프로필은 동기화되지 않습니다. - 업데이트 정책: 공식 안정 채널을 추적하며 명시적인 확인 후에만 설치합니다. 시작 시 온라인으로 접속하여 버전을 변경하지 않습니다. - 데이터 마이그레이션: 이전 커널에서 업그레이드할 때 세션 데이터를 자동 마이그레이션하며, 설정 가능한 백업 디렉토리에 먼저 백업을 수행합니다. - 보관소별 격리: 데이터는 보관소 외부의 보관소 전용 로컬 디렉토리에 저장되며, README에 따라 OneDrive를 통해 동기화되지 않습니다. - 진단: 설정에서 프로브, Node 감지, 포트, 커널 및 UI 로드에 대한 단계별 부팅 타이밍과 에러 로그, 복사 가능한 로그를 확인할 수 있습니다. 타임아웃 시 오래된 프로세스 트리는 정리됩니다. 요구 사항: Windows의 Obsidian 데스크톱 v1.4 이상. 플러그인이 휴대용 런타임을 설치하거나 절대 경로로 기존 설치본을 감지할 수 있으므로 Node.js를 미리 설치할 필요는 없습니다. 설치: Obsidian 커뮤니티 플러그인에서 'DSH for Vaults' 검색, BRAT을 통해 moozhu/dsh-obsidian 저장소 이용, 또는 main.js, manifest.json, styles.css 파일을 보관소의 .obsidian/plugins/dsh-ob/ 폴더에 수동으로 넣고 플러그인을 활성화하여 설치할 수 있습니다. 사용법: 고래 아이콘이나 명령 팔레트에서 패널을 열고 시작될 때까지 기다린 후, 보관소를 활성 워크스페이스로 하여 채팅합니다. 상태 표시줄에 인스턴스 상태가 표시됩니다. 멀티 보관소 동작으로는 보관소별 결정적 포트 할당, 서로 다른 보관소에 대한 독립적 인스턴스, 두 창에서 동일한 보관소를 사용할 때의 공유 인스턴스, 별도 설정이 없는 한 창 닫을 때 인스턴스 종료 등이 있습니다. 하단 패딩은 0에서 40픽셀까지 조정 가능합니다. 개인정보 보호: README에 따르면 이 플러그인은 런처 및 내장 클라이언트이며, localhost(127.0.0.1)를 통해서만 DSH와 통신하고 텔레메트리나 릴레이가 없습니다. DSH 자체는 작업에 따라 모델 API와 같은 외부 요청을 보낼 수 있습니다. 세션 기록, 모델 설정 및 API 자격 증명은 보관소 전용 로컬 데이터 디렉토리에 저장됩니다. 설정 항목에는 실행 파일 경로, 버전 업데이트, 데이터 백업 디렉토리, 기본 포트, Obsidian 시작 시 자동 시작, 종료 시 중지, 단축키 패스스루, 리버스 브리지, 모델 설정 동기화, 패널 위치, 패널 하단 패딩, 부팅 타이밍 진단 등이 포함됩니다. 개발 명령어로는 npm install, TypeScript 감시를 위한 npm run dev, npm run typecheck, 그리고 esbuild를 통한 타입 체크 및 번들링을 위한 npm run build가 있습니다.