安装教程

选哪种方式

插件市场和 BRAT 都是从 GitHub 下载文件，网络连不上 GitHub 时都会失败。离线包放在本站，国内可以直接下载，文件和插件市场里的完全一样。

方式一：插件市场

装主题：设置 → 外观 → 主题旁边的「管理」→ 搜索 gogoga → 安装并使用。

装插件：

1. 设置 → 第三方插件，关闭「安全模式」（新版 Obsidian 叫「受限模式」）。
2. 点「浏览」，搜索插件名，比如 gogoga Mind Map。
3. 点「安装」，装好后点「启用」。

以后有新版本，在「第三方插件」里点「检查更新」即可。

方式二：离线包

1. 下载

在下载页或插件页下载 zip。想一次装齐，下载 gogoga 合集，里面是主题和所有上架插件。

解压后：

• 单个插件的包里是一个文件夹，名字就是插件 id，比如 gogoga-mindmap/，里面有 main.js、manifest.json，可能还有 styles.css。
• 主题的包里是 gogoga/ 文件夹，里面有 theme.css 和 manifest.json。
• 合集里是 themes/ 和 plugins/ 两个文件夹。

2. 找到库里的 .obsidian 文件夹

库（vault）就是你存笔记的那个文件夹。不确定在哪：在 Obsidian 左侧文件列表里右键任意笔记 →「在访达中显示」（Windows 是「在系统资源管理器中显示」）。

库的根目录里有一个 .obsidian 文件夹，主题和插件都装在这里。它是隐藏文件夹：

• macOS：在访达里按 ⌘ ⇧ . 显示隐藏文件，再按一次隐藏。
• Windows：资源管理器顶部「查看」→「显示」→ 勾选「隐藏的项目」。

3. 放进去

你的库/
└── .obsidian/
    ├── themes/
    │   └── gogoga/              ← 主题文件夹
    │       ├── manifest.json
    │       └── theme.css
    └── plugins/
        ├── gogoga-mindmap/      ← 每个插件一个文件夹
        │   ├── main.js
        │   ├── manifest.json
        │   └── styles.css
        └── gogoga-table/
            └── …

• 没有 themes 或 plugins 文件夹就新建一个，名字全小写。
• 用合集的话，把 themes 和 plugins 拖进 .obsidian，提示同名文件夹时选「合并」。
• 注意别多套一层：正确的是 plugins/gogoga-mindmap/main.js，不是 plugins/gogoga-mindmap/gogoga-mindmap/main.js。

4. 启用

1. 完全退出 Obsidian 再打开（或者在「第三方插件」里点刷新按钮）。
2. 主题：设置 → 外观 → 主题，选择 gogoga。
3. 插件：设置 → 第三方插件，关闭安全模式，在「已安装插件」里逐个打开开关。

手机上安装

最省事的办法是先在电脑上装好，再同步到手机。

• 用 iCloud 存库（iPhone/iPad 常见做法）：电脑上把文件放进 iCloud 里那个库的 .obsidian，等同步完成，在手机上重启 Obsidian 再启用。
• 用 Obsidian Sync：在 设置 → 同步 里打开「已安装的第三方插件」「外观设置」等同步选项，电脑装好后手机会自动拉下来。
• 用 Syncthing、Remotely Save 等工具：确认没有把 .obsidian 排除在同步之外。

只有手机的话：

• iPhone/iPad：「文件」App 不显示以点开头的隐藏文件夹，没法直接放文件，建议用插件市场安装，或者借一台电脑装好后再同步过去。
• Android：用能显示隐藏文件的文件管理器（比如 MT 管理器、Solid Explorer），把解压出的文件夹放进 库/.obsidian/plugins/，再在 Obsidian 里启用。

方式三：BRAT

BRAT 是一个帮你从 GitHub 仓库安装、更新插件的插件，适合没有上架插件市场的插件。它同样需要能访问 GitHub。

1. 在插件市场安装并启用 Obsidian42 - BRAT。
2. 设置 → BRAT →「Add beta plugin」（主题用「Add beta theme」）。
3. 填仓库地址，比如 JackWeiGogoga/gogoga-fav-sync，版本选 Latest，点添加。

怎么更新

• 插件市场装的：在「第三方插件」里点「检查更新」。
• 离线包装的：下载新版 zip，把里面的文件覆盖进原来的文件夹，重启 Obsidian。插件设置保存在同一个文件夹的 data.json 里，离线包不含这个文件，覆盖不会丢设置。
• 已上架插件市场的插件，离线装好后，以后在网络通畅时也能直接从插件市场更新，两种方式可以混用。

校验文件（可选）

下载页和插件页都列出了每个 zip 的 SHA-256，可以核对下载的文件是否完整：

# macOS / Linux
shasum -a 256 gogoga-mindmap-0.61.8.zip

# Windows PowerShell
Get-FileHash gogoga-mindmap-0.61.8.zip