Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs: clarify optional component and partner provider installation
rpone8260cdc17d6e
diff --git a/docs/guide/providers.md b/docs/guide/providers.mdindex c9f79bb0..ce7679ba 100644--- a/docs/guide/providers.md+++ b/docs/guide/providers.md@@ -9,8 +9,8 @@ configured instance of that Provider, with its service address, credential referThe Runtime Profile binds the requested capability to an Endpoint.Hypit's official Distribution selects local Providers and the HypiHub Provider as defaults.-TokenDance, HiAPI, Pollo, BeatAPI and Monid Providers are independently versioned packages installed-by projects that choose those services. Other services connect through packages owned by the+TokenDance, HiAPI, Pollo, BeatAPI and Monid Providers are independently versioned optional npm packages, not default dependencies.+Install the chosen Provider in the video project. Other services connect through packages owned by theproduction or their authors. The Agent can implement a new service through the public SDK, just asit can create a visual component for a video.[Model and deployment services](./service-partners.md) introduces independent partners through thatdiff --git a/docs/guide/service-partners.md b/docs/guide/service-partners.mdindex 754b64a6..7e8edc12 100644--- a/docs/guide/service-partners.md+++ b/docs/guide/service-partners.md@@ -12,7 +12,7 @@ Providers, and users can connect their own services through project Providers.The services introduced below are independent partners. They have their own accounts, terms,prices, model availability and APIs. A partnership is an introduction, not a shared HypiHub account.-Each service Provider below is an independently versioned npm package. Install the one the project+These Providers are independently versioned optional npm packages, not installed with Hypit. Install the one the projectselects with the ordinary package manager, then name it in the Runtime Profile; merely installing itdoes not activate the service. Each Provider maps the installed models that service offers and reportsthat service's input limits, and its README lists both. A model the service offers beyond that set connects through the ordinarydiff --git a/docs/zh/guide/providers.md b/docs/zh/guide/providers.mdindex 8dc4e108..6c2e1539 100644--- a/docs/zh/guide/providers.md+++ b/docs/zh/guide/providers.md@@ -5,7 +5,7 @@ description: 选择账户、连接服务或添加模型,沿用同一套视频**Model** 定义要生成什么:输入、支持的参数和输出类型。**Provider** 知道如何通过某个服务完成这个请求。**Endpoint** 是配置好的 Provider 实例,包含服务地址、凭据引用和容量。Runtime Profile 将所需能力绑定到 Endpoint。-官方 Distribution 默认选择本地 Provider 与 HypiHub Provider。TokenDance、HiAPI、Pollo、BeatAPI 和 Monid Provider 是独立版本包,由选择相应服务的项目安装。其他服务通过项目或作者自己的包接入;Agent 可以使用公开 SDK 编写所需接入,就像为视频创建视觉组件。[模型与部署服务](./service-partners.md) 集中介绍独立合作服务,它们沿用同一套扩展方式。选择执行服务,与[选择 Agent 工作环境](./agents.md)是两件事。+官方 Distribution 默认选择本地 Provider 与 HypiHub Provider。TokenDance、HiAPI、Pollo、BeatAPI 和 Monid Provider 是独立版本的可选包,不是默认依赖,需在视频项目中额外安装所选包。其他服务通过项目或作者自己的包接入;Agent 可以使用公开 SDK 编写所需接入,就像为视频创建视觉组件。[模型与部署服务](./service-partners.md) 集中介绍独立合作服务,它们沿用同一套扩展方式。选择执行服务,与[选择 Agent 工作环境](./agents.md)是两件事。HypiHub 是我们推荐的集成托管服务。**BYOK** 指使用自己账户的 API Key:Key 通过兼容的 Provider 连接到签发它的服务。告诉 Agent 你已有哪个服务及其 API 文档,具体接线和项目包可以由 Agent 完成。Key 负责授权请求,本身不会实现 API 接口。一个项目可以为不同能力使用不同服务,分别使用各自的账户并按各自规则计费。diff --git a/docs/zh/guide/service-partners.md b/docs/zh/guide/service-partners.mdindex f16b5a5a..c6f11267 100644--- a/docs/zh/guide/service-partners.md+++ b/docs/zh/guide/service-partners.md@@ -10,7 +10,7 @@ HypiHub 是 Hypit 推荐的集成托管服务,提供已支持的生成与 Whis下面介绍的合作方是独立服务,各有自己的账户、条款、价格、模型可用性和 API。合作关系提供一个了解服务的入口,不共用 HypiHub 账户。-下面每个服务 Provider 都是独立版本的 npm 包。项目用普通包管理器安装自己选择的包,再在+下面的 Provider 是独立版本的可选 npm 包,不随 Hypit 安装。项目用普通包管理器额外安装所选包,再在Runtime Profile 中引用它;安装本身不会启用服务。Provider 覆盖该服务提供的已安装模型,并按该服务的输入限制报告不支持的请求;具体清单见各 Provider 的 README。服务提供、但不在这个范围内的模型,通过普通的 [Model 与 Provider](./providers.md) 扩展方式连接。diff --git a/migrations/0.3.1.md b/migrations/0.3.1.mdindex 782a6477..31246111 100644--- a/migrations/0.3.1.md+++ b/migrations/0.3.1.md@@ -33,6 +33,7 @@ a global executable does not update the project's explicit component dependencie| `@hypit/run-markup` cannot be found | Use the [current Run header](0.3.md#cannot-locate-installed-package-hypitrun-markup); no extra reader package is needed || A former root domain subpath is not exported | Migrate that component's import using the table below || A new domain package cannot be found | Declare and install it in the package that imports it |+| Ranking or a partner Provider cannot be found | These are optional, not default dependencies; install the selected package in the project, e.g. `npm install @hypit/ranking@^0.1.0` || The error originates inside an installed third-party package | Select an available migrated release, or explicitly arrange a source-level repair with the user || Installation reports conflicting peer versions | Inspect the root and the named package's requirements together; choose a compatible set || Files are updated but a running Studio or Worker still uses old code | Check the active process and installation, then restart that process when active work permits |diff --git a/migrations/0.3.1.zh-CN.md b/migrations/0.3.1.zh-CN.mdindex 92666cbe..0522bc28 100644--- a/migrations/0.3.1.zh-CN.md+++ b/migrations/0.3.1.zh-CN.md@@ -31,6 +31,7 @@ rg -n '@hypit/hypit/' packages --glob '*.{ts,tsx,js,mjs,cjs,json}' --glob '!node| 找不到 `@hypit/run-markup` | 使用[当前 Run 文件头](0.3.zh-CN.md#cannot-locate-installed-package-hypitrun-markup);不需要额外的解析器包 || 主包原来的领域子路径不再导出 | 按下表迁移该组件的导入 || 找不到新的领域包 | 在实际导入它的包中声明并安装依赖 |+| 找不到 Ranking 或合作 Provider | 它们是可选包,不是默认依赖;在项目中安装所选包,例如 `npm install @hypit/ranking@^0.1.0` || 错误来自已安装的第三方包内部 | 选择已发布的迁移版本,或与用户明确约定源码修复 || 安装时报告 peer 版本冲突 | 同时检查主包与报错包的要求,选择兼容的版本组合 || 文件已更新,但运行中的 Studio 或 Worker 仍使用旧代码 | 检查当前进程和安装;在不影响正在进行的工作时重启该进程 |diff --git a/migrations/0.3.md b/migrations/0.3.mdindex 0f63a346..8a428a35 100644--- a/migrations/0.3.md+++ b/migrations/0.3.md@@ -78,6 +78,9 @@ This reader change predates the published 0.3.0 release. It is not a 0.3.1-onlyAPI credentials do not affect reader resolution. `hypit cli use` selects installed commandcontributions, not document readers; `hypit packages install` is not a current command.For a genuinely missing external capability package, use the project's ordinary package manager.+Ranking and other optional components, plus partner Providers, are not included in the default+installation. Install the selected package in the project, for example `npm install @hypit/ranking@^0.1.0`;+for repository examples with a lockfile, use `npm ci` as their README directs.## 3. Migrate the work's relationships, not just tag namesdiff --git a/migrations/0.3.zh-CN.md b/migrations/0.3.zh-CN.mdindex 56c57b72..c233aeda 100644--- a/migrations/0.3.zh-CN.md+++ b/migrations/0.3.zh-CN.md@@ -76,6 +76,8 @@ Run 文件头解析成功,并不代表其 Author、所选包或 Targets 都有API 凭据不影响解析器的查找。`hypit cli use` 选择已安装的命令贡献,不选择文档解析器;`hypit packages install` 不是当前支持的命令。如果确实缺少外部能力包,请使用项目的普通包管理器安装。+Ranking 等可选组件和合作 Provider 不随默认安装提供。请在项目中安装所选包,+例如 `npm install @hypit/ranking@^0.1.0`;仓库中带 lockfile 的示例按其 README 执行 `npm ci`。## 3. 迁移作品中的关系,而不只是标签名称diff --git a/packages/provider-beatapi/README.md b/packages/provider-beatapi/README.mdindex d7d0feb8..f1449d25 100644--- a/packages/provider-beatapi/README.md+++ b/packages/provider-beatapi/README.md@@ -1,6 +1,6 @@# `@hypit/provider-beatapi`-Install in the video project alongside Hypit:+Optional Provider, not installed with Hypit. Install in the video project:```bashnpm install @hypit/provider-beatapidiff --git a/packages/provider-hiapi/README.md b/packages/provider-hiapi/README.mdindex 9671f88f..989be088 100644--- a/packages/provider-hiapi/README.md+++ b/packages/provider-hiapi/README.md@@ -1,6 +1,6 @@# `@hypit/provider-hiapi`-Install in the video project alongside Hypit:+Optional Provider, not installed with Hypit. Install in the video project:```bashnpm install @hypit/provider-hiapidiff --git a/packages/provider-monid/README.md b/packages/provider-monid/README.mdindex 731a6c17..2a2ce82a 100644--- a/packages/provider-monid/README.md+++ b/packages/provider-monid/README.md@@ -1,6 +1,6 @@# `@hypit/provider-monid`-Install in the video project alongside Hypit:+Optional Provider, not installed with Hypit. Install in the video project:```bashnpm install @hypit/provider-moniddiff --git a/packages/provider-pollo/README.md b/packages/provider-pollo/README.mdindex 15dbb7d9..7fc27bbb 100644--- a/packages/provider-pollo/README.md+++ b/packages/provider-pollo/README.md@@ -1,6 +1,6 @@# `@hypit/provider-pollo`-Install in the video project alongside Hypit:+Optional Provider, not installed with Hypit. Install in the video project:```bashnpm install @hypit/provider-pollodiff --git a/packages/provider-tokendance/README.md b/packages/provider-tokendance/README.mdindex 266df2d5..d41ae287 100644--- a/packages/provider-tokendance/README.md+++ b/packages/provider-tokendance/README.md@@ -1,6 +1,6 @@# `@hypit/provider-tokendance`-Install in the video project alongside Hypit:+Optional Provider, not installed with Hypit. Install in the video project:```bashnpm install @hypit/provider-tokendancediff --git a/packages/ranking/README.md b/packages/ranking/README.mdindex 0e2f0ec9..750b04e7 100644--- a/packages/ranking/README.md+++ b/packages/ranking/README.md@@ -1,6 +1,6 @@# `@hypit/ranking`-Install in the video project alongside Hypit:+Optional component, not installed with Hypit. Install in the video project:```bashnpm install @hypit/rankingdiff --git a/skills/hypit/references/environment/model-and-provider.md b/skills/hypit/references/environment/model-and-provider.mdindex c2809b96..c73f7cab 100644--- a/skills/hypit/references/environment/model-and-provider.md+++ b/skills/hypit/references/environment/model-and-provider.md@@ -41,7 +41,9 @@ those capabilities. Its current catalogue, account access and rates still determA user's existing service or deployment remains a normal choice. When a suitable maintained Providerpackage is available, use its published version and package instructions; otherwise a project Provider-can connect the service through the same interfaces. The+can connect the service through the same interfaces. TokenDance, HiAPI, Pollo, BeatAPI and Monid+Providers are optional: install the selected npm package in the video project before configuring its+Endpoint; HypiHub and local Providers are defaults. The[model and deployment service page](https://github.com/hypit-ai/hypit/blob/main/docs/guide/service-partners.md)introduces partners and links their own documentation. A partnership alone does not establish that aparticular capability, account or implementation is available. Carry an already suitable, chosendiff --git a/skills/hypit/references/production/component-design.md b/skills/hypit/references/production/component-design.mdindex dfe886cf..ee36f244 100644--- a/skills/hypit/references/production/component-design.md+++ b/skills/hypit/references/production/component-design.md@@ -117,6 +117,8 @@ coordinated explainer scenes. Trace why a behavior has its owner, what drives itinputs a changed brief would replace. Their notes explain those choices; the scene lists are eachproduction's design. In the explainer, scenes retain fixed internal details while Script events,Caption and presenter framing remain independently authored.+Install the selected example's declared dependencies first; `npm ci` installs optional components+such as Ranking where its README and lockfile specify them.For that whole-work relationship, read [Presenter-led visual explainers](../playbooks/formats/presenter-led-explainer.md).The [explainer's craft notes](https://github.com/hypit-ai/hypit/blob/main/examples/complex-explainer/productions/explainer/CRAFT-NOTES.md)trace concrete revisions back to their design decisions and source owners.