通过个人账户提交插件
这 社区市场 允许任何注册用户发布插件供所有人安装——就像你向应用商店发布应用一样。你填写商店页面的元数据，声明你的插件所需的权限，上传构建文件，并提交审核。该页面一步步讲解了整个过程。
[!NOTE] 此流程用于 社区（第三方） 通过你的提交的插件 个人柜 在 my.aihummer.ru. 第一方 AiHummer 插件自带其管道。社区插件是 免费；你 可以添加一个可选的捐赠链接。
在你开始之前
- A 注册个人账户 — 注册并确认（参见 注册任何客户都可以提交。
- A 已构建的插件 — 使用生成的签名发布压缩包
插件开发工具包 (
aihummer plugin package）。如果你有 还没建一个，先从那里开始。 - 一 图标和至少一个截图，而且你的描述已准备好 两者 俄语和英语.
出版的工作原理（整体概览）
您的提交会通过固定的流程。您可以在每一步通过柜子查看其状态。
| 舞台 | 会发生什么 | 谁表演 |
|---|---|---|
| 草稿 | 您创建条目并填写元数据；目前还没有公开。 | 你 |
| 已提交 | 你把它送去审查。 | 你 |
| 人工智能审查 | 一个自动化代理会检查插件是否符合 审核政策 — 安全性、清单正确性、完整性、内容。 | 自动化 |
| 适度 | 人工审核员会阅读 AI 报告以及你的工件和元数据，然后做出决定。 | AiHummer 团队 |
| 已发布 | 经批准后，该工件将被签署并添加到社区目录和公共市场信息流中。 | AiHummer 团队 |
| 被拒绝 | 如果某件事情失败了，你就会得到原因；修正后重新提交。 | 你 → 返回草稿 |
[!IMPORTANT] 人工智能 从不 自己发布。最终的决定总是由人类做出， 没有他们的批准，任何东西都不能进入目录。
步骤 1 — 打开 «我的插件»
登录到 my.aihummer.ru，打开 «我的插件» 部分，然后点击 «发布» （或 《新插件》）。这会产生一个 草稿 你可以自由编辑直到提交。
第2步 — 填写商店元数据
填写每个字段。不完整的元数据是提交被退回的最常见原因之一。
| 字段 | 输入什么 |
|---|---|
| 姓名（俄语 + 英语） | 插件在两种语言中的显示名称。 |
| 简短描述（俄语 + 英语） | 目录卡的一行。 |
| 完整描述（俄语 + 英语） | 插件的功能、如何使用它、它需要什么。要有意义——不要用作占位符。 |
| 类别 | 从允许的集合中选择一个（例如：频道、生产力、集成、语音、实用工具）。 |
| 版本 | A 语义化版本 字符串，例如 1.0.0. 每次新的提交都必须增加它。 |
| 图标 | 一个有效的正方形图像。 |
| 截图 | 至少一个；展示插件的使用效果。 |
| 许可证 | 插件的许可证（例如 MIT、Apache-2.0）。 |
| 首页 / 仓库 | 可选 https:// 你的项目链接。 |
| 捐赠链接 | 可选。一个有效的 https:// 链接到 a 知名捐赠主持人 ——例如 Boosty、Patreon、PayPal 或 YooMoney。网络钓鱼或任意主机将被拒绝。 |
| 更新日志 (俄语 + 英语) | 此版本有什么变化。 |
[!TIP] 为从未见过你插件的真实用户撰写描述。 “dummies” 正是正确的说法：说明它的作用、何时使用以及它需要什么。
第3步 — 声明功能清单
这 功能清单 是安全模型的核心。它是一个简短的、结构化的声明，关于 你的插件需要的每个权限 ——它与哪些主机通信，它接触哪些文件，它是否运行外部命令，它使用哪些通道和凭据。
为什么要声明它
- 客户会看到所请求的权限 在他们安装之前 并同意 它们，就像移动应用的权限提示一样。
- 该实例使用清单来 限制 插件所声明的内容。
- 审稿人会检查你的 宣布 能力 比赛 什么代码 实际上确实如此。一个请求未声明权限的插件是 被拒绝。
最小权限原则
声明 只有 您的插件真正使用的内容，仅此而已。权限越少意味着审核越快、客户同意越容易，以及安装量更多。如果您不访问文件系统，请声明一个空列表。如果您从不启动进程，请设置 exec 到 false.
格式
能力清单是一个包含以下字段的 JSON 对象：
| 字段 | 类型 | 意义 |
|---|---|---|
network |
字符串数组 | 插件连接的主机名（其出口允许列表）。 |
filesystem |
字符串数组 | 它读取或写入的路径，相对于它自己的插件目录。 |
exec |
布尔 | 它是否会生成外部进程/运行命令。 |
channels |
字符串数组 | 它集成的消息通道（例如 telegram). |
credentials |
字符串数组 | 使用的命名秘密/配置键（绝不包含秘密值）。 |
description |
字符串 | 它所需要的以及原因的简短、易于理解的总结。 |
示例：
{
"network": ["api.example.com", "cdn.example.com"],
"filesystem": ["./cache"],
"exec": false,
"channels": ["telegram"],
"credentials": ["api_token"],
"description": "Calls the Example API to sync tasks and posts replies to Telegram. Caches responses under its own ./cache directory. No process spawning, no other hosts."
}[!WARNING] 做 不 不要把真实的秘密、令牌或密钥放在任何地方——不要放在清单文件中，也不要 在元数据中，而不是在工件中。声明凭据 仅凭名字 （例如
api_token客户在安装时提供实际值。硬编码 秘密会被自动拒绝。
第4步 — 上传构件
上传您的插件构建：
- 格式： 一
.tar.gz由…生成的发布压缩包aihummer plugin package. - 它必须包含插件的
manifest.json（SDK 清单 — 类型， 版本，入口点，声明capabilities，配置字段）。 - 你在第3步填写的功能清单必须是 一致的 用什么
代码和
manifest.json实际上做
你也附上了 图标 和 截图 如果你还没有的话，可以在这里。
[!TIP] 跑
aihummer plugin validate在上传之前本地验证。验证合同 是市场使用的相同版本，所以在本地通过的清单也会 这里也接受。
步骤5 — 发送审核
当每个字段都填写完毕并上传了文物后，点击 提交审核. 内阁首先进行完整性检查；如果有缺失，它会准确告诉你缺少的内容。一旦被接受，状态将变为 已提交 然后 人工智能审查 — 你不需要做其他任何事情。
第六步 — 跟踪状态并阅读判决
打开插件于 «我的插件» 以跟踪其状态。当审核完成时，您将看到以下之一：
- 适度 ——自动审核通过或仅标记了少量问题；一个 人类现在正在看它。等一下。
- 被拒绝 — 某些操作失败了。你将看到一个 裁决、摘要，以及 未通过的具体项目 （附上每个的原因）。这是你的 修复列表。
- 已发布 — 已批准、已签署并已上线。您的插件现在出现在 AiHummer 市场 并安装到任何实例中 已启用社区目录。
如何阅读拒稿并重新提交
- 打开插件；阅读 失败的项目 以及他们的理由。
- 修复它们——大多数都是以下之一：缺失/弱的描述，能力不匹配 清单、硬编码的密钥、错误的捐赠链接，或一个你没有的版本 增加
- 编辑元数据和/或上传一个 带有递增版本的新工件.
- 点击 提交审核 再次。它会通过同样的流程返回。
[!NOTE] 拒绝不是惩罚——它是一份清单。 审核政策 正因为如此它是公开的 可以满足每一个要求 之前 你提交。