tags:

Obsidian
obsidian-wiki
Codex
AI-Agent title: Obsidian + obsidian-wiki 个人知识库搭建记录

Obsidian + obsidian-wiki 个人知识库搭建记录

目标

搭建一个基于 Obsidian 的个人知识库，用于长期沉淀：

前端开发知识
Java / NestJS / Python
Docker / Nginx / Git
AI / Agent / Skills
电力交易业务知识
项目踩坑记录
日常技术问题解决方案

整体流程：

text
日常项目
 ↓
Codex / Claude Code
 ↓
obsidian-wiki Skills
 ↓
统一知识库
 ↓
Obsidian

一、知识库位置

推荐只维护一个 Vault：

text
D:\knowledge-base\all

所有项目共享：

text
D:\ditanProject
├── electricity-trading-platform
├── power-middleware-system
├── nest-test

统一沉淀：

text
D:\knowledge-base\all

二、安装 obsidian-wiki

初始化：

powershell
obsidian-wiki setup --vault "D:\knowledge-base\all"

作用：

配置个人知识库路径
安装 Agent Skills
连接 Codex / Claude Code

三、Windows WinError 1314

如果出现：

text
OSError: [WinError 1314]
客户端没有所需的特权

原因：

Windows 创建符号链接需要权限。

默认：

text
Skills
 ↓
symlink
 ↓
.codex / .claude

解决：

powershell
obsidian-wiki setup --vault "D:\knowledge-base\all" --copy

--copy：

表示直接复制 Skill 文件，不使用符号链接。

四、安装成功

成功示例：

text
Setup complete!

Skills installed: 37

mode: copy

Vault:
D:\knowledge-base\all

说明：

Skills installed: 37 个技能安装完成
mode: copy 使用复制模式
Vault 配置成功

五、set up my wiki 使用方式

注意：

set up my wiki 不是 PowerShell 命令。

正确流程：

powershell
cd D:\ditanProject\electricity-trading-platform

codex

进入 Codex 后：

text
set up my wiki

作用：

让当前项目接入个人知识库。

六、全局配置和项目接入区别

全局配置

执行：

powershell
obsidian-wiki setup --vault "D:\knowledge-base\all" --copy

作用：

告诉 obsidian-wiki：

我的知识库在哪里。

通常一次即可。

项目接入

Codex 中：

text
set up my wiki

作用：

让当前项目使用统一 Wiki。

结构：

text
Vue项目
Java项目
NestJS项目
电力交易项目

        ↓

D:\knowledge-base\all

七、常用 Skills

/wiki-update

同步知识：

text
/wiki-update

用途：

分析项目
提取重要经验
写入 Obsidian

例如：

Wujie
CORS
Nginx
Vue
ECharts

/wiki-query

查询历史知识：

text
/wiki-query

例如：

text
之前 Wujie 跨域怎么解决？

八、推荐工作流

text
开发遇到问题

↓

Codex / ChatGPT / Claude解决

↓

/wiki-update

↓

保存长期知识

↓

Obsidian查看

不要只记录：

text
今天修复一个Bug

应该沉淀：

text
CORS.md

Wujie.md

Nginx跨域配置.md

九、知识库目录建议

text
D:\knowledge-base\all

├── 前端
│   ├── Vue
│   ├── Pinia
│   ├── ECharts
│   └── 微前端

├── 后端
│   ├── Java
│   ├── NestJS
│   └── Python

├── DevOps
│   ├── Docker
│   ├── Nginx
│   └── Git

├── AI
│   ├── Agent
│   ├── Skills
│   └── MCP

├── 电力交易

└── 项目经验

十、最终架构

text
                 Obsidian

                    |

          D:\knowledge-base\all

                    |

              obsidian-wiki

                    |

        ---------------------

        Codex  Claude  Agent

                    |

 Vue项目 Java项目 NestJS项目 电力项目

核心原则：

一个统一 Vault，多项目共享。
AI 负责整理，人负责使用。
项目经验进入长期知识库。
/wiki-update 负责沉淀。
/wiki-query 负责复用。

目录