tp plugin

tp plugin publish ./my-plugin
tp plugin install alice/opsd-patch --exp my-grpo

一个插件就是一个里面有 plugin.yaml 的目录。整体流程见扩展点；manifest 见插件包。

实例

# 浏览
tp plugin ls
tp plugin info alice/opsd-patch

# 安装，并锁进某个实验
tp plugin install alice/opsd-patch                    # 到本地 tuneplane_plugins/，默认最新版
tp plugin install alice/opsd-patch --exp my-grpo      # 到实验的 plugins.lock.json
tp plugin remove alice/opsd-patch --exp my-grpo

# 发布
tp plugin publish ./my-plugin                         # 目录里必须有 plugin.yaml
tp plugin publish ./my-plugin --owner team-x          # 只有管理员能跨命名空间

# 治理（管理员）
tp plugin disable alice/opsd-patch                    # 新作业不能再引用它；历史保留
tp plugin enable alice/opsd-patch

--exp 是让一个插件跟着作业走的关键：提交时 JobSpec 里会引用那个锁文件，平台把包注入作业。不带 --exp 只会把它放到你自己机器上。

发布时检查什么

入口模块在包里存在。
顶层没有文件遮蔽真实依赖。根目录下一个 torch.py 会让训练进程里之后每一次 import torch 都加载你的文件。
声明包在 template/ 之外不含可执行文件。
重新计算的内容摘要与客户端声称的一致。
这个版本还不存在。版本不可变 —— 修 1.2.0 的方式是发布 1.2.1。

确认成功

tp plugin info alice/opsd-patch

会显示你刚发布的版本和它的 digest。提交引用了它的作业之后，作业日志里每个装载的插件有一行：

plugin  : alice/opsd-patch@1.2.0 loaded

禁用只拦新提交。已经在跑或在排队的作业不受影响。

`tp plugin`

Manage plugins

tp plugin <subcommand>

命令	说明
`tp plugin activate`	Activate a playbook or prompt version
`tp plugin deactivate`	Restore the built-in defaults
`tp plugin disable`	Disable a plugin
`tp plugin enable`	Enable a plugin (admin)
`tp plugin info`	Show a plugin’s details
`tp plugin install`	Install a plugin
`tp plugin ls`	List the plugins on the platform
`tp plugin publish`	Publish a plugin version
`tp plugin remove`	Remove a plugin from an experiment
`tp plugin validate`	Validate a plugin package

`tp plugin activate`

Activate a playbook or prompt version

tp plugin activate <REF>

参数	说明
`REF`	Exact plugin reference: owner/name@version (必填)

除 --help 外没有其他选项。

`tp plugin deactivate`

Restore the built-in defaults

tp plugin deactivate <KIND>

参数	说明
`KIND`	playbook or prompt (必填)

除 --help 外没有其他选项。

`tp plugin disable`

Disable a plugin

tp plugin disable <REF>

参数	说明
`REF`	Plugin id: <owner>/<name>[@version] (必填)

除 --help 外没有其他选项。

`tp plugin enable`

Enable a plugin (admin)

tp plugin enable <REF>

参数	说明
`REF`	Plugin id: <owner>/<name>[@version] (必填)

除 --help 外没有其他选项。

`tp plugin info`

Show a plugin’s details

tp plugin info <REF>

参数	说明
`REF`	Plugin id: <owner>/<name>[@version] (必填)

除 --help 外没有其他选项。

`tp plugin install`

Install a plugin

tp plugin install <REF> [options]

参数	说明
`REF`	Plugin id: <owner>/<name>[@version], defaults to the latest (必填)

选项	说明
`--exp`, `-e`	Lock it to this experiment: referenced with the JobSpec on submission, injected into the job package by the platform

`tp plugin ls`

List the plugins on the platform

tp plugin ls

除 --help 外没有其他选项。

`tp plugin publish`

Publish a plugin version

tp plugin publish <PATH> [options]

参数	说明
`PATH`	Plugin directory (必填)

选项	说明
`--owner`	Target namespace (only an admin can cross namespaces; defaults to your own)

`tp plugin remove`

Remove a plugin from an experiment

tp plugin remove <REF> [options]

参数	说明
`REF`	Plugin id: <owner>/<name> (必填)

选项	说明
`--exp`, `-e`	Experiment name or path (必填)

`tp plugin validate`

Validate a plugin package

tp plugin validate <DIRECTORY>

参数	说明
`DIRECTORY`	必填

除 --help 外没有其他选项。

CLI 参考

配置

实验

训练

产物与评测

资源

管理

实例

发布时检查什么

确认成功

`tp plugin`

`tp plugin activate`

`tp plugin deactivate`

`tp plugin disable`

`tp plugin enable`

`tp plugin info`

`tp plugin install`

`tp plugin ls`

`tp plugin publish`

`tp plugin remove`

`tp plugin validate`

​实例

​发布时检查什么

​确认成功

​tp plugin

​tp plugin activate

​tp plugin deactivate

​tp plugin disable

​tp plugin enable

​tp plugin info

​tp plugin install

​tp plugin ls

​tp plugin publish

​tp plugin remove

​tp plugin validate

实例

发布时检查什么

确认成功

`tp plugin`

`tp plugin activate`

`tp plugin deactivate`

`tp plugin disable`

`tp plugin enable`

`tp plugin info`

`tp plugin install`

`tp plugin ls`

`tp plugin publish`

`tp plugin remove`

`tp plugin validate`