文档
支持/代理

代理

AI代理(WebMCP)

通过WebMCP让浏览器中的AI读取并编辑序列,修改实时可见。

本页内容

什么是WebMCP

WebMCP是拟议Web标准,让网页向浏览器内AI提供工具。每项有名称、说明、输入定义,代理发现并调用,类似Model Context Protocol,但工具在页面内运行。

它操作当前会话打开的方案,不需账户、服务器或上传,改动立即出现在PUNCHER。

这是W3C Web Machine Learning Community Group的草案。API仍在变化,尚无浏览器为所有网站默认开启。

代理能做什么

PUNCHER提供十九个工具,读取全序列并修改几乎所有手动可改内容。

工具功能
get_sequence读取设置、声部、节奏、所有非空步、调制、播放状态和选择
set_steps多步音符、移调、休止、跳过、跳转、CC包络
set_voices声部设置、节奏和圆点选项
list_rhythm_presets列出预设名称、分组、步速、圆点
apply_rhythm_preset像面板一样应用命名节奏
set_euclidean均匀分布击数并旋转,如击数/长度/旋转控件
transform_pattern反向、反转、镜像、加倍、减半、随机、清空、填满
set_sequencer速度、大小、步速、方向、循环、音阶等
set_modulations像齿轮一样将设置绑定CC以调制
step_menu复制、粘贴、前后插入、清空、删除
play, pause, stop播放控制
set_recording录音开关及目标步
set_actionsHold、Sync、Flip、Transpose
select_step显示、试听或安排下一步
undo, redo撤销与重做
clear_sequence清空步并重置声部

步、声部、圆点从1编号。使用音名,C4为中央C。匹配预设或欧几里得时,工具像面板一样返回其身份。

仍由您掌控的部分

文件保存、打开、导出需要您在文件对话框点击,代理不能做;也不能改设置中的MIDI端口、主题和SoundFont。它可启动录音,但只有您能演奏输入。

浏览器音频需要页面点击或按键,代理调用不算。合成器无声时点一下页面。play和get_sequence会告诉代理何时无法听到声音。

撤销与安全

  • 每次请求一次撤销。 编辑→撤销(Ctrl + Z)撤回整个调用,无改动不记历史。
  • 全部成功或全不执行。 任一部分无效则不改任何内容,并返回原因。
  • 修改可见。 首个被编辑的步或声部自动选中。
  • 方案留在浏览器。 工具作用于当前方案,代理只见调用返回,主要是get_sequence。使用统计只记录工具名。方案名、文件名可能来自任意打开文件,代理被要求视其为不可信内容。

开启

在punchermidi.app使用Chrome 149或更新版。PUNCHER参与Chrome的来源试用,本站无需设置,试用持续至2027年3月。

本地或其他地址:

  1. 打开chrome://flags/#enable-webmcp-testing。
  2. 将WebMCP for testing设为Enabled,重启Chrome。

浏览器支持仍在变化:Microsoft Edge也列出了WebMCP源试用。上述设置针对Chrome。只有页面启用了WebMCP API,PUNCHER才会提供工具;浏览器名称本身不能保证可用。没有该API时,音序器仍可正常使用。

试用

最方便的是Chrome扩展Model Context Tool Inspector:

  1. 从Chrome Web Store安装。
  2. 打开编辑器,点扩展图标打开列有工具与输入的侧栏。
  3. 用{}运行get_sequence,返回当前方案。
  4. 用{ "tempo": 96, "scale": "A minor" }运行set_sequencer,设置立即改变;编辑→撤销可恢复。

然后可要求:“创建A小调四和弦循环,声部1低音,声部2琶音,然后播放。”好的代理先读取,再少量调用,最后播放。

没有工具时

  • 确认Google Chrome 149或更高版本。
  • Ctrl + Shift + R重新加载。
  • DevTools中Application → Frames → top → Origin Trials查看令牌是否接受及拒绝原因。
  • 非本站地址启用开启中的标志。

更多资料

PUNCHER / 支持与文档