60秒从0到1obsidian-wiki数字大脑安装全攻略4种方式避坑详解【免费下载链接】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-wikiobsidian-wiki 是一款让 AI Agent 替你构建并维护数字大脑的开源框架它把文档、聊天记录、会议纪要编译成互相链接的 Markdown 知识库并在每次会话自动注入记忆、结束前捕获要点。本文提供 obsidian-wiki 安装的 4 种完整方式pip / AI 代装 / 源码克隆 / Skills CLI外加新手最容易踩的坑与一键体检命令帮你 60 秒完成数字大脑安装。安装前 30 秒obsidian-wiki 是什么一句话理解你的第二大脑AI Agent 是它的园丁。它没有运行时、不需要 API Key所有技能都是任何 Agent 都能读取的 Markdown 文件兼容 Claude Code、Cursor、Codex、Windsurf、Gemini CLI 等主流工具。核心特性速览编译而非堆积新知识自动合并进已有页面矛盾会被标记答案带引用查询返回[[wikilink]]出处而不是凭感觉纯本地全是磁盘上的 Markdown可 grep、可 diff、可私有化⚡会话间记忆开场自动注入你是谁、哪些线索未结收尾自动捕获可复用内容官方入口见 SETUP.md完整安装文档见 docs/installation.md。四种安装方式怎么选一张表决策方式最适合谁写全局配置装到所有 Agent① pip / uv / pipx ⭐推荐大多数人✅✅② 让 AI Agent 代装不想碰终端✅✅③ git clone setup.sh贡献者、想改源码✅✅④ Skills CLI已弃用只要单个 Agent 的局部安装❌❌四条路殊途同归vault 路径写入全局配置~/.config/obsidian-wiki/config技能对 Agent 可见并生成写作风格档案~/.config/obsidian-wiki/WRITING.md重跑 setup 不会覆盖已有档案。方式一pip 安装 obsidian-wiki60 秒最快路径推荐所有人走这条路两条命令搞定pip install obsidian-wiki obsidian-wiki setup --vault ~/brain--vault后的路径就是数字大脑的家新文件夹或已有 Obsidian 库都行已用uv/pipx的话uv tool install obsidian-wiki或pipx install obsidian-wiki效果相同省略--vault会交互式询问也可以稍后在~/.config/obsidian-wiki/config里补常用参数obsidian-wiki setup --project . # 顺带为当前仓库写入项目级技能 obsidian-wiki setup --no-hooks # 跳过会话钩子注册升级用uv tool upgrade obsidian-wiki或pipx upgrade obsidian-wiki升级后记得重跑一次obsidian-wiki setup以拉取新增技能技能以符号链接指向已安装包全局生效。方式二让 AI Agent 替你装零终端方案不想打开终端把仓库地址丢给你的 Agent说一句set up my wiki给我的 wiki 做初始化即可https://gitcode.com/gh_mirrors/obs/obsidian-wiki — set up my wikiAgent 会读取仓库里的.skills/wiki-setup/SKILL.md技能文件询问 vault 存放位置然后完成全套初始化目录结构、索引、日志、Obsidian 配置、可选的自动捕获钩子——这个技能本身就是安装向导。任何能读文件的 AgentClaude Code、Cursor、Windsurf、Codex、Gemini CLI、Kiro 等都能执行各 Agent 的手动对照见 docs/agents.md。方式三git clone 源码安装贡献者路线git clone https://gitcode.com/gh_mirrors/obs/obsidian-wiki cd obsidian-wiki bash setup.shsetup.sh 与obsidian-wiki setup共享同一套实现结果完全一致。它额外完成写入全局配置vault 路径 仓库位置把wiki-update、wiki-query、wiki-context-pack全局链接到 Claude Code为 Gemini、Codex、Hermes、Copilot CLI、Trae、Kiro、Pi 等十来个 Agent 建立全局技能链接在当前仓库生成项目级.claude/skills/、.cursor/skills/等目录和常开规则文件CLAUDE.md、AGENTS.md需要本地私有配置时把.env.example复制为.env并设置OBSIDIAN_VAULT_PATH就近的.env优先于全局配置详见 docs/configuration.md。方式四Skills CLI 局部安装已弃用谨慎选择npx skills add Ar9av/obsidian-wiki⚠️ 这条路径只把 Markdown 技能装进当前 Agent不写全局配置、不配 GitHub 同步、不做多 Agent 引导。除非你明确想要单 Agent 局部安装 自己管配置否则请直接用 pip 或 git clone。安装验证doctor 一键体检装完第一件事跑健康检查obsidian-wiki doctor # 加 --json 可输出机器可读格式 obsidian-wiki info # 查看解析后的实际路径doctor能揪出断掉的 setup、过期安装、vault 状态异常、钩子未注册。看到全绿再用 Agent 说 set up my wiki 收尾或直接给数字大脑喂第一份资料/wiki-ingest ~/research。全部 39 个技能见 docs/skills.mdCLI 子命令全集见 docs/cli.md。避坑详解新手最常踩的 4 个坑坑 1别用uvx obsidian-wiki setup⚠️ 头号陷阱uvx在一次性环境里运行而 setup 是把技能符号链接到已安装包。环境一销毁~/.claude/skills/等所有链接全部悬空。实在要用uvx请加--copy改为复制文件uvx obsidian-wiki setup --copy坑 2旧版本配置目录~/.obsidian-wiki老版本的全局配置在~/.obsidian-wiki。升级后该路径依然被识别不用手动搬家。但如果你接手的是记忆写入器诞生前的旧 vault先跑一次迁移预演——它会先写带时间戳的备份到_archives/确认无误再加--apply坑 3忘了重跑 setup 就以为升级生效pip install -U只会更新包本体新增技能需要重跑obsidian-wiki setup才会出现在 Agent 的技能目录里。坑 4会话钩子静默缺失setup 默认注册两个 Claude Code 钩子会话开始注入记忆、会话结束捕获要点。若跳过了--no-hooksvault、CLI、MCP 都正常只是开场无人报数。随时可补救obsidian-wiki hooks status # 确认钩子能触达安装包 obsidian-wiki hooks install # 之后补装装完之后多 Vault 与浏览器扩展彩蛋工作 / 研究分开记/wiki-switch new work创建命名配置任何请求里用work前缀路由到指定 vault只影响当前请求不改默认work update wiki wiki-query personal 我对 MCP 安全知道些什么另外还有个 Chrome 扩展把网页或选中文字直接存进 vault 的_raw/目录本地优先、内容不上传之后/wiki-ingest promote my raw pages一键转正。扩展细节见 docs/browser-extension.md。写在最后60 秒安装只是开始。你的数字大脑现在是一个纯 Markdown 文件夹——用 Obsidian 打开看图谱、推到私有仓库做备份、用obsidian-wiki sessions-query 那个重试循环的鉴权 bug找回说不清名字的历史会话都是顺手的事。想深入原理读 docs/architecture.md 与 docs/memory.mdCLI 与 Python 接口的实现分别在 obsidian_wiki/cli.py 和 obsidian_wiki/memory.py源码就在旁边随时可查。【免费下载链接】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），仅供参考
