EpCodePlugin

工作区共享配置保存在 .epointai/eplowcode.yml。插件不会读取或迁移 .vscode 目录中的文件。

apps.active 保存当前应用唯一的 appTag，apps.list 是应用概要的唯一数据源。清单项的 localpath 是包含 appinfo.lowcode.yml 的 workspace folder 相对路径，统一使用 / 分隔。 插件激活、打开本地应用列表和拉取/推送前会校准清单，并监听 appinfo.lowcode.yml 的创建、 修改和删除。多根工作区分别写回各自的 .epointai/eplowcode.yml；重复 appTag 会告警并只 保留一个规范条目。旧配置中的 current/recent/index 和绝对 localpath 会在下一次同步时 自动迁移到 active/list。

安装与更新

插件发布在 Visual Studio Marketplace，扩展标识为 epoint-mrc.epcodeplugin。

新装

1. 打开 VS Code 的“扩展”视图。
2. 搜索 epoint-mrc.epcodeplugin 或 EpCodePlugin。
3. 选择 EpCodePlugin 并安装。
4. 按提示重载窗口。

升级

1. 在“扩展”视图中打开 EpCodePlugin 的详情页。
2. 若显示“更新”，选择该按钮；也可执行 Extensions: Check for Extension Updates。
3. 完成后按提示重载窗口。

更新后验证清单

• [ ] 版本号已生效（扩展详情页显示为目标版本）
• [ ] 插件入口可见（状态栏/主视图入口正常）
• [ ] 关键命令可执行（应用列表、设置工作目录、拉取、差异预览、推送）
• [ ] 日志面板可打开（EpCodePlugin: 查看日志）
• [ ] 版本不一致提示可触发并可跳转到安装/更新指引

版本一致性提示说明

当当前插件版本低于配置的最低版本（epcodeplugin.version.minimumRequired）时：

1. 插件启动时会显示非阻断提示（包含“当前版本、目标版本、下一步”）。
2. 执行关键命令前会再次确认，可选择：
   • 继续执行
   • 查看安装/更新指引
   • 取消

开发与打包

• 编译：npm run compile
• 测试：npm test
• 打包：npm run package
• 发布：设置仅当前终端有效的 VSCE_PAT 后执行 npm run publish:marketplace

发布令牌需要 Azure DevOps 中具备 Marketplace > Manage 权限，且不得提交到仓库。