@zwook/live-kit

中文文档
0.1.3发布于 2026/11/03UNLICENSEDES Module

Zwook Live Kit - AbletonMCP安装程序+电报桥的生产者

中文使用文档
文档目录7 节
  1. Быстрый старт (студенты)
  2. 窗户
  3. Команды
  4. Куда ставится远程脚本
  5. Требования
  6. Публикация(будущее)
  7. Лицензия上游

标签:

  • zwook
  • 文档
  • 易宝

Zwook Live Kit

Один пакет для продюсера: установка AbletonMCP远程脚本 (hk GitHub, без поиска папок внутри Live) + подключение <e:1>电报-боту (релей - без SSH, Taiga #72)。

Быстрый старт (студенты)

npx @zwook/live-kit install
# Live → Settings (Preferences) → Link, Tempo & MIDI → Control Surface: AbletonMCP
# Код — из Telegram: /live connect
npx @zwook/live-kit connect      # спросит код
# Дальше — просто:
npx @zwook/live-kit connect
# В Telegram: live status

Инструкция: https://mcp.sonicum.com

Или двойной клик:

  • 麦克: mac/Zwook Live — Install.command,затем mac/Zwook Live — Connect.command… (на Mac студенты подключаются через npx @zwook/live-kit connect вТерминале)
  • 窗口: windows/Zwook Live — Install.cmd,затем windows/Zwook Live — Connect.cmd (код спросит, окне)

窗户

Полностьюподдерживается: install находит %APPDATA%\Ableton\Live *\Preferences\User Remote Scripts, connect/start/status работают как на Mac. Отличия:

  • Установка: windows/Zwook Live — Install.cmd (двойной клик) или npx @zwook/live-kit install
  • Настройка生活: 选项→首选项 活得精彩 设置)→链接,节奏和MIDI→控制面 AbletonMCP
  • Подключение: windows/Zwook Live — Connect.cmd (спросит код из /live connect;при повторном запуске достаточно进入)
  • tunnel (SSH)требуетвключённогоOpenSSH -клиентаWindows——ностудентамонненужен

Команды

КомандаДействие
installСкачивает __init__.py с ahujasid / ableton-mcp во все найденные User Remote Scripts
pathsПоказывает пути Ableton (диагностика)
connect --code XXXX-XXXXПервое подключение: меняет код из /live connect на токен устройства (сохраняется ~/.zwook-live/credentials.json)
connectПовторноеподключениекрелею(безфлагов,信誉изфайла;автопереподключение)
startЛокальный HTTP网桥 127.0.0.1:9878 →激活TCP 9877 (для ssh -пути мейнтейнера)
tunnelSSH反向隧道на сервер (только мейнтейнеры)
statusПроверка Live + bridge

connect держит соединение * переподключается <e:2>;Коды выдаёт бот (/live connect),устройствахранятсянасервере——новый招生перепривязываетустройствоиотключаетстарое。

Куда ставится远程脚本

Автоматическив 用户库→远程脚本 (так Live 10+ ищет пользовательские скрипты)

  • macOS: ~/Music/Ableton/User Library/Remote Scripts/AbletonMCP/__init__.py
  • 窗口: %USERPROFILE%\\Documents\\Ableton\\User Library\\Remote Scripts\\AbletonMCP\\

用户库еЕслищёнет(住ниразунеоткрывали),安装падаетобратнонастарыепапки ~/Library/Preferences/Ableton/Live <версия>/User Remote Scripts (macOS)или %APPDATA%\\Ableton\\Live <версия>\\Preferences\\User Remote Scripts (Windows)——生活10 +ихигнорирует,поэтомусначалаоткройте住одинразиповторите安装。

Не нужно лезть Applications/Ableton Live.app/Contents/... (это сбрасывается при обновлении)。

Требования

  • node . js 20 +
  • Ableton Live 10+
  • 易宝открытхотябыраз(чтобысоздалисьпапки偏好)

Публикация(будущее)

cd packages/zwook-live-kit
npm publish --access public
# у тестера:
npx @zwook/live-kit install

Лицензия上游

远程脚本- ableton-mcp (麻省理工学院)。Zwook Live Kit - обёртка установки bridge。

版本与发布记录

@zwook/live-kit 共发布 5 个版本,首次发布于 2026/11/03;过去 12 个月发布了 5 个版本。

版本发布日期距今
0.1.3latest2026/11/03今天
0.1.22026/11/03今天
0.1.12026/11/03今天
0.1.02026/11/03今天
0.0.0-stage2026/11/03今天

关于 @zwook/live-kit 的常见问题

@zwook/live-kit 是什么?

Zwook Live Kit - AbletonMCP安装程序+电报桥的生产者

如何安装 @zwook/live-kit?

在项目目录运行 npm install @zwook/live-kit,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 zwook-live,可以用 npx zwook-live 直接运行。

@zwook/live-kit 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/zwook__live-kit 是否存在。

@zwook/live-kit 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@zwook/live-kit 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@zwook/live-kit 可以商用吗?

@zwook/live-kit 使用 UNLICENSED 许可。作者声明为 UNLICENSED,即不授予公开使用许可(与公共领域的 Unlicense 不同)。使用前需获得作者授权。以上为概括,不构成法律意见,请以许可原文为准。

@zwook/live-kit 还在维护吗?

最新版本 0.1.3 发布于 2026/11/03(今天);至今共发布 5 个版本,其中过去 12 个月发布了 5 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。