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 的客户端集成。

如何减少令牌消耗?

使用限定范围的结构映射和针对性编辑,代替完整读取和重写。节省程度取决于任务。