zizo
z2lab-team/zizo-skill · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por z2lab-team/zizo-skill no skills.sh. Instale com: npx skills add z2lab-team/zizo-skill@zizo
Details
- Kind
- Agent skills
- Publisher
- z2lab-team
- Origin
- skillssh
- Category
- ferramentas
- Last push
- 2026-07-18T04:13:22Z
- Repository state
- ativo
- Added
- 2026-10-07 06:29:46
- Updated
- 2026-10-07 06:29:46
- Origin id
z2lab-team/zizo-skill/zizo
README
# zizo-skill
> AI Agent Skill for [zizo.pro](https://zizo.pro) —— Zizo 灵感图库的图片和画板搜索能力。
> 一次安装，在 TRAE CN / Cursor / Claude Code 等所有兼容 Agent 里直接说需求就能搜图。
---
## ⚡️ 一键安装
```bash
# 中国版 TRAE（推荐）
npx skills add z2lab-team/zizo-skill -g -a trae-cn -y
# 通用（Cursor / Claude Code / Windsurf / Copilot 等）
npx skills add z2lab-team/zizo-skill -g -y
# 一次装到所有兼容的 Agent
npx skills add z2lab-team/zizo-skill -g --all
```
> 安装名 `z2lab-team/zizo-skill`（GitHub 仓库名，单数）；卸载时按 Skill 名：`npx skills remove zizo -g -y`
---
## ✨ 功能
| 能力 | 说明 |
|---|---|
| 🔍 **图片搜索** | 支持中英文关键词，返回原图 URL（带 CDN 签名，完整分辨率） + 缩略图 + 原始宽高 |
| 📚 **画板搜索** | 搜索 zizo 灵感画板集合（Board Search），返回画板封面和标题 |
| 🔐 **本地持久化登录** | `zizo login` 交互式获取 Token，保存到 `~/.config/zizo/config.json`（权限 0600），无需每次设置环境变量 |
| 🌱 **零依赖单文件** | 构建产物为单个 `dist/index.js`，装完即跑，无 `npm install` |
| 🪜 **Token 两级优先级** | `ZIZO_TOKEN` 环境变量 > 本地 `~/.config/zizo/config.json`，适配 CI / 交互双场景 |
---
## 🚀 快速开始
装完 skill 后，在你的 Agent 里直接对它说：
```
帮我搜 5 张「日落海边」的图片
用 zizo 找一下「北欧风格室内设计」画板
```
Agent 会自动加载本 Skill 并按流程执行。如果是第一次使用，Agent 会先引导你登录（只需一次，后续所有搜索复用）。
### 手动 CLI 操作（调试用）
```bash
# 定位到已安装的 skill 目录
# 全局 (macOS): ~/.agents/skills/zizo/
# TRAE CN: ~/.trae-cn/skills/zizo/
cd ~/.agents/skills/zizo
# 1. 交互式登录（浏览器自动打开 → 复制 Token → 粘贴进终端即可）
node dist/index.js login
# 2. 查看登录状态（显示 Token 来源：env / 本地文件，在线验证结果）
node dist/index.js auth status
# 3. 搜索图片
node dist/index.js search images "日落海边" --limit 5
# 4. 搜索画板
node dist/index.js search boards "北欧风格" --limit 10
```
### CI / 脚本环境（非交互）
通过密钥管理器或 CI secrets 注入 `ZIZO_TOKEN` 环境变量（优先级最高）。
**禁止将明文 Token 写入脚本或命令行**。
```bash
# ❌ 错误做法：export ZIZO_TOKEN="明文值"（会泄露到 shell 历史、git 仓库）
# ✅ 正确做法：从外部密钥管理系统注入，例如：
# ZIZO_TOKEN="$SECRET_STORE_ZIZO_KEY" node dist/index.js search images "cat"
# 或通过 direnv / vault / CI secrets provider 等安全机制设置环境变量
# 可选环境变量
# ZIZO_LIMIT=20 # 每次搜索默认结果数
# ZIZO_SCOPE=public # 搜索范围：public / mine / all
# ZIZO_SERVER=https://zizo.pro # 自定义服务端地址
```
---
## 🤖 兼容 Agent 列表
本 Skill 兼容所有遵循 [SKILL.md](https://skill.md) 开放规范的 Agent CLI / IDE：
TRAE CN · Cursor · Claude Code · GitHub Copilot · Windsurf · Cline · Goose · Codex · Gemini CLI · RooCode · OpenCode · Zed · ……
> 兼容性提示：Skill 触发依赖 Agent 自带的 Bash 工具执行能力，图片搜索结果通过标准 stdout 结构化输出供 Agent 解析。
---
## 📦 仓库结构
```
z2lab-team/zizo-skill ← GitHub 仓库根（skills.sh 抓取的 README 就是你现在在读的）
├── README.md ← 你正在读的文件：给人看 + skills.sh 展示
└── zizo/ ← Skill 本体（和 SKILL.md 内 name=zizo 对齐）
├── SKILL.md ← AI Agent 读取入口：元数据 + 触发条件 + 使用指令
├── package.json # 声明 bin 名（zizo）与版本号
└── dist/ # 零依赖单文件构建产物（由开发仓库的 pack.sh 生成）
└── index.js
```
---
## 📚 更多说明
- **技能市场页面（收录后）**：<https://www.skills.sh/skill/z2lab-team/zizo-skill>
- **后端服务**：<https://zizo.pro>（灵感图库官网）
- **License**：MIT
- **反馈 / Issues**：<https://github.com/z2lab-team/zizo-skill/issues>
由 [z2lab-team](https://github.com/z2lab-team) 维护，基于 [zapp_server](https://github.com/z2lab-team/zapp_server) 后端开发。