内容
# Obsidian Wiki 代理插件
一款与 Google Antigravity / Gemini 兼容的 AI 代理插件，使 LLMs 可以使用本地 Obsidian 知识库作为长期 **外部语义记忆（MSE）**。
通过结合源摄取 MCP 服务器和语义链接协议，该插件允许 AI 代理在聊天中持久化、检索和遍历知识，绕过上下文窗口限制。
---
## 🚀 主要功能
* **源摄取（MCP 爬虫）**：自动抓取 YouTube 视频转录、描述、频道和缩略图，直接保存为 Obsidian 知识库中的原始笔记。
* **语义记忆协议（`SKILL.md`）**：指示 LLM 代理自动将原始来源编译成原子、相互连接的概念卡。
* **类型突触链接**：格式化概念卡之间的连接，带有精确的关系类型（`Généralisation`、`Spécialisation`、`Prérequis`、`Tension`等），实现代理导航的无缝衔接。
* **自组织网络**：指导代理何时拆分（有丝分裂）大型概念或合并（修剪）重复想法。
* **激活图和活动日志**：动态维护 `index.md`（领域分类）和 `log.md`（编译历史），用于代理发现。
---
## 📂 文件夹结构
该插件在去中心化、扁平的 Obsidian 知识库结构上运行：
```
your-vault/
├── raw/ # 临时传感器内存（输入文档）
│ ├── youtube/ # 抓取的 YouTube 视频转录，以标题命名
│ └── assets/ # 本地缩略图和图像（.jpg，.png）
└── brain/ # 长期语义记忆（扁平文件夹）
├── index.md # 激活图（代理入口）
├── log.md # 活动日志（时间顺序学习历史）
├── RAG.md # 原子概念笔记
└── Notion.md # 原子工具笔记
```
---
## 🛠️ 安装
### 1. 将插件放入您的环境中
克隆此存储库到您的代理自定义目录或工作区：
```bash
git clone https://github.com/your-username/obsidian-wiki-plugin.git
```
### 2. 注册插件
确保插件已在您的 `config/plugins` 路径中注册。该目录应包含：
* `plugin.json` - 插件元数据。
* `mcp_config.json` - 服务器注册，指向 `tools/mcp_server.py`。
* `skills/obsidian-wiki/SKILL.md` - 代理加载的认知指南。
### 3. 依赖项
MCP 服务器在启动时会自动尝试安装其依赖项。但是，您可以手动安装它们：
```bash
pip install yt-dlp youtube-transcript-api requests urllib3
```
---
## ⚙️ 配置
MCP 服务器通过标准 stdin/stdout JSON-RPC 连接，在 `mcp_config.json` 中注册：
```json
{
"mcpServers": {
"obsidian-wiki-scraper": {
"command": "python",
"args": ["/path/to/obsidian-wiki-plugin/tools/mcp_server.py"]
}
}
}
```
---
## 📖 使用方法
安装完成后，代理将加载指令并访问 `obsidian-wiki-scraper` 工具。
### 1. 摄取 YouTube 视频
您可以告诉代理抓取视频：
> *"摄取视频 https://www.youtube.com/watch?v=mHxLXzYjQRE"*
代理将运行 `ingest_youtube_video` 工具，在 `raw/youtube/` 下创建以视频标题命名的文件，其中包含其元数据、描述和转录。
### 2. 编译大脑
要求代理索引新来源：
> *"将新来源编译到数字大脑中"*
代理将：
1. 扫描 `raw/` 目录。
2. 读取 `brain/log.md` 以查找未处理的输入。
3. 根据突触指南在 `brain/` 中生成或丰富原子笔记。
4. 更新 `brain/index.md` 并记录操作。
