产品人必备工具:GitHub同步&Obsidian知识库配置指南

kb GitHub 知识库 仓库 wiki
发布于 2026-06-11
1

我们非常重视原创文章,为尊重知识产权并避免潜在的版权问题,我们在此提供文章的摘要供您初步了解。如果您想要查阅更为详尽的内容,访问作者的公众号页面获取完整文章。

扫码阅读
手机扫码阅读

AI时代,对于产品人来说,经常会用到大量的skills去协助工作,这个时候管理工具就很重要。

相比于网盘,Github可以说是管理skills的最佳工具,免费又稳定。

而且管理上也很方便,随时迭代、随时提交和拉取

这篇文章就帮大家解决一下环境配置的问题。


目录:

1. 第0步:先解决 GitHub 访问问题

2. 第一步:注册 GitHub,建一个仓库

3. 第三步:配置 .gitignore

4. 第四步:Obsidian Git 插件配置

5. 实例:kb — LLM WiKi知识库管理工具



第0步:先解决 GitHub 访问问题

在国内用 GitHub,你基本会遇到两种情况:

打不开,或者打开非常慢。

可以安装 Watt Toolkit,微软应用商店直接搜就有。

应用商店地址:https://apps.microsoft.com/

装完勾上 GitHub 加速,一秒直达。

这是第0步。



第一步:注册 GitHub,建一个仓库

github.com 注册账号,新建 Repository,起个名字(别用中文)。

可以选择Private/Public ,看你自己需要。



第二步:下载 GitHub Desktop,克隆仓库

Obsidian Git 插件本身不能创建仓库,可以先用 GitHub Desktop 把远程仓库拉到本地。

如果学过编程,直接使用命令行也可以。

- 去 [desktop.github.com] 下载 GitHub Desktop- 登录账号- 点击「Clone a repository」- 选你刚创建的仓库,路径选一个你记得住的地方- 用 Obsidian 打开这个文件夹作为 vault

这样你的 vault 和 Git 仓库才是真正绑定的。



第三步:配置 .gitignore

这一步很重要,对于一些频繁改动的文件,不需要同步到 GitHub,否则会引起冲突:

.obsidian/workspace.json.obsidian/workspace-mobile.json

在仓库根目录新建一个.gitignore文件,把上面这些写进去。



第四步:Obsidian Git 插件配置

在Obsidian社区插件里搜 "Git",装上。

安装git后,点击选项,然后配置这几个:

1. Auto commit after stopping file edits

    • 开启(建议 5 分钟)

    • 停止编辑后自动提交

2. Auto pull interval

    • 开启(建议 10-15 分钟)

    • 定时拉取最新内容

3. Pull on startup

    • 开启

    • 启动时自动拉取

配置好之后,你得到的是一个真正的双向同步系统。

笔记在本地,GitHub 是中转层,任何设备装了 Obsidian + 登录了同一个 GitHub 账号,打开就是最新内容。

丢了就从 GitHub 重新 Clone 一份就行。



5. 实例:kb — LLM 知识库管理工具

如果大家配置好了git环境,可以将这个仓库的kb知识库管理skills下载下来测试验证。

https://github.com/JayWP/wp-kb-vault

基于 Karpathy 的 LLM Knowledge Base 模式:

    • raw/ 存原始资料;

    • LLM 编译成 wiki/;

    • 索引替代 RAG。


快速开始

1. 初始化知识库

/kb init

在当前目录创建知识库目录结构:

├── raw/ # 原始资料(只读)├── wiki/│   ├── concepts/ # 核心概念│   ├── sources/ # 来源摘要│   └── comparisons/ # 对比分析├── output/│   ├── analysis/ # 分析报告│   └── slides/ # 幻灯片└── index/ # 索引文件

2. 导入文件

将 PDF、Excel、图片、Word 文档放入 raw/ 目录,然后:

/kb ingest

自动提取文本并登记到索引。

3. 编译为 Wiki

/kb compile

LLM 读取原料,生成结构化 wiki 文章。

4. 查询知识库

/kb query "你的问题"

生成结构化报告,包含分析、结论和回填建议。

5. 回填有价值的结果

/kb file

将查询报告中有价值的内容并入 wiki。

6. 健康检查

/kb lint

六项检查:断链、孤岛、溯源、一致性、覆盖度、空白发现。

7. 查看状态

/kb status

仪表盘展示整体健康度和统计信息。


子命令速查

命令 功能 触发词

kb init [目录]	初始化知识库	初始化、创建知识库kb ingest	预处理 raw/ 文件	导入、处理新文件kb compile [文件]	编译为 wiki	编译、更新 wikikb query "<问题>" 查询知识库	查知识库、问知识库kb file [报告]	回填到 wiki	回填、归档kb lint	健康检查	检查、lintkb status	状态仪表盘	状态、看看知识库


Python 依赖

首次使用需要安装依赖:

pip install -r .claude/skills/kb/scripts/requirements.txt

依赖列表:

PyMuPDF — PDF 提取openpyxl — Excel 读取pandas — 数据处理pytesseract — 图片 OCRpython-docx — Word 读取Pillow — 图片处理

产品人卫朋