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. חיפוש בזיכרון המקומי

Simplicio בודק ב-SQLite FTS ובווקטורים לפני קריאת קבצים.

4. הקשר מוגבל

מפות מבניות מספקות סמלים רלוונטיים במסגרת תקציב טוקנים.

5. עריכה ואימות גיבובים

החלפות ממוקדות מתבצעות באופן אטומי ונבדקות באמצעות SHA-256.

6. בדיקה ואישור ביצוע

בדיקות מקומיות מפיקות רשומה עם תוצאת ההרצה.

CPUExecutor

CPUExecutor ומקביליות

תורי הרצה וכתיבה סדרתית מתאמים את העבודה המקומית.

תור עדיפות מקביליות פעולות
InteractiveHigh גבוהה CPU × 2 הסוכן קורא לכלים באמצעות JSON-RPC 2.0 ישירות מהצ׳אט.
AnalysisBackground רגילה Tokio Semaphore Simplicio בודק ב-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.

כיצד מצמצמים את צריכת הטוקנים?

באמצעות מפות מבניות מוגבלות ועריכות ממוקדות במקום קריאה ושכתוב מלאים. החיסכון תלוי במשימה.