Knobwerk

关于项目

v0.39.0

Knobwerk——硬件乐器说明书的可交互、面向 LLM 的重制版。

这是一个非官方的社区项目,把 Elektron 的用户说明书重制为可交互的形式——让“怎么操作”“这个参数是做什么的”这类问题比翻 PDF 更快得到答案。目前覆盖 Elektron Tonverk(OS 1.4.0)、Syntakt(OS 1.40A)、Digitone II(OS 1.10D)和 Digitakt II(OS 1.15A)。

页面上的内容都由一条可复现的流水线从官方说明书编译而来:每条操作流程、参数和 MIDI 地址都被抽取为结构化数据、与原文逐条核对,并渲染成可交互的面板演示。每条记录都标注了它出自说明书的哪一节。

为什么会有这个项目

我的 Tonverk 已经在桌上摆了好几个月。我是一个彻头彻尾的合成器/电子音乐制作新手,Tonverk 对我来说就是一头猛兽。我看 YouTube,频道里每个人都很酷,随手就能拨弄出一段带感的鼓组、一段动人的乐句;而我对着说明书一筹莫展——它很厚,满是闻所未闻的概念,我不知道该做什么,甚至不知道自己想做什么。这就像把一台 Phase One 中画幅相机塞给一个摄影新手:当你不懂构图、不懂色彩、不懂光线、甚至不懂相机的基本操作时,你真能拍出好照片吗?

借助 AI(thank goodness,如今的 AI 如此发达),我开始一点点补课,却依然在说明书和机器的操作逻辑之间迷失。AI 几乎替我解构了整本说明书,在每次回答里不厌其烦地告诉我:按下 X、旋转 A、同时按住 C+D。但对照着回答在机器上来回找按键的过程效率极低。这启发了我做这个项目:一本至少能让我一目了然地看到“这个操作到底怎么做”的电子说明书。

这个项目是用 Claude 的 Fable 模型构建的——这是我能找到的最强的编程模型。幸运的是,我本来就是 Claude 的重度用户,忙完自己的工作之余,还有不少空闲 token 可以燃烧在这个项目上。我希望这本电子说明书能帮到和我一样困惑的人。我坚持一个原则:所有内容必须来自原版说明书,绝不由 AI 杜撰。另外,鉴于我是音乐制作的门外汉,我不会把自己关于音乐制作的观点写进说明书里——尽可能让它保持纯粹。

项目在缓慢但持续地迭代:我给它配了一个全新的域名,强化了面板交互,加上了多语言支持(如果你需要其他语言,尽管提)。我也加入了另外几台机器,但目前的主要精力仍在 Tonverk 上,其他机器还没有达到同样的完成度。至于要不要开源,我还没想好,请给我一点时间。

我真心希望这个项目能帮到别人——那些和我一样热爱电子音乐的人。享受音乐,也享受 Elektron 带来的这些不可思议的机器。

包含哪些功能

技术栈

Next.js、TypeScript、Tailwind CSS、shadcn/ui 与 Web MIDI;数据流水线使用 Python。

数据再利用

手工撰写的部分——深入解读文章、学习路径、概念讲解、作者自述,以及中文和日文翻译——是本项目的原创内容。如需再利用,请署名 Knobwerk 并附上 https://www.knobwerk.com 的链接;请勿整体转载,也请勿将其呈现为 Elektron 的官方材料。

编译得到的参考数据——说明书文本、参数信息、操作流程、MIDI 地址——源自 Elektron 的官方用户说明书。本项目不对 Elektron 的内容主张任何版权,也无权授予其再利用许可;这些内容只是在此被重组为可交互的阅读形式,每条记录都注明出处章节。如果你基于本项目对这些数据的结构化成果继续构建,希望你注明出处并附上链接;至于底层内容本身,请以 Elektron 为准。

免责声明

这是一个独立的非官方项目,与 Elektron Music Machines MAV AB 无任何隶属或背书关系。“Elektron”“Tonverk”等名称为其各自所有者的商标,此处仅用于标识本指南所记录的硬件。请始终以官方说明书和你的硬件为准。关于名字的说明:这里的“Knobwerk”只是 knob(旋钮)+ werk(德语“工坊/作品”),为这个文档项目而取——它与任何以相同或相近名字录制、演出的音乐人或艺术家均无关联,双方之间不存在任何关系或背书。