内容
# 系统概览
<img width="2752" height="1536" alt="SABIO__Cerebro_para_memoria_IA" src="https://github.com/user-attachments/assets/3d0b5db7-973b-412f-a5f4-b42d67b10a23" />
> **一个从头到尾使用 AI 的平台 — 无向量数据库，无 RAG。**
> 它包含三个组件：**SABIO**（长期记忆，以 Claude Code 直接读取的文本文件形式存储），**GREMIO**（基于该知识构建软件的代理工厂），和 **COUNCIL**（一个对你的决策进行辩论的委员会）。有序，联邦化，按项目隔离。
> **SABIO 知道 · GREMIO 构建 · COUNCIL 商议。**
> 🌎 **英文，一句话：** *一个与 AI 编码助手合作的端到端平台，无 RAG：** **SABIO**（一个无 RAG 的长期记忆的纯 Markdown 保险库，五个联邦化的“房间”）， **GREMIO**（一个基于该知识构建软件的代理工厂），和 **COUNCIL**（一个对你的决策进行辩论的委员会）— 所有这些都由 Claude Code 驱动。下面所有内容都是西班牙语；安装指南（[`INSTALAR.md`](INSTALAR.md)）由 Claude Code 自身执行。*
---
## 三个组件
| 组件 | 功能 | 位置 |
|---|---|---|
| 🧠 **SABIO** — *知道* | **长期记忆**：无 RAG 的知识维基，联邦化在 5 个房间中，按项目隔离。是其他两个组件的基础。 | 本 README + [`docs/`](docs/) |
| 🏭 **GREMIO** — *构建* | **代理工厂**：将想法转化为软件：1 个工厂管理 + 8 个领导 + 24 个专家（33 个代理），他们使用决策记录（房间 E）进行决策，并具有验证门控和**人工签名**。 | [`gremio/`](gremio/) |
| 🏛 **COUNCIL** — *商议* | **商议委员会**（`/council`）：5 人 + 1 名主席，对想法或决策进行辩论和红队评审。提供**角度和盲点覆盖**，而非事实准确性（它是同质的：它们是同一个模型的实例）。 | 命令 `/council` |
---
## 一句话总结
SABIO 是一个有序的站点，**你研究或决策的每个东西都只保存一次**，被标记，并且可以被重新找到 — 不会让一个项目与另一个项目的數據混淆，并且不会让 AI 在会话之间“记住”任何东西：它从文件中读取。
## 解决的问题
AI 有 **两个遗忘和一个混乱**。SABIO 解决了这三个问题：
| 问题 | 发生的情况 | SABIO 中谁来解决 |
|---|---|---|
| **聊天中的遗忘** | 在长时间的对话中，AI 忘记了前面的内容（窗口饱和）。 | **上下文管理**（层 1）。 |
| **会话之间的遗忘** | 你关闭聊天窗口，明天它不记得你做出的决定。 | **知识保险库**（层 2）。 |
| **混乱/混合** | 一个项目的數據泄漏到另一个项目中。 | **按项目隔离**。 |
**设计理念：无 RAG。** 在中等容量（< 2000 页）下，不需要向量数据库：一个 AI 直接读取的文本 wiki 就足够了。更简单，更便宜。这是 Andrej Karpathy 的“LLM Wiki”模式。
---
## 组织结构：5 个房间和 2 个平面
知识被组织在 **5 个房间**中（每个数据都存放在一个房间中，其他房间通过 ID 引用）：
- **房间 A · 研究** — 原子笔记的保险库（`investigacion:<主题>`）。在指挥中心是**多领域的**：新领域作为标签和地图添加，**永远不会**作为单独的保险库。
- **房间 B · 目录** — 您的工具和资产的卡片（`activo:<东西>`）。
- **房间 C · 参考** — 外部规范和标准（`norma:<框架>:<代码>`）。按**范围**细分，带有标签：`universal`（国际框架 — NIST/ISO/PCI — 适用于所有人），`jurisdiccion:`（一个国家的普遍适用立法）和 `sector:`（一个行业的监管）。升级到全局平面的是**需要多个项目**的内容，而不是“国际内容”；每个项目声明其**适用性配置文件**并解决 `universal` + 其自身的内容。
- **房间 D · 学习** — 不重复错误的课程（`aprendizaje:<ID>`）。
- **房间 E · 决策（GREMIO）** — **决策记录**的日志（`dr:<领域>-<N>`），用于为 GREMIO 工厂（如下）提供信息。**按项目本地存储，永不联合**：决策是做出该决策的产品独有的。
并且在 **2 个平面**上，通过单向**只读**箭头连接：
```text
全局平面 · 指挥中心 Sabio （只读）
★ 索引索引 · 房间 A（研究 · 多领域）· 房间 C（参考）· 房间 D（学习）
▲
│ 项目通过 sabio-shared 读取全局平面（只读）
│
本地平面 · 项目 （隔离）
房间 A（研究）· 房间 B（目录）· 房间 D（本地捕获）· 房间 E（决策 · DRs）
/sabio-aprender → /sabio-promover 将通用内容 ↑ 提升到全局平面（DRs 永不提升）
```
> 项目**永远不会**读取另一个项目的目录。只能通过 **MCP `sabio-shared`**（只读）查询全局平面。这就是**隔离**。
---
## 此仓库包含的内容
整个系统（SABIO + GREMIO + COUNCIL），以通用和可重用的版本：
| 组件 | 内容 |
|---|---|
| 🧰 **项目工具包** | 创建一个完整的新项目（目录，独立的 git，保险库和房间 A-D — 房间 E 由 GREMIO 创建），具有**基本**或**代理**配置文件。 |
| 🚀 **端到端部署** | `/sabio-welcome <路径>` 创建项目，**测试**（结构 + 全局平面通道，具有确定性测试）并将其采用到仪表板 — 一步完成。包括测试 `kit/Validar-Despliegue.ps1`。 |
| 🏛 **指挥中心 Sabio** | 所有项目共用的全局中心 / 平面模板。 |
| 🔌 **MCP `sabio-shared`** | 只读桥梁，允许项目查询全局平面。 |
| 🤖 **自动学习** | **反射器**模式（代理 `sabio-reflector`）：通过外部反馈反思并推断出经验教训，然后再保存。房间 D 的代理配置文件：捕获 + 验证器。 |
| ⌨️ **技能/命令** | `/sabio-aprender`（及其 `--reflexivo` 模式），`/sabio-promover`，`/sabio-promover-buzon`，`/sabio-converger`，`/memory-lint`，`/disenar`，`/sabio-welcome`。 |
| 📮 **提升邮箱** | `/sabio-promover-buzon`（从中心）：**自动**发现项目在其邮箱中留下的已准备好软件包，并实现您选择的内容 — 自动运输方向，无需复制粘贴。您决定什么内容提升（门控）；扫描仅带来内容。仅读取每个项目的邮箱，而非其保险库。 |
| 🧠 **代理** | Sabio 代理，自我改进反射器，研究代理，代码审查器，提交作者，文档作者和安全工程师。 |
| 🏭 **GREMIO — 代理工厂** | 基于 **SABIO** 的 AI 软件代理：1 个工厂管理 + 8 个领导 + 24 个专家（33 个代理），在决策记录（房间 E）上合作，具有验证门控和**人工签名**。 [`gremio/`](gremio/) 中的完整协议。*SABIO 知道 · GREMIO 构建 · COUNCIL 商议。* |
| 🏛 **COUNCIL — 商议委员会** | 命令 `/council`：5 人 + 1 名主席，对想法或决策进行辩论和红队评审。提供**角度和盲点覆盖**，而非事实准确性 — 这是 GREMIO 在高风险决策前可以调用的对抗性审计模式。 |
| 📊 **舰队仪表板** | **离线**面板（Python + HTML），显示您的项目的健康状况（git，SABIO，备份，安全）和优先处理的内容 ([`dashboard/`](dashboard/))。 |
| 📚 **指南** | 每个组件的视觉文档（[`docs/`](docs/)）。 |
---
## 仓库结构
每个文件都有其作用。**生成的内容**（`.venv/` 目录，`flota.config.json`，`estado-flota.json`，`panel/datos/`）不会被版本控制：它在您的机器上创建或安装/扫描时创建。
```text
sistema-agentico-blackdestiny/
├── README.md # 本文件：什么是系统以及它包含什么
├── INSTALAR.md # 安装指南，由 Claude Code 执行（4 个步骤）
├── LICENSE # MIT 许可证
├── .gitignore # 忽略 venvs、本地配置和生成的数据
│
├── kit/ # 🧰 创建具有基本或代理配置的新项目
│ ├── Crear-Proyecto.ps1 # 在一步中部署整个项目（幂等）
│ ├── Actualizar-Proyecto.ps1 # 将标准传播到现有项目（仅添加）
│ ├── Validar-Despliegue.ps1 # 🚀 部署测试：结构 + 隔离 + 全局通道
│ ├── LEEME - Crear un proyecto nuevo.md
│ ├── Chuleta de Prompts - Investigacion e Ingesta.md # 用于填充保险库的提示
│ ├── _proyecto/CLAUDE.md # 项目的 CLAUDE.md 模板（树 + 规则 + 联邦）
│ ├── _plantilla/ # 保险库（房间 A）模板：CLAUDE.md，index.md，log.md，templates/，raw/，wiki/
│ └── _federado/ # 联邦大脑模板：索引 + 房间 B/C/D + 统一房间 D（模式 + 验证器，所有项目标准）
│
├── centro-de-mando-sabio/ # 🏛 全局中心 / 平面模板
│ ├── CLAUDE.md # 中心的角色
│ └── LEEME - Montar tu Centro de Mando Sabio.md
│
├── mcp/ # 🔌 只读全局平面桥
│ ├── server.py # sabio-shared 服务器（stdio，只读，4 个工具）
│ ├── requirements.txt # 依赖项：mcp + pydantic
│ └── README.md # 公开内容，安全性和如何注册项目
│
├── dashboard/ # 📊 离线舰队健康面板（多平台）
│ ├── escanear-flota.py # 扫描器（可移植引擎；Windows · macOS · Linux）
│ ├── Escanear-Flota.ps1 # Windows 包装器（调用 .py）
│ ├── Abrir-Panel.cmd # Windows 双击（重新扫描并打开面板）
│ ├── flota.config.example.json # 配置模板（复制到 flota.config.json，本地）
│ ├── README.md # 如何配置，测量内容和 arquetipos/信号灯
│ └── panel/ # 面板：index.html · 样式/（tokens.css，panel.css）· 应用/（5 个 JS 模块）
│
├── entorno-claude/ # ⌨️🤖 Claude Code 环境（安装在 ~/.claude）
│ ├── Aplicar-Setup.ps1 # 复制环境到 ~/.claude（带备份）
│ ├── Sincronizar-Setup.ps1 # 将 ~/.claude 转储回仓库（以版本控制）
│ ├── README.md # 每个组件的作用
│ └── home-claude/ # 进入 ~/.claude 的内容：
│ ├── CLAUDE.md # 跨领域偏好（通用模板）
│ ├── settings.json # 会话设置 + 钩子
│ ├── commands/ # 技能：sabio-aprender（反射模式）· sabio-promover · sabio-promover-buzon · sabio-converger · memory-lint · disenar · sabio-welcome (+ 别名 sabio-reflector) · council · gremio-iniciar · gremio-continuar · gremio-analizar · gremio-converger
│ ├── agents/ # 40 个代理：7 个跨领域（sabio-curator · sabio-reflector · research-curator · code-reviewer · commit-writer · doc-writer · security-engineer）+ 33 个 GREMIO（在 <Division> Gremio/ 子目录中）
│ └── scripts/ # 钩子：登录提醒 · 打包时捕获
│
├── gremio/ # 🏭 GREMIO — 代理工厂（完整协议）
│ ├── Protocolo GREMIO.md # 指导文档：生命周期，门控，领域合约
│ ├── ROSTER.md # 33 个代理目录（从他们的 frontmatter 派生）
│ ├── README.md # 什么是 GREMIO，诚实状态和安装方法
│ ├── comandos/ # /gremio-iniciar 和 /gremio-continuar 的源代码
│ ├── compuertas/ # /gremio-analizar 和 /gremio-converger 的源代码
│ ├── plantillas/ # DR.md · plan.md · agente.md · runbook.md（规范模板）
│ └── simulacros/ # 门控回归测试套件（3 个嵌入缺陷）
│
└── docs/ # 📚 “直白”指南
├── guia-sabio.md # 什么是 SABIO，如何使用，无专业术语
├── resumen-consolidado.md # 集成视图，一次阅读
└── media/sabio-infografia.png # 封面信息图
```
---
## 安装
系统通过 **引导 Claude Code** 进行安装 — 在 **Windows，macOS 和 Linux** 上均可运行，因为 Claude 会适应您的系统并执行步骤。一次安装会将三个组件（SABIO + GREMIO + COUNCIL）放入您的 `~/.claude` 中。
```text
1. 克隆此仓库。
2. 在仓库文件夹中打开 Claude Code。
3. 告诉它： 「按照 INSTALAR.md 安装系统」
```
👉 完整指南，步骤： **[`INSTALAR.md`](INSTALAR.md)**
---
## 哲学
- **无 RAG**。纯文本，AI 直接读取。更少的组件，更低成本，更高的控制权。
- **一个数据，一个位置**。不会复制；按 ID 引用。零重复，零漂移。
- **默认隔离**。每个项目都在自己的盒子里；一个门通往共享知识。
- **比例**。解决问题所需的最小配置。仅当真正执行循环中的代理时，才启用代理配置文件。
---
## 许可证和致谢
**系统** — 由 **Blackdestiny** 创建。 在 **MIT 许可证**（查看 [`LICENSE`](LICENSE)）下发布：您可以自由使用，修改和分享，保持署名。
