AI Knowledge Manager

approved

by cyk111

AI-powered book library manager with auto-tagging, knowledge graphs, and multi-tool skill generation. - This plugin has not been manually reviewed by Obsidian staff.

★ 2 stars↓ 155 downloadsUpdated 1mo ago

Install in Obsidian View on GitHub

AI Knowledge Manager — Obsidian 知识库管理插件

🤖 AI 驱动的 Obsidian 知识库管理插件 — 扫描本地书籍、导入 Chrome 书签、同步 GitHub Stars，AI 自动分类打标，生成知识图谱，一键编译 AI Skill。

✨ 功能特性

三大知识来源，一个知识库：

来源	功能	AI 能力
📂 本地书籍	PDF/EPUB/TXT 扫描，SHA256 去重	自动分类 + 标签 + 简介/目录/章节概要
🔖 Chrome 书签	自动导入 292+ 书签，分类目录	10 大类别智能分类 + 标签 + 摘要
⭐ GitHub Stars	API 同步 Star 项目，抓 README	项目分类 + 技术标签 + AI 摘要

核心能力：

📂 多格式书籍扫描 — PDF、EPUB、TXT，递归扫描，SHA256 去重
🔖 Chrome 书签导入 — 一键导入浏览器书签，自动按类别归档
⭐ GitHub Stars 同步 — API 同步 Star 项目，自动抓取 README 摘要
🏷️ AI 自动分类 — 每个来源独立标签体系，各 10 个分类
📝 AI 摘要生成 — 书签和 GitHub 项目自动生成中文内容摘要
📂 分类目录归档 — 自动移到分类子目录，生成分类导航页
📚 多源笔记集成 — 微信读书、Apple Books 划线笔记，交叉引用
🧠 一键生成 AI Skill — 书籍编译为结构化 Skill，同步到 Claude Code / Cursor / Copilot
🗺️ 知识图谱 — Obsidian 原生图谱 + wikilinks，书与书、项目与项目之间的隐藏关联
⚡ 懒加载 AI — 简介、目录、章节概要按需生成，不浪费 Token
🌐 多模型支持 — DeepSeek / OpenAI / 通义千问，OpenAI 兼容 API 均可

📦 安装

方式一：Obsidian 社区插件市场（推荐）

打开 Obsidian → 设置 → 第三方插件 → 关闭安全模式
点击「浏览」，搜索 AI Knowledge Manager
安装并启用

方式二：BRAT 插件（Beta 测试）

安装 BRAT 插件
BRAT 设置 → Add Beta Plugin → 输入 cyk111/ai-book-manager
启用插件

方式三：手动安装

从 Releases 下载最新版
解压到 <vault>/.obsidian/plugins/ai-book-manager/
重启 Obsidian，在设置中启用

🚀 快速开始

配置 AI API Key — 填入 DeepSeek / OpenAI / 通义千问的 API Key
选择知识来源：
- 📂 配置书籍目录 → Cmd+P → Scan book directory
- 🔖 开启书签导入 → Cmd+P → 导入 Chrome 书签
- ⭐ 填入 GitHub Token → Cmd+P → 同步 GitHub Stars
查看结果 — 打开 🧠知识库/，浏览自动生成的笔记卡片
AI 分类 — 插件自动在后台调用 AI 打标签、分类、生成摘要

⚙️ 配置说明

设置项	说明	默认值
Book directory	书籍文件夹绝对路径	无
Supported formats	扫描的文件后缀	`.pdf,.epub,.txt`
AI 模型	AI 服务提供商	DeepSeek
API Key	AI 服务的 API 密钥	无
API URL	API 端点地址	自动填充
Model	模型名称	自动填充
Auto AI tagging	扫描后自动 AI 分类打标	关
Notes folder	生成的笔记存放目录	`🧠知识库`
Max concurrency	并发 AI 请求数	1
笔记来源	微信读书 / iBook 等笔记目录	无
GitHub Stars	Token + 启用同步开关	—
浏览器书签	启用导入 + 自动/手动路径	—
Skill 生成	模式（轻量/完整）+ 同步目标	轻量

