cli
一条命令,把口播毛片变成可二次精修的剪辑工程。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
Its scripts were only partly scanned.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Gitruck/cli with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Gitruck/cli'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/gitruck--cli)HTML
<a href="/listings/gitruck--cli"><img src="/api/listings/gitruck--cli/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 20 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "gitruck",
- "owner": {
- "name": "Gitruck (同合云)",
- "url": "https://ai-mcn.tv/gtrk"
- },
- "metadata": {
- "description": "gtrk video-creation Skills for Claude Code"
- },
- "plugins": [
- {
- "name": "gtrk",
- "source": "./",
- "description": "Agent-native video creation: turn your own footage into an editable multi-track project and export to Jianying/CapCut, Premiere XML, FCPXML or OTIO. Requires the gtrk CLI (npm @gitruck/cli).",
- "category": "productivity",
- "homepage": "https://ai-mcn.tv/gtrk",
- "license": "MIT"
- }
- ]
- }
README.md · README · 260 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="assets/readme/wordmark.svg" alt="gtrk CLI" width="420">
- <h1>一句句把片子聊出来</h1>
- <p><strong>让你的 AI Agent,把素材做成可以继续精修的视频工程。</strong></p>
- <p>剪口播 · 切高光 · 做解说 · 配画面 · 叠动效 · 上字幕</p>
- <p>
- <a href="#demo">观看演示</a> ·
- <a href="#quick-start">快速开始</a> ·
- <a href="https://hocassian.feishu.cn/wiki/HCFpwoF7SivIFbkKosgcFMcEnxk">使用教程</a> ·
- <a href="https://github.com/Gitruck/ai-drama-desk">AI Drama Desk</a> ·
- <a href="docs/development.md">开发文档</a> ·
- <a href="README.en.md">English</a>
- </p>
- <p>
- <a href="https://www.npmjs.com/package/@gitruck/cli"><img src="https://img.shields.io/npm/v/@gitruck/cli?style=flat-square&color=f43b48" alt="npm 版本"></a>
- <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-%E2%89%A520.6-43853d?style=flat-square" alt="Node.js ≥20.6"></a>
- <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-f43b48?style=flat-square" alt="MIT"></a>
- <img src="https://img.shields.io/badge/CLI-Windows%20%7C%20macOS%20%7C%20Linux-555?style=flat-square" alt="CLI 支持 Windows、macOS、Linux">
- </p>
- <p><a href="https://ai-mcn.tv/gtrk"><strong>产品主页 ↗</strong></a> <a href="https://cloud.ai-mcn.tv/zh-CN/download"><strong>下载客户端 ↗</strong></a> <a href="https://cloud.ai-mcn.tv/zh-CN/dashboard"><strong>获取 API Key ↗</strong></a></p>
- </div>
- <!-- 中英双份:修改本页须同步 README.en.md,详细参数维护在 docs/reference*.md。 -->
- **gtrk 是为 AI Agent 准备的视频创作 CLI。** 在 Codex、Claude Code、Cursor、TRAE 等支持 Skills 的 Agent 里说需求,Agent 调用 gtrk 完成剪辑与装配,你在客户端里看效果、挑素材、调细节。
- 从一条口播、一场访谈、一篇稿子或一组旅拍素材开始。把粗剪、配画面、动态图、配乐和字幕接成工作流,也可以单独调用其中一个工具。**你负责创意和判断,gtrk 负责执行。**
- <a id="demo"></a>
- ## 每一步都能改,每一层都在轨上
- <a href="https://www.bilibili.com/video/BV1HAec6fELP/"><img src="assets/readme/editable-project.webp" alt="真实客户端工程:画面预览、动态图与多轨时间线,可逐段精修。点击观看流程速览。" width="100%"></a>
- <p align="center"><strong>在 Agent 里说需求,在客户端里看效果。</strong><br>上图为真实客户端工程。<a href="https://www.bilibili.com/video/BV1HAec6fELP/">▶ 2 分 28 秒,看完整条路</a></p>
- | 先看一次实测 | 再看完整制作 |
- | :---: | :---: |
- | [](https://www.bilibili.com/video/BV1PcYK6kEEL/) | [](https://www.bilibili.com/video/BV1iZYK6YEew/) |
- | **7 分钟快速模式** · 口播、字卡、BGM、字幕 | **35 分钟解说实战** · 看素材、写稿、配音、配画面 |
- <a id="quick-start"></a>
- ## 安装一次,开始对话
- 准备一个支持 Skills、能执行本地命令的 AI Agent,以及 **Node.js ≥ 20.6**。
- ```bash
- npx @gitruck/cli@latest install
- ```
- 安装器会配置 gtrk、安装配套 Skills,并引导填写 API Key。Key 在[同合云控制台](https://cloud.ai-mcn.tv/zh-CN/dashboard)获取;调用云端能力需要账户和可用额度。完成后重新打开 Agent 会话,让新 Skills 生效。
- 把素材文件夹交给 Agent,然后说:
- > 帮我把「口播.mp4」做成一期视频,文字稿在同目录。先给我看制作方案。
- 只想先粗剪,也可以说:
- > 把这条口播剪一版,去掉重复和长停顿,给我能在剪映里继续改的工程。
- **Windows 推荐同时安装桌面客户端**,用于预览和精修:[全套安装指南](https://hocassian.feishu.cn/wiki/HCFpwoF7SivIFbkKosgcFMcEnxk) · [客户端下载](https://cloud.ai-mcn.tv/zh-CN/download)。CLI 支持 Windows、macOS、Linux;桌面客户端目前提供 Windows 版。
- <details>
- <summary>直接用命令、检查环境与升级</summary>
- ```bash
- gtrk oralcut "./talk.mp4" --script "./script.txt"
- gtrk transcript "./interview.mp4"
- gtrk doctor
- gtrk upgrade
- ```
- 音视频处理需要 FFmpeg。用 `gtrk deps status` 检查;缺少时按提示显式运行 `gtrk deps install`。已有配置会保留,需要修改时用 `gtrk init --reconfigure`。
- [完整配置与命令参考](docs/reference.md)
- </details>
- <details>
- <summary>从 Skills 目录或插件市场安装(Claude Code / Codex)</summary>
- ```bash
- # 通用 skills CLI(skills.sh)
- npx skills add Gitruck/cli
- # Claude Code 插件市场
- /plugin install gtrk --marketplace Gitruck/cli
- # Codex 插件市场
- codex plugin marketplace add Gitruck/cli
- codex plugin add gtrk@gitruck
- ```
- 以上几种方式都只装 Skills。gtrk CLI 和 API Key 仍需用 `npx @gitruck/cli@latest install` 安装和配置。
- </details>
- ## 看看它能做什么
- 下面选用与[产品专页](https://ai-mcn.tv/gtrk)一致的真实案例。点击封面观看成片,口播示例也可打开原片对比。
- <table>
- <tr>
- <td width="50%" valign="top">
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/oralcut/webm/fishing_after.webm"><img src="https://api.ai-mcn.tv:9000/cloud/static/assets/showcase/posters/oralcut/fishing_after.webp" alt="器材测评口播成片" width="100%"></a>
- <strong>口播:从毛片到包装成片</strong><br>
- 1:04 → 0:48 · 粗剪、结构图解、器材特写、字幕。<br>
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/oralcut/webm/fishing_before.webm">看原片</a> · <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/oralcut/webm/fishing_after.webm">看成片</a> · <a href="https://hocassian.feishu.cn/wiki/Y6Odw4Kz5iPKMxkOOPJc6FyOnpe">口播教程</a>
- </td>
- <td width="50%" valign="top">
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/l2s/webm/huangqin_talking_demo_1_16_9.webm"><img src="https://api.ai-mcn.tv:9000/cloud/static/assets/showcase/posters/l2s/huangqin_talking_demo_1_16_9.webp" alt="双人访谈高光短片" width="100%"></a>
- <strong>长剪短:让好话题单独成片</strong><br>
- 26:29 访谈中的 45 秒高光 · 横竖屏分别制作。<br>
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/l2s/webm/huangqin_talking_demo_1_16_9.webm">横屏成片</a> · <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/l2s/webm/huangqin_talking_demo_1_9_16.webm">竖屏成片</a> · <a href="https://hocassian.feishu.cn/wiki/Gls1wTebVi1tpDkeaK8cINqbnMb">长剪短教程</a>
- </td>
- </tr>
- <tr>
- <td width="50%" valign="top">
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/narration/travel/webm/3.webm"><img src="https://api.ai-mcn.tv:9000/cloud/static/assets/showcase/posters/narration/travel_3.webp" alt="黄石国家公园旅拍解说" width="100%"></a>
- <strong>旅拍:把一组素材讲成故事</strong><br>
- 黄石国家公园 · 3:05 · 素材理解、解说、配音与画面。<br>
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/narration/travel/webm/3.webm">看成片</a> · <a href="https://hocassian.feishu.cn/wiki/CjDPwyLMcimfjDk1c2NcSv3unCf">旅拍教程</a>
- </td>
- <td width="50%" valign="top">
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/narration/food/webm/1.webm"><img src="https://api.ai-mcn.tv:9000/cloud/static/assets/showcase/posters/narration/food_1.webp" alt="铁板炒肉定食美食解说" width="100%"></a>
- <strong>美食:一家店,一顿饭,一条片子</strong><br>
- 铁板炒肉定食 · 2:36 · 提炼看点、保留现场、重述故事。<br>
- <a href="https://api.ai-mcn.tv:9000/cloud/static/assets/narration/food/webm/1.webm">看成片</a> · <a href="https://hocassian.feishu.cn/wiki/EbY3wo6YhiABCjkhczRcpixVniQ">美食教程</a>
- </td>
- </tr>
- </table>
- [更多题材与前后对照 →](https://ai-mcn.tv/gtrk)
- ## 从你的素材开始
- 不用记命令或 Skill 名字,直接描述想做的事。
- | 你手上有什么 | 对 Agent 说 | 工作流 |
- | --- | --- | --- |
- | 一条或几条口播,可能还有外录音频 | “把这些口播做成一期,剪掉重录,配上字卡和字幕。” | [口播](https://hocassian.feishu.cn/wiki/Y6Odw4Kz5iPKMxkOOPJc6FyOnpe) |
- | 一篇已经写好的稿子 | “用这篇稿子做条配音视频,先给我选音色。” | [配音](https://hocassian.feishu.cn/wiki/CdpewYDOmialPLkjOmacI97Wnfd) |
- | 播客、课程、访谈或直播回放 | “挑出值得单发的话题,做成几条短片工程。” | [长剪短](https://hocassian.feishu.cn/wiki/Gls1wTebVi1tpDkeaK8cINqbnMb) |
- | 影视、游戏、旅拍或探店素材 | “看完这些素材,提炼看点,写解说并配画面。” | [通用解说](https://hocassian.feishu.cn/wiki/CmtRwmqzYi5dRtkWKgDc7ApWnre) |
- | 录屏和同时录制的人像 | “把录屏合进来,做成讲师画中画。” | [录屏画中画](https://hocassian.feishu.cn/wiki/GO84wbFqOi9W92kzGzpcc3nQnNh) |
- | 一批现场素材,想保留同期声 | “把这批素材做成纪实 Vlog,保留现场声音,再补旁白。” | [Vlog Skill](skills/gtrk-vlog-docu/SKILL.md) |
- 长剪短保留原声高光;解说会提炼素材并重新讲述。具体流程、交付文件和可选环节见[工作流指南](docs/workflow.md)。
- ## 为什么用 gtrk
- - **在你熟悉的 Agent 里创作。** 配套 Skills 负责组织步骤,CLI 负责执行;也能直接接入脚本和自动化流程。
- - **工程留在手里。** 画面、音频、字幕和动效写进可编辑工程。你可以在客户端继续调整,并按支持范围导出到剪映、Premiere。
- - **用自己的素材,也能找新画面。** 按文稿检索本地素材库或平台素材,将候选铺到时间线上,逐段挑选。
- - **栏目风格可以复用。** 字体、配色、画面语言和创作规则可通过自己的 Skills 与栏目配置延续到下一期。
- ## 一份工程,贯穿全程
- ```mermaid
- flowchart LR
- A["你在 Agent 里说需求"] --> B["gtrk CLI 执行"]
- B <--> C["同合云分析与处理"]
- B --> D["本地 .gtrk 工程"]
- D <--> E["客户端预览与精修"]
- D --> F["CLI 渲染 MP4"]
- E --> G["导出成片 / 支持的剪辑工程"]
- ```
- **当前对话入口在你自己的 Agent 中,客户端没有内置 AI 对话框。** Agent 修改工程后,在客户端查看效果、继续精修;也可以用 `gtrk render` 渲染成片。需要云端渲染的动态图会单独计费,缓存可复用。
- 粗剪阶段的三端工程,与完整包装后的导出支持范围不同;[工作流指南](docs/workflow.md)说明每种交付物在哪打开、哪些效果需要渲染。
- 客户端精修 `.gtrk` 后,用 `gtrk project export --project <目录>` 导出剪映、Premiere XML、FCPXML 或 OTIO,保留精修时间线;不要重跑 `oralcut`,否则会重新生成粗剪。导出会把 MG 颗粒预渲进 NLE 工程,结构导出按次计费,未命中共享缓存的颗粒按分钟计费;`project init` 仍是 0 积分。只选 `gtrk` 时会保留原生 `beat_track` 并自动跳过颗粒预渲。
- ## gtrk + AI Drama Desk:从分镜到可回轨片段
- 如果你的素材不是实拍,而是希望把一份分镜稿变成 AI 情景片段,可以把 [Gitruck AI Drama Desk](https://github.com/Gitruck/ai-drama-desk) 接到同一条工程链里。两者分工很清楚:
- | 组件 | 负责什么 | 产物 |
- | --- | --- | --- |
- | `gtrk CLI` | 在 Agent 中理解需求、组织工作流、管理 `.gtrk` 工程 | 可继续精修的视频工程 |
- | `AI Drama Desk` | 导入分镜稿、管理角色与画风、生成 keyframe / I2V 片段、导出回轨包 | `return-v1` 片段包 + `manifest` |
- | `gtrk ai-drama lay` | 把工作台导出的片段按 beat 区间铺回工程 | 独立 AI 视频轨 |
- 典型路径是:
- ```text
- 分镜稿 md → AI Drama Desk → 角色参考图 / keyframe / I2V → return-v1 导出包
- ↓
- gtrk ai-drama lay → .gtrk 工程 → 客户端精修
- ```
- 工作台支持 mock、云端出口和可选的本地 ComfyUI;你可以先零 GPU、零 Key 跑通流程,再按需要启用真实引擎。已有工作台项目时,CLI 只需要 **API 地址 + 项目 ID**,不需要扫描仓库目录:
- ```bash
- gtrk ai-drama lay --project ./my-video --desk-project <project-id>
- ```
- → [AI Drama Desk README](https://github.com/Gitruck/ai-drama-desk) · [AI 漫剧教程](https://hocassian.feishu.cn/wiki/FRAKwUvBWib2vrkqZ5XcLDRqnOe) · [命令参考](docs/reference.md#命令参考)
- ## 成片之外,也能只做一件事
- | 想做什么 | 从这里开始 |
- | --- | --- |
- | 抠像、降噪、人声分离、超分、补帧、图片运镜、视频译制 | [单点工具箱](https://hocassian.feishu.cn/wiki/Uh19wAphailtSqkt6jsclW0Rnie) · `gtrk tool list` |
- | 做一套多尺寸封面 | [封面工作流](https://hocassian.feishu.cn/wiki/AD5bwUAHris75vkWl4DcsvPJntb) |
- | 把一首歌做成频谱视频 | [音乐可视化 Skill](skills/gtrk-music-visualizer/SKILL.md) |
- | 拆解一条参考视频的包装与节奏 | [参考片精读 Skill](skills/gtrk-ref-reading/SKILL.md) · `gtrk media` |
- | 给自己的栏目建立视觉风格 | [风格体系 Skill](skills/gtrk-style-maker/SKILL.md) |
- | 接入第三方动画、排版或创作 Skills | [Skill 地图](https://hocassian.feishu.cn/wiki/SxRtwJ0G7inTbQkwckFcZmClnrd) |
- ## 常见问题
- **需要会写代码吗?**
- 不需要。日常使用可以直接对 Agent 描述需求。安装、配置或费用需要你提供信息时,Agent 会引导你完成。
- **开源等于所有服务免费吗?**
- CLI 代码采用 MIT 许可证;同合云能力按对应规则计费,你使用的 Agent 和第三方生成服务也可能单独收费。价格与额度以[控制台](https://cloud.ai-mcn.tv/zh-CN/dashboard)和[计费说明](https://hocassian.feishu.cn/wiki/Iq9NwC3briQ2TJkSrzPcm5Jensd)为准。
- **原始视频会被上传吗?**
- 口播粗剪和长剪短工程流程保留本地原片,默认上传提取的音频;开启视觉辅助或智能分屏时上传压缩代理视频。云端直接处理或渲染的工具可能需要上传视频,按具体工具说明执行。
- **一定要用 Windows 客户端吗?**
- CLI 可以跨平台执行。Windows 客户端用于可视化预览与精修;已有工程也可通过 CLI 渲染。剪映、Premiere 的使用取决于对应软件和工程格式的支持情况。
- **安装后找不到 Skills,或任务出错怎么办?**
- 重新打开 Agent 会话,运行 `gtrk doctor` 检查环境;补装用 `gtrk skills install`。任务已有 ID 时优先恢复结果,避免重新提交云端任务。详见[工作流与排障](docs/workflow.md)。
- ## Star History
- <a href="https://star-history.com/#Gitruck/cli&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Gitruck/cli&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Gitruck/cli&type=Date" />
- <img alt="gtrk CLI Star History" src="https://api.star-history.com/svg?repos=Gitruck/cli&type=Date" />
- </picture>
- </a>
- ## 文档与参与
- [完整教程](https://hocassian.feishu.cn/wiki/HCFpwoF7SivIFbkKosgcFMcEnxk) · [工作流](docs/workflow.md) · [命令参考](docs/reference.md) · [开发文档](docs/development.md) · [更新日志](CHANGELOG.md)
- 欢迎通过 [Issues](https://github.com/Gitruck/cli/issues)反馈问题和提出建议,或提交文档、示例与代码改进。商务联系:[business@gitruck.com](mailto:business@gitruck.com)。
- [MIT 许可证](LICENSE) · [用户协议](https://hocassian.feishu.cn/wiki/T6UywR8b3ik4Mgk7tP9c1b7Kn0b) · [隐私政策](https://hocassian.feishu.cn/wiki/ZLRNwlEhfishYtkosUhcofMYnPf)
- <p align="center">如果 gtrk 帮你省下了剪辑时间,欢迎点个 Star,让更多创作者找到它。</p>
src/lib/desktop-client-hint.ts · Bundled script · 48 lines · 2 findings marked
- /**
- * 桌面客户端提示(change gate-desktop-client-hint-by-platform · desktop-client-boundary spec)。
- *
- * 主理人 2026-08-17 定的方向性约束:**exe 顺带装 cli,但 cli 别顺带装 exe**。
- * 随附关系严格单向 —— 客户端安装包可以随附/引导安装 CLI(见 opencut 仓
- * `cli-companion-install` spec 的 Requirement 4),反向不成立:
- * 本 CLI 的任何发行物与任何命令 MUST NOT 随附、下载、静默安装桌面客户端,
- * 也 MUST NOT 把客户端当作自身任何能力的运行前置。
- *
- * 单向的两条硬理由:
- * ① **CLI 跨平台,客户端只有 Windows**(mac 在 opencut 的 add-macos-desktop-support
- * 射程内、Linux 无计划)——反向随附等于把跨平台的 CLI 绑死在 Windows;
- * ② CLI 的消费者是终端里的 agent,其中相当一部分从头到尾不需要 GUI。
- *
- * 本模块的定位:CLI **MAY 在信息层面提及**客户端,但
- * - 止步于「告知」:只打一行命令,MUST NOT 代为执行;
- * - **限定在客户端真实可用的平台**上呈现 —— 在 macOS/Linux 上打一条
- * PowerShell `irm … | iex` 既跑不通也无从谈起,是纯噪音。
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 18 on GitHub
- */
- /** 客户端(桌面端)一键升级 = 重跑安装脚本(NSIS 覆盖装最新、per-user、免管理员)。 */
- export const CLIENT_UPGRADE_CMD = "irm https://api.ai-mcn.tv:9000/broadcast/exe/install.ps1 | iex";
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 22 on GitHub
- /** 客户端有发行版的平台。目前只有 Windows;mac 版上线后在此扩,别散落在各调用点判。 */
- const CLIENT_PLATFORMS: readonly string[] = ["win32"];
- /**
- * 本平台是否有桌面客户端可言。
- * @param platform 缺省取 `process.platform`(注入仅供测试)
- */
- export function hasDesktopClient(platform: string = process.platform): boolean {
- return CLIENT_PLATFORMS.includes(platform);
- }
- /**
- * 取「客户端升级」提示行;**无客户端的平台恒返 null**(调用点据此静默跳过)。
- *
- * 刻意返回 `string | null` 而不是空串:null 表达「这个平台没有这回事」,
- * 空串会被误当成「有提示但内容为空」。
- *
- * @param prefix 提示的前半句(如「客户端(桌面端)如需一起升级」)
- */
- export function desktopClientUpgradeHint(
- prefix: string,
- platform: string = process.platform,
- ): string | null {
- return hasDesktopClient(platform) ? `${prefix}:${CLIENT_UPGRADE_CMD}` : null;
- }
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.