N2 Arachne
현재 작업에 필요한 부분을 찾기 위해 프로젝트 코드와 문서를 검색합니다.
release: 5.0.0 runtime: Node.js 22+ license: terms
한국어
<p align="center">
<img src="https://github.com/choihyunsus/n2-arachne/raw/refs/heads/main/docs/images/comic.png" alt="현재 작업에 필요한 부분을 찾기 위해 프로젝트 코드와 문서를 검색합니다." width="640">
</p>
현재 작업에 필요한 부분을 찾기 위해 프로젝트 코드와 문서를 검색합니다.
앱의 스크린샷이 아닌, 기능을 설명하는 스토리입니다.
<details>
<summary>워크플로우 보기</summary>
Read project files → Build a search index → Find relevant content
</details>
사용 시점 (When to use it)
대규모 프로젝트에서 함수나 설정을 찾거나, 모델 요청을 위한 관련 구절들을 수집할 때 사용합니다.
검색하기 전에 폴더를 인덱싱(Indexing)해야 합니다. 인덱싱은 해당 파일들의 검색 가능한 기록을 구축하는 과정입니다. PDF 및 Office 문서를 읽으려면 플랫폼별 파서 빌드(platform-specific parser build)가 필요할 수 있습니다.
사용해 보기 (Try it)
터미널에서 node --version을 실행하여 Node.js 22 이상 버전을 확인하세요. 이 명령어들은 새로운 실습 폴더를 생성하고 GitHub 릴리스를 설치합니다. 예제 파일과 데이터베이스는 이 폴더에 보관하십시오.
mkdir n2-arachne-demo
cd n2-arachne-demo
npm init -y
...
설치 과정에서 SQLite 빌드 오류가 보고되면, 플랫폼의 C/C++ 빌드 도구가 필요할 수 있습니다. 플랫폼 요구 사항은 설치 참고 자료를 참조하십시오.
다음 내용을 실행 명령을 내린 폴더에 demo.mjs로 저장하십시오.
import { mkdirSync, writeFileSync } from 'node:fs';
import { resolve } from 'node:path';
import { Store, Indexer, loadConfig } from 'n2-arachne';
...
완료 플래그는 true이며, 검색 결과에는 greeting 함수가 포함됩니다. 그런 다음 인덱서(indexer)를 사용자의 소스 폴더로 지정하십시오.
Soul과 함께 사용하기
연결된 N2 모듈들을 동일한 mimir.db 파일에 지정하십시오. project는 작업 이름을, agent는 계속 사용할 AI 신원(identity)을 이름 짓습니다. 같은 레코드 작업을 계속하려면 이 값들을 일치시키십시오. 독립적으로 사용하는 경우에도 동일한 필드 레이아웃을 따릅니다.
다음 단계 및 참고 자료
전체 참고 자료에는 앱 통합, API, 지원되는 기능, 복구 및 유효성 검사에 대한 내용이 포함되어 있습니다. 릴리스 페이지에는 설치 가능한 버전과 릴리스 노트가 담겨 있습니다.
참고 자료에 사용된 몇 가지 용어: MCP는 도구를 AI 앱에 연결하며, **데이터베이스(database)**는 레코드를 저장하고, **호스트(host)**는 이 모듈을 연결하고 실행하는 앱입니다.
사용 및 재배포를 위해 라이선스를 검토하십시오. 종속성(Dependencies)은 참고 자료에 설명된 상업적 사용 조건 등을 포함하여 자체적인 약관을 가질 수 있습니다.