Obsidian+Claude Code打造本地AI知识库
Claudian + Obsidian Skills
1. 核心组件
- Claudian: Obsidian 第三方插件（暂未上架官方市场），适配 Claude Code。
- Obsidian Skills: 由 Obsidian CEO (Kepano) 发布的 Skill 包，赋予 AI 处理 Canvas、Markdown 及数据库的能力。
2. 环境部署流程
2.1 安装 Claudian 插件 (手动旁加载)
- 获取文件: 访问 GitHub 仓库
claudian，下载以下三个核心文件：main.jsmanifest.jsonstyles.css
- 放置插件:
- 进入 Obsidian 仓库根目录。
- 路径导航:
.obsidian->plugins。 - 新建文件夹命名为
claudian。 - 将上述三个文件放入该文件夹。
- 启用: 重启 Obsidian，在“第三方插件”中开启 Claudian。
2.2 配置模型参数
- 打开 Claudian 设置页。
- 基础设置: 设置
User Name(如 Jason)。 - 自定义AI模型: 使用智谱GLM或DeepSeek来替换Claude模型。
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic ANTHROPIC_API_KEY=你的智谱api key ANTHROPIC_DEFAULT_OPUS_MODEL=GLM-5.0 我今天试了一下新发布的glm5，竟然把我代码里藏了好多天的bug改掉了，感觉还是挺厉害的。
- 连通性验证:
Ctrl/Cmd + P调出命令面板 -> 输入claudian-> 选择Open chat view。- 发送“你好”，若回复正常则配置成功。
2.3 部署 Obsidian Skills
- 下载: 访问 GitHub 仓库
kepano/obsidian-skills，下载 ZIP 包并解压。 - 安装:
- 复制解压后的
skills文件夹。 - 进入 Obsidian 仓库根目录。
- 进入或新建
.claude隐藏文件夹。 - 粘贴
skills文件夹 (最终路径:[Vault Root]/.claude/skills/)。
- 复制解压后的
- 验证: 在 Claudian 对话框输入
/skills，应显示以下三个 Skill:obsidian-markdown: 处理专有 Markdown 语法。json-canvas: 生成/编辑无限画布。obsidian-bases: 数据库管理。
这里其实就跟添加skills的思路是一样的，只是取决于你想要只装在obsidian里面还是全局skills
3. 实战应用与技巧
3.1 典型用例：生成知识图谱
- 指令: “使用无限画布 canvas 画出地中海饮食的知识结构图，并保存到根目录。”
- 流程: AI 自动调用
json-canvasskill -> 分析逻辑 -> 在根目录直接生成.canvas文件。
3.2 优化
由于 Skill 定义为英文，中文指令可能导致匹配偏差，建议方案：
- 显式指令: 在 Prompt 中明确指定工具名 (如“请使用 json-canvas skill…”)。
- 系统提示词 (System Prompt): 在插件设置中添加规则 —— “收到指令后优先思考并匹配最合适的 Skill”。
4. 为什么obsidian不做agent
- 官方态度 (Stephan Ango/Kepano):
- 发布渠道: 选择在个人 GitHub 账号而非 Obsidian 官方账号发布，体现了 “非官方强制” 的定位。
- 核心哲学: 知行合一。坚持 Local-first 和 Privacy-first，不构建封闭的官方 AI 环境，也不参与 AI 军备竞赛。
- 差异化优势:
- 不同于 Notion 的云端封闭生态。
- Obsidian 文件完全本地化，鼓励用户基于隐私安全，“手搓”适合自己的 AI Agent。
