前言¶
在 DeepSeek Harness（DSH）里做工作流时，常见做法是文本、工具调用和外部 API。如果任务涉及和声走向、和弦编排，纯文字难以「听」到效果，需要在浏览器里有一块可点按、可播放的板面，并由智能体通过工具读写板内容。Tele（npm 包名 @kyn0v/pi-tele）面向这类场景：为 AI 智能体提供可交互的吉他和弦板，并在 v0.2.0 起提供 DSH 插件形态。与在同一仓库内面向 Pi 的私有对话、音乐模式不同，DSH 插件只提供板面能力，不提供私有聊天、音乐模式或内嵌 DSH 面板。
这是什么¶
Tele 的定位是「面向 AI 智能体的交互式音乐工具」。维护者为 kyn0v，代码托管于 GitHub kyn0v/Tele，社区目录页为 SkillHub：kyn0v/Tele。在 DSH 侧，插件通过 tele_board 工具暴露目录查询、按 boardId 读取以及带 expectedRevision 与完整 content 的创建或替换；用户在 DSH 主机上的浏览器中手动打开返回的 URL 进行点按和弦与试听，页面与 DSH 聊天互不读写。
核心功能¶
以下为 README 与 package.json 中已写明、且针对 DSH 插件的能力：
- 可演奏吉他和弦板：智能体可要求修改和弦进行；用户在浏览器中点击和弦即可试听。
- DSH 工具
tele_board：查看目录、读取指定 board、在正确修订号下创建或更新板内容。 - 独立浏览器页面：非 DSH 内嵌面板；板能力配置为
chat: false、chatPanel: false，不展示 Pi 式对话侧栏。 - 本地服务与数据目录：默认
dataDir为~/.tele/dsh（会展开为绝对路径），默认port为0（自动选取空闲端口）；可在 Plugin Manager 中配置非空绝对路径的dataDir以及 0–65535 的整数端口。 - 跨会话共享：同一 profile 内使用插件时，板数据在会话间共享；能访问该本地服务的调用方也可读取，不宜存放私密对话或密钥。
运行环境要求：Node.js 22.19 及以上；DSH 版本需与包声明一致，Tele v0.2.0 仅声明支持 DSH 0.2.2-rc.1，未声称与其他 DSH 版本兼容。许可证为 MIT。
安装与启用¶
安装前请在 npm registry 确认 @kyn0v/pi-tele@0.2.0 可用。官方说明不要求 clone 源码、不要求本地 build；npm 包内已包含构建好的服务端与浏览器资源。
在 DSH 的 Plugin Manager 中安装 npm 包规格：
@kyn0v/pi-tele@0.2.0
也可让 DSH 智能体调用 plugin_manager，例如：
{
"action": "install_bundle",
"target": "@kyn0v/pi-tele@0.2.0"
}
安装后应查看返回的激活结果；失败或提示需重启并不等同于插件已在运行。插件以当前 DSH 进程的宿主用户权限运行，未提供操作系统级沙箱；安装前建议阅读仓库源码与 LICENSE，并理解板数据的可访问范围。
若需从本地源码开发安装（非普通用户必选路径），在 shell 中于绝对路径下执行 npm ci 与 npm run build，再在 Plugin Manager 中安装该绝对目录，或将同一目录作为 install_bundle 的 target；源码更新后需重新构建并按应用提示处理重载或重启。
典型用法¶
经过上面的安装步骤后，可按 README 中的 DSH 集成流程操作：
- 让 DSH 智能体使用
tele_board查看目录（catalogue）。 - 按
boardId读取已有板，或携带当前expectedRevision与完整content创建/替换板。 - 在返回结果中取得板 URL，在 DSH 所在主机 的浏览器中手动打开；Tele 不会自动拉起浏览器。
- 在页面中点按和弦卡片或组合播放，对照智能体改写后的和声进行确认。
板页支持在页眉 Language 中选择 English 或 简体中文；界面语言不改变已保存的和弦符号与板正文。README 还提供 npm run verify:dsh（构建后跑 fixture 检查）与 npm run verify:dsh:live -- http://127.0.0.1:PORT/b/board（只读检查线上板 URL），用于开发验证，不等同于完整 DSH 工具链或 Plugin Manager GUI 元数据校验。更完整的工具契约与真机清单见仓库内 DSH integration reference（文档路径以仓库为准）。
同仓库另支持 Pi 包安装（pi install npm:@kyn0v/pi-tele）及 /tele harmony 等命令，那是 Pi 会话内的私有链接与对话侧栏能力，不属于 DSH 插件交付范围，本文不展开。
适用场景与注意¶
适合谁：需要在 DSH 工作流里让模型维护和迭代吉他和弦编排，并在浏览器中即时试听、人工点按验证的开发者或编曲协作者。
应注意：
- 版本耦合：仅在与 DSH
0.2.2-rc.1搭配时，上游才在 v0.2.0 中声明支持；升级 DSH 或插件前应核对package.json的engines.dsh与 README。 - 安全与隐私：板对能访问本地插件服务的调用方可见；勿将 secrets 写入板内容。插件信任模型与宿主用户权限一致。
- 能力边界：DSH 插件不提供 Pi 的私有聊天、音乐模式或内嵌面板；浏览器页无法代替终端里其他扩展的确认对话框。
- 生态关系：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek、幻方无官方从属关系，本文所述安装方式均来自项目 README，而非臆测的
dsh plugin add github:…一类命令。
结尾¶
Tele 把「智能体改和弦进行」和「浏览器里可演奏的和弦板」接到一起，在 DSH 里用 tele_board 与本地板服务完成闭环。查阅详情可访问目录页 https://www.skillhub.cn/plugins/kyn0v/Tele 与源码 https://github.com/kyn0v/Tele。
