Skip to content

joeseesun/qiaomu-cut-skill

qiaomu-cut

Verified

把一句话需求转成可复现、可验收视频工程的乔木智能剪辑导演。Use when the user asks to create, plan, edit, remix, explain, narrate, subtitle, animate, composite, or render a video—including one-line requests such as “制作一个科普视频:介绍 LLM 中的 RL”. Builds English-learning movie mixes, person profiles, explainers, code-drawn motion graphics (UI morph loops, showreels, kinetic-type promos, line-art/pixel/Three.js animation, lyric MVs), product launch videos, cinematic shorts, social clips, course/PPT videos, AI image/video/TTS/music-assisted stories, stock-footage stories, or multi-source montage. Routes across 33台词, ClipSeek/open media, local files, ListenHub, image generation, HTML/SVG/Canvas motion graphics with beat-grid storyboards and determinism probes, Manim, ffmpeg-full, captions, sound design, frame-0 video covers with YouTube thumbnails, and release checks.

FileKindSize
SKILL.mdskill md54.0 KB
agents/interface.yamlconfig17.2 KB
agents/openai.yamlconfig323 B
assets/explainer-social/base.cssother24.9 KB
assets/explainer-social/component-runtime.jsscript41.1 KB
assets/explainer-social/scene-shell.htmlother829 B
assets/motion-kit/qiaocut-motion.jsscript8.2 KB
assets/qiaomu-profile/qiaomu_avatar.jpegbinary5.6 MB
assets/qiaomu-profile/qiaomu_reward_qr.pngbinary515.9 KB
assets/qiaomu-profile/qiaomu_wechat_public_account_qr.jpgbinary8.3 KB
references/ad-concept-library.mdmarkdown6.5 KB
references/aesthetic-preferences.mdmarkdown3.0 KB
references/brand-card-templates.mdmarkdown1.6 KB
references/chinese-font-themes.mdmarkdown804 B
references/cinematic-techniques.mdmarkdown2.8 KB
references/code-motion-direction.mdmarkdown11.1 KB
references/cover-thumbnail-method.mdmarkdown6.4 KB
references/english-mix-fast-path.mdmarkdown6.0 KB
references/explainer-autopilot.mdmarkdown11.1 KB
references/feedback-evolution.mdmarkdown37.6 KB
references/ffmpeg-full.mdmarkdown1.7 KB
references/incremental-production.mdmarkdown4.4 KB
references/licensing.mdmarkdown1.9 KB
references/listenhub-provider.mdmarkdown12.6 KB
references/motion-prompt-patterns.mdmarkdown9.3 KB
references/movie-montage-fast-path.mdmarkdown4.4 KB
references/qiaocut-ir.mdmarkdown4.2 KB
references/renderer-engines.mdmarkdown3.3 KB
references/schemas/qiaocut.timeline.v1.schema.jsonconfig7.2 KB
references/social-safe-zones.mdmarkdown3.3 KB
references/source-adapters.mdmarkdown5.7 KB
references/source-selection-gate.mdmarkdown2.5 KB
references/styles/cinematic.mdmarkdown475 B
references/styles/explainer.mdmarkdown1.5 KB
references/styles/social-short.mdmarkdown383 B
references/timeline-schema.mdmarkdown12.2 KB
references/trust-boundary.mdmarkdown3.0 KB
references/workflows.mdmarkdown7.5 KB
scripts/adapters/33tc.jsscript2.1 KB
scripts/adapters/33tc_cli.jsscript4.8 KB
scripts/adapters/clipseek.jsexecutablescript5.4 KB
scripts/adapters/listenhub.jsscript35.7 KB
scripts/adapters/listenhub_cli.jsexecutablescript2.1 KB
scripts/adapters/local.jsscript2.4 KB
scripts/audio_beats.jsscript17.5 KB
scripts/bilingual_typography_smoke.jsscript1.4 KB
scripts/bootstrap_listenhub.shexecutablescript5.4 KB
scripts/bootstrap_macos.shexecutablescript2.5 KB
scripts/brand_templates.jsscript2.4 KB
scripts/brand_templates_smoke.jsscript869 B
scripts/complete_sentence.jsscript3.9 KB
scripts/component_motion_smoke.jsscript21.2 KB
scripts/concept_smoke.jsscript5.6 KB
scripts/cover.jsscript9.1 KB
scripts/cover_smoke.jsscript5.1 KB
scripts/english_mix.jsscript24.1 KB
scripts/english_mix_smoke.jsscript5.7 KB
scripts/explainer_beats.jsscript6.7 KB
scripts/explainer_beats_smoke.jsscript4.8 KB
scripts/explainer_cognitive_timing_smoke.jsscript5.8 KB
scripts/explainer_e2e_smoke.jsscript7.4 KB
scripts/explainer_pipeline.jsscript49.3 KB
scripts/explainer_pipeline_smoke.jsscript12.7 KB
scripts/explainer_spec.jsscript51.4 KB
scripts/explainer_timing.jsscript8.6 KB
scripts/fetch_generated.jsexecutablescript17.4 KB
scripts/ffmpeg_retry_shim_smoke.jsscript2.3 KB
scripts/file_narration_smoke.jsexecutablescript6.6 KB
scripts/ingest_asset.jsexecutablescript15.0 KB
scripts/kinetic_caption_smoke.jsscript1.4 KB
scripts/license_report.jsexecutablescript2.3 KB
scripts/listenhub_narration.jsexecutablescript11.0 KB
scripts/listenhub_smoke.jsexecutablescript26.7 KB
scripts/local_preferences.jsscript1.8 KB
scripts/motion_studio.jsscript55.9 KB
scripts/motion_studio_smoke.jsscript11.0 KB
scripts/movie_montage.jsscript24.7 KB
scripts/movie_montage_smoke.jsscript4.0 KB
scripts/qcut.jsexecutablescript40.8 KB
scripts/release_check.jsscript7.0 KB
scripts/render_project.jsscript85.1 KB
scripts/render_scene.jsscript26.4 KB
scripts/renderers/ass.jsexecutablescript2.7 KB
scripts/renderers/bilingual_ass.jsscript12.6 KB
scripts/renderers/html_scene.jsexecutablescript3.9 KB
scripts/renderers/procedural_music.jsscript7.6 KB
scripts/scene_content_cache.jsscript3.2 KB
scripts/scene_renderer_smoke.jsscript2.8 KB
scripts/security_smoke.jsscript10.2 KB
scripts/sentence_boundary_smoke.jsscript1.6 KB
scripts/setup_deps.jsscript8.4 KB
scripts/shims/ffmpegexecutablescript3.0 KB
scripts/source_review.jsexecutablescript5.1 KB
scripts/timeline_features_smoke.jsscript3.7 KB
scripts/trigger_eval.pyexecutablescript2.5 KB
scripts/validate_skill.pyexecutablescript3.1 KB
scripts/verify_marswave_vendor.jsexecutablescript3.5 KB
scripts/verify_video.jsexecutablescript3.4 KB

