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