obsidian-releases：Obsidian 发布与插件目录

项目简介

本仓库用于托管 Obsidian 的公开版本发布，同时维护社区插件（community plugins）与主题（themes）两个目录。

需要说明的是，Obsidian 本身并不是开源软件，本仓库不包含 Obsidian 的源代码。如果想为 Obsidian 做贡献，最直接的方式是通过它提供的插件系统，插件开发指南见 https://docs.obsidian.md。

• 项目主页：https://obsidian.md
• 社区与讨论：https://obsidian.md/community

主要功能

• 版本发布托管：存放 Obsidian 客户端的公开发布文件。
• 社区插件目录：插件清单记录在 community-plugins.json 中，其中 name、author、description 三个字段用于搜索。
• 社区主题目录：与插件目录并列，收录社区提交的主题。
• 插件详情拉取：用户打开插件详情页时，Obsidian 会从该插件自己的 GitHub 仓库拉取 manifest.json 与 README.md。
• 版本兼容处理：仓库中的 manifest.json 只用来确定最新版本，实际文件从插件的 GitHub Releases 下载；若 manifest.json 要求的 Obsidian 版本高于当前运行版本，则查询 versions.json 找到兼容的最新版本。
• 插件安装：用户安装插件时，Obsidian 会查找与 manifest.json 中版本号一致的 GitHub release 标签，下载 manifest.json、main.js 以及 styles.css（如果存在），并放入 vault 内的对应目录。

安装与使用

这个仓库面向插件、主题作者以及需要查看发布信息的用户，本身不提供安装命令。

提交自己的插件或主题前，请阅读官方说明：

• 插件提交：https://docs.obsidian.md/Plugins/Releasing/Submit+your+plugin
• 主题提交：https://docs.obsidian.md/Themes/App+themes/Submit+your+theme

全部提交都必须遵守开发者政策：https://docs.obsidian.md/Developer+policies

插件或主题被社区收录后，可以在论坛（https://forum.obsidian.md/c/share-showcase/9）和 Discord 服务器的 #updates 频道公布。正式提交之前，也可以先把可用版本作为公开测试发布，并用 BRAT 插件（https://obsidian.md/plugins?id=obsidian42-brat）方便测试者安装。

注意事项

• 本仓库不接受 issue。插件相关的问题请到插件自己的仓库提交；关于 Obsidian 本体的问题请前往社区 https://obsidian.md/community。
• 作者更新插件时，请保持 GitHub release 标签与 manifest.json 中的版本号一致，否则用户安装时可能找不到对应文件。
• 若插件依赖较新的 Obsidian 版本，记得同步维护 versions.json，以便旧版本用户获得兼容版本。

本作品整理自 GitHub 开源项目 obsidianmd/obsidian-releases，原作者 @obsidianmd。中文介绍由 AI 根据项目 README 整理，以原仓库为准。