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

文章主旨：本文为产品人提供了一套利用GitHub和Obsidian Git插件搭建稳定、免费的skills管理环境的方法，并以kb知识库管理工具为实例，演示了从环境配置到工具使用的完整流程。

关键要点：

1. 使用Watt Toolkit工具解决国内GitHub访问慢或打不开的问题。
2. 通过GitHub Desktop将远程仓库克隆到本地，实现与Obsidian vault的绑定。
3. 配置.gitignore文件，忽略.obsidian/workspace.json等频繁变更的文件，避免同步冲突。
4. Obsidian Git插件需开启“停止编辑后自动提交”“定时拉取”“启动时拉取”等选项，实现双向同步。
5. kb知识库管理工具基于Karpathy的LLM知识库模式，提供初始化、导入、编译、查询、回填、健康检查等子命令。

内容结构：

第0步：解决GitHub访问问题
在国内使用GitHub常遇到打不开或速度慢的问题，推荐安装Watt Toolkit（微软应用商店可搜），勾选GitHub加速即可解决。

第一步：注册GitHub，建一个仓库
在github.com注册账号，新建Repository，建议用英文命名，选择Private或Public按需设置。

第二步：下载GitHub Desktop，克隆仓库
Obsidian Git插件不能直接创建仓库，使用GitHub Desktop将远程仓库克隆到本地。具体步骤：下载GitHub Desktop → 登录 → 点击Clone a repository → 选择刚创建的仓库，设置本地路径 → 用Obsidian打开该文件夹作为vault。

第三步：配置.gitignore
在仓库根目录新建.gitignore文件，写入：.obsidian/workspace.json 和 .obsidian/workspace-mobile.json，避免同步冲突。

第四步：Obsidian Git 插件配置
在Obsidian社区插件中搜索并安装“Git”，进入选项配置：
- Auto commit after stopping file edits：开启（建议5分钟）
- Auto pull interval：开启（建议10-15分钟）
- Pull on startup：开启
配置完成后，实现真正的双向同步：本地笔记通过GitHub中转，多设备登录同一账号即可同步最新内容，丢失可从GitHub重新Clone。

实例：kb — LLM 知识库管理工具
若配置好Git环境，可下载kb知识库管理skills测试（仓库地址：https://github.com/JayWP/wp-kb-vault）。该工具基于Karpathy的LLM Knowledge Base模式，目录结构包括raw/（原始资料）、wiki/（核心概念、来源摘要、对比分析）、output/（分析报告、幻灯片）、index/（索引）。
快速开始命令：
- /kb init：初始化知识库目录结构
- /kb ingest：自动提取raw/目录中的PDF、Excel、Word等文件并登记索引
- /kb compile：LLM读取原料生成结构化wiki文章
- /kb query "你的问题"：生成结构化报告
- /kb file：将查询报告有价值内容回填到wiki
- /kb lint：六项健康检查（断链、孤岛、溯源、一致性、覆盖度、空白发现）
- /kb status：仪表盘展示整体健康度和统计信息
首次使用需安装Python依赖：pip install -r .claude/skills/kb/scripts/requirements.txt，包含PyMuPDF、openpyxl、pandas、pytesseract、python-docx、Pillow等。

文章总结：本文采用分步教程与实例结合的方式，系统讲解了GitHub与Obsidian Git的配置方法，并提供了可实际使用的知识库管理工具，操作性强，适合产品人按步骤实践。

一文看懂华为研发的底层逻辑：数十亿学费总结出“追赶到引领”的研发实践

了解更多

产品人卫朋

查看原文：产品人必备工具：GitHub同步&Obsidian知识库配置指南

文章来源：

产品人卫朋

扫码关注公众号