references/source-adapters.md

View on GitHub
# Source Adapters

qiaomu-cut 的素材源必须走统一 adapter contract,避免把“搜索、下载、许可、归因、缓存”混在剪辑逻辑里。

## Adapter Contract

```ts
type AssetCandidate = {
  id: string
  source: string
  provider: string
  mediaType: "video" | "photo" | "illustration" | "audio" | "html" | "svg" | "generated-image"
  title?: string
  sourcePage?: string
  thumbnail?: string
  downloadMode: "direct" | "provider_source_page" | "manual" | "generated"
  licenseStatus: "verified" | "verify_at_provider" | "user_provided" | "ai_generated" | "unknown"
  attribution: string
  raw?: unknown
}
```

## 当前已实现

### ClipSeek

- CLI:`node scripts/qcut.js clipseek "挖掘机" --type video --json`
- 角色:免费素材发现入口。
- 支持:视频、照片、插画。
- 返回:标题、缩略图、原始素材页。
- 边界:不直接证明许可,不直接下载原始文件。

### Local

- CLI:`node scripts/qcut.js local /path/to/assets --recursive --json`
- 角色:扫描用户提供的本地素材。
- 边界:不删除、不覆盖原文件;许可默认为 `user_provided`。

### 33tc

- CLI:`node scripts/qcut.js doctor --json` 会检测 33tc 本机状态。
- 搜索:`node scripts/qcut.js 33tc search "台词" --json`。
- 角色:影视台词/片段工作流。
- 公开包边界:`qiaomu-cut` 只委托 `QIAOMU_33TC_CLI` 或 `PATH` 中独立安装、获得授权的 `33tc` 适配器;不再分发 App 私有协议、签名或解密实现。
- 隐私:qcut wrapper 清洗结构化 token/cookie/password 字段和 URL;独立 adapter 仍必须避免输出无字段标签的裸凭据。公共 JSON 输出应使用字段白名单。
- 外部写操作:`pick` / `cut` 会创建远端裁片任务并可能消耗积分,必须先核对时间范围,且仅在明确确认后传 `--yes`。
- 下载弹性:`pick/cut/download` 的 HTTP(S) 输入默认经过有界 ffmpeg reconnect/retry;本地文件不重试。若任务已创建但下载失败,qcut 输出已有 task ID 和 `download --no-status` 恢复提示,禁止为修复下载重新提交付费 cut。
- 许可:成功下载不等于获得影视作品的公开传播或商业权利。

