# second-brain-release

**Repository Path**: grinningGrace/second-brain-release

## Basic Information

- **Project Name**: second-brain-release
- **Description**: obsidian 插件 Second Brain
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-19
- **Last Updated**: 2026-04-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Second Brain for Obsidian

AI 驱动的知识编译器 -- 把散乱的笔记自动整理成结构化、双向链接的知识库。

## 它做什么

你有很多笔记：文章剪藏、读书笔记、播客心得、会议记录、闪念碎片。它们躺在文件夹里，找不到、连不上、用不起来。

Second Brain 解决这个问题：

1. 把原始素材放进 `raw/` 目录（建议以「大脑已经处理过」的内容为主，见下方指南）
2. AI 自动提取概念、实体和知识来源，生成带 `[[双向链接]]` 的结构化 Wiki 页面
3. 在 Wiki 浏览器中按概念、实体、素材分类浏览，支持向量语义搜索

## 第一次使用（推荐）

### 第一步：下载本项目

点击页面右上角的 **「克隆/下载」** 按钮，选择 **「下载 ZIP」**，将整个项目下载到本地，然后**解压**到一个你喜欢的位置（比如桌面、文档文件夹）。

或者用 Git 克隆：

```bash
git clone https://gitee.com/grinningGrace/second-brain-release.git
```

项目内已包含：插件本体、范例素材（`raw/`）、预编译好的 Wiki（`wiki/`），开箱即用。

> Release 页面的 zip 只包含插件三个文件，是给老用户更新插件用的，**第一次使用请下载整个项目**。

### 第二步：用 Obsidian 打开

1. 打开 Obsidian
2. 点击 **「打开本地文件夹作为库」**（不要选「创建新库」）
3. 选中刚才下载（或克隆）的文件夹，点确定

> 如果 Obsidian 提示「受限模式」，点击「信任」即可。这是因为插件不是从官方市场安装的。

### 第三步：启用插件并配置 API Key

1. 打开后会自动弹出 **设置向导**（4 步引导），跟着向导走完即可

如果没有自动弹出向导，手动操作：

1. 进入 **设置 -> 社区插件**
2. 找到「Second Brain」，打开开关启用它
3. 在 **设置 -> 社区插件 -> Second Brain** 中配置 API Key

**推荐使用 DeepSeek（注册即送额度，性价比最高）：**

