「本文参加年度征文活动 #TeamCarbon25赛道」

大家好，这里是前往北极星的路。这里给大家介绍下我最近如何使用AI进行obsidian的个人插件开发的教程吧。本文将手把手教你如何使用AI进行obsidian插件开发

相信大家在刚入手obsidian前，会听说或者了解过它那丰富的插件生态。然后在接触后，会发现面对这么多的插件会一脸懵逼和无从下手。会想着“这么多插件，我该使用哪个插件呢？”。然后随着时间和自己投入的精力，在经过漫长的学习各插件的功能使用后，能很熟练的去使用它们。这时候会想着“这些插件已经熟悉了，但就是有些地方用着不顺手，跟自己的工作流不搭”。于是你再次扎进插件市场， 希望这次能找到‘那个对的插件’——结果往往只是重复之前的循环。

终于有一天，你忍无可忍：“要是我能自己开发一个插件就好了！”于是开始学习代码——结果往往是从入坑到放弃。相信很多自学代码开发的人都深有体会。

正文

现在随着AI模型能力的提升，我相信大家也或多或少的接触了市面上那么多AI模型，那除了使用AI进行对话、笔记整理外，为什么不试试让AI进行插件的开发呢？让AI根据个人的工作流进行完全适配化的开发。

第一步：从“要是能...就好了”开始

想要梳理自身工作流，我的做法是先用“场景法”捕捉灵感火花（比如“要是能一键生成周报就好了”），再用“流程法”拆解该场景涉及的操作步骤（打开笔记→筛选任务→格式化输出），从而形成可执行的开发需求。

场景法——捕捉“啊哈时刻”

“场景法”就是记录自己内心的想法是“要是能从xxx做到xxx就好了”的发生场景、或者想象自己使用obsidian时，在某个界面下，通过某个神奇按钮，一按下就把这界面的xxx变成了xxx。一般来说，这些场景就是自己真正想要实现的需求。

流程法——绘制操作地图

想要进行AI的插件开发，那就需要先明确自己想要AI开发的插件是要满足什么？即先明确自己想要这个插件来做什么动作？明确自身工作流，那就需要自己去回顾自己在obsidian上的使用场景、以及场景下的各步骤顺序：

1. 为了避免其他插件的干扰，我们可以先关闭obsidian里所有的第三方插件
2. 然后我们打开思维脑图工具开始梳理工作流。一边回想，一边在脑图上记录。
3. 从打开obsidian开始，自己最经常做的步骤是哪些？做了这一步后，下一步是什么？我做这每一步的目的是什么？

经过这样的梳理绘制，我们就能得到一个流程图：

看懂obsidian插件四件套

接下来就是简单介绍下obsidian的插件基础说明。相信大家在使用插件时，有大概了解过插件存放路径及路径下有哪些文件。

• main.js ：插件的主要功能逻辑代码都在这里，这里也是需要让AI进行代码开发的主要文件。插件必需文件之一。
• manifest.json：插件的“身份证文件”，里面包括版本号、作者、GitHub路径等。有了它才能在obsidian第三方插件界面里找到对应的插件。插件必需文件之二。
• styles.css：插件相关UI都在这里。如果有UI界面需求，可把UI相关代码都保存这里，让main.js只负责逻辑部分。
• data.json：记录插件运行时相关配置项等都在这里。如果插件有设置项等保存需求可放在该文件下。

以上所有文件即使不懂代码，也无需理解全部内容。我们可以按照AI的指示去修改对应部分，或者直接让它输出完整内容，我们复制粘贴即可。

实践开始

市面上AI模型很多，我们根据自己的情况灵活选择国内和国外的模型，可使用支持代码生成的AI工具，如 GitHub Copilot、Claude 或 Qwen-Max 等，通过网页端或本地IDE插件调用。其中我们直接使用网页端是最简单的方法。如果插件场景少，需求不复杂，可直接让它生成main.js的所有代码，然后自己复制粘贴到文件中并保存，最后再在obsidian上验证效果即可。

准备工作，快速搭建好插件环境

先把自己想要的插件文件环境都配置好，你可以直接复制任意一个插件文件夹并重命名成自己喜欢的名字。比如我这里复制一个插件文件夹，并重命名为你好：

然后再用记事本方式打开manifest.json文件，修改它里面的id、name等信息并保存。

这样就可以在obsidian第三方插件界面刷新并看到插件显示了

最后再删除main.js文件后，重新创建一个同名文件，并记得使用记事本方式打开等待代码复制粘贴过来。

开始指挥AI干活

输出提示词

打开任意AI网页端，我这里选择的是千问的qwen3-max-thinking，先输出提示词需求给AI

以下是我使用的AI提示词，可供大家参考

## 背景
你是一位融合五重身份的专家：资深 Obsidian 插件架构师、TypeScript 专家、前端性能优化工程师、资深测试工程师、资深产品经理。你的任务是帮助用户安全地开发其 Obsidian 插件代码。

## 核心原则（必须严格遵守）
1. **零发散**：温度=0，只基于用户提供的确切代码和指令响应。
2. **完整性保障**：任何修改不得省略、删除或意外破坏原有功能；必须显式分析对其他模块的影响。
3. **交互控制**：在用户明确说出“输出完整代码”之前，你只能进行方案讨论、建议和确认，**绝不可输出任何完整代码文件**。
4. **上下文记忆**：用户会先提供目录结构，再逐个上传文件。你必须记住所有已提供的文件内容及结构，用于跨文件影响分析。
5. **节约**：输出的代码里不要带任何注释。

说明需求

输出提示词后，我们就可以正式输出自己的想法和场景了，在网页端，记得让它直接输出main.js完整代码便于我们直接复制。

复制粘贴代码到创建的main.js里并保存

调试验证

重新加载插件后，可以看到侧边栏有一个新的icon图标出现，点击后就会弹出我们刚才让AI实现的功能。

异常处理

如果保存后重新加载下插件，发现提示插件无法加载，这时候就需要去确认问题出现在哪。我们可以在obsidian里按快捷键ctrl+shift+i打开控制台界面，选择Console标签，然后复制报错信息给到AI，让AI自身去DEBUG代码，我们再把代码复制粘贴回main.js里重新运行验证即可。

结语

看！这就是我们使用AI开发的插件就诞生并运行起来了，整个过程中，我们没有写一行代码。后续只需要经过这样一轮又一轮的循环调试，我们的插件功能就会越来越丰富，越来越适配我们自己的工作流。

以上只是一个简单的插件开发实践过程。实际运用中，我们可以根据我们的使用过程去逐渐增加自己想要的功能和UI，从而完整适配自己的工作流。

最后，大家快去试试用AI开发只属于你的第一款obsidian插件吧。从而让你在知识管理的路上不再被工具所困扰，更加专注与记录上。