EpCodePlugin

工作区共享配置保存在 .epointai/eplowcode.yml。插件首次发现旧目录 .vscode 时会将其 整体合并到 .epointai 并删除 .vscode；同名内容以 .epointai 中的现有版本为准。

apps.index 记录每个 workspace folder 中实际存在的全部低代码应用。索引项的 localpath 是包含 appinfo.lowcode.yml 的规范化绝对路径；相同 appTag 的多个本地副本会分别保留。 插件激活、打开本地应用列表和拉取/推送前会校准索引，并监听 appinfo.lowcode.yml 的创建、 修改和删除。多根工作区分别写回各自的 .epointai/eplowcode.yml，删除的应用也会从索引及 带同一路径的当前/最近记录中清理。

安装与更新

插件发布在 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 权限，且不得提交到仓库。