Microi吾码 - V8引擎 VS Code 插件

将低代码平台与 AI 编程深度融合的 VS Code 插件。 一键拉取 Microi 后端业务代码 + 数据库结构，自动为 GitHub Copilot / Claude Code / Cursor 生成完整知识库——AI 不仅懂 V8 引擎 API，更了解你的每一张表、每一个字段。写代码、远程真机执行、逐行断点调试，全部在 VS Code 内闭环完成。

🤖 AI + 低代码本地编程

这是本插件最核心的价值：让你在 VS Code 中直接用 AI 编写 V8 接口引擎代码，AI 自动了解你的全部 V8 API 和数据库结构，无需反复"喂文档"。 即使你的数据库有 600 张以上的表，AI 也能精准识别。

工作原理

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

知识库内容包含：
  ✅ V8 引擎全部 API 用法与示例
     FormEngine / Db / Cache / Http / ApiEngine / MQ / MongoDB 等
  ✅ _Where 条件语法（支持 MySQL / Oracle / SqlServer）
  ✅ 上下文变量（V8.Param / V8.CurrentUser / V8.Form 等）
  ✅ System 命名空间（.NET 互操作）

同时，为每个应用（OsClient）生成独立的数据库结构文件：
  {服务器}/{OsClient}/.microi-db-schema.md  ← 完整表名 / 字段 / 类型
  → AI 按需参考，即使 600+ 张表也不影响指令加载
  ↓
打开任意 .js 接口引擎文件
  ↓
GitHub Copilot / Claude Code / Cursor 自动获得完整上下文
→ 直接 AI 辅助写代码，不需要手动解释 API 用法或表结构
  ↓
保存 → 自动推送到数据库（无需编译发布）
远程执行 + 远程逐行调试，全在 VS Code 内完成

AI 辅助编程演示

只需一步：拉取

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

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

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

对比	传统低代码 AI	Microi吾码本地 AI 编程
AI 对数据库的了解	❌ 无，每次手动描述	✅ 600+ 张表一键拉取，自动建立知识库
AI 对平台 API 的了解	❌ 无，手动喂文档	✅ 内置完整 V8 API 知识库，自动注入
支持的 AI 工具	有限，受平台约束	✅ Copilot / Claude Code / Cursor，自由切换
写代码	平台 Web 编辑器	✅ VS Code，享受最强 AI 加持 + 智能补全
执行调试	浏览器平台界面	✅ VS Code 内远程真机执行 + 逐行断点调试
推送部署	手动保存/编译	✅ 文件保存自动推送，无需编译发布
多人协作	平台内操作	✅ Git 版本控制 + AI Code Review

零配置：AI 工具自动识别知识库

拉取后，插件自动在工作区根目录生成三大 AI 工具的知识库文件，无需手动配置：

文件	GitHub Copilot	Cursor	Claude Code
`.github/copilot-instructions.md`	✅ 自动加载	—	—
`CLAUDE.md`	—	—	✅ 自动加载
`.cursorrules`	—	✅ 自动加载	—
`microi-v8-engine/.microi-typings/v8-engine.d.ts`	✅ 智能感知	✅ 智能感知	—
`microi-v8-engine/{服务器}/{应用}/.microi-db-schema.md`	✅ AI 按需引用	✅ AI 按需引用	✅ AI 按需引用

知识库文件由插件自动管理（包含 Generated by Microi吾码 标记），不会覆盖用户手动创建的同名文件。

关键设计：知识库分层

指令文件（copilot-instructions.md / CLAUDE.md / .cursorrules）仅包含 V8 API 知识（约 6KB），由 AI 工具在每次对话时自动加载，不会因为数据库表多而膨胀。

数据库表结构以独立的 .microi-db-schema.md 存放在各应用目录下，指令文件中已包含引导语告知 AI 在需要时去读取。这意味着：

600+ 张表也不会让指令文件超限
AI 工具会根据上下文按需读取对应的表结构文件
无需 MCP Server、无需 Skills 配置，拉取即可用

💡 如需更高级的 AI 能力（如让 AI 直接查询真实数据、远程执行接口），可搭配 Microi MCP Server 使用。

🔌 搭配 Claude Code 使用

安装本插件后，GitHub Copilot 已经开箱即用。如果你想切换到其他 AI 模型（如 Claude、MiniMax、DeepSeek），推荐安装 Claude Code for VS Code。

1. 安装 Claude Code

在 VS Code 扩展市场搜索 「Claude Code for VS Code」 并安装（发布者：Anthropic）。

安装后左侧 Activity Bar 会出现 Claude 图标，点击即可打开 Claude Code 面板。

2. 配置 API Key

