# @zwook/live-kit 中文文档

规范地址：https://npmcn.com/package/%40zwook/live-kit/

版本：0\.1\.3
npm 元数据更新时间：2026-11-02T23:00:22.245Z
中文译文更新时间：2026-11-03T01:11:02.659Z
软件包许可：UNLICENSED

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40zwook/live-kit
原文对照：https://npmcn.com/package/%40zwook/live-kit/?lang=original
项目主页：https://mcp.sonicum.com/
源码仓库：https://github.com/dancingteeth/zwook

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：42.9 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：1 个
- 首次发布：2026-11-02T21:19:38.313Z
- 最新版本发布：2026-11-02T23:00:22.072Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install @zwook/live-kit
```

也可以使用：`pnpm add @zwook/live-kit`、`yarn add @zwook/live-kit`、`bun add @zwook/live-kit`

## README

* * *

标签:

-   zwook
-   文档
-   易宝

* * *

# Zwook Live Kit

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

## Быстрый старт （студенты）

```bash
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](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](https://github.com/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 -пути мейнтейнера） |
| `tunnel` | SSH反向隧道на сервер （только мейнтейнеры） |
| `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+
-   易宝открытхотябыраз(чтобысоздалисьпапки偏好)

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

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

## Лицензия上游

远程脚本- [ableton-mcp](https://github.com/ahujasid/ableton-mcp) (麻省理工学院)。Zwook Live Kit - обёртка установки bridge。

## 常见问题

### @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 和提交记录判断。