// 빠른 시작
처음부터 첫 답까지.
요구 사항: Node.js 24 이상과 git 저장소. 읽을 이력이 있어야 합니다. smart-workbench 원장, 플러그인 자체 로그, 둘 다 가능합니다.
읽을 이력 만들기
smart-workbench를 설치해 결정 원장을 켜거나, /vhdb:on record로 플러그인이 직접 기록하게 합니다.
- >
/plugin install smartworkbench --marketplace nathak/smart-workbench - >
/swb ledger on
VHDB 플러그인 추가
엔진(engine/vhdb.wasm)이 들어 있어 따로 빌드할 필요가 없습니다.
- >
git clone https://github.com/nathak/vhdb-plugin ~/vhdb-plugin - >
claude --plugin-dir ~/vhdb-plugin
직접 검색하고, Claude에게 검색시키기
먼저 손으로 질의해 보고, 기록과 주입을 켭니다.
- >
/vhdb:search 토큰 갱신 kind:decision since:30d - >
/vhdb:on
팀 서버 띄우기
Ubuntu 22.04+ / Debian 12+. 기본 설정(auth = "off")은 계정 없이 루프백에서만 듭니다. 여럿이 쓰려면 먼저 Google 로그인을 설정하세요.
- >
sudo apt install ./vhdb-server_0.1.0-1_amd64.deb - >
curl -s http://127.0.0.1:7600/healthz # {"ok":true}
// 솔직한 한계
아직 하지 못하는 것.
- 플러그인은 로컬 WASM 엔진만 씁니다. 팀 서버나 데몬 연결, 원격 업로드(
POST /v1/ingest)는 구현되지 않았습니다. - 교차 프로젝트 검색이 없습니다. 토큰 하나가 프로젝트 하나만 닿는 규칙과 충돌해서 만들지 않았습니다.
- 의미 검색은 해시 기반 대역을 씁니다. 실제 임베딩 모델은 연결되어 있지 않습니다.
- 로그 구조라 개별 이력을 지울 수 없습니다. 유출이나 퇴사자가 생기면 디렉터리를 다시 만듭니다.
- 서버 로그인 세션은 메모리에만 있어서, 재시작하면 모두 로그아웃됩니다.
- 시간은 UTC로 표시합니다. 커밋 전 라인 단위 이력(편집 hunk)은 아직 기록하지 않습니다.
세션에 기억을 주세요.
MIT 라이선스. 소스는 GitHub에 있습니다.