AI Knowledge Manager

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

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

---

📖 目录

• 功能特性
• 安装
• 快速开始
• 配置说明
• 功能详解
  • 本地书籍扫描
  • Chrome 书签导入
  • GitHub Stars 同步
  • AI 自动分类打标
  • 微信读书 & Apple Books 集成
  • 一键生成 AI Skill
  • 知识图谱
• 支持的 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 社区插件市场（推荐）

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

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

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

方式三：手动安装

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

---

🚀 快速开始

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

---

⚙️ 配置说明

---

📖 功能详解

本地书籍扫描

支持 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 模型

Token 消耗参考（DeepSeek 定价）：

---

🔧 开发

# 安装依赖
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) 协议。

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

Copyright (c) 2024 cyk111

---

⬆ 回到顶部