下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/caiguwang--caiguwang-creator.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @caiguwang/caiguwang-creator。才谷网投票是才谷网(chinacaigu.com)旗下的 AI 投票制作技能——10年品牌、超亿人使用、全免费的共享投票小程序。当用户需要制作投票、发起评选、组织投票活动、创建微信投票时使用此 Skill。支持群投票、图文投票、分组投票制作,投票模板精美,稳定可靠,安全防刷。核心功能:1. 投票模板检索——按关键词筛选,返回模板列表与预览图 2. AI 一句话创建投票——描述需求即可生成标题、投票时间、投票规则并匹配模板 3. 批量添加选手——JSON 批量导入选手名称与图片,支持分组 4. 活动修改——对话修改标题、说明、时间、投票规则、分组,支持分组改名 5. 图片上传——本地图片转 URL 并进入素材库 6. 数据查询——选手票数榜单、参与人数、累计投票、浏览次数。
本 Skill 仅支持图文投票,视频投票、问卷投票请登录才谷网投票网页后台制作。触发词:才谷网、才谷网投票、制作投票、创建投票、发起投票、在线投票、微信投票、群投票、图文投票、分组投票、投票小程序、评选投票、活动投票、作品评选、摄影投票、美食投票、萌娃投票、投票平台、人气投票、免费投票、投票工具、投票网站、投票系统、投票链接、二维码投票、投票模板、投票活动怎么弄、怎么发起投票、AI投票
阅读全文 (展开查看完整说明)
概述
前置条件
- 零第三方依赖:仅使用 Python 3 标准库(urllib/json),无需 pip install 任何包
- 获取访问令牌
X-Caigu-Token:
登录网页管理后台 https://www.chinacaigu.com/mp/index.html → 左侧菜单「养虾Skill」→ 开启令牌开关(默认停用,开启后才会显示令牌)→ 复制安装指令或令牌。泄露可随时重置,重置后旧令牌立即失效;平台有权冻结令牌,冻结时开关不可开启。
- 令牌保存于
~/.caiguwang/config.json,后续命令自动复用;也可通过环境变量X_CAIGU_TOKEN提供。 - 默认接口地址
https://www.chinacaigu.com,可用环境变量CAIGU_API_BASE覆盖(本地联调用)。
认证(推荐先做)
# 保存令牌(任选其一)
python scripts/caiguwang_cli.py login --token <你的令牌>
python scripts/caiguwang_cli.py login # 不带参数则提示粘贴
# 验证令牌有效性
python scripts/caiguwang_cli.py auth status返回 {"success": true, "code": 200} 表示有效;code: 1002 表示令牌无效/已停用/被冻结,请用户到后台「养虾Skill」页检查令牌开关,或联系平台客服。
检索投票模板
python scripts/caiguwang_cli.py search --kw "绘画比赛" --page 1 --size 10返回模板列表(template_id / title / image)。创建活动时可将 template_id 传给 create --template。
创建投票活动
方式一:AI 一句话生成(推荐,无需手动拼参数)
python scripts/caiguwang_cli.py create --describe "给阳光幼儿园办一个国庆绘画比赛投票,10月1日到7日,每人每天投3票"AI 自动生成活动标题、投票时间、投票规则(每天/总共可投次数、单选多选、是否开启报名),并自动匹配合适模板。可叠加手动参数覆盖 AI 生成结果(如 --multi --per-user-count 5)。
方式二:手动参数
python scripts/caiguwang_cli.py create
--title "年度最佳作品评选"
--intro "本次评选由某某单位主办,欢迎参与投票。"
--start "2026-11-15 08:00" --end "2026-11-25 22:00"
--multi --per-user-count 3 --per-user-scope day
--groups "绘画组,书法组"
--template 123456
--sponsor "某某单位" --sponsor-tel "13800000000"带选手列表(每个选手必须有图片:本地图片请先经 upload 转成 URL;报名型活动可不传选手,由选手自主报名):
python scripts/caiguwang_cli.py create
--title "摄影作品人气投票"
--intro "欢迎参与本次摄影作品人气投票。"
--items-file items.json
# items.json 示例:[{"name":"作品一","image":"https://example.com/p1.jpg"},{"name":"作品二","image":"https://example.com/p2.jpg"}]参数说明
| 参数 | 说明 |
|---|---|
--describe | 一段话描述活动需求(走 AI 生成,与手动参数可混用) |
--title | 活动标题(≤50字,手动创建必填) |
--intro | 活动说明(必填,面向参与者,长度不限,建议简明) |
--start / --end | 时间,格式 YYYY-MM-DD HH:MM;不传默认当前开始、10 天后结束 |
--multi | 开启多选投票(默认单选) |
--per-user-count | 每人可投次数(1-20,默认 3) |
--per-user-scope | day 每天 / total 活动期间总共(默认 day) |
--select-min / --select-max | 多选时每次最少/最多选几个(min 1-999;max 0-999,0=不限) |
--groups | 分组名,逗号分隔(2-100 组,单个名称 ≤20 字) |
--apply | 开启选手报名 |
--template | 模板 ID(search 返回的 template_id);不传时 AI 自动匹配 |
--sponsor / --sponsor-tel | 主办方名称/电话 |
--cover | 活动封面图 URL(网页后台要求 750×464 比例;建议先 upload --crop 750x464 再传入) |
--items-file / --items | 选手列表(JSON 文件路径或 JSON 字符串),name、image 均必填(图文投票);分组活动可加 "cat_id": 0 指定分组序号(从 0 开始) |
--notice | 报名须知(开启报名时展示) |
创建成功返回
{
"success": true, "code": 200,
"data": {
"id": "4HGZ7L0X",
"title": "国庆绘画比赛投票",
"start_time": "2026-11-12 08:00",
"end_time": "2026-11-19 22:00",
"edit_url": "https://www.chinacaigu.com/mp/edit.html?id=19630",
"qrcode": "https://cdn.example.com/data/poster/xxxxxx/xxxx.jpg",
"hint": "活动已创建并按投票时间生效;qrcode 为小程序码图片地址(为空时请到管理后台活动列表「地址」获取);edit_url 用于调整配置"
}
}关于活动 id(引用码):接口返回的 id 是引用码(字母数字,如 4HGZ7L0X),不是真实活动编号——对话展示时请使用引用码或活动标题,不要向用户展示真实数字 ID。所有命令的 --id 既接受引用码,也接受真实数字 ID(两者都有效)。edit_url/qrcode 中的链接是活动本身的固定访问地址,无法去除编号,属正常现象。
分享与编辑(告知用户时用这两样):
- 分享投票:把
qrcode(微信小程序码图片地址)给用户,可下载打印张贴;为空则引导用户到管理后台活动列表点「地址」获取; - 调整配置:
edit_url在浏览器打开(需微信扫码登录管理后台),可调整全部配置。
创建即按投票时间生效,对话时请复述活动标题、时间与规则要点,请用户确认。
修改活动与管理选手(对话修改)
用户对已创建活动说"改一下…"时用这些命令。所有修改均有归属校验,只对自己的活动生效。
修改活动配置(update,可选参数只传要改的)
# 延长活动时间 + 改标题
python scripts/caiguwang_cli.py update --id 19630 --title "年度最佳作品评选(延期)" --end "2026-12-01 22:00"
# 改投票规则:改为多选、每人总共投 5 票
python scripts/caiguwang_cli.py update --id 19630 --multi --per-user-count 5 --per-user-scope total
# 改分组(整体替换)
python scripts/caiguwang_cli.py update --id 19630 --groups "绘画组,书法组,摄影组"
# 关闭报名 / 开启报名
python scripts/caiguwang_cli.py update --id 19630 --no-apply可改字段:--title --intro --notice --start --end --multi/--no-multi --per-user-count--per-user-scope --select-min --select-max --groups --apply/--no-apply --sponsor --sponsor-tel --cover。注意:改时间时结束时间必须晚于开始时间;--groups 传空串可清空分组;标题≤50 字。
添加选手(item-add)
# 单个添加(image 必填)
python scripts/caiguwang_cli.py item-add --id 19630 --name "张三的作品" --image "https://..."
# 批量添加(JSON,同 create 的选手格式;分组活动可在每个选手里加 "cat_id" 指定分组序号)
python scripts/caiguwang_cli.py item-add --id 19630 --items-file items.json注意:活动若要求参赛图片(图文投票默认要求),每个选手都必须带 image;活动要求视频/音频/文件/手机号时,本命令会被拒绝,请引导用户到网页后台添加。单次最多 200 位选手(可分多次追加);选手更多时引导用户到网页后台「批量导入选手」上传。
修改选手(item-update)
# item_id 从 vote-data 的返回里取(每行选手有对应 ID 字段)
python scripts/caiguwang_cli.py item-update --id 19630 --item-id 881 --name "新名称" --image "https://..."不提供选手删除——如需删除或下架选手,引导用户到网页后台操作。
分组改名(group-rename)
# 按分组序号改(从 0 开始)
python scripts/caiguwang_cli.py group-rename --id 19630 --index 1 --new-name "书法组"
# 按原分组名改
python scripts/caiguwang_cli.py group-rename --id 19630 --name "摄影组" --new-name "手机摄影组"只改分组名称,不改选手归属(选手按分组序号挂组);改名后返回完整分组列表。不提供分组的新增/删除/选手换组——请引导用户到网页后台操作。
我的素材列表(material)
python scripts/caiguwang_cli.py material # 全部素材(最近上传在前)
python scripts/caiguwang_cli.py material --cate 0 # 仅未分组
python scripts/caiguwang_cli.py material --page 2 --size 20返回素材 url(图片可直接用作选手图片或 --cover)、type(1图片 2视频 3音频 4文件)、上传日期。创建活动前若用户说"用我之前传过的图",先用本命令列出素材再选用。
上传图片
选手图片/封面图支持两种来源:本地图片文件(multipart 上传)或图片链接(远程抓取)。
# 上传本地图片文件
python scripts/caiguwang_cli.py upload --file /path/to/photo.jpg
# 抓取图片链接(AI 生成的图片、图床链接均可)
python scripts/caiguwang_cli.py upload --url https://example.com/p1.jpg
# 封面图:加 --crop 750x464(与网页后台轮播图裁剪比例一致,CLI 本地裁剪)
python scripts/caiguwang_cli.py upload --file /path/to/cover.jpg --crop 750x464
python scripts/caiguwang_cli.py upload --url https://example.com/cover.jpg --crop 750x464返回 {"data": {"image_url": "https://..."}},把 image_url 用于 create 的选手图片或 --cover。
限制(与网页后台一致):
- 图片:jpg/png/gif/webp,10MB 以内;
- 上传前自动压缩(与网页后台上传行为一致):宽 > 1000 缩到 1000;PNG→webp(缩放 0.82 / 仅压 0.88)、其他→jpg(0.8 / 0.9);宽≤1000 且 ≤200KB 不压;GIF 不压;压缩结果更小才采用(需 Pillow,未装则原图上传);
- 封面图:网页后台要求 750:464 比例。处理方式:
upload --crop 750x464会在本地(CLI)用 Pillow 中心裁剪成 750×464 后上传,与后台裁剪效果一致;- 本地未装 Pillow 时,服务端只做比例校验(不依赖 GD):比例符合直接存,不符则报错并提示先裁剪;
- 可选依赖:
pip install pillow(仅封面自动裁剪需要);
- 视频/音频不支持:Skill 只做图文投票,视频/音频请在网页后台「素材管理」或活动编辑页上传;
- 上传后自动进入该账号素材库。
活动列表
python scripts/caiguwang_cli.py list --page 1 --size 10 --status ongoing --kw "绘画"--status 可选 ongoing(进行中)/ ended(已结束)/ pending(未开始)。返回含每个活动的参与人数、累计投票、浏览次数。
投票数据(选手榜单)
python scripts/caiguwang_cli.py vote-data --id 19630 --page 1 --size 20返回选手榜(rank 名次 / name 选手 / votes 票数),按票数降序。
活动整体数据
python scripts/caiguwang_cli.py view-data --id 19630返回参与人数(participants)、累计投票(votes)、浏览次数(visits)、TOP5。
返回值与错误
统一形态:{"success": true|false, "code": 200|1002|400|429|500, "msg": "...", "data": ...}
| code | 含义 |
|---|---|
| 200 | 成功 |
| 1002 | 令牌无效/已停用/被冻结 → 引导用户到后台「养虾Skill」页检查开关或重置 |
| 400 | 参数错误(msg 有具体中文提示,可直接转述给用户) |
| 429 | 今日创建次数已达上限(手动创建每天 20 次;AI 生成单独配额) |
| 500 | 服务异常 → 建议稍后重试或到网页后台操作 |
边界说明(务必遵守)
- 创建即生效:活动按投票时间自动开启/结束;把小程序码(分享)和编辑链接(调整)告知用户;
- 修改期限:活动结束后 1 天起,修改活动/添加和修改选手会被拒绝(与网页后台一致),提示用户"活动已结束,超过修改期限,请重新创建活动";
- 不提供删除/清空数据等高危操作:如用户要求删除活动,引导其到网页后台或小程序操作;
- 选手图片/封面:本地图片先经
upload转为素材 URL 再传给 create;封面图用upload --crop 750x464裁剪后再--cover传入(后台轮播图强制该比例);视频/音频不开放,引导用户到网页后台操作; - 内容规范:活动标题与说明须积极健康,违法违规内容平台会拒绝;
- 网页后台和小程序端功能更全(批量导入、防刷设置、海报等),复杂配置引导用户到对应端操作。