DJCCCCCCCC/midi_operater

README 摘要

dsh-midi-plugin 为 DeepSeek Harness 添加 MIDI 文件的识别、编辑与可视化能力，基于 @tonejs/midi 功能 - 识别 ： midi summary （概览）、 midi read （完整音符）、 midi chords （和弦进行） - 编辑 ： midi write （写回）、 midi transpose （移调，可只移单条声部）、 midi quantize （量化）、 midi tempo （改速度） - 可视化 ： midi read 的调用卡片带 FL Studio 风格钢琴卷帘（缩放、拖拽平移、轨道筛选） 组成 插件分两部分： 部分 文件 生命周期 作用 持久化 bundle （必装） index.js + midi.js + cordis.patch.yml 随 profile 持久，重启不丢 7 个 MIDI 工具 动态伴侣 （可选） plugin.host.js + plugin.client.js + worker.mjs 会话级，重启后需重载 钢琴卷帘（在对话卡片里渲染） 工具是核心能力，靠 bundle 持久化。钢琴卷帘是可选的浏览器可视化，走动态插件（harness 对第三方只开放这一条 UI 通道）；它用 host.call('midi-preview') 直接读完整文件，不受工具结果 24KB 截断限制，所以大文件也能画。 安装 一键安装 脚本会自动完成：装依赖 → 打包 → 装进 profile → 验证。重启 web 服务后 7 个工具生效。 装到其他 profile： npm run install:plugin -- tui （把 tui 换成你的 profile 名）。 手动安装 验证是否装好： 可选：钢琴卷帘 钢琴卷帘是浏览器可视化，属于动态插件，无法随上面的命令自动安装（harness 的安全机制要求授权）。想要的话，对 AI 说一句： 加载 midi 伴侣 AI 会完成注册，你点一次「允许」并刷新页面即可。之后 midi read 的调用卡片里就会带出钢琴卷帘。 动态插件是会话级的，重启 web 服务后需要再说一次「加载 midi 伴侣」。工具（7 个 MIDI 工具）不受影响，永远在。 使用 把 .mid 文件放进工作区目录，让模型处理即可： 工具 参数 说明 midi summary path 紧凑概览：速度/拍号/调号/轨道/音色/音符数 midi read path, mode? 解析为 JSON； mode=full （默认）含每个音符 midi write path, midi 把 JSON 写回 .mid midi transpose path, semitones, trackIndex?, outputPath? 移调； trackIndex 只移…

分类