内容
<p align="center">
<img src="./assets/ucoz-banner.webp" alt="uCoz 智能代理技能" width="100%">
</p>
# uCoz 智能代理技能
适用于与 uCoz 合作的 AI 代理的官方智能代理技能：登陆页面、站点配置、广告活动。
每个技能都附带 [ucoz-mcp](https://www.npmjs.com/package/ucoz-mcp) 服务器 - 只需安装一次插件，即可获得指令和工具。
网站目录：[ucoz.com/ai/skills](https://www.ucoz.com/ai/skills)
MCP 文档：[api.ucoz.net/mcp](https://api.ucoz.net/en/mcp.html)
## 可用技能
| 技能 | 描述 | 版本 |
|-------|-------------|---------|
| [ucoz-landing-skill](skills/ucoz-landing-skill/SKILL.md) | 通过 MCP 生成和编辑登陆页面 | 1.3 |
| [ucoz-provisioning-skill](skills/ucoz-provisioning-skill/SKILL.md) | 创建或连接 uCoz 站点并配置 MCP（uAPI、FTP、模块）。需要 Playwright - 请参阅 [browser-runner](skills/ucoz-provisioning-skill/browser-runner/) | 1.1 |
## 安装
### Cursor（技能 + MCP）
从 GitHub 安装 - 技能和 MCP 通过 [`.cursor-plugin/plugin.json`](.cursor-plugin/plugin.json) 一起配置：
**设置 → 规则 → 新建规则 → 从 Github 添加** → `https://github.com/ucoz-skills/agent-skills.git`
或在 [cursor.directory/plugins/new](https://cursor.directory/plugins/new) 提交存储库。
安装后，打开 **设置 → 工具和 MCP** 并为 `ucoz-mcp` 设置环境变量（请参阅 [MCP 设置](#mcp-设置)）。
### Codex（技能 + MCP）
**Codex 应用程序** - 从插件目录安装 uCoz 插件。
**Codex CLI** - 运行 `/plugins`，选择 **uCoz**，然后选择 **安装插件**。
技能从 `skills/` 加载；MCP 配置通过 [`.codex-plugin/plugin.json`](.codex-plugin/plugin.json) 从 [`.mcp.json`](.mcp.json) 读取。在 Codex MCP 设置中设置 uCoz 环境变量（请参阅 [MCP 设置](#mcp-设置)）。
### Antigravity（IDE + CLI）
[Google Antigravity](https://antigravity.google/docs/skills) 从 `skills/` 发现技能，并通过本机插件（[`plugin.json`](plugin.json) + [`mcp_config.json`](mcp_config.json)）支持捆绑的 MCP。
**Antigravity CLI - 插件安装（推荐，技能 + MCP）：**
```bash
agy plugin install https://github.com/ucoz-skills/agent-skills.git
```
全局安装在 `~/.gemini/config/plugins/ucoz/` 下。验证 `agy plugin list` 并在 CLI 中浏览技能 `/skills`。
**Antigravity IDE - 技能 CLI：**
```bash
npx skills add ucoz-skills/agent-skills
```
将技能文件夹安装到 `~/.agents/skills/`（由 Antigravity IDE 发现）。对于在所有 Antigravity 工具中共享的技能，将它们复制到 `~/.gemini/skills/` - 请参阅 [Antigravity 技能文档](https://antigravity.google/docs/skills)。
**仅工作区安装** - 将技能文件夹复制到项目根目录的 `.agents/skills/`。
安装后，为 MCP 设置 `UCOZ_*` 环境变量（请参阅 [MCP 设置](#mcp-设置)）。使用插件路径时，MCP 从 [`mcp_config.json`](mcp_config.json) 捆绑；否则，将该文件合并到 `~/.gemini/config/mcp_config.json`。
验证本地克隆后再安装：
```bash
agy plugin validate /path/to/agent-skills
```
### Hermes（技能中心）
[Hermes Agent](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) 从 GitHub Taps 和 [skills.sh](https://skills.sh) 索引发现技能。
**订阅存储库（自定义 Tap）：**
```bash
hermes skills tap add ucoz-skills/agent-skills
```
**安装技能：**
```bash
hermes skills install ucoz-skills/agent-skills/skills/ucoz-landing-skill
hermes skills install ucoz-skills/agent-skills/skills/ucoz-provisioning-skill
```
**技能 CLI（也将存储库注册到 skills.sh 以进行目录索引）：**
```bash
npx skills add ucoz-skills/agent-skills
```
安装后，技能出现在 [skills.sh/ucoz-skills/agent-skills](https://skills.sh/ucoz-skills/agent-skills) 和 Hermes 技能中心索引中（定期刷新）。更新：推送到 GitHub；用户运行 `hermes skills check` 和 `hermes skills update`。
> Hermes 使用 GitHub API 浏览 Taps。如果达到 API 速率限制，请在 `~/.hermes/.env` 中设置 `GITHUB_TOKEN`（或运行 `gh auth login`）。
### Claude Code（市场）
```bash
/plugin marketplace add ucoz-skills/agent-skills
/plugin install ucoz@ucoz-skills
```
技能从 `skills/` 加载；MCP 配置从插件根目录的 [`.mcp.json`](.mcp.json) 读取。
### 技能 CLI（仅限技能）
```bash
npx skills add ucoz-skills/agent-skills
```
安装单个技能：
```bash
npx skills add ucoz-skills/agent-skills --skill ucoz-landing-skill
npx skills add ucoz-skills/agent-skills --skill ucoz-provisioning-skill
```
> 技能 CLI 仅安装指令。添加 [`.mcp.json`](.mcp.json) 到您的项目或 IDE 中，单独使用 MCP 工具。
### 手动安装
将技能文件夹复制到您的代理技能目录：
- `skills/ucoz-landing-skill`
- `skills/ucoz-provisioning-skill`（包括用于 Playwright 配置的 `browser-runner/`）
| 工具 | 技能路径 |
|------|-------------|
| Cursor | `.cursor/skills/` 或 `.agents/skills/` |
| Claude Code | `.claude/skills/` |
| Antigravity | `.agents/skills/`（工作区）或 `~/.gemini/skills/`（全局） |
## MCP 设置
存储库包括 [`.mcp.json`](.mcp.json) - 当您安装 **Cursor**、**Codex**、**Claude Code** 或 **Antigravity** 插件时自动捆绑。
MCP 通过 stdio 运行：
```bash
npx -y ucoz-mcp@latest
```
在您的 IDE MCP 设置中设置以下环境变量：
| 变量 | 描述 |
|----------|-------------|
| `UCOZ_API_TOKEN` | 控制面板中的 uAPI 令牌 |
| `UCOZ_SITE_URL` | 站点 URL，例如 `https://example.ucoz.net/` |
| `UCOZ_FTP_HOST` | FTP 主机 |
| `UCOZ_FTP_USER` | FTP 用户名 |
| `UCOZ_FTP_PASS` | FTP 密码 |
MCP 配置示例（也在 [`.mcp.json`](.mcp.json) 和 [`mcp_config.json`](mcp_config.json) 中）：
```json
{
"mcpServers": {
"ucoz-mcp": {
"command": "npx",
"args": ["-y", "ucoz-mcp@latest"],
"env": {
"UCOZ_API_TOKEN": "your-token",
"UCOZ_SITE_URL": "https://your-site.ucoz.net/",
"UCOZ_FTP_HOST": "your-site.ucoz.net",
"UCOZ_FTP_USER": "your-ftp-login",
"UCOZ_FTP_PASS": "your-ftp-password"
}
}
}
}
```
### MCP 工具
| 工具 | 用途 |
|------|---------|
| `templates_tool` | 页面模板、菜单、邮件表单、备份 |
| `ftp_tool` | 上传 CSS/JS/图像、管理站点文件 |
| `modules_tool` | 安装模块、隔离/索引 |
## 许可证
MIT - 请参阅 [LICENSE](LICENSE)。
