前言¶

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