CSV Jumper — PLM 模型 CSV 文件工具
一款专为 PLM（产品生命周期管理）开发者设计的 VS Code / CatPaw 扩展，用于处理基于 CSV 的模型配置文件。
✨ 功能
智能跳转
- Ctrl+Click 跳转：像代码导航一样在关联的 CSV 文件之间跳转
- 双向链接：table ↔ tablefield、form ↔ form_field 双向跳转
- 跨文件引用：page → command/panel、command → table/form/page/toolbar
- 反向查找：查找哪些页面/命令引用了指定的表格或命令
CSV 表格编辑器 📊
- 直接打开即表格：打开 CSV 文件直接显示为可编辑表格，无需额外操作
- 表头固定：首行（列名）滚动时粘在顶部，始终可见
- 单元格编辑：双击任意单元格即可编辑；Enter/Tab 确认，Esc 取消
- 列过滤：每列表头提供实时搜索输入框，按子串匹配过滤行
- 右键菜单：上方插入行、下方插入行、删除行、跳转定义
- 按原编码保存：保存时按文件原始编码写回（GB2312 文件保存后仍为 GB2312）
- GB2312 自动解码：自动检测并解码 GB2312 编码文件，正确显示中文
- 链式跳转：model CSV 文件中可跳转的单元格（🔗 标记）支持 Ctrl+Click 跳转到关联定义
- 暗色/亮色主题：UI 自适应 VS Code 配色主题
GB2312 编码管理 🇨🇳
- 保存时自动转换：UTF-8 CSV 文件保存时自动转换为 GB2312 编码
- 状态栏指示器：右下角显示当前编码状态
- ✅
GB2312 — 编码正确
- ⚠️
UTF-8 — 需要转换（点击转换）
- 手动转换命令：转换单个文件或批量转换整个工作区
- 编码检测：智能检测防止中文字符乱码
🎯 支持的文件类型
| 源文件 |
点击列 |
跳转目标 |
table.csv |
表格名 |
→ tablefield.csv、引用此表格的命令 |
tablefield.csv |
表格名 |
→ table.csv |
form.csv |
表单名 |
→ form_field.csv、引用此表单的命令 |
form_field.csv |
表单名 |
→ form.csv |
page.csv |
子项列 |
→ command.csv、panel.csv |
panel.csv |
子项列 |
→ command.csv、panel.csv |
toolbar.csv |
子项列 |
→ command.csv |
command.csv |
Action 列 |
→ table.csv、form.csv、page.csv、toolbar.csv |
🚀 使用方式
跳转
- 在
model/ 目录下打开任意 CSV 文件
- 按住 Ctrl 并 点击 某个名称（表格名、命令名等）
- 将跳转到定义处，或显示多个目标的 Peek 视图
表格编辑器
- 打开任意 CSV 文件 — 直接显示为可编辑表格
- 编辑：双击任意单元格进入编辑模式；Enter/Tab 确认，Esc 取消
- 过滤：在任意列的过滤框中输入，即时过滤该列（子串匹配，不区分大小写）
- 新增行：点击
➕ Add Row 按钮，或右键 → 上方/下方插入行
- 保存：点击
💾 Save 按钮或 Ctrl+S — 按文件原始编码保存
- 跳转：在 model CSV 文件中，Ctrl+Click 🔗 链接单元格跳转到关联定义
⌨️ 命令
| 命令 |
说明 |
CSV: Go to Definition |
在光标位置跳转到定义 |
CSV: Convert current file to GB2312 |
手动将当前文件转为 GB2312 编码 |
CSV: Convert current file to UTF-8 |
手动将当前文件转为 UTF-8 编码 |
CSV: Batch convert all model CSVs to GB2312 |
批量转换工作区所有 model CSV 文件 |
⚙️ 配置
| 配置项 |
默认值 |
说明 |
csv-jumper.enableCrossReference |
true |
启用跨文件引用跳转（page→command、command→table 等）。关闭后仅 table↔tablefield 和 form↔form_field 跳转可用。 |
📋 环境要求
- VS Code / CatPaw 1.80.0 或更高版本
- CSV 文件位于
**/model/** 目录结构中
📝 许可证
MIT
| |
