InfinitePersistence/dsh-serial-console

## Core Features
- The plugin places user terminal input, model tool calls, board output, and session records in one serial console for DeepSeek Harness.
- It supports browser-based viewing of boot logs and live serial output, with keyboard input, tab completion, arrow keys, backspace, paste, input methods, and common terminal control keys.
- It allows selection of serial port, baud rate, and CR, LF, or CRLF line-ending modes, and provides Text and HEX views.
- It gives DeepSeek models tools to list ports, connect, send text or raw bytes, read bounded event windows, wait for expected content, add audit markers, and disconnect.
- It records RX and TX original bytes and event metadata including session, sequence, time, and source, while browser view clearing does not delete host-side records.

## Use Cases
- The README lists Linux development board boot and login consoles, U-Boot environment variables, boot flows, and image debugging.
- It also covers MCU command lines, firmware diagnostic interfaces, modems, GNSS, and other AT command devices.
- It can be used for automated post-flash boot checks, long-running serial log collection, fault review, and AI-assisted hardware debugging or remote collaboration.

## Technical Details
- The package is published as @infinitepersistence/dsh-serial-console and can be installed into a DSH web profile with dsh plugin add.
- It exposes library entries for shared protocol types and codecs, Node.js host serial management and audit, DSH host serial service, model tool plugin, prebuilt web client, and React xterm.js console.
- The terminal restores display, cursor, and source markers from an in-memory xterm checkpoint when switching pages and falls back to full rebuild when checkpoints are discontinuous or event windows are truncated.
- The interface marks sources as U for user input, M for model input, B for board output, and S for connection status, errors, or audit markers without writing those markers into serial data.

## Notes
- The project requires Node.js ^22.19.0 or >=24.0.0, DeepSeek Harness 0.1.0-rc.7, pnpm 11.22.0, and a Windows or Linux serial environment.
- Current limitations include one active physical serial port at a time, no automatic reconnection or command replay, and Text mode dependence on board echo.
- The project is community-maintained, not an official DeepSeek product, and terminal checkpoints remain in current browser memory, so page refreshes or event gaps rebuild the view.