LibTV CLI（libtv）

libtv 的文档地图。子命令与选项权威文案以 libtv --help 与 libtv <子命令> --help 为准；当文档与 --help 不一致时，以 CLI 实际输出为准并修订本 skill。

术语：本 CLI 里 画布（project） 是真正的画布文件，项目（workspace）= 工作区 是装画布的容器，一个项目下可放多张画布。

画布 / 分组范围：在画布所在工作目录执行 libtv project use <画布UUID>，写入 .libtv/project.json 的 projectUuid；之后大多数子命令（libtv node / libtv upload / libtv group）在省略 -p / --project 时即使用该画布。需要限定到某个普通分组时，再执行 libtv group use <分组> 写入 groupNodeKey。详见 commands/project.md、commands/group.md。

项目（工作区）绑定：用 libtv workspace use <项目ID> 把目录绑定到一个项目（工作区），写入 .libtv/project.json 的 workspaceId，用于 project create / project list 的默认项目范围。workspace use 不设置默认画布，会清掉原 projectUuid / groupNodeKey；project use 会写入画布，并把该画布实际所属的 workspaceId / teamId 同步进本地状态。详见 commands/workspace.md。

文档地图