📖 功能详解

本地书籍扫描

支持 PDF、EPUB、TXT 三种格式。通过 SHA256 哈希去重，避免重复扫描。

AI 分类标签（25 类）：文学、科幻、推理悬疑、历史、哲学、心理学、社会学、经济学、管理学、编程、人工智能、数学、物理学、生物学、医学、法律、政治、教育、艺术、设计、传记、商业、科普、宗教、技术

Chrome 书签导入

一键导入 Chrome 浏览器全部书签。插件自动检测 Chrome 书签文件位置（支持 macOS / Windows / Linux）。

AI 分类标签（10 类）：AI与大模型、编程与架构、面试与算法、运维与基础设施、前端与设计、交易与投资、英语学习、工具与效率、学习资源、其他

导入后自动按类别创建子目录，生成分类导航页。每个书签生成 AI 摘要，让你无需打开网页就能了解内容。

GitHub Stars 同步

通过 GitHub Personal Access Token 同步你 Star 的所有项目。自动抓取项目 README 摘要，AI 分析项目类型并分类。

AI 分类标签（8 类）：框架、库、工具、CLI、文档、示例、实验、归档

每个项目自动生成：

🏷️ 技术标签（语言、领域、成熟度）
📝 AI 摘要（50-100 字中文，描述项目功能）
📂 分类归档 + 导航页

AI 自动分类打标

每个来源使用独立的标签体系，不强行统一。AI 同时生成标签、分类和内容摘要。所有标签写入 Markdown 的 YAML frontmatter：

---
title: "react"
source: "GitHub Stars"
tags: ["框架", "JavaScript", "react"]
category: "框架"
projectType: "framework"
language: "JavaScript"
---

微信读书 & Apple Books 集成

配置笔记来源目录后，自动扫描微信读书、Apple Books 导出的 Markdown 笔记，为每本书创建索引卡片，并自动进行跨来源交叉引用匹配。

一键生成 AI Skill

将书籍编译为通用 AI Skill（Markdown 格式），存放在 🧠知识库/Skills/，通过软链接同步到 Claude Code、Cursor、Copilot CLI 等 AI 工具。

Skill 目录结构：
三体-abc123/
├── SKILL.md              ← 核心思维模型 + 章节索引
├── chapters/
│   ├── ch01-*.md         ← 每章独立概要
│   └── ...
├── glossary.md           ← 术语表（完整模式）
├── patterns.md           ← 模式库（完整模式）
└── cheatsheet.md         ← 速查表（完整模式）

知识图谱

所有标签、分类、交叉引用通过 Obsidian 的 wikilinks 连接，在原生图谱视图中呈现知识关联网络。

知识库目录结构：

🧠知识库/
├── 本地书籍/           ← 本地电子书
│   ├── 科幻/
│   │   ├── 科幻.md     ← 分类导航页
│   │   └── 三体.md
│   └── 编程/
├── 浏览器书签/          ← Chrome 书签
│   ├── AI与大模型/
│   │   ├── AI与大模型.md
│   │   └── Devv AI.md
│   └── 编程与架构/
├── GitHub Stars/        ← GitHub Star 项目
│   ├── 框架/
│   │   ├── 框架.md
│   │   └── facebook-react.md
│   └── 工具/
├── 微信读书/            ← 微信读书笔记
├── ibook书籍/           ← Apple Books 笔记
└── Skills/              ← AI Skill 文件

🌐 支持的 AI 模型

提供商	模型	说明
DeepSeek	deepseek-chat	默认，性价比最高
OpenAI	gpt-4o / gpt-4o-mini	兼容性最好
通义千问	qwen-plus / qwen-max	阿里云
其他	任意 OpenAI 兼容 API	自定义 Base URL

