nas-llm

LLM Wiki Knowledge Base — 구축 및 운영 계획

개요

Andrej Karpathy의 LLM Wiki 패턴과 nashsu/llm_wiki 데스크톱 앱, kepano/obsidian-skills 에이전트 스킬을 결합하여 회사 NAS 자료를 구조화된 지식 베이스로 자동 변환·유지하는 시스템.

핵심 원칙

• 사람: 무엇을 넣을지, 무엇을 물어볼지만 결정
• LLM: 요약, 교차참조, 백링크 갱신, 모순 표시 전부 수행
• 지식은 컴파일: 매번 재합성(RAG)이 아닌 사전 컴파일 + 점진 갱신

대상 시스템

항목	사양
PC	DESKTOP-AT1P1UD
CPU	Intel i5-10500 @ 3.10GHz (6C/12T)
RAM	16GB
스토리지	256GB NVMe SSD (C:) + 1TB HDD (D:)
GPU	Intel UHD 630 (내장)
OS	Windows 10 Pro 64bit
운영 모드	24시간 상시 가동

현재 상태

Phase 4 우선순위 압축 인제스트 — P0/P1 완료, P2 착수 대기 (2026-07-04 기준, 이슈 #18 참고)

앱 단일 큐 순차 인제스트(실측 일 65건, 전량 처리 시 ~1,070일)가 운영상 불가능하다고 판단되어(#17, CLOSED), 우선순위 압축(대표문서 추출) + Codex/Claude CLI 직접 스테이징 워크플로우(docs/10-PRIORITY-STAGING-TO-VAULT-WORKFLOW.md)로 전환했다. 앱 자체의 flat ingest 큐는 더 이상 대량 처리 경로로 사용하지 않는다.

산출물	상태
설계 문서 10종 (01~10)	✅ 완료
운영 스크립트 (ps1 27종 + 우선순위 파이프라인 js 20종)	✅ 완료
E2E 체크리스트 (TC-01~TC-12, 46항목)	✅ 완료
Phase 0~3: 환경/SW/vault/NAS 동기화	✅ 완료
우선순위 분류: P0 9,027 / P1 7,941 / P2 7,959 / P3 1,203 / P4 43,403 / P5 16	✅ 완료
P0: 대표문서 1,775/1,775 스테이징 → vault 발행(f36083933) → QA PASS	✅ 완료
P1: 대표문서 2,275/2,275 스테이징 → vault 발행(cc36f47fa) → QA PASS	✅ 완료
P2: 착수 절차 문서화 완료, 실행 대기 (#18)	⏳ 대기
P3	⏳ 대기 (P2 완료 후)
P4/P5 (대부분 중복/저가치)	처리 필요성 낮음, 별도 판단

앱 큐 워치독(#13/#15/#16) 버그는 모두 스크립트에 반영·검증 완료. 큐 처리 속도 자체(#14)는 튜닝하지 않고 위 우회 전략으로 해결.

구축 로드맵

Phase 0  사전 준비 (전원설정, 디렉터리, SW확인)     ~1h
Phase 1  소프트웨어 설치 (Node, Rust, Git, llm_wiki) ~2h
Phase 2  프로젝트 초기화 (vault, API, Git)           ~30m
Phase 3  NAS 동기화 설정 (SMB Z: 매핑, 스케줄)        ~1h
Phase 4  전량 인제스트 (~51,000 파일, 7개 폴더)        ~2-3m
Phase 5  안정화 및 확장 (자료 확장, 자동화 완성)      ~2-4w

각 Phase의 상세 작업은 Issues에서 추적.

시스템 아키텍처

flowchart TB
    subgraph NAS["Synology DS224+"]
        NAS_SRC["\\\\10.11.1.40\\DR_Dev\\공통자료"]
    end

    subgraph PC["DESKTOP-AT1P1UD (24h 운영)"]
        subgraph VAULT["D:\\vault (HDD 1TB)"]
            RAW["raw/sources/<br/>immutable 원본"]
            SCHEMA["purpose.md<br/>schema.md"]
            subgraph INGEST["2-Step CoT Ingest"]
                S1["Step1: 분석<br/>엔티티·개념 추출"]
                S2["Step2: 생성<br/>위키 페이지 생성"]
            end
            WIKI["wiki/<br/>entities/ concepts/ sources/<br/>synthesis/ comparisons/ queries/"]
        end

        APP["llm_wiki<br/>Tauri 앱 (v0.4.16)"]
        API["Codex CLI v0.132.0<br/>(ChatGPT Plus OAuth, gpt-5.4)"]
        GIT["Git (GitHub)<br/>wiki/ 이력 추적"]
        OBS["Obsidian<br/>wiki/ 읽기·그래프 탐색"]
        SCHED["Task Scheduler<br/>06:30 sync · 23:00 commit"]
    end

    NAS_SRC -- "SMB Z: 드라이브<br/>sync-nas.ps1 (06:30)" --> RAW
    RAW --> S1
    S1 --> S2
    S2 --> WIKI
    SCHEMA -. "규칙 준수" .-> S1
    APP --> INGEST
    API <-- "codex exec --json<br/>(ChatGPT Plus OAuth)" --> INGEST
    WIKI -- "auto-commit.ps1 (23:00)" --> GIT
    WIKI --> OBS
    SCHED -.-> RAW
    SCHED -.-> GIT

일일 운영 사이클

시각	자동화 작업	스크립트
06:30	NAS(Z:) → raw/sources 선별 복사	sync-nas.ps1
수시	raw/ 변경 감지 → 인제스트	llm_wiki auto-watch
수시	사용자 쿼리 응답	llm_wiki 채팅
23:00	wiki/ Git 자동 커밋 & 푸시	auto-commit.ps1
일 09:00	시스템 상태 점검	health-check.ps1

3계층 소유권 모델

역할	소유	행동
사람	raw/, schema	자료 투입, 규칙 정의, 질문
LLM	wiki/	분석, 생성, 교차참조, 모순 표시
자동화	스케줄	동기화, 커밋, 점검

3계층 데이터 아키텍처

계층	경로	소유자	규칙
Raw Sources	D:\vault\llm-wiki-vault\raw\sources\	사람	불변, append-only
Wiki	D:\vault\llm-wiki-vault\wiki\	LLM	LLM만 쓰기, 사람은 읽기만
Schema	purpose.md, schema.md	사람	LLM이 준수할 규칙 정의

파일 구조