Files

jesxion d4c1e9affd 任务004: 创建快手CLI基础框架和Hermes Skill

- Skill: ~/.hermes/skills/kuaishou/SKILL.md
- CLI: ~/weekly-plan/scripts/kuaishou/kuaishou_client.py
- 支持短视频/直播/用户/数据分析12个命令
- 待扩展: 快手电商API（店铺/订单/商品）

2026-04-13 10:42:27 +08:00

2.5 KiB

Raw Blame History

任务004：快手平台 CLI

基本信息

任务ID: 004
任务名称: 快手平台 CLI + Skills
负责人: jesxion
创建日期: 2026-04-13
预计工期: 2天
状态: 已创建基础框架

目标

封装一套 CLI 工具和 Hermes Skills，使 Agent 能够调用 CLI 获取快手店铺信息。

已完成

已创建文件

1. Hermes Skill

路径: ~/.hermes/skills/kuaishou/SKILL.md
功能: 短视频/直播/用户管理/数据分析
认证: OAuth2（APP_ID + APP_SECRET + ACCESS_TOKEN + REFRESH_TOKEN）

2. Python CLI 脚本

路径: ~/weekly-plan/scripts/kuaishou/kuaishou_client.py
功能: 已实现 12 个命令
- user [user_id] - 获取用户信息
- videos - 列出视频
- video <id> - 视频详情
- upload <file> - 上传视频
- delete <id> - 删除视频
- analytics <id> - 视频分析
- play-data <id> - 播放数据
- livestream - 直播状态
- livestream-data - 直播数据
- comments <id> - 评论列表
- reply <id> <cid> <text> - 回复评论
- refresh-token - 刷新token

验证结果

python kuaishou_client.py --help  # ✓ 正常工作

待完善

问题

当前创建的skill基于快手开放平台（open.kuaishou.com，短视频/直播API），而任务需要的是快手电商API（kwaixiaodian.com，店铺/订单/商品API）。

扩展方向

扩展 CLI 支持快手电商 API（商品、订单、店铺信息）
获取快手电商开放平台开发者账号
测试实际 API 调用

已收集信息

快手电商开放平台

地址: https://open.kwaixiaodian.com/
文档: https://open.kwaixiaodian.com/zone/new/docs/dev

已开放的 API 类别

类别	功能
商品管理	管理商品信息/SKU、上下架商品、更新库存
订单管理	查看/管理订单、快速发货、更新物流信息
退款管理	查看/处理退款信息
物流管理	新增/管理运费模板
分销管理	管理推广位、管理分销计划/商品
客服管理	发送客服信息、订单/商品卡片

技术方案

CLI 设计（已搭建框架）

Python CLI，基于 click 框架
输出 JSON 格式
支持 token 自动刷新

Hermes Skills

Skill 框架已创建
需要根据实际电商 API 扩展

备注

基础框架已创建，需要获取快手电商开发者账号才能对接实际 API。

2.5 KiB Raw Blame History Unescape Escape