# 编译全部项目
dotnet build ACCcom.sln
# 运行 WPF 桌面客户端
dotnet run --project src\ACCcom\ACCcom.csproj
# 运行 MCP Server（供 AI 客户端直接调用）
dotnet run --project src\ACCcom.McpServer\ACCcom.McpServer.csproj
# 发布单文件
dotnet publish src\ACCcom\ACCcom.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -o dist\
系统要求
| 项目 |
要求 |
| 操作系统 |
Windows 10 1607+ / Server 2019+ |
| 运行时 |
.NET 8 运行时（下载） |
| 编译环境 |
.NET 8 SDK |
| 架构 |
x64 |
三种模式共享 src/ACCcom.Core 业务核心，按场景选用或组合：
| 模式 |
位置 |
说明 |
| 🖥 桌面端 |
src/ACCcom（WPF） |
完整 GUI 调试界面；内嵌 HTTP API（:8899）与 WebSocket，供脚本/第三方调用 |
| 🤖 MCP Server |
src/ACCcom.McpServer（stdio） |
11 个工具（list_ports/open_port/send/read_data/… + traffic_log 流量记录仪），供 Claude Code、DeepSeek Harness 等 AI 客户端直接挂载；独立于桌面端运行（直接模式） |
| 🔌 DSH 插件 |
tools/dsh-serial-panel |
DeepSeek Harness 右侧停靠栏内的串口实时面板(对话与串口数据并排可见):尾随 MCP 的 mcp-traffic.jsonl,实时显示 AI 收发的每条串口数据(Δt 帧间隔、TX/RX 徽章、端口/正则过滤、断层标记、新流量徽章);带 agent 专用 HTTP API(紧凑增量 / stats=1 心律 / jsonl·csv 导出) |
MCP 与插件的关系：MCP 负责"让 AI 能操作串口"，插件负责"让人类看得见 AI 在串口上做了什么"——两者通过共享日志 %LOCALAPPDATA%\ACCcom\mcp-traffic.jsonl 解耦，互不依赖运行。
ZCode 用户另有本地市场插件 plugins/acccom-zcode：打包 acccom-serial skill（接口选择/干净复现等判断层）与 /acccom-status、/acccom-repro 两个命令；MCP server 沿用用户级已配置的 acccom，插件不重复声明，避免双进程。
DSH 插件的开发/部署（真源在仓库，部署到 Harness profile）：
cd tools\dsh-serial-panel
deploy.cmd :: 部署到 desktop profile，重启 DeepSeek Harness 生效
node test.js core :: 行为测试四个模式(core/window/api/client),共 67 项断言
node test.js window
node test.js api
node test.js client
agent 侧的接口与工作流说明见 tools/dsh-serial-panel/AGENTS.md;
更多细节见 tools/dsh-serial-panel/README.md。
| 文档 |
内容 |
| 快速入门 |
系统要求、安装方法、快捷键一览 |
| 文档 |
内容 |
| 串口操作指南 |
串口配置、数据收发、文件操作、连接管理器、包过滤引擎、高亮规则 |
| 数据管理 |
高性能数据缓冲区、实时统计、多格式导出（TXT/JSON/CSV/PCAP） |
| 高级通信 |
多端口并发、TCP/UDP 桥接、自动波特率、虚拟串口 |
| 文档 |
内容 |
| 协议解析引擎 |
C# Script 解析器、可视化编辑器、多帧拼接、测试运行器、自动解析器匹配 |
| 协议→解析器 操作指南 |
从协议文档到生成 .csx 解析器的完整流程 |
| 文档 |
内容 |
| Modbus 支持 |
图形界面操作、功能码速查、设备扫描、从站模拟、RTU/TCP/ASCII 传输、MCP 工具 |
| 文档 |
内容 |
| 自动化系统 |
会话录制回放、多步骤宏、条件触发 |
| 管理功能 |
书签标记、配置预设、快捷指令、全局设置 |
| 文档 |
内容 |
| 可视化分析 |
实时波形绘图、统计仪表盘、数据对比、差异分析 |
| 文档 |
内容 |
| 集成指南 |
HTTP API（完整参考）、WebSocket、国际化、主题、AI 集成 |
| 架构指南 |
MVVM 分层、基类体系、性能优化策略、技术栈、项目结构 |
| 类别 |
功能 |
| 🔌 串口 |
300~921600 波特率、DTR/RTS 流控、自动扫描、设备插拔自动检测、断线重连（含设备等待）、多端口并发 |
| 📡 网络 |
TCP/UDP 客户端、自动桥接、零拷贝接收 |
| 📝 协议 |
Roslyn C# Script 引擎、热加载、LRU 缓存、自动代码生成、自动解析器匹配、高亮规则 |
| 🔧 Modbus |
RTU/TCP/ASCII 主站、10 种功能码、自动分片、轮询、从站模拟 |
| 🎨 界面 |
7 款主题（昼白/墨 + 五幅名画配色：日出·印象、麦田群鸦、神奈川冲浪为亮色，吻、珍珠少女为深色，色相拉开、标题栏画廊挑选含实时预览）、中英文切换（运行时即时生效）、发送历史 |
| 🤖 AI |
MCP Server（11 个工具,含 traffic_log 流量记录仪）、HTTP REST API、WebSocket 实时推送、DSH 右侧停靠串口面板（可视化 AI 串口收发 + agent 查询 API） |
| 📊 数据 |
Channel+RingBuffer 缓冲、实时统计、TXT/JSON/CSV/PCAP 导出 |
| ⚡ 自动化 |
会话录制回放、多步骤宏、条件触发器、协议测试运行器 |
| 🧩 工具 |
协议可视化编辑器、数据对比/差异分析、实时波形绘图、包过滤引擎 |
| 按键 |
行为 |
Enter |
发送输入框内容 |
Ctrl+Enter |
发送（换行用 Shift+Enter） |
Ctrl+S / Ctrl+Shift+S |
保存 RX / TX 数据 |
Ctrl+Shift+L |
清空 TX 面板 |
Ctrl+L |
清空 RX 面板 |
Ctrl+F |
聚焦 RX 搜索框 |
Ctrl+D |
切换主题（在 7 款主题间循环） |
Ctrl+H |
切换 HEX 显示 |
Ctrl+P |
切换合并 / 拆分数据视图 |
Ctrl+B |
添加书签 |
Ctrl+Left/Right |
书签前后导航 |
ESC |
停止循环发送 |
Alt+1~Alt+9 |
快捷发送当前可见列表第 1~9 条指令 |
Ctrl+Q |
开关快捷发送侧边栏 |
F5 |
刷新可用串口列表 |
F1 |
打开完整快捷键窗口（以 ShortcutCatalog 为准） |
MIT
