夜雨聆风作为obsidian的笔记使用者，你是否也曾被Obsidian的某个小功能卡住过？想加个自定义功能，却懒得从头搭环境、写TypeScript？2026年，AI已经把这件事的门槛大幅降低——用各种大模型即可，我最近只花了不到1小时，就从0做出一个可用的插件。
今天这篇手把手教你如何用AI开发Obsidian插件，适合有一定编程基础、想提升效率或做副业开源的开发者。
一、为什么现在是开发Obsidian插件的好时机？
Obsidian社区插件已超2700个，但垂直痛点依然很多（尤其是AI集成、生产力自动化、中文优化）。 AI coding工具成熟：Cursor（基于Claude的IDE）和Claude Code能理解整个项目结构，大幅减少调试时间。 插件上架后，容易获得曝光和Star，积累个人IP。
二、准备工作（10分钟搞定）
- 安装Obsidian
（最新版） - 准备开发环境
Node.js（推荐18+） git VS Code 或 Cursor（强烈推荐后者） - 创建插件模板
打开终端，复制官方插件模板：
shell git clone https://github.com/obsidianmd/obsidian-sample-plugin.git my-plugin
或者直接复制一个现有插件文件夹，修改 manifest.json中的id、name、version。
manifest.json 核心字段示例：
json {
"id":"ai-assistant-plugin",
"name":"AI助手插件",
"version":"0.0.1",
"minAppVersion":"1.0.0",
"description":"用AI增强Obsidian笔记体验",
"author":"你的名字",
"isDesktopOnly":false
}
三、核心流程：让AI帮你写插件（重点）
推荐组合：Cursor（主力编辑器） + Claude（深度思考）
实战步骤：
在Cursor中打开插件项目
Cursor自带强大RAG能力，能读取整个文件夹。
写好系统提示（System Prompt）
这步最重要！给AI清晰角色：
plain 你现在是一个有3年Obsidian插件开发经验的TypeScript专家。
项目使用Obsidian Plugin API（最新版）。
严格遵守官方最佳实践：使用registerEvent、addCommand、addRibbonIcon等。
代码要简洁、可读性强，并添加中文注释。明确插件需求（举例：做一个“选中文字AI总结”插件） 告诉AI：
功能：右键菜单或命令面板，选中文字后调用AI生成总结，插入当前笔记。 技术要求：支持本地Ollama或Claude/GPT API，可配置。 界面：用Obsidian的Modal或SettingTab。 让AI生成代码
Cursor中选中文件或用Chat模式输入需求，它会自动创建/修改main.ts、styles.css等文件。常见命令示例：
“帮我实现一个Command：一键生成笔记大纲” “修复这个registerEvent的内存泄漏问题” “添加设置面板，支持API Key配置”
测试与迭代
把插件文件夹放到 .obsidian/plugins/下在Obsidian中启用插件 → 重新加载 遇到报错直接复制给AI：“修复这个错误：xxx”
四、避坑经验（血泪总结）
- API调用
：不要在主线程阻塞，用 requestUrl或异步处理。 - 权限
：manifest.json里声明需要的 permissions。 - 移动端兼容
：如果要做移动端，注意 isDesktopOnly: false并测试。 - 性能
：大模型调用要加Loading提示和错误处理。 - 安全
：不要硬编码API Key，用Obsidian的data.json存储加密配置。 - 调试
: 当出现问题时候，打开ob控制台（ctrl+shift+I)将报错信息告诉AI，AI会帮助你处理。
五、推荐进阶方向
集成Smart Connections或本地embedding。 开发AI Agent插件（结合MCP Tools）。 做中文优化插件（如智能标签、双链建议）——这块竞争相对小。
做完后，建议上传到GitHub，提交Obsidian社区插件审核。第一个插件可能简单，但积累经验后，速度会越来越快。
你最近想用Obsidian实现什么自动化功能？
在AI时代，开发自己的小工具成本变得越来越低，你和别人拉开差距最本质的地方就是你永远都在思考，而别人已经行动起来了。
AI时代执行力是拉开差距最大的因素。
