Zem-四路高压箱
Zeptools 四路场发射高压箱 VS Code / Cursor 扩展 — 在编辑器内完成串口连接、四路高压实时监控与参数下发（Beam / Filament / Extractor / Suppressor），支持 Legacy 老协议 与 ZEP 通用协议 (0x0200)。
0.1.1：监控数值统一显示小数点后 3 位（Legacy / ZEP 均适用）。
你能做什么
| 模块 |
说明 |
| 串口连接 |
COM 口扫描、Open/Close、协议切换（Legacy / ZEP） |
| 系统控制 |
高压箱初始化、一键关闭（Deinit） |
| Beam |
加速电压 0～32 kV，Demand + SlewRate，Disable 单路关断 |
| Filament |
灯丝电流 0～2.913 A，Demand + SlewRate |
| Extractor |
吸取极电压 0～10 kV，Demand + SlewRate |
| Suppressor |
栅极电压 0～900 V |
| 实时监视 |
各路实测电压/电流、短时趋势曲线、隔离供电参数 |
| 通信日志 |
串口收发、协议解析（View → Logging 或面板内日志区） |
| 历史与日志 |
测量 CSV、通信日志按日落盘（扩展全局存储目录） |
快速开始
- 安装扩展后按
Ctrl+Shift+P，执行 「四路高压箱: 打开控制面板」
- 在顶栏 COM Port 选择串口，点击 Open
- Protocol 选择与设备一致的协议：
- 老协议 (Legacy)：13 字节帧 + 文本回包
- ZEP 通用 (0x0200)：64 字节帧 + 二进制回包
- 点击 初始化，等待状态为 READY（ZEP 会自动轮询
0x0221 进度）
- 在各通道设置 Demand、SlewRate，点击 Set
- 停机：逐路 Disable，或顶栏 关闭高压箱；最后 Close 串口
界面说明
顶部栏
| 元素 |
说明 |
| COM Port |
串口选择与 Open/Close |
| Protocol |
Legacy / ZEP（须在未连接时切换） |
| 初始化 |
高压箱上电初始化流程 |
| 关闭高压箱 |
一键 Deinit，之后需重新初始化 |
通道卡片（四路）
每路包含：
| 控件 |
说明 |
| Disable |
将该路目标置 0 并下发（步进沿用当前 SlewRate） |
| Demand |
目标值：Beam/Extractor/Suppressor 为 V，Filament 为 A |
| SlewRate (Step) |
爬升速率，建议 1 或 2，勿填 0 |
| Set |
下发 Demand + SlewRate |
| 右侧读数 |
实测电压、电流及趋势曲线 |
各通道量程
| 通道 |
Demand 范围 |
SlewRate |
| Beam |
0～32000 V |
有 |
| Filament |
0～2.913 A |
有 |
| Extractor |
0～10000 V |
有 |
| Suppressor |
0～900 V |
协议无 ramp，界面可保留输入 |
协议说明
| 项目 |
Legacy |
ZEP (0x0200) |
| 帧格式 |
13 字节 |
64 字节 $Zep: |
| 状态读取 |
快/慢轮询 0x0E / 0x0F |
0x021E / 0x021F 等 |
| 初始化 |
文本 HV_INIT → step* → HV_init_done |
0x02F1 + 轮询 0x0221 |
| 单路关断 |
SET 目标 0 + 用户步进 |
同左；栅极 BV 使用 +2 关断标志 |
详细协议见项目文档 docs/场发射高压源协议.md。
数据存储
| 项目 |
路径 |
| 扩展设置与参数 |
VS Code 全局存储（globalStorage） |
| 测量 CSV / 通信日志 |
{globalStorage}/data/measurements/、.../logs/ |
系统要求
- Windows（串口与 native 模块已在 Windows / Cursor 验证）
- VS Code 1.85+ 或兼容的 Cursor
- 四路场发射高压箱经 USB 串口 连接（默认 115200）
安装
- Marketplace：搜索 Zem-四路高压箱 或 Zem HV Box
- 离线 VSIX：扩展面板 →
··· → 从 VSIX 安装 → 选择 zem-hvbox-4ch-0.1.1.vsix
安全提示
- 遵守实验室高压安全规程与联锁要求
- 首次使用建议低电压、慢爬升验证反馈
- 异常时优先 Disable / 关闭高压箱，再 Close 串口并断电
- 本扩展直接控制高压设备，仅限授权人员使用
发布与版本
- Publisher：
fj-dev
- 当前版本：0.1.1
- 源码：http://gitlab.dc000.local:8070/software/fe-hvb（分支
四路高压箱vscode插件分支）
常见问题
Q：ZEP 下 Disable 无效？
A：确认已完成 初始化 且状态 READY；查看通信日志是否有 TX 与 protocol_error。栅极关断依赖 BV_SET 的关断标志。
Q：与桌面版 Electron 程序关系？
A：同一套前端与 electron/ 后端逻辑；本扩展通过 Webview + 扩展宿主运行，无需单独安装桌面程序。
Q：F5 开发调试？
A：见仓库根目录 README-VSCODE.md（面向开发者，Marketplace 用户可忽略）。
发布到 VS Code Marketplace（维护者）
- 在 Azure DevOps 创建 Personal Access Token（范围：
Marketplace → Manage）
- 登录发布账号：
npx vsce login fj-dev（或 vsce login fj-dev）
- 在
fe-hvb-4 根目录打包：npm run vscode:package
输出：vscode-extension/zem-hvbox-4ch-0.1.1.vsix
- 发布：
cd vscode-extension && npm run publish:marketplace
或仅上传 VSIX：Marketplace 管理页 → Upload extension
Marketplace 填写建议
| 字段 |
建议内容 |
| Name |
Zem-四路高压箱 |
| Short description |
同 package.json 的 description |
| Category |
Other |
| Tags |
ZEM, high voltage, serial port, 四路高压箱 |
| README |
使用本文件（打包时自动包含） |
| License |
Proprietary（见 LICENSE.txt） |
| |
