技能介绍

解决的问题

手工做投票页、改选项、查票数通常分散在网页后台和接口之间，运营需要反复切换，参数和素材路径也不容易沉淀成脚本。这个技能把投票鸭的常用操作收敛到 CLI：先查模板，再创建作品，然后维护选项、分组、素材，最后拉取投票记录和访问趋势，适合做批量活动页或定时数据巡检。

技能如何工作

技能依赖 requests，上传素材还依赖 cos-python-sdk-v5。认证优先复用 ~/.toupiaoya/config.json 中的 X-Openclaw-Token，也可用 --access-token 显式传入。

模板检索：按 --keywords、--color、分页和排序字段查询模板，返回可用于 project create 的 templateId。
创建投票：通过 project create 提交 briefTitle、briefDesc、voteType、时间范围和 groupList；不传时间时服务默认创建后 10 天结束。
选项与分组：使用 get_choices、add_choices、update_choices 和分组命令维护文字、封面、排序及分组关系。
数据与素材：project list 拉取作品，投票数据返回表头 obj、分页 map 和明细 list；project view-data 返回 uv、pv、spv、fpv 趋势；上传素材走 COS PutObject 后写入素材库。

适用边界

该技能面向已有投票鸭账号和 token 的运营脚本化场景。返回结构以 JSON 为主，id == 0 时可能只返回 data.code 供拼接预览链接；创建失败常见 400、404。素材上传若 COS 成功但 saveFile 失败，错误里会保留 cos 字段，需要结合对象 key 与素材接口分别排查。