Sealos 部署助手 labring/sealos-skills

sealos-skills

用于在 Sealos Cloud 上部署和运维应用的智能体插件，按 Agent Plugins 格式打包，同时也是一个 DeepSeek Harness 配置档 bundle。同一个 use-sealos 技能也能通过 Codex、Claude Code、Cursor、Qoder、skills.sh、OpenClaw / ClawHub、CodeBuddy、Gemini CLI、Qwen Code 以及通用仓库导入工具安装。

在兼容的智能体里说一句「deploy X to Sealos」（或「帮我把 X 部署到 Sealos」），use-sealos 技能就会接手剩下的事：登录、挑选最快的部署路径、数据库、存储、公网 HTTPS，以及部署后验证。

目录结构

package.json # DeepSeek Harness bundle manifest (dsh.bundle)
cordis.patch.yml # inserts the skill provider into a dsh profile
index.js # registers use-sealos on ctx.skills
CLAUDE.md # context-only hosts (Gemini, Qwen, Amp / Kimi)
gemini-extension.json # Gemini CLI extension
qwen-extension.json # Qwen Code extension
openclaw.plugin.json # unused on OpenClaw's native package.json path; install plugins/sealos instead
.codex-plugin/plugin.json # root Codex import manifest
.agents/plugins/marketplace.json # Codex marketplace entry
.codebuddy-plugin/marketplace.json # CodeBuddy marketplace
skills/ # skills.sh entries (symlinks → plugins/sealos/skills/*)
plugins/sealos/
├── .codex-plugin/plugin.json # Codex marketplace plugin manifest
├── .claude-plugin/plugin.json # Claude Code manifest
├── .cursor-plugin/plugin.json # Cursor manifest
├── .qoder-plugin/plugin.json # Qoder manifest
├── commands/sealos.md # /sealos for compatible plugin hosts
└── skills/
├── use-sealos/
│ ├── SKILL.md # intent router + execution rules
│ ├── references/ # loaded on demand
│ │ ├── deploy.md # three deploy paths (store / image / source)
│ │ ├── build.md # Dockerfile, linux/amd64 build, registry push
│ │ ├── databases.md # KubeBlocks clusters + credentials
│ │ ├── platform.md # manifest contract (labels, Ingress, storage, quota)
│ │ ├── operate.md # status, logs, debugging, deletion
│ │ └── recipes.md # per-app recipes for popular self-hosted software
│ └── scripts/
│ ├── sealos-api.py # auth (OAuth2 device flow) + Template API, stdlib only
│ └── wait-app.sh # post-deploy readiness + URL verification
├── sealos-deploy/SKILL.md # Brain managed-mode entry (MCP-gated pipeline)
└── k8s-kaniko-job/ # sandbox build executor (Kaniko Job → GHCR)
├── SKILL.md
└── scripts/kaniko-build.py

安装

Cursor

从已发布的 GitHub 仓库：Settings → Plugins，把仓库 URL 粘贴到 Search or Paste Link，打开 Sealos 插件，点击 Add to Cursor。

本地开发时，把技能软链接到你的个人 skills 目录：

ln -sfn "$(pwd)/plugins/sealos/skills/use-sealos" ~/.cursor/skills/use-sealos

Claude Code

claude plugin marketplace add labring/sealos-skills
claude plugin install sealos@sealos-skills
/reload-plugins

交互式操作用 /sealos。marketplace 也接受本地 checkout 路径。

Codex

codex plugin marketplace add labring/sealos-skills
codex plugin add sealos@sealos

在 Codex CLI 里调用 $sealos；在 Codex App 里，到 Plugins 下选择 Sealos。marketplace 源是 .agents/plugins/marketplace.json；插件清单是 plugins/sealos/.codex-plugin/plugin.json。仓库根目录还带了一份 Codex 清单，供直接导入使用。

Qoder

在 Qoder 里打开插件 Marketplace（Settings → Plugins → Marketplace），点击 + Create Plugin，选择 import from a local folder，然后从本仓库的 clone 里选中 plugins/sealos。

要分发的话，把 plugins/sealos 的内容打包成 sealos-2.0.0.zip（zip 根目录必须包含 .qoder-plugin/plugin.json），再通过 Qoder marketplace 分享或发布。

安装完成后在 Qoder 里用 /sealos。

DeepSeek Harness

