sint

SINT — 结构化智能网络拓扑 > **智能体作为系统，而非带有工具的聊天机器人。** SINT 是一个基于核心理论构建的智能体架构：智能体不是功能调用的语言模型，而是一个具有七个独立、可替换层的**认知系统**层都有自己的数据结构、持久化模型和验证协议。 本仓库包含了整个 SINT 生态系统：11 个 MCP 服务器、核心内存系统体定义、技能和架构文档。 --- ## 目录 [架构概述](#架构概述) - [七个认知层](#七个认知层) - [MCP 服务器](#mcp-服务器) - [智能体系统](#智能体系统) - [内存系统](#内存系统) - [技能](#技能) - [快速快速入门) - [配置](#配置) - [设计原则](#设计原则) - [项目状态](#项目- [路线图](#路线图) --- ## 架构概述 ``` ┌─────────────────────────────────────────────────────────────────────────────┐ │ SINT 操作系统 │ │ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ 感知 — 我所见到的 │ │ │ │ mcp/re-graph 二进制 → 语义图（逆向工程智能） │ │ │ │ mcp/spec RFC + 二进制格式 → 结构化知识 │ │ │ │ mcp/algo 算法、论文、专利 → 可查询索引 │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────┐ │ │ │ 认知 — 我如何思考 │ │ │ │ mcp/devflow 管道、TDD、代码风格、提交约定 │ │ │ │ mcp/crypto 密码数据库 + 模式检测 + 测试向量 │ │ │ mcp/embed MCU 数据库、RTOS 模式、代码生成 │ │ │ [计划中] 类比引擎、对抗性推理 │ │ │ └─────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ 内存 — 我所知道的 │ │ │ │ mcp/working 任务状态、发现、信念（基于 │ │ │ │ core/memory 哈希链区块、时间衰减、来源 │ │ │ │ mcp/historian 跨会话分析、漂移检测 │ │ │ │ mcp/self 矢量字符数据库、身份回忆 │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ ─────────────────────────────────────────────────────────────────────┐ │ │ │馈 — 我如何学习 │ │ │ │ mcp/learner 错误模式、改进、会话前检查│ │ │ │ mcp/portfolio 跨项目知识链接、转移 │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ 身份 — 我是谁 │ │ │ │ mcp/self 字符校准、所有者模型 │ │ │ AGENTS.MD 不变性、语义寄存器、验证 │ │ │ │ core/skills/ 所有者模型、专业行为 │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ 行动 — 我所做的 │ │ │ 原生工具 读取、写入、编辑、bash、网页（非 MCP） │ │ │ │ core/bin/ 命令行工具（sint-drift、sint-decay 等） │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ 元认知 — 我如何思考我的思考 │ │ │ │ mcp/working 认知状态（信念 + 置信度） │ │ │ │ mcp/historian 漂移检测、寄存器分布 │ │ │ │ mcp/learner 错误模式检测、校准 │ │ │ │ [计划中] 约束跟踪器、元认知监视器 │ │ │ └─────────────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────────────┘ ``` --- ## 七个认知层 SINT 建立在七个认知层上，每个层都是独立且可替换的： ### 1. 感知 — 我所见到的 智能体的感官装置。原始输入在认知开始之前转换为结构化、可查询的知识。 | 组件 | 功能 | 状态 | |---|---|---| | **RE 图** | 将二进制文件分解为数据块 + 操作，表现为矢量嵌入图 | ✅ | | **规范库** | 获取 RFC 和格式规范，本地缓存，混合搜索 | ✅ | | **算法库** | 搜索 Rosetta Code、论文、专利、文档，并进行时代过滤 | ✅ | | 日志解析器 | 事件 → 相关时间线（结构化日志） | 🔲 计划中 | ### 2认知 — 我如何思考 对感知知识进行操作的推理引擎。 | 组件 | 功能 | 状态 | |---|---|---| | **开发流程** | 管道规划、代码审查、TDD 指导、提交约定 | ✅ | | **密码学** | 密码识别、测试向量验证、代码生成 | ✅ | | **嵌入式系统** | MCU 数据库、RTOS 推荐、链接器/启动代码生成 | ✅ | | **对抗性** | 挑战（部分通过 sint-critic 智能体） | ✅ 部分完成 | | **规划器** | 多步骤推理链（在开发流程管道中） | ✅ 部分完成 | | 类比引擎 | 跨领域结构映射 | 🔲 计划中 | ### 3. 内存 — 我所知道的 不是存储。**知识管理** — 类型、链接、时间、来源、可查询。 | 组件 | 功能 | 状态 | |---|---|---| | **工作内存** | 任务状态、发现、信念 — 基于磁盘，约 200 个令牌/查询 | ✅ | | **会话内存** | 具有 SHA-256 来源的哈希链区块 | ✅ | | **长期内存** | 衰减加权的知识区块（30 天半衰期） | ✅ | | **语义内存** | 身份和字符召回的矢量嵌入 | ✅ | | **历史学家** | 跨会话分析、漂移检测、工作报告 | ✅ | ### 4. 行动 — 我所做的 原生智能体能力（非 MCP 服务器 — 这些是智能体的操作手）。 - **代码**：读取、写入、编辑文件 - **文件**：文件系统操作 网络**：HTTP、git、API - **通信**：用户交互 ### 5. 元认知 — 我如何思考我的思考 智能体的自我意识层。没有它，智能体就无法检测自己是否错误。 | 组件 | 功能 | 状态 | |---|---|---| | **认知状态** | 带有置信度、矛盾检测的信念 | ✅ | | **漂移检测** | 寄存器分布监测、异常警报 | ✅ | | **错误模式** | 重复错误检测、反模式生成 | ✅ **校准** | 会话前检查：“我不应该重复什么？” | ✅ | | **约束跟踪器** | 硬/软限制、冲突检测 | 🔲 计划中 | | **监视器** | 错误模式分析、漂移警报 | 🔲 计划中 | ### 6. 身份 — 我是谁 不是角色。**操作校准** — 矢量编码、所有者对齐、上下文敏感。 | 组件 | 功能 | 状态 | |---|---|---| | **字符数据库** | 矢量笔记、语义回忆 | ✅ | | **所有者模型** | 价值观、偏好、所有者技能的反模式 | ✅ | | **价值观** | 伦理框架、优先级（在 AGENTS.MD 中） | ✅ 部分完成 | ### 7. 反馈 — 我如何学习 没有反馈环，智能体会无限重复同样的错误。 | 组件 | 功能 | 状态 | |---|---|---| | **会话日志** | 记录发生了什么、错误、发现 | ✅ | | **错误模式** | 自动检测跨会话的重复错误 | ✅ | | **改进** | 跟踪改进了什么以及为什么 | ✅ | | **会话前检查** | “记住什么不该做？” | ✅ | | **投资组合** | 跨项目知识链接、转移建议 | ✅ | | 会话重放 | “这个会话哪里出了问题？” | 🔲 计划中 | MCP 服务器 ### 感知 | 服务器 | 目录 | 描述 | 关键工具 | |---|---|---|---| | **re-graph** | `mcp/re-graph/` | 逆向工程的语义二进制图 | `build_graph`, `query_semantic`, `trace_forward`, `trace_backward`, `find_patterns` | | **spec** | `mcp/spec/` | RFC + 二进制/容器格式规范 | `get_rfc`, `describe_format`, `search_spec` | | **algo** | `mcp/algo/` | 算法知识（Rosetta、论文、专利） | `search_algorithm`, `get_paper`, `ent`, `getations` | ### 认知 | 服务器 | 目录 | 描述 | 关键工具 | |---|---|---| **devflow** | `mcp/devflow/` | 开发流程智能 |_feature`, `code_review`, `tdd_guide`, `discover_edge_cases` | | **crypto** | `mcp/crypto/` | 密码数据库 + 模式检测 | `search_cipher`, `get_test_vectors`, `detect_cipher`, `generate_code` | | **embed** | `mcp/embed/` | 嵌入式系统专家 | `get_mcu`, `recommend_rtos`, `gen_linker_script`, `gen_start | ### 内存 | 服务器 | 目录 | 描述 | 关键工具 | |---|---|---|---| | **working** | `mcp/working/` | 工作内存 + 认知状态 | `get_state`, `inding`, `add_belief`, `contr`, `get_weakest_beliefs` **historian**mcp/historian/` | 跨会话工作分析师 | `session_stats`, `work_report`, `drift_analysis` | | **self** | `mcp/self/` | 智能体身份矢量数据库 | `self_recall`, `self_teach`, `self_seed`, `self_identity` | ### 反馈 | 服务器 | 目录 | 描述 | 关键工具 | |---|---|---|---| | **learner** | `mcp/learner/` | 跨会话学习 | `log_error`, `get_repeated`, `detect_error_patterns`, `pre_session_check` | | **portfolio** | `mcp/portfolio/` | 项目投资组合 + 知识链接 | `add_project`, `add_link`, `find_transfer`, `get_portfolio_summary` | ### 核心 | 服务器 | 目录 | 描述 | 关键工具 | |---|---|---|---| | **sint-memory** | `core/mcp/sint-memory/` | 哈希链结构内存 | `memory_write_block`, `memory_read_blocks`, `memory_verify_chain`, `memory_apply_decay` | ### 计划中 | 服务器 | 目录 | 描述 | 状态 | |---|---|---|---| | **analogy** | `mcp/analogy/` | 跨领域结构映射 | 🔲 计划中 | | **constraints** | `mcp/constraints/` | 硬/软限制跟踪器 | 🔲 计划中 | | **metacog** | `mcp/metacog/` | 元认知监视器 | 🔲 计划中 | | **replay** | `mcp/replay/` | 会话重放 + 故障分析 | 🔲 计划中 | | **logparser** | `mcp/logparser/` | 事件日志 → 相关时间线 | 🔲 计划中 | --- ## 智能体系统 SINT 使用具有四个专门角色的多智能体架构： ### 智能体角色 | 智能体 | 模式 | 目的 | 模型 | |---|---|---|---| | **sint-main** | 主要 | 任务分类、委托、会话生命周期 | 会话模型 | | **sint-critic 子智能体 | 独立验证、寄存器审计话模型 | | **sint-scribe** | 子智能体 | 内存管理、哈希链维护 | 会话模型 | | **sint-router** | 子智能体 | 任务分类、技能推荐 | 会话模型 | > **没有硬编码模型。** 所有智能体都使用为当前会话选择的模型。这确保了一致性，并允许在不更改智能体配置的情况下升级模型。 ### 智能体流程 ``` 用户输入 ↓ sint-main（主要） ├─ 读取内存状态（sint-memory） ├─ 分类任务（寄存器 + 领域） ├─ 加载相关技能 ├─ 委托给专家智能体 │ ├─ sint-critic（验证任务） │ ├─ sint-scribe（内存任务） │ └─ 通用（实施任务） └─ 管理会话生命周期 ``` ### 语义寄存器 每个输出都属于一个寄存器： | 寄存器 | 要求 | |---|---|---| | **** | 原始数据、观察、用户 无解释 | | **FACT** | 关于世界的验证声明 | 需要来源 | | **LOGIC** | 从 FACT/SENSE 推导出的结论 | 前提明确 | | **OPINION** | 主观评估 | 演员声明 | | **CAUSALITY** | 动作计划、执行链 | 步骤遵循前一步 | --- ## 内存系统 内存系统（`core/memory/`）是 SINT 的知识管理基础设施。 ### 架构 ``` ┌─────────────────────────────────────────────────┐ │ 内存系统 │ │ │ │ ┌──────────────┐ ┌──────────────────────────┐ │ │ │ 状态文件 │ │ 区块存储 │ │ │ │ focus[] │ │ blocks/0000.sense.json │ │ │ │ pending[] │ │ blocks/0001.fact.json │ │ │ │ last_session │ │ blocks/0002.logic.json │ │ │ └──────────────┘ │ ... │ │ │ └──────────────────────────┘ ┌──────────────┐ ┌──────────────────────────┐ │ │ 链文件 │ │ 会话日志 │ │ │ │ chain.jsonl │ │ sessions/2026-07-22.jsonl │ │ │ │ （哈希链接） │ │ ... │ │ │ └──────────────┘ └──────────────────────────┘ │ └─────────────────────────────────────────────────┘ ``` ### 关键特性 - **哈希链来源**：每个区块都通过 SHA-256 哈希链接到前一个区块。篡改会破坏链的完整性。 - **时间衰减**：区块会随着时间推移而失去相关性（30 天半衰期）。活跃的知识保持新鲜。 - **寄存器类型**：、FACT、LOGIC、OPINION、ACTION — 每个都有不同的验证要求。 - **漂移检测**：分布。如果 OPINION 过多或 FACT 过少，则发出警报。 - **来源考古学**：追溯任何结论到其起源区块。 - **Git 集成**：链接内存区块到提交记录以进行交叉引用。 ### 工具 | 工具 | 描述 | |---|---| | `memory_write_block` | 将新区块写入哈希链 | | `memory_read | 读取最近的区块（按寄存器/项目过滤） | |_read_state` | 读取当前焦点和待处理决策 | | `memory_update_state` | 更新焦点、待处理决策、最后会话 | | `memory_verify_chain` | 验证哈希链完整性 | | `memory_apply_decay` | 应用时间衰减，返回相关性得分 | | `memory_heat_block` | 将区块标记为最近访问（7 天提升） | | `memory_search` | 全文 + 寄存器 + 标签搜索 | | `memory_drift_check` | 检查寄存器分布异常 | | `memory_trace_provenance` | 追溯区块到起源 | | `memory_stats` | 、寄存器分布、链| `_chain_tail` | 获取最后 N 个链条条目 | --- ## 技能 技能为特定任务提供专业指令： | 技能 | 目的 | 位置 | ---| | **agents** | 多智能编排、 `core/skents/` | | **dso** | DSO、MPTCTrace、确定 | `core/dso/` | | **memory-system** | 结构化内存区块、哈希链审计 | `core/skills/memory-system/` | | **owner** | 所有者模型、决策风格、偏好 | `core/skills/owner/` | | **state** | 会话管理、项目状态跟踪 | `core/skills/state/` | | **wiki** | 制品注册、交叉引用 | `core/skills/wiki/` | --- ## 快速入门 ### 前提条件 - Python 3.10+ - pip ### 安装 ```bash # 克隆 monorepo git clone https://github.com/kostyk348/sint.git cd sint # 安装核心依赖 pip install -r requirements.txt ``` ### 运行 MCP 服务器 每个 MCP 服务器都通过 stdio 独立运行： ```bash # 感知 cd mcp/al python server.py cp/spec && python server.py cd mcp/re-graph && python server.py # 认知 cd mcp/devflow && python server.py cd mcp/crypto && python server.py cd mcp/embed && python server.py # 内存 cd mcp/working && python server.py cd mcp/historian && python server.py cd mcp/self && python server.py # 反馈 cd mcp/learner &&.py cd mcp/portfolio && python server.py # 核心 cd core/mcp/sint-memory && python server.py ``` ### 与 OpenCode 集成 主要的集成是通过 [OpenCode](https://opencode.ai) 进行的。在 `opencode.jsonc` 中配置： ```jsonc { "default_agent": "sint-main", "mcp": { "sint-memory": { "type": "local", "command": ["python", "path/to/sint/core/mcp/sint-memory/server.py"], "env": { "SINT_MEMORY_DIR": "~/.config/opencode/memory" } } // 根据需要添加其他 MCP 服务器 } } ``` --- ## 配置 ### MCP 服务器 每个 MCP 服务器都有一个 `config.py`，包含： - `NAME` — 用于 MCP 协议的服务器名称 - `CACHE_DIR` — 本地缓存路径 - 源特定的设置 ### 内存系统 环境变量： - `SINT_MEMORY_DIR` — 内存区块、会话和链的存储位置 默认：`~/.config/opencode/memory` ### 智能体定义 智能体行为在 `core/agents/` 中定义： - `sint-main.md` — 主要协调器 - `sint-critic.md` — 验证智能体 - `sint-scribe.md` — 内存智能体 - `sint-router.md` — 任务分类器 --- ## 设计原则 1. **语义寄存器** — 每个输出都是常识、事实、逻辑、观点或因果关系 2. **来源可追溯** — 可追溯的推理链条，无来源不明的主张 3. **不确定性显现** — 低置信度明确表示，不被掩埋 4. **角色校准** — 通过向量召回的代理身份，非静态提示 5. **记忆作为基础设施** — 结构化块，非扁平上下文窗口 6. **无硬编码模型** — 代理使用会话选择的模型 7. **独立层** — 每个认知层可替换，不影响其他层 8. **反馈环** — 代理从跨会话的错误中学习 --- ## 项目状态 | 组件 | 层 | 状态 | 备注 | |---|---|---|---| | **sint-memory** | 记忆 | ✅ v2.1 | 哈希链、时间衰减、漂移检测、来源考古 | | **sint-self-mcp** | 身份 | ✅ | 向量角色数据库、语义召回、所有者模型 | | **sint-spec-mcp** | 感知 | ✅ | RFC + 格式规格、混合搜索 | | **sint-algo-mcp** | 感知 | ✅ | 罗塞塔代码、论文、专利、文档 | | **sint-re-graph-mcp** | 感知 | ✅ | 语义二进制图 + DataTrace 污染 | | **sint-devflow-mcp** | 认知 | ✅ | 流水线 + 模块化样式（C/Python/Rust）+ TDD | | **sint-crypto-mcp** | 认知 | ✅ | 25+ 密码、测试向量、模式检测 | | **sint-embed-mcp** | 认知 | ✅ | MCU 数据库、RTOS 模式、代码生成 | | **sint-working-mcp** | 记忆 | ✅ | 任务状态、发现、信念、认知状态 | | **sint-historian-mcp** | 记忆 | ✅ | 会话分析、漂移检测、工作报告 | | **sint-learner-mcp** | 反馈 | ✅ | 错误模式、改进、会话前检查 | | **sint-portfolio-mcp** | 反馈 | ✅ | 项目投资组合、知识转移链接 | | **sint-critic** | 元认知 | ✅ | 注册审计、事实核查、代码审查 | | **sint-main** | — | ✅ | 主要协调器 | | **sint-scribe** | — | ✅ | 记忆管理代理 | | **sint-router** | — | ✅ | 任务分类代理 | | **日志解析器** | 感知 | 🔲 | 事件 → 相关时间线 | | **类比引擎** | 认知 | 🔲 | 跨领域结构映射 | | **约束跟踪器** | 元认知 | 🔲 | 硬/软限制、冲突检测 | | **元认知监视器** | 元认知 | 🔲 | 错误模式分析、漂移警报 | | **会话重放** | 反馈 | 🔲 | 重放 + 失败分析 | --- ## 路线图 ### 第一阶段：核心（已完成） - [x] 哈希链记忆系统 - [x] 向量身份数据库 - [x] 多代理架构 - [x] 语义寄存器系统 ### 第二阶段：知识（已完成） - [x] 算法知识库 - [x] RFC + 格式规格 - [x] 二进制图（RE） - [x] 密码数据库 - [x] 嵌入式系统数据库 ### 第三阶段：智能（已完成） - [x] 工作记忆 + 认知状态 - [x] 跨会话学习 - [x] 项目投资组合 - [x] 漂移检测 ### 第四阶段：元认知（计划中） - [ ] 类比引擎（跨领域映射） - [ ] 约束跟踪器（硬/软限制） - [ ] 元认知监视器（错误模式分析） - [ ] 会话重放（失败分析） ### 第五阶段：集成（计划中） - [ ] 日志解析器（事件 → 时间线） - [ ] 跨MCP编排 - [ ] 自动反馈环 - [ ] 性能基准 --- ## 链接 - [SINT 宣言](docs/) — 架构哲学 - [AGENTS.MD](AGENTS.MD) — 操作不变式 - [OpenCode](https://opencode.ai) — 主要运行时 ## 许可证 MIT — 见 [LICENSE](LICENSE)