1. 前往 [DeepSeek 开放平台](https://platform.deepseek.com/) 注册账号
2. 进入 [API Keys 页面](https://platform.deepseek.com/api_keys) 创建一个 API Key
3. 复制 API Key，填入插件设置的 **「API Key」** 栏
4. **「LLM 后端」** 选择 DeepSeek，Base URL 会自动填充

> 设置是即时保存的，填完直接关闭设置页面即可，不需要找保存按钮。

> 其他后端配置方式相同，只需更换对应的 API Key 和 Base URL。API Key 仅保存在本地，不会上传到任何服务器。

### 第四步：开始编译

1. 点击 Obsidian 右侧栏的编译图标（或按 `Cmd/Ctrl + Shift + X`）
2. 点击「开始编译」按钮
3. 等待编译完成，然后点击左侧栏的 Wiki 图标查看结果

### 从已有 Vault 安装（老用户更新插件）

如果你已经有自己的 Obsidian 库，只需从 [Releases](https://gitee.com/grinningGrace/second-brain-release/releases) 下载最新 zip，把里面的 `main.js`、`manifest.json`、`styles.css` 三个文件复制到你的 Vault 下 `.obsidian/plugins/second-brain/` 目录中（没有就新建这个目录）。

## 日常使用流程

```
添加素材 → 编译 → 浏览 Wiki → 发现缺口 → 补充素材 → 再次编译
   ↑                                                    |
   └────────────────────────────────────────────────────┘
```

1. **添加素材**：在 `raw/` 目录下放入 Markdown 笔记文件（可以手动创建，也可以在 Obsidian 中用 `Cmd/Ctrl + Shift + I` 把当前笔记快速捕获到闪念收件箱）
2. **编译**：点击编译面板的「开始编译」，AI 会分析素材并生成/更新 Wiki 页面
3. **浏览 Wiki**：在 Wiki 面板中按概念、来源、实体浏览，支持搜索和语义检索
4. **发现缺口**：Wiki 面板中的「质量总览」会显示知识缺口和待审核页面
5. **补充素材**：针对缺口补充新的素材到 `raw/`，然后再次编译

## 素材使用指南

### 什么素材适合放进 raw/

`raw/` 是插件的输入层。核心原则：**放进来的应该是你已经理解、正在使用的知识，而不是「收藏了但没看过」的内容。**

适合放入的：

- 你自己写下的笔记：想法、转述、复盘、方法论总结
- 已读过并留下个人痕迹的外部素材：加了高亮的文章剪藏、写了批注的读书笔记、附了一句「这对我意味着什么」的播客心得
- 项目实战中的经验记录：踩坑笔记、方案选型对比、事后复盘

不适合直接放入的：

- 收藏但从未打开的链接
- 全文剪藏但一眼没看的文章
- 说不出具体使用场景的「可能有用」材料

这些更适合先放在稍后读或单独收件箱。**等你真的读进去、变成自己的输入之后，再放进 `raw/`**。

### 为什么这个原则很重要

插件把 `raw/` 编译成带链接的 Wiki，扮演的是**第二大脑** -- 用来串联和复用你已经理解的东西。若 `raw/` 里多半是未读收藏，输出再漂亮也只是「囤积自动化」。

### 素材目录结构

```
raw/
  01-文章剪藏/        -- 网页、博客等外部文章（建议带自己的高亮或批注）
  02-书籍笔记/        -- 读书时的摘录和思考
  03-播客笔记/        -- 播客、音频内容的学习笔记
  04-视频内容/        -- 视频课程、演讲的整理
  05-课程笔记/        -- 系统化学习的课程记录
  06-公众号长文/      -- 公众号深度文章
  07-访谈与咨询记录/  -- 访谈、咨询等对话型内容
  08-闪念速记/        -- 随手记下的灵感和碎片想法
    收件箱/           -- 临时暂存区，插件会自动整理到上级目录
  99-待整理/          -- 还没归类的材料
```

子文件夹名称和数量可以按需调整，在插件设置中修改素材根目录即可。

### 素材写作建议

好的素材更容易被编译成高质量 Wiki 页面：

- **有自己的观点**：纯摘录不如「摘录 + 我的理解」
- **一篇一主题**：混合多个不相关话题会降低编译质量
- **保留关键术语**：领域专有名词有助于 AI 准确提取概念
- **标注来源**：开头注明出处，便于 Wiki 建立引用关系

## 功能

### 免费版

- **手动编译**：全量编译或选择单个素材文件编译
- **Wiki 浏览器**：卡片索引、页面阅读器、反向链接、搜索
- **向量语义搜索**：Embedding + 关键词回退，在知识库中语义检索
- **知识缺口检测**：编译后扫描断链，自动生成待补充页面
- **智能补链**：基于语义相似度自动补充页面间的双向链接
- **笔记库扫描**：自动检测 Vault 中已有笔记并导入为素材
- **快速捕获**：`Cmd/Ctrl + Shift + I` 将当前笔记捕获到闪念收件箱
- **多语言界面**：中文、英文、日文

### 完整版

- **自动编译**：监听 `raw/` 目录变化，有新素材自动触发增量编译
- **AI 对话**：与知识库直接对话，回答带 `[[wiki-links]]` 引用来源
- **多 LLM 后端**：支持 OpenAI、Claude、OpenRouter 及任何 OpenAI 兼容 API
- **健康检查**：检测配置和连接状态

## 向量语义搜索（可选）

插件默认将 Embedding 指向 **Gitee AI（模力方舟）**（OpenAI 兼容接口）。若要用 Wiki 里的向量语义检索，请在 **设置 -> Second Brain -> 高级设置 -> 向量检索 (Embedding)** 填写你在 [Gitee AI 控制台](https://ai.gitee.com) 创建的**访问令牌**。

注意：**不要**把 DeepSeek 等 LLM 的 Key 当成 Gitee 令牌使用。不配令牌时仍可编译与浏览，检索会主要走关键词回退。

## 完整版

首次编译自动赠送 **14 天完整版试用**，可体验自动编译、AI 对话等全部功能。

内测阶段结束后公布购买方式。

## 支持的 LLM

| 后端 | 配置方式 | 版本要求 |
|------|---------|---------|
| DeepSeek（推荐） | 填入 API Key，Base URL 自动填充 | 用户自行配置 |
| OpenAI | 填入 API Key | 完整版 |
| Claude (Anthropic) | 填入 API Key | 完整版 |
| OpenRouter | 填入 API Key | 完整版 |
| 其他 OpenAI 兼容 API | 填入 Base URL + API Key | 完整版 |

API Key 仅保存在本地 Obsidian 配置中，不会上传到任何服务器。

## 日常使用成本

以 DeepSeek 为例：
- 输入：约 1 元 / 百万 token
- 输出：约 1.4 元 / 百万 token
- 首次全量编译消耗最多，增量编译只处理变化文件
- 每月几十条笔记的使用量，充值 10 元可用几个月

## 系统要求

- Obsidian >= 1.5.0
- 桌面端（Windows / macOS / Linux）
- 需要可用的 LLM API Key

## 链接

- 问题反馈 QQ 群：1098044447

<div align="center"><img src="qq-group.jpg" width="200"></div>