前言¶
在 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。