Claude Code 支持多种 AI 模型提供商。在 Claude Code 面板中输入 /config 打开配置，设置你的 API Key：

Anthropic（Claude）：直接使用 Anthropic API Key
第三方模型（MiniMax / DeepSeek / OpenAI 等）：在 Claude Code 设置中配置 OpenAI-compatible API，填入对应的 Base URL 和 API Key

具体配置方式请参考 Claude Code 官方文档。

3. 为什么能直接用？

本插件在拉取代码时自动生成 CLAUDE.md 文件，Claude Code 会自动加载该文件作为上下文——包含完整的 V8 API 文档和数据库结构引用。无需任何额外配置，Claude Code 开箱即知道你的所有 API 和表结构。

同时，插件还自动配置了 MCP（.vscode/mcp.json），Claude Code for VS Code 可直接调用 MCP 工具查询实时数据、远程执行引擎。

📦 安装

方式一：从 VSIX 文件安装

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

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

在扩展市场搜索 Microi吾码

🚀 快速开始

第一步：打开配置面板

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

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

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

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

在配置面板中：

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

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

第三步：拉取代码

登录成功后：

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

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

第四步：编辑与推送

在拉取的 .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 服务器连接：

在配置面板「📡 连接配置」Tab 中添加多个服务器
已连接的服务器列表实时展示，支持「🔄 重新登录」和「删除」操作
Token 过期后自动用已保存凭据重新登录，无需手动操作
每个服务器的帐号密码独立存储，互不干扰

📁 本地目录结构

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

# 工作区根目录
.github/copilot-instructions.md             # AI 知识库（GitHub Copilot 自动加载）
CLAUDE.md                                   # AI 知识库（Claude Code 自动加载）
.cursorrules                                # AI 知识库（Cursor 自动加载）

microi-v8-engine/
├── .microi-typings/
│   └── v8-engine.d.ts                  # V8 API 类型定义（智能补全）
├── jsconfig.json                       # TypeScript 配置（自动生成）
├── .microi-config.json                 # 本地同步配置
├── .microi-meta.json                   # 元数据（脏检测 / 冲突检测）
│
├── {SysTitle (host)}/                  # 服务器目录
│   └── {OsClient.Type.Network}/        # 应用目录
│       ├── .microi-db-schema.json      # 原始数据库结构
│       ├── .microi-db-schema.md        # 📊 数据库结构 Markdown（AI 按需参考）
│       ├── api-engine/                 # 接口引擎代码
│       │   └── {Category}/
│       │       └── {ApiName}({ApiEngineKey}).js
│       └── v8-event/                   # V8 事件代码
│           └── {TableName}/
│               └── {EventType}.js
└── ...

💡 数据库表结构以独立的 .microi-db-schema.md 文件存在于各应用目录下，AI 工具可按需引用，即使 600+ 张表也不影响指令文件加载速度。

⚙️ 设置选项

在 VS Code 设置中搜索 microi：

设置项	默认值	说明
`microi.apiBaseUrl`	`""`	后端 API 地址
`microi.osClient`	`""`	默认 OsClient 租户标识
`microi.profiles`	`[]`	多服务器连接配置列表
`microi.localDir`	`""`	本地同步目录（留空使用工作区下 `microi-engines`）
`microi.autoSyncOnSave`	`true`	保存文件时自动推送到数据库
`microi.pollInterval`	`10000`	数据库变更检查间隔（毫秒，最小 3000）
`microi.showConsoleOnExecute`	`true`	远程执行时自动显示输出面板

⌨️ 命令列表

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

命令	说明
`Microi: 配置连接`	打开图形化配置面板
`Microi: 登录`	快速登录（命令行方式）
`Microi: 退出登录`	清除登录凭据
`Microi: 拉取V8引擎代码`	从数据库拉取全部引擎代码，并自动更新 AI 知识库
`Microi: 拉取数据库结构到AI知识库`	单独拉取数据库结构并更新 AI 知识库文件
`Microi: 推送当前文件到数据库`	推送当前编辑的文件
`Microi: 推送所有已修改文件`	批量推送所有已修改文件
`Microi: 远程执行当前接口引擎`	在后端执行当前文件
`Microi: 远程逐行调试当前接口引擎`	启动远程调试会话
`Microi: 与远程版本对比`	Diff 对比
`Microi: 切换 OsClient`	切换当前使用的 OsClient
`Microi: 刷新`	刷新侧栏树

❓ 常见问题

登录失败？

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

拉取代码后没看到文件？

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

远程调试无法启动？

确认后端已部署 Microi吾码平台 v4.8.3 及以上版本
WebSocket 不可用时会自动降级为 HTTP 执行模式

📄 License

MIT

Microi吾码

Microi 吾码