Simplicio DOCS
Blog GitHub ↗

SIMPLICIO / 문서 및 아키텍처

개발을 위한 네이티브 AI 런타임

설치, 로컬 실행, 기계적 편집 및 MCP 에이전트 연동 안내입니다.

문서 및 아키텍처

네이티브 Rust로 개발

Simplicio는 가상 환경이나 Python 의존성 없이 독립 실행 파일로 배포됩니다.

Rust Tokio MCP SHA-256
실행 엔진 100% Rust
신경 캐시 조회: 177 ns 토큰 소비: 0 토큰

01.1 · VANTAGENS ARQUITETURAIS · BENCHMARK REAL

🏆 Nossos Diferenciais Competitivos

O Simplicio não é um mero compressor de texto ou proxy de terminal: ele é um kernel autônomo local-first em Rust que resolve os gargalos estruturais de custo, latência e estabilidade da engenharia de software com IA.

⚡
Prompt Caching > 90% Comprovado Injeção determinística do mapa do repositório no prefixo do prompt (Context Anchor). Em testes com OpenRouter/DeepSeek, alcançou 93,06% de cache hit rate e redução de -64,3% no custo por turno.
🔬
Edição Cirúrgica Atômica (Zero Truncamento) Modifica apenas as linhas necessárias via simplicio_edit. O modelo nunca reescreve arquivos inteiros, eliminando 100% dos riscos de // ... existing code ... e economizando mais de 95% em tokens de saída.
🧠
Daemon Residente Tokio com RAM < 1ms Processo em segundo plano via socket Unix (~/.simplicio/daemon.sock). ASTs, símbolos e grafos ficam permanentemente aquecidos na RAM compartilhada entre múltiplos harnesses concorrentes, com watcher inotify reativo.
🔌
Interoperabilidade com 29 Harnesses Conexão transparente com Pi, Cursor, Claude Code, Codex, Copilot, Antigravity, OpenCode, Devin, Goose e outros 20 harnesses. Inclui auto-detecção de conflito (mapper-first) e unlock dinâmico via tools/list_changed.
🛡️
Schema Resilience & Coerção Segura Camada pré-validação tolerante a variações de LLMs: aceita path por file, cmd por command, ops por operations, sem falhas de validação JSON-RPC.
📜
Recibos Auditáveis de Economia (ROI) Gera comprovantes canônicos (simplicio.token-savings-receipt/v1) com métricas reais reportadas pelos provedores: taxa de cache, tokens evitados e dólares economizados.
// Telemetria Real Observada (Modelo: deepseek-v4.1-flash via OpenRouter):
Turno 1 (Mapeamento Inicial & Context Anchor): Input: 2.926 | Output: 78 | Cache: 0 | Custo: $0.0024675
Turno 2 (Edição Cirúrgica via simplicio_edit): Input: 210 | Output: 86 | Cache: 2.816 | Custo: $0.0008809
=> TAXA DE PROMPT CACHE HIT: 93,06% | ECONOMIA DE CUSTO NO TURNO: -64,3%

설치

명령 하나로 시작

운영 체제에 맞는 서명된 실행 파일을 설치하세요.

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 에이전트 연동

앱을 선택하고 설정 단계를 따르세요.

앱에서 확인

이 페이지에서는 앱의 MCP 연결을 확인할 수 없습니다.

계정 관리
요청 예시
프로젝트 구조를 매핑해 주세요.
대상 부분을 수정하고 결과를 검증해 주세요.
프로젝트 테스트를 실행하고 실패를 보여 주세요.

질문 및 개인정보

자주 묻는 질문 및 개인정보

소스 코드가 Simplicio 서버로 전송되나요?

로컬 실행 시 파일은 컴퓨터에 유지됩니다. AI 클라이언트는 설정에 따라 모델 제공업체에 컨텍스트를 전송할 수 있습니다.

어떤 모델을 지원하나요?

Simplicio는 모델에 독립적이며 MCP 호환 클라이언트와 연동됩니다.

토큰 소비는 어떻게 줄이나요?

전체 읽기와 재작성 대신 범위가 제한된 구조 맵과 부분 편집을 사용합니다. 절감량은 작업에 따라 다릅니다.