### ListenHub / MarsWave

- CLI:`node scripts/qcut.js listenhub doctor --json`。
- 能力:AI 图片、视频镜头、TTS、ListenHub Voice、多角色播客、音乐、解说片、Slides 在线产物、URL 内容解析,以及 `coli` 本地 ASR。
- 运行:委托单独安装的 `@marswave/listenhub-cli`;本地 ASR 委托 `@marswave/coli`。完整上游快照只作为锁定参考,不直接执行嵌套 `SKILL.md`。
- 认证:只读取 `LISTENHUB_API_KEY` 或 ListenHub CLI 自身凭据;公共输出只显示配置状态。
- 付费门:远端创建必须同时提供 `--yes` 与 `--qcut-project`。上传本地文件还必须提供 `--allow-upload`。
- 结果:原始任务 JSON 以 `0600` 写入项目私有 `.qiaocut/jobs/listenhub/`;终端输出会清除密钥、Bearer 和签名 URL。
- 入库:用 `qcut fetch` 从私有任务结果下载,完成 HTTPS/DNS/体积/MIME/文件签名检查后,写入 `assets/generated/` 与 `assets-manifest.json`。已有本地文件用 `qcut ingest`。
- 默认旁白:新中文讲解音频优先使用 `qcut listenhub narration`;它只读查询 Chinese speakers、唯一精确匹配“向阳乔木 v1.1”、默认请求 MP3、执行 TTS、自动 ingest 并返回带 speaker/text/catalog/capture provenance 的时间线对象。缺失或歧义时不得静默换音色。
- 默认生图:先按主题、受众、年代、情绪、平台与媒介锁定 visual bible,再选 agent imagegen 或 ListenHub image。Provider 选择不能替代内容一致性审查。
- 许可:生成物标记 `ai_generated` 和 `provider_terms_unverified`;上游 MIT 许可证不等于生成内容可商用。

完整命令与边界见 `references/listenhub-provider.md`。

## 计划/推荐扩展

### Provider Download Adapters

ClipSeek 返回原站页面后,应通过原站 adapter 完成下载和许可记录。

- `pexels`:下载视频/照片,记录 Pexels source page/license。
- `pixabay`:下载视频/图片/矢量,记录 Pixabay source page/license。
- `unsplash`:照片,记录 Unsplash page 和 attribution。
- `wikimedia`:开放授权图片/视频,记录 author/license。
- `nasa`:NASA Image and Video Library,记录 public domain/status。
- `internet-archive`:公共领域或开放素材,逐项记录 rights。
- `openverse`:开放授权聚合搜索,记录源站。

### Generated Sources

- `imagegen`:AI 生成封面、插图、背景、缺口 B-roll。
- `listenhub`:生成图片、短视频镜头、旁白、对白、音乐与完整解说源片;所有临时 URL 必须先本地化。
- `svggen`:图标、流程图、HUD、字幕装饰。
- `htmlgen`:网页卡片、排行榜、人物档案、产品界面。
- `chartgen`:数据图表、地图、趋势动画。

### Information Sources

用于人物、公司、事件、论文和历史视频:

- 官方网站
- Wikipedia / Wikidata
- 新闻源
- 论文/PDF
- 本地笔记或用户资料

规则:事实型视频必须保留 citation manifest。

### Capture Sources

- browser screenshot / screen recording
- app demo recording
- slides export
- terminal recording

规则:需要用户授权的账号界面不得自动公开,除非用户明确要求。

## 选择策略

1. 用户素材优先:本地文件最可控。
2. 开放许可素材第二:Pexels/Pixabay/Wikimedia/NASA 等,但必须记录原站。
3. AI 生成补缺口:用于抽象、封面、背景,不冒充真实事件。
4. 影视片段只用于用户授权/合理使用边界内的学习、评论、研究或用户私有项目;公开视频需谨慎。
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall