Microi吾码 - V8引擎 VS Code 插件

Microi吾码低代码平台 V8 引擎开发调试工具。 连接 Microi 后端，拉取 / 编辑 / 推送接口引擎，支持远程真机执行、逐行断点调试，以及 GitHub Copilot / Claude Code / Cursor 本地 AI 编程——AI 知识库自动生成，无需任何额外配置。

🤖 AI + 低代码 本地编程

这是本插件最核心的价值：让你在 VS Code 中直接用 AI 编写 V8 接口引擎代码，AI 自动了解你的平台 API 和数据库结构，无需反复"喂文档"。

工作原理

点击「拉取」
  ↓
① 拉取所有接口引擎 .js 到本地
② 拉取所有 V8 事件 .js 到本地
③ 自动拉取数据库结构（表名 / 字段名 / 字段描述 / 菜单树）
  ↓
自动生成 AI 知识库文件：
  .github/copilot-instructions.md  ← GitHub Copilot 读取
  CLAUDE.md                        ← Claude Code 读取
  .cursorrules                     ← Cursor 读取

知识库内容包含：
  ✅ V8 引擎全部 API（FormEngine / Db / Cache / Http / ApiEngine 等）
  ✅ _Where 查询条件语法
  ✅ 你的数据库所有表结构（表名 / 字段名 / 类型 / 业务说明）
  ✅ 菜单树结构
  ↓
打开任意 .js 接口引擎文件
  ↓
GitHub Copilot / Claude Code / Cursor 自动获得完整上下文
→ 直接 AI 辅助写代码，不需要手动解释 API 用法或表结构
  ↓
保存 → 自动推送到数据库（无需编译发布）
远程执行 + 远程逐行调试，全在 VS Code 内完成

AI 辅助编程演示

只需一步：拉取

登录后点击左侧侧栏顶部 ↓（拉取） 按钮，或执行命令 Microi: 拉取V8引擎代码，插件自动完成所有知识库建立工作。

数据库结构变更后，执行 Microi: 拉取数据库结构到AI知识库 单独更新，无需重新拉取全部代码。

为什么说这是真正的 AI + 低代码？

📦 安装

方式一：从 VSIX 文件安装

1. 获取 v8-engine-x.x.x.vsix 文件
2. 打开 VS Code → 左侧「扩展」面板 → 点击右上角 ··· → 从 VSIX 安装...
3. 选择 .vsix 文件，安装完成后重新加载窗口

方式二：从扩展市场安装（发布后）

在扩展市场搜索 Microi吾码

🚀 快速开始

第一步：打开配置面板

安装后，左侧 Activity Bar 会出现 Microi吾码 图标（⚡）。

也可以通过命令面板打开：

• 按 Ctrl+Shift+P（Mac: Cmd+Shift+P）
• 输入 Microi: 配置连接

第二步：检测服务器并登录

在配置面板中：

1. 填写 API Base URL（后端地址，如 https://api.example.com）
2. 填写 OsClient（租户标识，留空自动获取）
3. 点击 「检测服务器，登录并保存连接」
4. 检测成功后，填写 用户名 和 密码
5. 如果服务器开启了验证码，需要填写验证码
6. 点击 「登录并保存连接」

💡 登录凭据使用 VS Code SecretStorage 安全存储，不会明文保存在配置文件中。

第三步：拉取代码

登录成功后：

• 在左侧 Microi 侧栏中，点击顶部工具栏的 ↓（拉取） 按钮
• 或使用命令面板：Microi: 拉取V8引擎代码

代码会按 OsClient → 分类 → 引擎名称 的目录结构拉取到本地 microi-engines/ 目录。

第四步：编辑与推送

• 在拉取的 .js 文件中编辑代码
• 保存时自动推送：保存文件后会自动同步到数据库（可在设置中关闭）
• 手动推送：右键编辑器 → Microi: 推送当前文件到数据库
• 输入 V8. 即可获得完整的 API 智能提示

第五步：远程执行

右键编辑器 → Microi: 远程执行当前接口引擎，或点击编辑器标题栏的 ▶ 按钮。

在弹出的参数面板中填写请求参数（JSON 格式），点击「执行」：

• 执行结果在 VS Code Output Channel 中展示
• console.log 输出会实时显示
• 执行错误会自动定位到出错行

第六步：远程逐行调试

右键编辑器 → Microi: 远程逐行调试当前接口引擎

调试功能支持：

• 设置断点：点击编辑器行号左侧的红点
• 逐行执行：Step Over（F10）/ Step In（F11）/ Step Out（Shift+F11）
• 变量观察：在「变量」面板查看当前作用域变量值
• 表达式求值：在调试控制台输入表达式实时计算
• Continue（F5）：继续执行到下一个断点

也可以通过 launch.json 配置调试：

{
  "type": "microi-v8-remote",
  "request": "launch",
  "name": "Microi V8 远程调试",
  "program": "${file}",
  "params": {},
  "stopOnEntry": true
}

🌲 侧栏资源管理器

登录后，左侧 Microi 面板会展示引擎列表树：

Microi V8引擎
├── 📂 OsClient1
│   ├── 📂 分类A
│   │   ├── 📄 ApiEngine1.js
│   │   └── 📄 ApiEngine2.js
│   └── 📂 分类B
│       └── 📄 ApiEngine3.js
└── 📂 OsClient2
    └── ...

树节点操作（右键菜单）： | 操作 | 说明 | |------|------| | 推送到数据库 | 将当前文件内容更新到后端数据库 | | 远程执行 | 在后端真实 V8 引擎中执行 | | 远程逐行调试 | 通过 DAP 协议进行断点调试 | | 与远程版本对比 | 打开 Diff 编辑器查看本地与远程差异 |

🔗 多服务器连接

支持同时管理多个 Microi 服务器连接：

1. 在配置面板中添加多个服务器
2. 已连接的服务器列表实时展示在面板顶部
3. 点击「删除」可移除不需要的连接

📁 本地目录结构

拉取代码后，工作区目录结构如下：

工作区/
├── microi-engines/                    # 接口引擎代码
│   └── {OsClient}/
│       └── {Category}/
│           └── {ApiEngineKey}.js
├── microi-events/                     # V8 事件代码
│   └── {OsClient}/
│       └── {FormEngineKey}/
│           └── {EventType}.js
├── .microi-typings/                   # 类型定义（自动生成）
│   └── v8-engine.d.ts
└── .microi-config.json                # 本地同步配置

⚙️ 设置选项

在 VS Code 设置中搜索 microi：

⌨️ 命令列表

按 Ctrl+Shift+P（Mac: Cmd+Shift+P）打开命令面板，输入 Microi 查看所有可用命令：

❓ 常见问题

登录失败？

• 检查 API Base URL 是否正确（需要包含 http:// 或 https://）
• 检查 OsClient 是否匹配
• 确认帐号密码正确
• 如果服务端启用了验证码，请输入正确的验证码

拉取代码后没看到文件？

• 确认已成功登录（侧栏树不显示「尚未连接」）
• 检查工作区目录中的 microi-engines/ 文件夹

远程调试无法启动？

• 确认后端已部署对应的 V8Debug 接口
• WebSocket 不可用时会自动降级为 HTTP 执行模式

保存时没有自动推送？

• 检查 microi.autoSyncOnSave 设置是否为 true
• 确认文件在 microi-engines/ 或 microi-events/ 目录下

📄 License

MIT