新手实战教程:10分钟用obsidian-wiki完成第一次知识摄入、查询与整理
【免费下载链接】obsidian-wikiFramework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents项目地址: https://gitcode.com/gh_mirrors/obs/obsidian-wiki
obsidian-wiki是一个帮你和 AI 智能体共同打造「数字大脑」的开源框架:它把你的文档、聊天记录、笔记编译成互相链接的 Markdown 知识库,并让 AI 帮你持续维护和查询。本教程面向零基础用户,全程 10 分钟,带你完成第一次知识摄入、查询与整理。
它的工作方式很直觉:喂给它任何文本材料 → 它提炼成 wiki 页面 → 你用一句话提问 → 它带引用地回答你。所有知识都是本地纯 Markdown 文件,无运行时、无 API Key,可用 Obsidian 直接打开查看。
第一步:1分钟完成安装(pip 一键安装 obsidian-wiki)
打开终端,执行两条命令:
pip install obsidian-wiki obsidian-wiki setup --vault ~/brain第二条命令做三件事:把~/brain设为你的知识库(vault)路径、写入全局配置、并把全部 39 个 wiki 技能安装到你常用的 AI 智能体(Claude Code、Cursor、Codex、Windsurf 等)。安装后可以用obsidian-wiki doctor做健康检查。
如果你习惯从源码安装,也可以克隆仓库后运行仓库根目录的 setup.sh 脚本,效果完全一致。更多安装方式见 docs/installation.md。
第二步:3分钟完成第一次知识摄入
在你的 AI 智能体里打开任意项目,对它说:"set up my wiki",它会引导你完成初始化。
接下来,把想记住的资料丢给它即可——文档、PDF、聊天导出、会议记录都行:
/wiki-ingest ~/research比如你正在调试一个限流问题,解决后可以随手把结论沉淀下来:
/wiki-capture # 把当前对话保存为 wiki 笔记智能体会自动完成四件事:读取原材料 → 提炼概念与结论 → 合并进已有页面(不产生重复)→ 更新索引与日志。如果你用 setup.sh 的git clone方式安装,还能用/wiki-update把当前代码仓库的架构知识蒸馏进知识库。
💡 网页内容想收藏?可以安装配套的浏览器扩展,把当前网页或选中文字直接存进知识库的
_raw/暂存区,本地优先、内容不上传:
第三步:3分钟学会带引用查询知识库
现在你的"大脑"已经有记忆了。提问时它返回的不是感觉,而是带[[wikilink]]引用的答案:
/wiki-query 我对限流了解什么? /wiki-narrate MCP 安全 # 生成一份带引用的主题简报 /wiki-digest week # 这周我学到了什么?也可以在终端直接问(不走 LLM,走索引检索):
obsidian-wiki query "what do I know about rate limiting?"查询成本几乎不随知识库膨胀:系统先读每页的标题、标签和摘要,再决定是否打开正文——20 页和 2000 页的开销大致相同。
第四步:3分钟整理你的知识库
知识库会自己变乱,obsidian-wiki 提供了一组"清洁工"技能:
/wiki-lint # 找出断链、孤儿页、矛盾内容 /wiki-dedup # 合并同义页面("RSC" 和 "React Server Components" 变一页) /cross-linker # 把未链接的提及织进知识图谱 /wiki-status # 查看摄入进度、待处理项和枢纽页面终端党也可以随时体检:
obsidian-wiki lint # 检查 frontmatter、断链、重复、孤儿页用 Obsidian 打开你的数字大脑
最后一步:用 Obsidian 打开你的 vault 目录(File → Open Vault),按 Cmd/Ctrl+P 打开 Graph View,就能看见知识图谱。说一声"color my graph",还可以按标签或分类给节点上色。整个 vault 只是文件夹里的 Markdown,可 grep、可 diff、可备份,完全属于你。
延伸阅读
| 想深入了解 | 去哪里看 |
|---|---|
| 每个子命令详解 | docs/cli.md |
| 全部 39 个技能与斜杠命令 | docs/skills.md |
| 摄入四阶段与 vault 目录结构 | docs/architecture.md |
| 跨会话记忆面(index / log / hot) | docs/memory.md |
| 核心实现代码 | obsidian_wiki/ |
10 分钟走完"摄入 → 查询 → 整理"闭环后,你的数字大脑就开始自动运转了:每次会话结束它会自动捕捉可复用的结论,下次会话开始时自动注入上下文——你只需要继续喂它知识。🧠
【免费下载链接】obsidian-wikiFramework for AI agents to build and maintain a digital brain through Obsidian wiki | Memory System for Agents项目地址: https://gitcode.com/gh_mirrors/obs/obsidian-wiki
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考