Obsidian 插件的未来

# Obsidian 插件的未来 来源：https://obsidian.md/blog/future-of-plugins/ 今天，我们很高兴推出 **Obsidian 社区**（https://community.obsidian.md/），这是 Obsidian 插件和主题的新目录及开发者仪表盘。 自 2020 年发布 **Obsidian API**（https://docs.obsidian.md/）以来，我们出色的社区已创建了超过 4,000 个插件和主题。令人惊叹的是，Obsidian 插件的总下载量已突破 1.2 亿次！ 我们的目标是让任何人都能轻松、安全地构建、分发、发现和使用插件及主题。 今天的发布只是更大范围计划的第一步。我们很高兴与大家分享最新变化以及即将推出的功能。 1. 社区网站 2. 开发者仪表盘 3. 自动化审核 4. 插件安全性 5. 团队工具 6. 后续步骤 7. 常见问题解答 ### 社区网站 新的**社区网站**（https://community.obsidian.md/）通过全新的浏览、搜索、筛选和排序方式，让用户能够轻松探索海量的插件和主题。 Obsidian 社区（https://community.obsidian.md/） 您可以在数十个分类中浏览插件，例如**集成**（https://community.obsidian.md/search?type=plugin&categories=integrations）、**基底**（https://community.obsidian.md/search?type=plugin&categories=bases）、**图表**（https://community.obsidian.md/search?type=plugin&categories=charts）以及**更多分类**（https://community.obsidian.md/categories）。您可以按名称、下载量、热度、发布日期和更新日期对项目进行排序。 Obsidian 社区（https://community.obsidian.md/plugins/obsidian-minimal-settings） 每个项目都有独立的详情页，您可以在其中查看截图、详细信息以及安全评分卡。现在新增了针对付费插件和**官方**（https://community.obsidian.md/search?type=plugin&official=1）集成的标签。 作者可以通过赞助选项以及指向其网站和社交媒体的链接来自定义个人资料页面。 ### 开发者仪表盘 Obsidian 社区网站还托管了我们全新的开发者仪表盘。开发者可以在这里提交、管理并跟踪其项目的状态。 所有现有插件、主题以及之前通过 **GitHub**（https://github.com/obsidianmd/obsidian-releases）添加的排队提交项目，均已自动迁移至新站点。 若要认领您的现有项目，请**登录**（https://community.obsidian.md/account/profile）新的社区网站并关联您的 GitHub 账户。这样您就可以管理现有项目、提交新项目以及编辑个人资料页面。 ### 自动化审核 通过此次过渡，我们为所有社区项目引入了自动化审核。新的自动化审核系统会扫描**每一个版本**的安全性和代码质量，而**不仅仅是初始提交版本**。 直到今天，初始提交仍由我们的小团队进行手动审核和批准，以确保其符合**开发者政策**（https://docs.obsidian.md/Developer+policies）。然而，随着 Obsidian 流行度的增长，我们难以跟上提交的节奏，且后续版本并未得到审核。 随着代码代理加速插件的创建，审核队列只会越来越长。我们不认为新提交的 pace 会放缓。借助 **Obsidian CLI**（https://obsidian.md/cli）等工具，创建插件变得更加容易。 现在，当提交插件或主题时，自动化审核系统会验证其是否符合我们的开发者政策、源代码是否遵循最佳实践，以及是否不存在已知漏洞。 基于这一新系统，使我们能够以可扩展的方式审核未来的社区项目。通过不断改善自动化测试的能力，我们更有能力全面提升 Obsidian 生态系统的质量和安全性。 重要的是，**手动审核将继续进行**。新系统使我们能够将精力转移到需要深入检查的插件上，例如热门插件、精选插件以及社区标记的问题。 所有现有的插件和主题均已使用新系统重新审核。在此过程中，我们发现了一些不符合最新指南的旧插件和主题。这些旧项目目前被暂时豁免。但是，所有未能通过新审核流程的插件和主题最终将从官方目录中逐步淘汰。请参阅下方的常见问题解答。 此外……**是的！** 所有排队中的提交均已审核完毕。借助新系统，我们在过去几天内处理了超过 2,300 个排队中的提交。如果您一直在等待我们审核您的插件，请**登录**（https://community.obsidian.md/account/profile）社区网站查看您提交的当前状态。 ### 插件安全性 新的社区网站和自动化审核系统为 Obsidian 生态系统的安全性和稳定性带来了重大增强： - **自动化扫描。** 现在会自动检查每个版本的代码质量和安全漏洞。这包括恶意软件扫描，以检测插件中可能存在的恶意添加内容。开发者可以在开发者仪表盘中查看每个项目的详细建议、警告和失败标记。 - **评分卡。** 用户和开发者可以通过每个项目的评分卡查看自动化检查的状态。随着我们纳入披露信息、隐私标签、产物认证、手动审核结果以及应用功能采用情况，这些评分卡将持续改进。 Obsidian 社区（https://community.obsidian.md/） 在未来几个月内，我们将进一步提高插件及其作者的透明度： - **披露信息。** 插件将声明其访问的内容：网络、文件系统、剪贴板和其他功能。用户将在安装插件前看到这些披露信息。 - **已验证作者。** 将添加针对已通过额外验证步骤且信誉良好的受信任开发者的标签。 作为 Obsidian 社区的一员，您在保持生态系统安全方面发挥着重要作用。用户随时可以直接向 Obsidian 团队**报告安全问题**（https://obsidian.md/help/resources#Report+a+security+issue）。 ### 团队工具 使用 Obsidian 的团队已经可以为其用户**部署安全控制措施**（https://help.obsidian.md/teams/deploy）。在未来几个月内，我们将使团队更容易管理允许使用的社区插件，并向团队成员分发**私有插件**。 发布官方 Obsidian 插件的团队现在可以在社区目录中申请**官方**（https://community.obsidian.md/search?official=1）徽章。如果您的插件符合条件，请**联系我们**（https://discord.com/invite/obsidianmd）。 ### 后续步骤 正如您所看到的，有很多动态变化！除了改进社区目录和自动化审核系统外，我们还将对 Obsidian 应用程序和 API 进行更改，以改善发现和安全机制。 社区生态系统是 Obsidian 最有趣且最强大的方面之一。我们很高兴为其奠定必要的基础，使其继续繁荣发展。 我们非常希望您能探索新的 **Obsidian 社区**（https://community.obsidian.md/）并向我们分享您的反馈！ --- ### 常见问题解答 呼！信息量很大，但您可能还有一些疑问。如果以下问题未解答您的疑惑，请通过**官方 Obsidian Discord 服务器**（https://discord.com/invite/obsidianmd）上的 `#plugin-dev` 和 `#theme-dev` 频道联系我们。 #### 作为用户，这对我有何影响？ 您可以使用新的**社区**（https://community.obsidian.md/）网站来探索插件和主题。如果您之前手动安装了早期访问插件，现在可能不再需要这样做了，因为审核时间已大幅缩短。 #### 我在评分卡中发现了错误。我该怎么办？ 评分卡是全新的，可能存在错误。您可能会发现误报和漏报。如果您发现不准确的地方，请在 **Obsidian Discord 服务器**（https://discord.com/invite/obsidianmd）的 `#plugin-dev` 频道中联系我们。 #### 某个插件的标签或标识（例如官方、付费、免费）不正确。我该怎么办？ 开发者可以使用开发者仪表盘更新项目的标签和定价。只有 Obsidian 工作人员可以更新“官方”标签。如果您发现任何问题，请在 **Obsidian Discord 服务器**（https://discord.com/invite/obsidianmd）上联系我们。 #### 如何提交新的插件或主题？ 该过程比以前显著更简单、更快速： 1. 登录**社区**（https://community.obsidian.md/）网站以访问新的开发者仪表盘。 2. 关联您的 GitHub 账户并选择一个仓库进行提交。 3. 完成仪表盘中的步骤。 4. 提交后，您的项目将立即接受审核。通常，您可以在几分钟内看到审核结果。 5. 如果您的项目通过审核，将在 24 小时内可在应用程序中搜索和下载。 #### 如何认领我现有的插件和主题？ 登录**社区**（https://community.obsidian.md/）网站以访问新的开发者仪表盘。这样您就可以关联您的 GitHub 账户并认领您的插件。登录后，您可以更新标题、描述和截图。 #### 为什么我的项目不出现在目录中？ 如果您的项目在搜索中不出现，很可能是因为存在错误，用户无法下载。请登录社区网站，认领该插件，并解决任何错误。 #### 我是否仍可以在不使用开发者仪表盘的情况下更新我的插件/主题？ 是的。您可以继续通过 GitHub 发布新版本，而无需使用新的开发者仪表盘。新版本会自动接受审核。但是，如果您的更新未能通过审核，您将需要使用开发者仪表盘查看所有详细信息。 #### 不再维护的项目会发生什么？ 我们现有的政策保持不变。在提交插件和主题时，开发者同意继续维护其项目。如果项目不再维护、无法与新版本的 Obsidian 配合使用，且未转让给新所有者，最终将根据**开发者政策**（https://docs.obsidian.md/Developer+policies）从社区目录中移除。 随着我们不断改进发现工具，将更容易找到活跃维护且与 Obsidian 最新功能保持同步的插件。 #### 未能通过自动化审核系统的插件和主题会发生什么？ 所有新插件和主题必须在添加到目录并通过搜索可用之前通过自动化审核。每个新版本都会经过扫描，如果未能通过审核，该插件将在 24 小时内从搜索结果中移除。您可以在发布前使用下文列出的新工具测试更改。 所有先前获批的插件和主题目前仍将可用，即使它们未能通过自动化审核。最终，我们将要求旧插件符合新标准。我们尚未为此设定截止日期，并将与社区开发者密切合作以定义这一过渡期。 #### 我能否在不发布版本的情况下运行自动化审核？ 是的。有两种选择： 1. 使用我们的 **ESLint 插件**（https://github.com/obsidianmd/eslint-plugin）在本地将您的 Obsidian 插件与官方开发者指南进行对比检查。 2. 使用开发者仪表盘在任何分支、标签或提交上运行预览扫描。 #### 我的插件有共同维护者或属于一个组织。我如何授予多个用户在开发者仪表盘中访问该插件的权限？ 目前，只有 GitHub 仓库的所有者才能在 Obsidian 社区中编辑它。如果您拥有该组织的公开成员资格，则可以认领和编辑组织仓库。在近期内，我们将添加对多个协作者的支持。 #### 闭源插件可以添加到新目录中吗？ 目前，我们不接受新的闭源插件进入目录。现有的闭源插件将继续可用，直至另行通知。未来，我们将考虑如何调整新审核系统以适应闭源插件。 #### 开发者仪表盘是否需要 Obsidian 账户？ 是的。您必须拥有 **Obsidian 账户**（https://obsidian.md/account/）才能访问新的开发者仪表盘。 #### 新站点是否必须使用 GitHub？ 目前，是的。未来我们将考虑添加其他软件托管平台。 #### 通过 GitHub 登录时，与 Obsidian 共享了什么信息？ 通过 GitHub 登录会共享您的用户名和公共仓库列表。这仅用于验证您对仓库的所有权。 #### 插件标记为“付费”或具有“可选支付”是什么意思？ Obsidian 社区并非商店，也不提供任何内置的支付解决方案。 开发者可以继续使用外部支付机制，如许可证密钥、API 密钥和登录网关。开发者必须将插件准确标记为以下三个类别之一： - **免费**意味着插件没有任何形式的支付，也不与任何付费服务挂钩。对于*免费*插件，捐赠链接和赞助链接是可以接受的。 - **可选支付**意味着用户可以*选择*付费以解锁额外功能，或者插件连接到付费服务。如果插件连接到付费服务或 API，即使该服务提供免费层级，也必须标记为具有*可选支付*。 - **付费**意味着用户*必须*付费才能使用其主要功能，即使它提供免费试用。 这些标签决定了用户应预期支付多少费用，而不是插件开发者是否收取费用。 #### 如果我在使用新的社区目录和开发者仪表盘时遇到问题，该怎么办？ 我们的团队随时准备提供帮助，以确保一切顺利进行。如果您有任何问题或疑虑，请在 **Obsidian Discord 服务器**（https://discord.gg/obsidianmd）的 `#plugin-dev` 频道中联系我们。