Token 消耗参考（DeepSeek 定价）：

操作	预估费用
AI 打标（书籍）	~0.00035 元
书签分类 + 摘要	~0.0005 元
GitHub 项目分类 + 摘要	~0.0008 元
生成简介	~0.0012 元
生成目录	~0.0021 元
章节概要	~0.0038 元
Skill 生成（12 章）	~0.03 元

🔧 开发

# 安装依赖
npm install

# 构建
npm run build

# 监听模式（开发时使用）
npm run dev

# 类型检查
npx tsc --noEmit

# 运行测试
npm test

技术栈

平台: Obsidian Plugin API（TypeScript）
构建: esbuild
测试: Jest（232 tests）
PDF 解析: pdfjs-dist
EPUB 解析: adm-zip
AI: OpenAI 兼容 API（DeepSeek / OpenAI / 千问）

项目结构

├── main.ts                    # 插件入口
├── src/
│   ├── models.ts              # 类型定义
│   ├── ai-client.ts           # AI API 客户端（书籍/书签/GitHub）
│   ├── parser.ts              # 书籍解析器
│   ├── scanner.ts             # 文件扫描器
│   ├── scanners/              # 新增扫描器
│   │   ├── bookmark-scanner.ts   # Chrome 书签解析
│   │   ├── github-scanner.ts     # GitHub API 客户端
│   │   └── web-scraper.ts        # 网页内容抓取
│   ├── services/
│   │   ├── scan-service.ts    # 书籍扫描编排
│   │   ├── tag-service.ts     # AI 打标（全部来源）
│   │   ├── note-service.ts    # 笔记 CRUD（全部来源）
│   │   ├── knowledge-service.ts  # 知识库统一编排
│   │   ├── skill-service.ts   # Skill 生成流水线
│   │   ├── source-scanner.ts  # 笔记来源扫描
│   │   ├── file-watcher.ts    # 文件监听
│   │   └── queue-service.ts   # 任务队列
│   ├── views/
│   │   ├── sidebar-view.ts    # 侧边栏
│   │   └── setting-tab.ts     # 设置页
│   ├── utils/                 # 工具函数
│   └── __tests__/             # 测试文件（232 tests）
├── manifest.json
├── LICENSE
└── README.md

❓ 常见问题

Q: 扫描后没有生成笔记？

检查书籍目录是否填写了绝对路径
macOS：Obsidian 首次访问文件目录时会弹窗请求权限，必须点「允许」
只支持 .pdf、.epub、.txt 格式

Q: 书签导入没有反应？

确认已安装 Chrome 浏览器且已登录同步
检查设置中「浏览器书签」→「启用书签导入」是否开启
确认已配置 AI API Key

Q: GitHub 同步失败？

检查 Token 是否有 repo 和 user 权限
经典 Token 选 repo + user，新版 Token 选 Stars: Read-only

Q: AI 分类不生效？

确认 API Key 配置正确且有效
使用 Cmd+P → Test AI connection 验证
未分类的可用 Cmd+P → 重新给未分类书签打标签

Q: 为什么不支持移动端？

插件使用 Node.js fs 模块访问本地文件系统，这些 API 在 Obsidian 移动端不可用。

🙏 致谢

book-to-skill — Skill 生成设计理念
Obsidian Weread Plugin — 微信读书集成参考
obsidian-ibook-plugin — Apple Books 集成参考
pdfjs-dist — PDF 解析引擎
adm-zip — EPUB 解析

☕ 支持作者

如果这个插件对你有帮助，欢迎请我喝杯咖啡 ☕

微信赞赏码

也欢迎在 GitHub 上给项目点个 ⭐ Star！

📜 许可证

本项目采用 Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) 协议。

✅ 允许：个人学习、研究、非商业用途的自由使用、修改、分发
❌ 禁止：未经授权的商业用途
📧 商业授权：如需商业使用，请联系作者获取授权

⬆ 回到顶部

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.