hashgraph-online/awesome-ai-plugins · 上手攻略

• 仓库：hashgraph-online/awesome-ai-plugins
• 链接：https://github.com/hashgraph-online/awesome-ai-plugins
• 分类：ai
• 作者：Tom
• 更新：2026-10-27

§0 三证自检

⚠️ 版本说明：plugin-scanner / hol-guard 当前 PyPI 版本为 3.57.0（2026-10-27 查询），pipx run 会拉取该版本。README 中引用的 CI action 为 hashgraph-online/ai-plugin-scanner-action@v1。

这是什么

这是一个跨 AI 助手的插件/技能目录，由 Hashgraph Online（HEDERA 相关的开源组织）维护。名字里虽然写着 "awesome"（awesome-list 风格），但它已经不是一个纯 markdown 清单了——它背后有一整套机器可读的注册表、扫描器和信任评分体系。

它解决的问题很具体：AI 编程助手的插件生态正在碎片化。Claude Code 有自己的 skill 格式，Codex 有自己的 plugin manifest，Grok 有 .grok-plugin/，Kimi 有 kimi.plugin.json，DeepSeek Harness 有 Cordis 模块，OpenCode 又有自己一套。用户要装东西，得在六个不同的 GitHub 搜索框里分别翻。这个仓库试图提供一个入口。

规模上：README 里有约 974 个列表条目，plugins.json 中 total = 1035（含 README 之外的条目），覆盖 9 类生态：codex、grok、agent-skills、claude-code、standalone、mcp、kimi、deepseek-harness、opencode。

解决什么问题

• 发现：一个目录看全所有主流 AI 助手的可装扩展，按 Agent Skills / Development & Workflow / Tools & Integrations / Grok Plugins / Kimi Plugins / DeepSeek Harness Plugins / OpenCode Plugins / ZCode Plugins & Localization 分区。
• 安全：接入 HOL Guard 的 plugin-scanner，给每个插件打六维信任分。
• 可自动化：提供 plugins.json 和 .agents/plugins/marketplace.json 两份机器可读导出，registry 和 CI 可以直接消费。

六维信任分的维度是（README 原文）：

• Installability — 能否无错误安装运行
• Maintenance — 仓库是否活跃维护、文档是否清晰
• MCP Posture — MCP server 配置是否安全
• Plugin Security — manifest 是否遵循安全最佳实践
• Provenance — 发布者身份能否验证
• Publisher Quality — 发布者是否有高质量发布记录

快速安装

这个仓库本身不需要安装，它是目录。但它配套的扫描器需要：

# 方式一：pipx 直接跑（推荐，README 明确给出的 preflight 方式）
pipx run plugin-scanner lint .
pipx run plugin-scanner verify .

# 方式二：常驻安装
pipx install hol-guard && hol-guard init

plugin-scanner 与 hol-guard 是同版本发布的（当前 3.57.0），requires Python >=3.10。

如果你是使用者而不是作者，正确的姿势是：到 HOL Plugin Registry 搜索，或者直接读 plugins.json 筛选：

# 拉下机器可读目录
curl -sL https://raw.githubusercontent.com/hashgraph-online/awesome-ai-plugins/main/plugins.json -o plugins.json

# 只看 MCP 类插件
python3 -c "
import json
d=json.load(open('plugins.json'))
for p in d['plugins']:
    if 'mcp' in p.get('ecosystems',[]):
        print(p['name'], '->', p['url'])
" | head -30

核心用法

用法 1：安装各客户端的插件

Codex 系（.codex-plugin/plugin.json）

my-plugin/
├── .codex-plugin/
│   └── plugin.json          # 必需：name, version, description, skills path
├── skills/
│   └── my-skill/
│       ├── SKILL.md          # 必需：技能指令 + 元数据
│       ├── scripts/          # 可选：可执行脚本
│       └── references/       # 可选：文档与模板
├── apps/                     # 可选：app 集成
└── mcp.json                  # 可选：MCP server 配置

用内置 skill 脚手架：$plugin-creator

Grok 系（.grok-plugin/plugin.json，可选）

grok plugin install owner/repo --trust

Kimi 系

/plugins install https://github.com/owner/repo

Kimi Code 当前用 kimi.plugin.json；早期包可能是 .kimi-plugin/plugin.json 或裸 plugin.json——跟随目标仓库的 manifest 走。

DeepSeek Harness 系（Cordis apply 函数，不需要 .codex-plugin/plugin.json）

import type { Context } from '@deepseek-ai/cordis'

export const name = 'my-plugin'

export function apply(ctx: Context) {
  // 用 ctx 注册服务、工具或 UI 贡献
}

dsh plugin add <npm-package-or-github-spec>

用法 2：加 CI 安全门（作者必做）

README 明确指出：没有 scanner CI 的项目仍可收录，但信任分会被扣 10%。

- uses: hashgraph-online/ai-plugin-scanner-action@v1
  with:
    plugin_dir: "."
    fail_on_severity: high

