产品人必备工具:GitHub同步&Obsidian知识库配置指南
版权声明
我们非常重视原创文章,为尊重知识产权并避免潜在的版权问题,我们在此提供文章的摘要供您初步了解。如果您想要查阅更为详尽的内容,访问作者的公众号页面获取完整文章。
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 — 图片处理
产品人卫朋