前言¶

DeepSeek Harness (DSH) 生態強調插件化，開發者常需調試 Arduino、STM32、ESP32 等嵌入式設備。傳統方式需要手動複製串口日誌或編寫腳本讀取，效率較低。dsh-serial 插件通過將電腦串口接入 DSH 環境，讓 AI 能直接讀取硬件的運行時輸出，實現面板與 AI 工具的雙通道監控。

插件概覽¶

• 名稱：dsh-serial
• 維護者：Canye-zdm
• 類別：聯網工具
• 許可證：MIT
• 版本：v0.1.7
• 核心價值：把電腦串口接進 DeepSeek Harness，讓 AI 能看見 Arduino/STM32/ESP32/51 單片機的運行時輸出（面板 + AI 工具雙通道）。

核心功能¶

該插件提供兩條通道，共同服務於串口通信：

1. 懸浮球面板（人用）

   • 安裝後界面右下角會出現懸浮球，可拖動移位。
   • 支持選擇串口連接、實時查看日誌。
   • 提供“演示模式”（無需硬件即可測試）、手動發送數據、複製日誌等功能。

2. AI 工具通道（AI 用）

   • serial_list_ports：列出本機所有串口（藍牙、虛擬口等）。
   • serial_read：讀取串口數據並自動分析。

3. 共用實例

   • 面板與 AI 工具共用同一個串口服務實例。面板打開的串口，AI 工具會直接從該實例的實時緩衝中讀取數據，避免衝突。

安裝與啓用¶

安裝過程包含依賴安裝和插件註冊兩步。

1. 安裝依賴
   在插件源碼目錄下執行：

    npm install --registry=https://registry.npmmirror.com

插件依賴 `serialport` 庫。

2. 註冊插件
   使用官方 CLI 將插件裝入 dsh 的 desktop profile：

    dsh plugin --profile desktop add link:<本目錄絕對路徑>

3. 重啓應用
   執行完上述命令後，重啓 DeepSeek Harness 桌面版即可生效。

使用示例¶

可以通過以下四個層級逐步驗證和體驗功能。

Level 1 · 面板通道（演示模式）
重啓 dsh 後，點擊右下角“串口”懸浮球，進入面板。點擊“演示模式”，即可看到模擬的串口數據滾動，驗證面板鏈路通暢。

Level 2 · AI 工具通道（列串口）
在 dsh 新會話中，直接對 AI 提問：“列一下我電腦上有哪些串口”。
預期：AI 調用 serial_list_ports 工具，返回本機串口列表。

Level 3 · 完整閉環（讀串口）
假設板子正在向 COM3 打印日誌，在會話中提出：“讀一下 COM3 五秒，告訴我板子在打印什麼”。
預期：AI 返回日誌原樣內容，並給出自己的解讀。

Level 4 · 製造故障（AI 診斷）
故意將讀取的波特率設爲 115200（與程序 9600 不一致），再讓 AI 讀取。
預期：AI 收到亂碼，並主動提示“疑似波特率不匹配”，體現 AI 輔助硬件診斷的價值。

技術細節與注意¶

• 無構建流程：插件爲純 JS 源碼，即運行產物。Host 端代碼在 lib/ 目錄，Browser 端在 client/ 目錄。修改代碼後刷新即可生效，但缺少類型檢查。
• 權限與運行環境：插件以 dsh 進程權限運行。若使用桌面版，需確保串口未被其他程序佔用。
• 許可證：遵循 MIT 許可證。

結語¶

dsh-serial 通過面板與 AI 工具的雙通道設計，降低了硬件調試的門檻。開發者可以直接利用 AI 對串口日誌進行分析，或利用 AI 的能力輔助診斷硬件故障。

• GitHub 倉庫：https://github.com/Canye-zdm/dsh-serial
• 社區目錄：https://www.skillhub.cn/plugins/Canye-zdm/dsh-serial