项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5376
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 支持容器运行的环境(Docker),可拉取 GHCR 上的运行时镜像
- 能访问 https://imageless.oss-cn-beijing.aliyuncs.com 下载启动脚本
- 安装 CLI 需要 Node.js 与 npm 环境
- 生产部署需准备一个可公网访问的域名(用于 --public-url)
安装与启动步骤
-
1启动本地全栈环境
一条命令拉起 SkillHub 完整本地环境,默认拉取 latest 稳定版镜像,脚本会下载到 /tmp/skillhub-runtime。
rm -rf /tmp/skillhub-runtime curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up -
2配置公网访问地址
生产环境建议显式指定 public-url,否则 CLI 安装命令、skill.md 地址和 OAuth 回调会不正确。
curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --public-url https://skillhub.your-company.com -
3国内走阿里云镜像
国内网络环境可加 --aliyun 使用阿里云镜像加速,同时指定 public-url 与版本。
curl -fsSL https://imageless.oss-cn-beijing.aliyuncs.com/runtime.sh | sh -s -- up --aliyun --public-url https://skillhub.your-company.com --version latest -
4安装 SkillHub CLI
全局安装官方 CLI,用于搜索、安装和管理技能包;也可用 npx 直接运行免安装。
npm install -g @astron-team/skillhub -
5验证 CLI 可用
输出版本信息说明 CLI 安装成功且能连通注册中心。npx 方式无需全局安装即可验证。
npx @astron-team/skillhub@latest version -
6搜索并安装技能
按关键字搜索技能包,并指定目标 Agent 平台安装;技能名与 Agent 名称按实际注册中心内容填写。
skillhub search pdf skillhub install pdf-parser --agent codex -
7查看已安装技能
列出当前本地已安装的技能包,确认安装结果。
skillhub list
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--public-url | 否 | 设置实例的公网访问地址,影响 CLI 安装命令、skill.md 链接与 OAuth 回调 | https://skillhub.your-company.com |
--version | 否 | 指定拉取的镜像版本,默认 latest 稳定版,edge 为 main 分支最新构建 | latest |
--aliyun | 否 | 使用阿里云镜像源,适合国内网络环境加速拉取 | --aliyun |
如何确认成功
执行 npx @astron-team/skillhub@latest version 能输出版本信息,说明 CLI 可用;通过 --public-url 配置的地址可访问实例页面。
常见问题
Q:部署过程中报错怎么办?
A:README 建议清空已有的 runtime home 目录后重试,即先执行 rm -rf /tmp/skillhub-runtime,再重新运行 up 命令。
Q:想体验 main 分支的最新构建?
A:在 up 命令后加 --version edge,默认不加时拉取的是 latest 稳定版发布镜像。
Q:国内拉取镜像很慢怎么解决?
A:在启动命令中加入 --aliyun 参数使用阿里云镜像源,可同时配合 --public-url 与 --version 一起使用。
Q:不想全局安装 CLI 可以吗?
A:可以,README 提供了直接运行方式:npx @astron-team/skillhub@latest version,无需 npm install -g。
Q:CLI 里显示的安装地址不对?
A:通常是启动时没有设置公网地址,需用 --public-url 指定实际的对外访问 URL 后重新部署。
注意事项
- 默认命令拉取 latest 稳定版镜像,官方文档地址为 docs/skillhub/en/guide/cli.md。
- --public-url 会影响 CLI 安装命令、Agent 配置中的 skill.md 地址以及 OAuth 回调与设备授权链接,生产环境务必配置。
- 已发布的服务端与 Web 镜像支持 linux/amd64、linux/arm64、linux/riscv64;扫描器镜像目前只支持 linux/amd64 与 linux/arm64。
- 除 CLI 外,也可在 Agent 平台上通过 npx clawhub 搜索与安装技能,指向自建的 SkillHub 实例。
核心亮点
- 面向企业级AI Agent场景,提供技能包(Skill)的发布、版本管理与私有化部署,填补了Agent生态中技能注册与治理的空白
- 内置RBAC权限控制和审计日志,满足企业合规要求,适合对安全性和可追溯性有严格要求的内部平台
- 基于Java实现,支持Docker和Kubernetes部署,技术栈成熟,便于与现有企业基础设施集成
不足之处
- 项目较新,社区生态和第三方集成案例相对有限,文档/社区待观察
适用场景
- 企业内部AI Agent技能市场:集中管理各团队开发的技能包,统一版本和权限
- 合规敏感行业(如金融、政务)的AI服务治理:通过审计日志和RBAC满足监管要求
- 私有化AI平台底座:在隔离环境中部署技能注册中心,支撑多Agent协同
替代项目
LangChain Hub、Hugging Face Hub、Portkey Gateway
下一篇:caura-memclaw
同类项目推荐
agentfield
开源
像管微服务一样管 AI 代理,一键部署自动扩容
Build, run and scale AI agents like API and microservices
warren
开源
像管容器一样管你的 AI 编码代理,自动修复、自我进化。
Run coding agents like infrastructure, not terminal sessions. Warren manages isolati···
ai-agents-from-scratch
开源
手写AI Agent,彻底搞懂原理,告别黑盒。
Demystify AI agents by building them yourself. Local LLMs, no black boxes, real unde···
DeepSeekBot
开源
组一支有记忆、有分工的私人 AI Bot 团队
Open-source GrokBot alternative built on DeepSeek Harness. Build your personal bot t···
squadra
开源
让多个 AI 编码代理共享任务、互相对账、留下证据
Coordinate Claude, Codex and Cursor windows with shared tasks, acknowledgements, pre···
PolyGPT-alpha
开源
用智能体编排自主跑通业务运营流程
PolyGPT: An Overview of Agent-Based System Architecture for Autonomous Business Oper···
OpenShell
开源
给自主智能体套上安全沙箱,放心跑命令
OpenShell is the safe, private runtime for autonomous AI agents.
maestro-orchestrate
开源
让多个 AI 编码助手协作,自动完成复杂开发任务并提升代码质量。
Multi-agent orchestration platform for Gemini CLI, Claude Code, Codex, and Qwen Code···
humanizer
开源
复制AI稿进去,秒变人写的
Agent skill that removes signs of AI-generated writing from text