用法 3：认领你的插件 + 打信任徽章

认领（只读授权 GitHub，无写权限）：

1. 打开 hol.org/guard/plugins，用 GitHub 登录
2. 找到你的插件，点 Verify Ownership
3. 授权只读连接（profile、email、公开组织成员关系）
4. 通过后条目显示 Verified 徽章

信任徽章（替换 OWNER%2FREPO 为 URL 编码的 owner/repo）：

[![Plugin Name on HOL Registry (Trust Score)](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fplugin%3Fslug%3DOWNER%252FREPO%26metric%3Dtrust%26style%3Dfor-the-badge%26label%3DPlugin+Name)](https://hol.org/registry/plugins/OWNER%2FREPO)

可用 metric：trust、security；可用 style：flat、flat-square、plastic、for-the-badge、social。

HOL Guard 保护徽章：

pipx install hol-guard && hol-guard init

[![HOL Guard](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fguard%2FOWNER%2FREPO%3Fstyle%3Dflat-square)](https://hol.org/guard)

典型适用场景

1. 给 AI 编程助手找现成能力：想做记忆管理、截图验证、UI 审计、提交规范、文档写作，先在这里搜 Agent Skills 区。
2. 给自己的技能做发布前自检：plugin-scanner lint . + verify . 作为本地 preflight，比直接发布安全得多。
3. CI 集成做持续安全扫描：接入 scanner action，拿 SARIF findings 进 code scanning。
4. 跨客户端分发：一个项目同时做 Agent Skills 主体 + Codex/Grok/Kimi 三个适配层，这个仓库给了每种 manifest 的骨架模板。
5. 给团队做依赖白名单：从 plugins.json 导出信任分，做内部准入清单。

坑与注意

1. 这是目录不是安装器（现象：README 明确写 "This repository is a discovery catalog, not a universal installer"。影响：期待 git clone 后一条命令装好所有东西的会扑空。修复：每个插件按其自己的 README 走安装流程）。
2. 条目数量 ≠ 可直接安装数量（现象：plugins.json 里有 install_url 字段，但 README 自己声明生成 JSON "are not a promise that every entry can be installed directly from this repository"。影响：脚本化批量安装会失败。修复：把 install_url 存在的条目当候选，实际安装前先探活）。
3. 信任分不是安全保证（现象：README 原文 "Scan ≠ safety guarantee. Catalog plugin count is not the Registry Broker agent catalog. HOL publishes it; not independent validation."。影响：把高分当安全背书。修复：高分只当"先看一眼"的排序信号，源码仍要自己审）。
4. HOL 与本仓库是同一利益主体（现象：目录、注册表、扫描器、信任分、数据集全部出自 hashgraph-online 组织。影响：不存在第三方交叉验证，评分口径自证。修复：交叉检查贡献者构成和 PR 审阅情况，别把它当独立审计报告）。
5. Kimi manifest 有三个变体（现象：kimi.plugin.json / .kimi-plugin/plugin.json / plugin.json。影响：脚本写死路径会漏。修复：以目标仓库 README 为准，别猜）。
6. DeepSeek Harness 是完全不同的编程模型（现象：需要导出 Cordis apply 函数、走 dsh plugin add。影响：照抄 Codex 的目录结构会无效。修复：按 §Formats & Development 里各自的 anatomy 段落分别写）。
7. README 与 JSON 存在条目数差异（现象：实测 grep -c "^- \[" 约 974，而 plugins.json 的 total 是 1035。影响：以 README 行数做统计会低估约 60 条。修复：以 plugins.json 为准，或说明是统计口径差异）。
8. 数据源是自动同步的（现象：最近提交含 "chore: sync from upstream registries"。影响：上游注册表变动的噪音会混进提交历史。修复：写 diff 时区分人工添加（Add xxx (#NNN)）与同步 chore）。
9. 仓库很新（现象：创建于 2026-04-07，半年内做到 880 stars / 1035 条目。影响：条目质量参差、坏链概率高于老牌 awesome list。修复：安装前一定打开源仓库看最后提交时间与 issue 状态）。
10. 无第三方 CI 即扣分只是软约束（现象：README 说扣 10% 信任分，但"仍可收录"。影响：catalog 里会混有未做任何扫描的条目。修复：自己装插件时优先挑带 scanner CI 徽章的）。

与同类对比

对比结论很清楚：要找"多客户端全覆盖"，这里没有替代品；官方目录更安全但只有自家插件；社区 awesome list 更中立但覆盖面窄。实际最优策略是三方交叉——先在这里发现，再看信任分和 CI 徽章，最后回到源仓库看活跃度和 issue。

一句话推荐

如果你同时用两三种 AI 编程助手，这个仓库是当下最省事的"插件超市索引"——它用 Agent Skills + MCP 这类开放格式做底座，一份清单打通 Codex/Grok/Kimi/DSH/OpenCode，外加 plugin-scanner 六维信任分和 CI 门；唯一要记住的是：它既是目录也是评分方，装之前自己再看一眼源码。