# Kuaishou Publish

快手内容发布：脚本预览、媒体上传、提交结果保存和 published-track 入库。

- Repository: https://github.com/TeamWiseFlow/xiaobei (8678 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TeamWiseFlow/xiaobei --skill kuaishou-publish -g -a claude-code -y`
Codex: `npx skills add TeamWiseFlow/xiaobei --skill kuaishou-publish -g -a codex -y`
Cursor: `npx skills add TeamWiseFlow/xiaobei --skill kuaishou-publish -g -a cursor -y`
Gemini CLI: `npx skills add TeamWiseFlow/xiaobei --skill kuaishou-publish -g -a gemini-cli -y`

## Description

快手内容发布：脚本预览、媒体上传、提交结果保存和 published-track 入库。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 快手发布

**本版本快手视频固定采用「先发私密作品，再把简介交给用户手动补齐并公开」的协作流程。** 接到视频发布任务时说明这一限制；已有该流程的发布授权就直接执行，不逐条重复询问是否改走私密暂存。具体顺序：

1. 准备成片与最终简介（含话题），保留简介供交付；平台提交为空简介、`--visibility private`。
2. 按下述方式本地预览，按需登录，再加 `--confirm` 提交私密作品。
3. 确认私密提交结果后，把**完整可复制的简介正文（含话题）直接发给用户**，同时说明：请在快手 App 找到这条私密作品，手动补简介、按需完成平台声明，再自行改为公开。不能只给简介文件路径或让用户自行找文案。
4. 如实告知审核/作品识别状态，保留原收据与发布记录；用户完成公开后沿用原记录核实，不另发一条作品。

**话题上限：快手平台单条视频描述最多支持4个 hashtag（`#话题`）。准备和交付简介时先核对数量，超过4个须精简至4个以内；交给用户在 App 手动补填的简介同样适用。**

索取扫码前，先按目标内容运行不带 `--confirm` 的发布预览，完成媒体、可见性、简介和参数能力检查。预览不访问平台；通过后才检查 `kuaishou-publish check`，需要登录时使用 `kuaishou-hunter login`。

`kuaishou-publish methods` 返回支持参数及取值。

```bash
kuaishou-publish publish --text @/绝对路径/body.txt --image /绝对路径/image.jpg --source-folder /绝对路径/kuaishou/outputs/作品 --account default
kuaishou-publish publish --text @/绝对路径/body.txt --image /绝对路径/image.jpg --source-folder /绝对路径/kuaishou/outputs/作品 --account default --confirm
```

默认只预览，不访问平台。多行正文先保存为 UTF-8 纯正文文件，用 `--text @/绝对路径/body.txt` 由脚本读取；不要用 `$(cat ...)` 或将多行文案拼进命令。路径含空格时给整个 `@路径` 参数加引号；文件只放正文和话题。媒体用真实本地文件。`--record-title` 可指定记录标题。视频与图集二选一；图集 1, 31 张、每张不超过 15MB，可见范围 public/private/friends。没有 --cover/--mention/--poi 等选项。私密图集接口有平台验证记录；没有自动删除接口。

视频接口目前仅覆盖空简介、仅自己可见、立即发布的分支，已实号确认可提交并进入审核。审核通过与实际可见仍须分别核查。已有上述协作流程的发布授权时使用：

```bash
kuaishou-publish publish --video /绝对路径/video.mp4 --visibility private --record-title "测试记录标题" --source-folder /绝对路径/kuaishou/outputs/测试 --account default
```

`--record-title` 只用于本地记录，不向平台提交标题。视频不要传 `--title`、非空 `--text`、`--tag`、`--topic` 或 `--schedule`；未指定 `--visibility private` 也会在上传前拒绝。正式公开视频及带简介的视频交用户在原平台完成，不建议靠养号、等待或改参数绕过未支持的分支。

参数支持范围以 `kuaishou-publish methods` 的 constraints 为准，本地能力限制应明确说明来源，不能表述成平台已拒绝本轮内容。

私密视频暂存默认 `distribute_status=1`（当前无需分发）；有实际分发计划时可显式传 `--distribute-status 0`，2 表示已分发。该参数仅用于本地记录，不提交平台；其他发布分支保持 published-track 原默认值，补录时按实际需求填写。

核对文本、媒体、账号、可见范围与声明后，已有发布授权时加 --confirm。

The rest: https://github.com/TeamWiseFlow/xiaobei/blob/HEAD/crews/main/skills/expert-kuaishou/tools/kuaishou-publish/SKILL.md