本仓库是 dsh 配置档 bundle。npx @deepseek-ai/dsh web 能跑起来之后，把插件装进同一个 web 配置档（pnpm 必须在 PATH 上）：

npx @deepseek-ai/dsh plugin --profile web add github:labring/sealos-skills
npx @deepseek-ai/dsh web

本地 checkout：

npx @deepseek-ai/dsh plugin --profile web add /path/to/sealos-skills

use-sealos 会出现在会话技能目录里。说「deploy X to Sealos」；模型通过 skill 工具加载技能，再用 bash 跑 scripts/sealos-api.py / kubectl。

登录会写入 ~/.sealos/kubeconfig；提示时给宿主机授予所需的文件系统访问权限。

在公开仓库上加上 GitHub topic dsh-plugin，它才会出现在 harness 插件索引里。

OpenClaw

装插件目录，不要装仓库根目录：

openclaw plugins install /path/to/sealos-skills/plugins/sealos

OpenClaw 把它当作 Cursor bundle 加载，并暴露 use-sealos。不承诺支持斜杠命令。说「deploy X to Sealos」。

不要装仓库根目录。OpenClaw 会先看到根目录的 package.json，把 checkout 当成原生插件，然后因为那个包没有 openclaw.extensions 而失败。这条路径上不会用到根目录的 openclaw.plugin.json。

CodeBuddy

/plugin marketplace add labring/sealos-skills

命令暴露取决于 CodeBuddy 运行时。

Gemini CLI

纯上下文扩展。不承诺支持斜杠命令。

gemini extensions install https://github.com/labring/sealos-skills
让 Gemini 部署到 Sealos Cloud。它会加载 CLAUDE.md，其中指向 use-sealos。

Qwen Code

仅提供上下文的扩展。不占用斜杠命令。

qwen extensions install https://github.com/labring/sealos-skills

skills.sh

npx skills add labring/sealos-skills

这个包会安装三个技能：use-sealos（交互式入口——说「deploy X to Sealos」），以及 sealos-deploy 和 k8s-kaniko-job，后两者在托管沙箱之外不起作用（见下文）。

Brain（托管沙箱）

Brain 的 GitHub 部署流水线会把这个包安装到 Devbox 里，命令是 npx skills add <repo> -y，并以托管模式驱动 sealos-deploy 技能（SEALAI_DEPLOY_MODE=managed，通过 template_ready / deployment_completed 完成 MCP 握手，源码构建走 k8s-kaniko-job 这个 Kaniko Job）。把 Brain 的 DEPLOY_SKILL_SOURCE 环境变量指向本仓库。设计思路和完整的控制面契约见 BRAIN-ADAPTATION.md。

Amp / Kimi / 通用仓库导入器

导入 https://github.com/labring/sealos-skills.git。具体行为取决于宿主。上下文是 CLAUDE.md；技能位于 skills/use-sealos 和 plugins/sealos/skills/use-sealos。

首次运行

说「deploy X to Sealos」。技能会检查凭据（sealos-api.py status），必要时通过 OAuth2 设备流让你登录——或者把 Sealos Web 控制台的 kubeconfig 粘贴到 ~/.sealos/kubeconfig。

部署策略

1. 模板商店——200+ 一键模板，通过 Template API 部署（约 3 分钟）。
2. 官方 Docker 镜像——为商店里没有的自托管应用生成模板（工作负载 + KubeBlocks 数据库 + Ingress）（约 5-10 分钟）。
3. 源码构建——Dockerfile → docker buildx --platform linux/amd64 → 推送镜像仓库 → 部署镜像（用于你自己的项目）。

三条路径都走 Sealos Template API，所以每次部署都会作为一个实例被跟踪：在 Sealos UI 里可见，也能整体删除。

环境要求

- kubectl、python3（仅标准库）；只有源码路径需要 docker + gh
- Sealos 账号——技能通过 OAuth2 设备流登录，或者把 Sealos Web 控制台的 kubeconfig 粘贴到 ~/.sealos/kubeconfig

开发

临时克隆、测试转储以及其他只在本机产生的文件放在 validation-assets/（已加入 gitignore）。

2.0 版本取代了此前八个技能的实现。独立的 Canvas、Sealos Desktop 应用构建器、云原生就绪、Dockerfile 和 Compose 转换技能已归档到 codex/backup-before-next-20260928 分支。部署、数据库、对象存储和运维现在都走 use-sealos；Brain 的托管部署有自己的 sealos-deploy 和 k8s-kaniko-job 技能。