SIMPLICIO / 文档与架构
面向开发的原生 AI 运行时
安装、本地执行、机械编辑和 MCP 智能体集成指南。
文档与架构
采用原生 Rust 开发
Simplicio 以独立可执行文件分发,无需虚拟环境或 Python 依赖。
Rust
Tokio
MCP
SHA-256
执行引擎
100% Rust
神经缓存查询: 177 ns
令牌消耗: 0 令牌
安装
一条命令即可开始
安装适用于您系统的签名可执行文件:
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 的客户端集成。
如何减少令牌消耗?
使用限定范围的结构映射和针对性编辑,代替完整读取和重写。节省程度取决于任务。