前言¶
在 DSH 的插件式擴展中，串口調試常見做法是把板卡日誌複製給模型，再讓模型給出命令，最後人工回到終端執行和核對。DSH Serial Console 把這個過程放進同一個控制檯：用戶與 AI 模型共享同一個可審計的嵌入式串口會話。
下面介紹 InfinitePersistence 維護的社區插件 @infinitepersistence/dsh-serial-console，包括它能做什麼、如何安裝啓用，以及當前需要注意的限制。
這是什麼¶
DSH Serial Console 是一個面向 DeepSeek Harness 的社區串口控制檯項目。它把瀏覽器終端、模型串口工具、板卡輸出和會話審計記錄放在同一個會話中。
該項目由 InfinitePersistence 社區維護，採用 MIT License，不代表 DeepSeek 官方產品或官方背書。
核心能力¶
瀏覽器終端¶
- 在瀏覽器中查看板卡啓動日誌和即時串口輸出。
- 使用鍵盤直接操作設備，包括 Tab 補全、方向鍵、退格、粘貼、輸入法和常用終端控制鍵。
- 選擇串口、波特率和 CR、LF、CRLF 等行尾模式。
- 在 Text 與 HEX 視圖之間切換。
- 在 Text 終端中使用
Ctrl+F查找歷史輸出，並在匹配項之間前後跳轉。
用戶與模型共享同一串口¶
DSH Serial Console 讓 DeepSeek 模型與用戶操作同一個串口，而不是分別佔用設備。
它支持在串口頁右側直接查看模型思考、工具進度和最終回覆。用戶與模型共享發送隊列，但當前尚未提供整條命令級別的輸入租約。
模型工具¶
插件提供以下模型工具：
| 工具 | 用途 |
|---|---|
serial_list_ports |
枚舉可用串口 |
serial_connect |
連接設備 |
serial_send |
發送文本或原始字節 |
serial_read |
讀取有界事件窗口 |
serial_expect |
等待提示符或指定內容 |
serial_mark |
標記關鍵證據位置 |
serial_disconnect |
安全斷開設備 |
審計與來源標記¶
插件會保留獨立的串口審計記錄，並支持導出會話事件。
它使用 U/M/B/S 來源標記區分：
U：用戶輸入M：模型輸入B：板卡輸出S：狀態/審計
安裝與啓用¶
環境要求¶
- Node.js
^22.19.0或>=24.0.0 - DeepSeek Harness
0.1.0-rc.7 - pnpm
11.22.0 - Windows 或 Linux 串口環境
已有 DSH 時安裝¶
如果已經安裝 DSH 0.1.0-rc.7，執行：
dsh plugin --profile web add '@infinitepersistence/dsh-serial-console@0.1.0-rc.4' --save-exact
安裝完成後，使用同一個 profile 啓動：
dsh --profile web
安裝和啓動必須使用同一個 profile。升級後請重啓 Host，並在瀏覽器中使用 Ctrl+F5 刷新頁面。
訪問頁面¶
啓動後訪問：
http://127.0.0.1:3080
進入任意對話，並選擇“串口”標籤。
作爲程序庫安裝¶
如果只把控制檯作爲庫嵌入自己的程序，可以執行：
pnpm add '@infinitepersistence/dsh-serial-console@0.1.0-rc.4' --save-exact
從源碼構建¶
git clone https://github.com/InfinitePersistence/dsh-serial-console.git
cd dsh-serial-console
corepack enable
pnpm install
pnpm build
典型用法¶
查找歷史輸出¶
在終端聚焦時按：
Ctrl+F
輸入內容後會高亮匹配項。跳轉規則如下：
Enter：跳到下一個匹配項Shift+Enter：跳到上一個匹配項Esc：關閉查找
用模型工具連接串口¶
可以先做 X，再做 Y：
1、使用 serial_list_ports 查看可用串口。
2、使用 serial_connect 連接設備。
3、使用 serial_send 發送命令。
4、使用 serial_read 或 serial_expect 讀取輸出。
5、需要時執行 serial_mark 標記關鍵位置。
6、結束時使用 serial_disconnect 斷開連接。
適用場景與注意¶
適合誰¶
適合需要在瀏覽器中調試串口設備，並希望在同一個 DSH 會話中查看用戶輸入、模型調用和板卡輸出的開發者。它也適合需要保留串口審計記錄，以便複查操作順序的調試流程。
當前限制¶
- 一次只管理一個活動物理串口。
- 暫不自動重連，也不會在重連後自動重放命令。
- 當前 Text 模式依賴板卡回顯；關閉 Shell echo 時不會顯示用戶正在鍵入的字符。
- 用戶與模型共享發送隊列，但尚未提供整條命令級別的輸入租約。
- 終端檢查點僅保存在當前瀏覽器內存中；刷新頁面、重載插件或事件出現缺口後會重新構建畫面。
- 瀏覽器清空視圖不會刪除 Host 側記錄。
安全注意¶
插件會隨當前 dsh 進程權限運行。安裝前建議先檢查源碼、依賴和許可證。第三方組件的許可證信息見 THIRD_PARTY_NOTICES.md。
鏈接¶
- GitHub 倉庫：https://github.com/InfinitePersistence/dsh-serial-console
- 包名：
@infinitepersistence/dsh-serial-console
