Board Debug Assistant / 板卡调试助手

面向 MCU 和嵌入式 Linux 板卡的 Windows 桌面调试工具。当前版本提供串口终端、结构化日志，以及可供 Claude Code 调用的本地 AI 调试桥接。

当前能力

• 枚举并连接 CH340 等 Windows 串口设备。
• 配置波特率、数据位、校验位、停止位和流控。
• 文本/HEX 发送，支持 CR、LF 和 CRLF 行尾。
• RX/TX 日志、时间戳、级别着色、搜索、暂停、清空和导出。
• 跨串口读取块自动拼行，避免日志被错误拆分。
• 100,000 条后端环形日志缓冲。
• 仅监听 loopback 的令牌认证 AI 桥接。
• Claude Code Skill：读取连接状态、历史日志、持续观察，并在用户明确授权后发送串口数据。
• AI 调用审计，不记录串口 payload 或明文凭据。

SSH 页面目前是界面骨架，PTY、认证、主机指纹和 SSH 命令执行尚未实现。

技术栈

• Tauri 2 / Rust
• React 19 / TypeScript / Vite
• serialport 4.9
• PowerShell Skill CLI

开发环境

• Windows 10/11
• Node.js 18+
• Rust stable（MSVC toolchain）
• Microsoft Edge WebView2 Runtime

启动开发环境

cd apps/desktop
npm install
npm run tauri dev

构建无安装包的 debug 可执行文件：

cd apps/desktop
npm run tauri build -- --debug --no-bundle

生成文件：

target/debug/board-debug-desktop.exe

使用 Claude Code 调试串口

1. 启动板卡调试助手，选择串口和波特率，然后点击“连接串口”。
2. 在项目根目录启动 Claude Code，首次进入时接受工作区信任。
3. 输入：

/board-debug-assistant

Skill 会检查串口和桌面桥接状态、读取最近日志，然后询问板卡型号、期望行为和故障现象。

AI 默认只有只读权限。发送串口内容前，必须向用户展示精确 payload、编码和行尾，并获得本次明确授权。

详细说明见 AI 串口联调桥接。

本地桥接

• 地址：http://127.0.0.1:17832
• 每次启动生成随机令牌。
• UI 与 AI 复用同一后台串口会话，不会重复占用 COM 端口。
• 未授权请求返回 HTTP 401；未明确批准的串口写入返回 HTTP 403。

测试

cargo fmt --all -- --check
cargo test --workspace

cd apps/desktop
npm run build

项目已使用 CH340 COM15 / 115200 完成实机验证，并通过 Claude Code Skill 读取 AD9959 周期日志。

项目结构

apps/desktop/                  Tauri + React 桌面应用
crates/device-core/            串口核心类型与编码
skills/board-debug-assistant/  Skill、桥接脚本和安全规则
.claude/skills/                Claude Code 项目级安装适配
docs/                          需求、设计与协议文档
tests/                         测试夹具目录

安全原则

• Skill 不直接打开串口，所有操作通过桌面应用现有会话执行。
• AI 默认只读，单次写入授权不可复用。
• 桥接只监听本机地址并要求随机令牌。
• 密码、私钥和令牌不得进入普通日志或导出文件。