夜雨聆风适用场景：别人发给你一个插件压缩包 / 文件夹，需要自己装进 Obsidian 里。
操作系统：Windows / macOS 均适用
···
🔹 前置准备
在开始之前，确保你已经：
✅ 在电脑上安装并打开了 Obsidian
✅ 手里有一个插件文件夹（通常是 .zip 压缩包或已经解压好的文件夹）
· 正确的插件文件夹里面应该有 main.js、manifest.json、style.css 这几个文件
💡 什么是「手动安装」？
Obsidian 有两种装插件的方式：
· 社区市场一键安装（最简单，但需要关闭安全模式 + 开启社区插件市场）
· 手动复制安装（本教程讲的就是这个 —— 别人发你插件包，你自己拷进去）
···
🔹 第一步：关闭「安全模式」
这是必须的第一步，不关的话没法用任何第三方插件。
打开 Obsidian，点击左下角的 ⚙️ 设置图标（齿轮状） 左侧菜单找到「第三方插件」 右侧顶部会看到「安全模式已开启」的提示 点击右侧的「关闭」按钮 ✅
📷 图片1：关闭安全模式界面
⚠️ 关闭安全模式 = 允许运行第三方插件。只要从可靠来源获取插件就没问题。
···
🔹 第二步：找到插件存放的位置
还在「第三方插件」这个页面 往下拉，找到「已安装插件」区域 点击「已安装插件」旁边的 📁 文件夹图标 
📷 图片2：找到文件夹图标
点击后，系统会自动打开一个文件夹窗口 —— 这个就是你的 plugins 文件夹，所有插件都放在这里。
···
🔹 第三步：确认目录结构
打开的文件夹路径应该是类似这样的：
你的库/.obsidian/plugins/
里面可能已经有了一些之前装过的插件文件夹。
📷 图片3：plugins 目录结构
💡 找不到这个文件夹？
· Windows：路径一般是 文档库\你的库名\.obsidian\plugins\
· macOS：路径一般在 ~/Library/Application Support/obsidian/你的库名/.obsidian/plugins/
···
🔹 第四步：把插件放进去 🔑
这是最关键的一步！
如果你拿到的是 .zip 压缩包 → 先解压它 解压后会得到一个文件夹（比如叫 xxxx-plugin 或类似的名称） 确认这个文件夹里的内容是正确的：
xxxx-plugin/
├── main.js ← 必须有
├── manifest.json ← 必须有
├── style.css ← 通常有（有些插件没有也正常）
└── README.md ← 可选
④ 把整个插件文件夹（注意是整个文件夹，不只是里面的文件）复制 / 拖进 plugins 目录下
⚠️ 常见错误提醒：
❌ 不要把插件文件夹塞到另一个插件文件夹里面（嵌套了就不认了）
❌ 不要只把 main.js 单独丢进去，必须是整个文件夹
✅ 正确做法：plugins 下面每个文件夹就是一个插件
完成后你的 plugins 目录看起来应该是这样的：
plugins/
├── emotion-journal/
├── image-converter/
├── obsidian-weread-plugin/
└── 你刚装的插件名/ ← 新加的在这里
├── main.js
├── manifest.json
└── style.css
···
🔹 第五步：启用插件
回到 Obsidian 的 设置 → 第三方插件 → 已安装插件 你应该能在列表中看到刚装的那个插件了 点击插件右边的开关按钮来启用它 ✅ 
📷 图片4：启用插件开关
▸ 如果列表里没看到？
别慌！试试这个：
完全关闭 Obsidian（不是最小化，是要彻底关掉） 重新打开 Obsidian 再回到 设置 → 第三方插件 → 已安装插件 这次应该就能看到了 👀
···
🔹 第六步：配置插件（按需操作）
大部分插件启用后就能用了。但有些插件需要额外设置才能正常工作。
以「鹦鹉效命系统」（AI 插件）为例，启用后你需要：
点击插件名字或右边的 ⚙️ 齿轮图标进入设置页 根据提示填写必要信息，比如：
· AI 服务商选择（如 DeepSeek、OpenAI 等）
· API 地址
· API Key（密钥） ← 这个需要去对应平台申请
③ 保存设置，就可以用了
📷 图片5：插件设置页面
💡 不同插件的设置项不一样，具体看每个插件的说明文档。
···
🔹 总结：六步口诀
① 关闭安全模式→ 设置里先关掉
②点开插件文件夹→ 点那个小文件夹图标
③认准 plugins 目录→ 就在这个位置
④整个文件夹拖进去→ 别拆散、别嵌套
⑤打开开关启用→ 不出现就重启软件
⑥进设置填配置 → 有的要填 API Key
···
🔹 常见问题 Q&A
▸ Q：为什么我的插件装上了但不工作？
A：检查这几点：① 安全模式是否已关闭？② 插件开关是否打开？③ 是否需要额外配置（比如填 API Key）？
▸ Q：从哪里可以下载插件？
A：官方推荐去 Obsidian 社区插件市场（obsidian.md/plugins）浏览和下载。也可以让朋友直接发给你。
▸ Q：手机端能这样装吗？
A：手机端比较麻烦，推荐还是通过社区市场安装。如果一定要手动装，需要用到文件管理 App（如 iOS 的 Files），原理一样 —— 放到 .obsidian/plugins/ 下。
▸ Q：装太多插件会卡吗？
A：适量没问题。建议只装真正在用的插件，不用的及时关闭或删除。
···
希望这份教程对你有帮助！有问题随时问～