Docbank, 사람과 AI 에이전트가 함께 쓰는 로컬 문서 금고

Docbank, 사람과 AI 에이전트가 함께 쓰는 로컬 문서 금고

AI 뉴스 썸네일

AI 에이전트가 문서를 읽고 고치는 일이 늘면 파일의 최신 위치만 알아서는 부족해요. 누가 어떤 내용을 바꿨는지, 이전 버전이 남아 있는지, 백업에서 같은 파일을 복원할 수 있는지도 확인해야 해요. Docbank는 이 문제를 로컬 우선 문서 기록 시스템으로 풀려는 오픈소스 프로젝트예요. 1

핵심 요약

구분	핵심	왜 볼 만한가요
문서 식별	문서를 경로가 아닌 Stable Node ID로 식별해요	이름을 바꾸거나 폴더를 옮겨도 같은 문서를 계속 가리킬 수 있어요
변경 이력	콘텐츠 버전을 SHA-256 다이제스트와 불변 버전으로 남겨요	자동화가 예전 상태를 덮어쓰려 할 때 충돌을 드러낼 수 있어요
복구	휴지통, 영구 삭제, 가비지 컬렉션, 저장 공간 회수를 나눠요	삭제와 실제 데이터 제거를 별도 단계로 다룰 수 있어요
연동	CLI, 웹, TUI, HTTP, OpenAPI가 같은 데몬 계약을 사용해요	사람용 화면과 프로그램용 인터페이스가 같은 문서 권한을 공유해요
한계	동기화·공유 서비스가 아니며 현재 알파 단계예요	중요한 자료는 별도 사본과 검증된 백업이 필요해요

1. 파일 경로 대신 문서 자체에 오래가는 ID를 붙여요

일반 파일 시스템에서는 경로가 문서의 주소 역할을 해요. 파일 이름을 바꾸거나 다른 폴더로 옮기면 기존 자동화가 문서를 놓칠 수 있어요. Docbank는 Stable Node ID를 써서 이동과 이름 변경 뒤에도 같은 문서를 식별해요. 폴더 구조는 사람이 익숙하게 탐색하는 화면으로 남기고, 장기 식별은 경로와 분리해요. 2

이 방식은 여러 도구가 한 문서를 번갈아 다룰 때 쓸모가 있어요. 사람은 웹 화면에서 문서를 옮기고, 프로그램은 이전에 받은 ID로 같은 문서를 다시 찾을 수 있어요. 경로 문자열을 저장한 스크립트가 폴더 개편 때 깨지는 문제도 줄일 수 있어요.

728x90

조용한 덮어쓰기 대신 충돌을 보여 줘요

Docbank는 콘텐츠 버전을 바꾸지 않는 형태로 보관하고 SHA-256 다이제스트로 식별해요. 변경 요청에는 리비전 조건을 걸 수 있어요. 자동화가 오래된 상태를 기준으로 저장하려 하면 새 내용을 조용히 덮지 않고 충돌로 처리해요. 여러 작업이 동시에 문서를 수정할 때 어느 변경이 먼저였는지 확인하기 쉬워져요. 3

버전 기록만 남기는 데서 끝나지 않아요. 이전 버전으로 되돌리기, 명시적인 버전 정리, 전체 저장소 검증도 제공해요. 변경 전후의 내용을 나중에 확인해야 하는 계약서, 영수증, 운영 기록처럼 이력이 중요한 문서에 맞는 구조예요.

삭제와 실제 데이터 제거를 구분해요

휴지통으로 보내는 일과 저장 장치에서 데이터를 없애는 일은 같지 않아요. Docbank는 복구 가능한 휴지통, 영구 삭제, 가비지 컬렉션, 압축 저장 공간 회수를 따로 다뤄요. 실수로 삭제했을 때 되돌릴 여지를 남기면서도, 더 이상 필요 없는 데이터는 관리자가 단계적으로 정리할 수 있어요.

백업도 복원 결과를 내놓기 전에 콘텐츠를 검증해요. 저장 위치가 바뀌어도 복원할 수 있도록 백업 구조와 물리 저장소를 분리해요. 로컬 파일 시스템뿐 아니라 S3 호환 저장소에도 콘텐츠를 둘 수 있어요. 다만 외부 저장소의 콘텐츠를 Docbank가 암호화해 주지는 않아요. 접근 제어와 저장소 암호화는 운영자가 따로 준비해야 해요. 4

왜 중요한가요

AI 에이전트에 파일 접근 권한을 줄 때는 검색 정확도만큼 변경 통제가 중요해요. Docbank의 안정적인 문서 ID, 리비전 조건, 불변 버전은 자동화가 어느 문서를 읽었고 어떤 상태를 기준으로 수정했는지 확인할 단서를 남겨요. 인증된 HTTP API와 구조화된 오류, 다이제스트 영수증도 프로그램이 변경 결과를 확인하는 데 도움을 줘요. 2

대신 Dropbox나 Google Drive를 대체하는 제품으로 보면 맞지 않아요. 여러 기기의 작업 폴더를 실시간으로 맞추거나 공개 공유 링크를 만드는 기능은 제공하지 않아요. 문서의 장기 식별, 변경 이력, 검증 가능한 복구에 초점을 둔 기록 시스템에 가까워요.

현재 저장소는 알파 소프트웨어라고 밝히고 있어요. 잃으면 안 되는 자료를 곧바로 한 곳에만 맡기기에는 이른 단계예요. 별도 사본을 유지하고, 백업을 만들었다면 실제 복원과 검증까지 해 본 뒤 사용 범위를 넓히는 편이 안전해요. 3

참고 자료

1. Docbank - 사람과 에이전트가 함께 쓰는 로컬 우선 문서 기록 시스템 — GeekNews
2. kenn-io/docbank — GitHub
3. Docbank README — GitHub
4. Docbank capability guide — Docbank