自架服務
iflytek/skillhub avatar
iflytek/skillhub

iflytek/skillhub:功能邊界、安裝路徑與使用判斷

專案速覽:企業的自架開源代理技能註冊表。發布和版本技能包,使用 RBAC 和審核日誌進行管理,使用 Docker 或 Kubernetes 進行本地部署。

5,112 個 Star836 個 ForkJavaApache-2.0

秒懂

它是什麼?
Self-hosted, open-source agent skill registry for enterprises. Publish & version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.;本文依 iflytek/skillhub README 整理功能、設定、依賴與專屬核驗重點。
適合誰用?
skillhub 適合需要「Self-hosted, open-source agent skill registry for enterprises. Publish & version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.」所涵蓋能力,且能依 iflytek/skillhub README 管理依賴、設定與執行環境的使用者;不適合只想直接取得成品、無法維護本地服務或不願處理輸入格式差異的人。
可以商用嗎?
可以。Apache-2.0 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫最近一次提交在 1 天前。
用什麼語言寫的?
主要是 Java(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

skillhub:自託管註冊中心,而非技能集合

SkillHub 是一個自託管、開源平台,用於在組織內部管理智慧體技能。README 明確說明了它不是什麼:它不是技能集合。它是一個註冊和治理層,團隊可以在其中私有地託管、版本化和分發技能。專案將自己與 anthropics/skills 等公開技能目錄並列,後者推廣了 Agent Skill 格式(包含 name 和 description 前置元資料的 SKILL.md 檔案及配套檔案)。SkillHub 透過提供託管、版本化、發現和存取控制的基础設施來補充該格式。倉庫元資料顯示有 4,872 個星標和 765 個復刻,表明公眾關注度,但 README 未提供使用者數量或生產採用數據。

在 iflytek/skillhub 依 README 的安裝入口執行最小範例,記錄 skillhub 的命令、設定檔、輸入、輸出與錯誤碼。 本節只把素材明確寫出的行為當成事實;文件沒有交代的結果,標記為尚待確認。skillhub 的實際表現還會受作業系統、依賴版本、權限與輸入格式影響,因此要把命令列輸出和生成檔案一起保存。

skillhub 補充核驗 1:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub 補充核驗 7:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub:發布、版本化和治理技能

README 的高亮部分列出了核心能力。技能包可以使用語意化版本號、自訂標籤(如 beta 或 stable)以及自動的 latest 追蹤進行上傳。全文搜尋支援按命名空間、下載量、評分和最近更新過濾,可見性規則限制使用者能看到的範圍。團隊命名空間將技能歸入團隊或全域範圍,每個命名空間有自己的成員和角色(Owner、Admin、Member)以及發布策略。審查和治理工作流允許團隊管理員在命名空間內審查,平台管理員則把關向全域範圍的提升;所有治理操作都有稽核日誌。社交功能包括星標、評分和下載追蹤。帳戶合併將多個 OAuth 身分和 API 令牌整合到單一使用者下,API 令牌管理生成帶前綴安全雜湊的作用域令牌。專案以 CLI 為第一優先,提供原生 REST API 以及針對 ClawHub 風格註冊表用戶端的相容層。

skillhub 補充核驗 2:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub 補充核驗 8:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub:執行 SkillHub:本機、Docker 和 Kubernetes

快速入門使用 curl 命令取得並執行一個執行時指令碼,該指令碼拉取最新的穩定版映像。--public-url 參數設定公開存取 URL,影響 CLI 安裝命令、智慧體設定說明和 OAuth 回呼。針對中國使用者提供了阿里雲映像標誌。本機開發依賴 Docker 和 Docker Compose;執行 make dev-all 以後端本機設定啟動,Web UI 在 localhost:3000 可用,後端 API 在 localhost:8080。提供了模擬認證使用者 local-user 和 local-admin,本機設定預設啟用引導管理員帳戶(admin,密碼 ChangeMe!2026)。容器執行時映像發布到 GHCR,支援 linux/amd64 和 linux/arm64,charts/skillhub 下的 Helm chart 支援可設定的 Kubernetes 部署,內建 PostgreSQL 和 Redis。README 也記錄了 Prometheus 和 Grafana 監控棧,用於抓取後端的 Actuator 端點。

skillhub 補充核驗 3:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub 補充核驗 9:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub:技術架構:後端、前端和儲存

架構圖顯示 Web UI(React 19)和 CLI 工具透過 Nginx 與 Spring Boot 後端(Java 21)通訊。後端處理認證、RBAC、核心服務、OAuth2、API 令牌和稽核日誌。它使用帶 Flyway 遷移的 PostgreSQL 16 儲存關聯式資料,Redis 7 用於工作階段管理。技能包儲存是可插拔的:本機檔案系統用於開發,S3 或 MinIO 用於生產,透過設定切換。後端是多模組 Maven 專案,包含 app、domain、auth、search、storage 和 infra 模組。前端使用 TypeScript、Vite、TanStack Router、TanStack Query、Tailwind CSS、Radix UI 和 OpenAPI TypeScript 提供型別安全的 API 用戶端。國際化透過 i18next 實現。

skillhub 補充核驗 4:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub 補充核驗 10:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub:與智慧體平台的整合

README 記錄了與多個智慧體平台的整合。OpenClaw 是一個開源的智慧體技能 CLI,可以將 SkillHub 用作其註冊中心;設定涉及設定 CLAWHUB_REGISTRY,並使用 clawhub login 和 npx clawhub 命令進行搜尋、安裝和發布。Hermes Agent 使用標準 SKILL.md 格式,可以透過 SkillHub CLI 的 --dir 選項安裝技能。HarnessClaw Engine 是一個 Go 語言 LLM 助手引擎,也接受透過 --dir 安裝到目錄的技能。AstronClaw 是一個基於 OpenClaw 建構的雲 AI 助手,可以連線到自託管的 SkillHub 註冊中心。Loomy 是一個桌面 AI 工作夥伴,與本機檔案和系統工具深度整合,可以從 SkillHub 發現技能。astron-agent,即 iFlytek Astron 智慧體框架,可以引用和載入儲存在 SkillHub 中的技能。README 未提供這些整合的基準測試或效能資料。

skillhub 補充核驗 5:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub 補充核驗 11:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub:開發工作流、測試和許可證

對於開發者,README 指定了 make 目標:make test、make test-backend-app、make build-backend-app,以及用於重新產生 OpenAPI 型別的 make generate-api。更嚴格的漂移檢查透過 scripts/check-openapi-generated.sh 執行。冒煙測試指令碼 scripts/smoke-test.sh 針對本機後端執行,並在提供憑據時包含管理員檢查。專案採用 Apache License 2.0 許可證;許可證摘錄授予永久、全球、非獨佔、免費、免版稅的版權和專利許可,但不提供任何保證或支援承諾。歡迎透過 issue 和 pull request 貢獻,並有貢獻指南和行為準則。支援管道包括 GitHub Discussions、Issues、Discord 和微信群。README 未提及具體的發布日期或版本號,僅提到通用的 latest 和 edge 標籤。

skillhub 補充核驗 6:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

skillhub 補充核驗 12:再次依 main README 固定輸入,記錄本次命令、設定鍵、輸出檔與錯誤碼,並與前一次 skillhub 結果逐項比較。

編輯結論

skillhub 適合需要「Self-hosted, open-source agent skill registry for enterprises. Publish & version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes.」所涵蓋能力,且能依 iflytek/skillhub README 管理依賴、設定與執行環境的使用者;不適合只想直接取得成品、無法維護本地服務或不願處理輸入格式差異的人。先依 README 執行 skillhub 的最小命令,核對輸入、輸出、日誌與版本,再決定是否納入正式工作流程。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記