内容
<div align="center">
<img src="https://raw.githubusercontent.com/LongLeo287/SEOSONA-OS/main/.github/assets/Seosona_Logo.png" alt="SEOSONA OS" width="560">
<h1>SEOSONA OS</h1>
**全能大脑 — 一个自我改进的人工智能操作系统,管理你的工具、项目和自身的知识。**
[](https://opensource.org/licenses/MIT)
[](https://github.com/LongLeo287/SEOSONA-OS)
[](https://www.python.org/)
[](https://nodejs.org/)
[](https://modelcontextprotocol.io/)
*一个大脑。每个AI工具。每个项目。知识自我增长。*
*Đọc bằng Tiếng Việt: **[docs/README-vi.md](docs/README-vi.md)***
</div>
---
## 📑 目录
- [什么是SEOSONA OS?](#-什么是seosona-os)
- [为什么它存在](#-为什么它存在)
- [核心能力](#-核心能力)
- [架构](#-架构)
- [生态系统(卫星)](#-生态系统卫星)
- [快速入门](#-快速入门)
- [仓库结构](#-仓库结构)
- [工作原理](#-工作原理)
- [文档](#-文档)
- [设计原则](#-设计原则)
- [许可证](#-许可证)
---
## 🧠 什么是SEOSONA OS?
**SEOSONA OS是一个个人AI操作系统。** 它是大脑“全能脑”的中心:
1. **管理** 机器上的每个AI编码工具 — 一个教义(`SOUL.md`)注入到Cursor、Claude Code、Codex、Windsurf、Aider等所有工具中,使它们共享相同的规则、记忆和技能。
2. **记忆** — 一个可查询的知识库,包含3000多个分析的知识项,通过语义搜索MCP服务器和代码知识图谱暴露给任何代理。
3. **自我增长** — **UAP**管道获取外部仓库,分析它们,并将真正有用的仓库转化为可路由的技能和知识,完全自主。
4. **行动** — 路由和调度层,选择适合任务的技能,可以安全执行,并防止不可逆的副作用。
5. **指挥生态系统** — 四个卫星项目(视频、内容、UX-UI、流程)连接到这个大脑,共享其运行时知识。
它不是一个被动的“第二大脑”,你需要阅读它。它路由、决策、获取、自我改进并运行自主的后台循环 — 一个管理知识的操作系统。
---
## 💡 为什么它存在
每个AI工具都从零开始:它不知道你的规则、项目或你已经学过的知识。你重复粘贴相同的系统,重复解释相同的上下文,每次会话结束时都会失去所有的洞察力。SEOSONA OS在操作系统级别解决了这个问题:
> **只需设置一次。机器上的每个AI工具和每个项目都继承一个共享的大脑,它只会随着时间的推移变得更智能。**
---
## ⚙️ 核心能力
| 能力 | 功能 |
|---|---|
| 🧬 **SOUL教义注入** | 一个单一的主智能层(`1_CORE/SOUL.md`)通过可移植的`~/.seosona`连接点锚定到每个检测到的AI工具 — 零硬编码路径。 |
| 🔎 **共享知识大脑** | `seosona-knowledge` MCP对`3_MEMORY/knowledge_items`执行混合(BM25 + TF-IDF)搜索;`codebase-memory` MCP提供确定性的代码知识图谱。 |
| 🛰️ **UAP — 自我获取** | 通用获取管道克隆 → 安全扫描 → 分析 → 分类 → 获取外部仓库到技能/知识,一次一个仓库,带有重复数据删除和版本检查。 |
| 🗺️ **技能路由器 + 调度** | 280+技能自动索引到`SKILLS_ROUTER.md`;上下文引擎选择每个任务最相关的技能;调度器可以在硬副作用防护后面执行它们。 |
| 🌐 **能力桥** | 验证的注册表,将任务路由到正确的技能/连接器/角色,并标记可以安全自动运行的内容。 |
| 🧠 **持久记忆** | 基于文件的知识项、语义向量索引(自我修复)和每个项目的记忆命名空间。 |
| 🤖 **自主守护进程** | 梦想、评估、预测扫描、自我升级和内存压缩循环在启动/按需运行。 |
| 🔐 **安全第一** | 仅限英语的linters、SSRF防护的连接器、大规模删除完整性防护和自动执行副作用的硬拒绝列表(推送/部署/发布/凭证)。 |
---
## 🏛️ 架构
```mermaid
graph TD
classDef user fill:#2d3748,stroke:#4a5568,color:#fff;
classDef core fill:#4299e1,stroke:#2b6cb0,color:#fff;
classDef mem fill:#48bb78,stroke:#2f855a,color:#fff;
classDef uap fill:#ed8936,stroke:#c05621,color:#fff;
classDef sat fill:#9f7aea,stroke:#6b46c1,color:#fff;
USER([👤 你 / 任意AI工具]):::user --> CORE
subgraph BRAIN[SEOSONA OS — 全能大脑]
CORE[1_CORE · SOUL教义<br/>上下文引擎 · 调度器]:::core
KNOW[2_KNOWLEDGE · 技能 + 框架<br/>SKILLS_ROUTER]:::core
MEM[3_MEMORY · 知识项<br/>向量索引 · MCP搜索]:::mem
UAP[UAP管道 · 获取仓库<br/>→ 技能 / 知识]:::uap
CORE --> KNOW --> MEM
UAP --> MEM
end
BRAIN -->|共享大脑 + SOUL| VIDEO[🎬 视频]:::sat
BRAIN --> CONTENT[✍️ 内容]:::sat
BRAIN --> UXUI[🎨 UX-UI]:::sat
BRAIN --> FLOW[🔀 流程]:::sat
```
操作系统分为编号的域层。**这些路径是可移植的(`~/.seosona/1_CORE/…`)并在整个代码库中引用 — 它们是架构,而不是要扁平化的文件夹。**
---
## 🛰️ 生态系统(卫星)
SEOSONA OS是四个连接项目的母脑。每个项目都提供一个`seosona.project.json`和一个`.mcp.json`,注册共享知识大脑,以便在任何一个项目中,运行时都可以查询中央知识库,并且操作系统会索引它们的内容。
| 卫星 | 领域 |
|---|---|
| 🎬 **SEOSONA 视频** | AI视频制作(VN ASR/TTS,HyperFrames渲染) |
| ✍️ **SEOSONA 内容** | 内容生成 + SEO馈送 |
| 🎨 **SEOSONA UX-UI** | 设计智能 + 运动系统 |
| 🔀 **SEOSONA 流程** | 工作流 / 解説视频自动化 |
在卫星仓库内连接:
```bash
npm run project:init
```
---
## 🚀 快速入门
一个全新的克隆**完整且可运行** — 所有代码、配置、角色、技能库、知识库和35个供应商的代理技能都包含在仓库中。请参阅 **[SETUP.md](SETUP.md)** 以获取完整的指南。
```bash
git clone https://github.com/LongLeo287/SEOSONA-OS.git
cd SEOSONA-OS
npm install # 运行postinstall(git钩子)
# 获取代码导航二进制文件(超过GitHub的100 MB/文件限制):
powershell -File 1_CORE/bin/codebase-memory-mcp/install.ps1
# 打开一个新的代理会话 — .mcp.json在启动时启动知识服务器。
```
语义向量索引**不**包含在内;它自我修复 — 第一个知识查询在~12秒内从KI重建它并持久化。
---
## 📂 仓库结构
```
SEOSONA-OS/
├── 1_CONFIG/ # 设置、API网关配置、工作区 + 卫星注册
├── 1_CORE/ # 大脑:SOUL.md、上下文引擎、调度器、UAP管道、
│ # 连接器、守护进程、能力桥、MCP服务器、bin/
├── 2_KNOWLEDGE/ # 技能库:框架 + SKILLS_ROUTER.md(自动生成)
├── 3_MEMORY/ # 内存:知识项(KIs)、项目命名空间、计划
├── 4_AGENTS/ # 代理角色
├── 5_RESEARCH/ # 经过验证的参考资料来自获取
├── .agents/skills/ # 35个供应商代理技能(在设置时获取重资产)
├── cli/ # Node.js CLI包
├── docs/ # 架构wiki + 审计记录
├── .mcp.json # 注册代码库内存 + seosona-knowledge MCP服务器
├── SETUP.md # 克隆到运行指南
└── AGENTS.md · GEMINI.md # 根代理指令约定
```
**不在git中** (获取或本地):257 MB代码导航`.exe`(有`install.ps1`)、重资产(字体、测试录像带)、生成的运行时状态(`vector_index/`、队列、日志)和机密(`.env` — 复制`.env.example`)。
---
## 🔧 工作原理
**通用锚点。** `~/.seosona`文件系统连接点指向此仓库的位置,因此每个工具在任何地方都读取相同的大脑。移动它,重新运行设置,锚点更新 — 任何地方都没有硬编码路径。
**运行时循环。** 任务进入 → **上下文引擎** 解析`SKILLS_ROUTER.md`并选择最相关的技能 → **能力桥** 标记安全的内容 → **调度器** 返回指导或执行可运行的程序,拒绝任何具有不可逆副作用的脚本。
**自我改进。** UAP获取仓库,分类器分层证据(依赖文件导入权重远高于文件名关键词)以决定实际的匹配,只有真正的匹配才成为技能/知识 — 其余的作为参考,查询但不转储到系统中。
---
## 📚 文档
| 文档 | 主题 |
|---|---|
| [docs/00_master_architecture.md](docs/00_master_architecture.md) | 完整系统架构 |
| [docs/01_agents_roster.md](docs/01_agents_roster.md) | 代理角色 |
| [docs/02_skills_frameworks.md](docs/02_skills_frameworks.md) | 技能 + 框架 |
| [docs/03_uap_pipeline.md](docs/03_uap_pipeline.md) | UAP自我获取管道 |
| [docs/05_brain_and_memory.md](docs/05_brain_and_memory.md) | 知识 + 内存 |
| [docs/06_sops_rules_workspaces.md](docs/06_sops_rules_workspaces.md) | SOPs,规则,工作区 |
| [SETUP.md](SETUP.md) | 克隆到运行设置 |
---
## 🎯 设计原则
- **可移植,零硬编码** — 所有内容都锚定在`~/.seosona`。
- **诚实的缝隙** — 未构建的功能会诚实地抛出或降级;没有任何结果是伪造的。
- **分析,而不是转储** — 获取会分类和路由;只有真正的匹配才会进入系统。
- **安全的自主性** — 自动执行由硬副作用拒绝列表控制;批量删除需要显式覆盖。
- **节俭** — 重型二进制文件和生成的状态不进入git;仓库是一个干净、自包含的克隆。
---
## 📄 许可证
[MIT](LICENSE) © SEOSONA
<div align="center">
<sub>构建为自我改进的全能大脑。一个设置 — 每个AI,每个项目,一个不断增长的思维。</sub>
</div>