dsh-libtv

LibTV 的 DeepSeek Harness 插件：一次安装，同时带来 LibTV 的 MCP 工具（画布、图片/视频/音频生成、剧本、剪辑、导出）和三个生产用技能。

不需要预装 Node，不需要敲命令。首次使用时会自动打开浏览器，用微信扫码授权一次，之后长期有效。

安装

在 DSH 里任选一种：

# 1) 插件市场（dshmarket）里搜 dsh-libtv，点安装
# 2) CLI
dsh plugin add dsh-libtv

安装后无需重启：工具和技能会在当前会话内直接出现。

Related MCP server: RunningHub Canvas Bridge

首次使用：扫一次码

第一次让模型做 LibTV 相关的事时，它会调用内置的 libtv_auth 工具，你的默认浏览器会自动打开 LibTV 授权页：

1. 浏览器里用微信扫码登录 / 确认授权；

2. 看到"授权成功"，回到 DSH 继续说你要做的事即可。

凭据保存在 ~/.libtv/credentials.json（权限 0600），access token 约 1 小时到期，由 refresh token 自动续期，不需要再扫。换机器、删了凭据、或长期未用导致 refresh 失效时，重复上面这一次扫码即可。

也可以自己开口触发：告诉模型「用 libtv_auth 授权 LibTV」。

为什么必须扫码

LibTV Remote MCP 用的是 OAuth 2.1 授权码 + PKCE（https://mcp.liblib.tv/mcp），令牌只能由你本人的 LibTV 账户签发，插件无权代你登录。扫码是这套标准流程的自然界面，也是插件唯一无法替你完成的一步——正因如此，它不需要你填任何 API Key 或密码。

装完有什么

工具（mcp__libtv__*）

1 个本地工具 + 86 个 LibTV 远端工具：

技能

• libtv-to-treatment — 把画布成果整理成可翻页的导演提案

• libtv-blender-live-action — 剧本 → Blender 白模预演 → Seedance 实拍视频

• music-driven-product-ad — 20 秒音乐驱动产品广告

可选配置

一般不需要动。都是环境变量，改宿主环境即可：

86 个工具的 schema 会常驻上下文。如果你只用其中几类，建议用 LIBTV_TOOL_FILTER 或写一行到 ~/.libtv/tools.allow（每行一个工具名，# 开头为注释）来瘦身。

它怎么工作

DSH 宿主
  └─ stdio: process.execPath lib/main.mjs           ← 不依赖系统 Node
       └─ lib/serve.mjs   协议桥 + OAuth 网关 + 工具过滤
            └─ https://mcp.liblib.tv/mcp           ← Bearer token，401 自动刷新重放

• 未授权也能正常加载：宿主握手由本地应答，工具面板里只有 libtv_auth，模型一调它就开浏览器。授权成功后自动建立远端会话并刷新工具列表，无需重启。

• 令牌不出本机：只写 ~/.libtv/credentials.json；不读任何环境变量里的 token（宿主会清洗 *_TOKEN 之类的子进程环境变量）。

• 长任务不超时：toolCallTimeoutMs 设为 20 分钟，视频生成/导出不会被误判。

排障

无头环境可以直接跑 CLI（等价于 libtv_auth，只是不经过模型）：

npx -p dsh-libtv libtv-auth login    # 打印授权链接并等待回调
npx -p dsh-libtv libtv-auth status
npx -p dsh-libtv libtv-auth logout

开发

git clone <repo> && cd dsh-libtv
node lib/cli.mjs status          # 用本机凭据自检
node ../test-serve.mjs           # 模拟宿主跑一遍握手与工具列表

改完本地联调：在 DSH 里把插件目录直接装上去

plugin_manager install_bundle target=<绝对路径>/dsh-libtv

License

MIT