SIMPLICIO / 문서 및 아키텍처
개발을 위한 네이티브 AI 런타임
설치, 로컬 실행, 기계적 편집 및 MCP 에이전트 연동 안내입니다.
문서 및 아키텍처
네이티브 Rust로 개발
Simplicio는 가상 환경이나 Python 의존성 없이 독립 실행 파일로 배포됩니다.
설치
명령 하나로 시작
운영 체제에 맞는 서명된 실행 파일을 설치하세요.
curl -fsSL https://simpleti.com.br/simplicio/install.sh | sh
체크섬을 확인하고 시스템에 맞는 실행 파일을 설치합니다.
수명 주기
요청 수명 주기
에이전트 호출부터 검증된 결과까지:
1. MCP로 요청 수신
에이전트는 채팅에서 JSON-RPC 2.0을 통해 도구를 호출합니다.
2. CPUExecutor 분류
대화형 요청과 분석은 별도 대기열을 사용하고 쓰기는 직렬화됩니다.
3. 로컬 메모리 조회
파일을 읽기 전에 SQLite FTS와 벡터 메모리를 조회합니다.
4. 제한된 컨텍스트
토큰 예산 내에서 관련 심볼을 포함한 구조 맵을 제공합니다.
5. 편집 및 해시 검증
대상 부분을 원자적으로 교체하고 SHA-256으로 검증합니다.
6. 검증 및 실행 기록
로컬 검사를 통해 실행 결과를 담은 기록을 생성합니다.
CPUExecutor
CPUExecutor 및 동시 실행
실행 대기열과 직렬화된 쓰기로 로컬 작업을 조정합니다.
| 대기열 | 우선순위 | 동시 실행 | 작업 |
|---|---|---|---|
| InteractiveHigh | 높음 | CPU × 2 | 에이전트는 채팅에서 JSON-RPC 2.0을 통해 도구를 호출합니다. |
| AnalysisBackground | 일반 | Tokio Semaphore | 파일을 읽기 전에 SQLite FTS와 벡터 메모리를 조회합니다. |
| write_workers: 1 | 직렬 | 1 | 대상 부분을 원자적으로 교체하고 SHA-256으로 검증합니다. |
기계적 편집
기계적 편집 엔진
대상 부분만 변경하여 전체 파일 재생성과 모델 출력을 줄입니다.
전체 파일 생성
대상 부분만 변경하여 전체 파일 재생성과 모델 출력을 줄입니다.
대상 기계적 편집
대상 부분을 원자적으로 교체하고 SHA-256으로 검증합니다.
// Simplicio
{
"TargetFile": "/path/to/src/auth.rs",
"TargetContent": "fn verify_token(token: &str) -> bool {\n true\n}",
"ReplacementContent": "fn verify_token(token: &str) -> bool {\n validate_jwt_signature(token)\n}"
}
MCP 설정
MCP 에이전트 연동
앱을 선택하고 설정 단계를 따르세요.
질문 및 개인정보
자주 묻는 질문 및 개인정보
소스 코드가 Simplicio 서버로 전송되나요?
로컬 실행 시 파일은 컴퓨터에 유지됩니다. AI 클라이언트는 설정에 따라 모델 제공업체에 컨텍스트를 전송할 수 있습니다.
어떤 모델을 지원하나요?
Simplicio는 모델에 독립적이며 MCP 호환 클라이언트와 연동됩니다.
토큰 소비는 어떻게 줄이나요?
전체 읽기와 재작성 대신 범위가 제한된 구조 맵과 부분 편집을 사용합니다. 절감량은 작업에 따라 다릅니다.