Skip to content

Microi吾码

Microi吾码 VS Code 插件

用自然语言开发完整的复杂业务系统,让低代码从“拖拉拽”进入“AI 直接交付”。

Microi 官网VS Code 1.85+80+ MCP 工具AI 客户端MIT License


不只是 V8 编辑器,而是 AI 原生的低代码开发工作台

传统低代码把开发从“写大量代码”变成了“手动建表、逐个添加字段、拖拽控件、配置菜单、拼界面 JSON、设计打印模板和工作流”。Microi吾码 VS Code 插件进一步把这些操作变成自然语言:

你描述业务目标,AI 通过插件内置的 Microi MCP、平台知识库和 Skills,完成业务蓝图、数据模型、表单字段、菜单权限、接口引擎、V8 事件、数据源、界面引擎、打印引擎、工作流、定时任务、前端微服务以及自动化测试。

这意味着,无论是 OA、ERP、MES、CRM、WMS、项目管理、售后服务、商城、预约、物联网,还是高度定制的行业系统,都可以从一段业务需求开始,由 AI 按 Microi 平台规范规划、生成、验证并持续迭代。

对业务人员,它是一套以自然语言为主要交互方式、无需手写代码的系统开发方案;对专业研发人员,AI 生成的 V8、前端源码、元数据和测试仍然可查看、可调试、可 Git 管理、可人工接管。

text
自然语言需求

业务蓝图 / 现有系统 / 实时数据库结构

Manifest 全系统规划 + dry-run 预演

用户确认后通过 MCP 写入 Microi

表单 · 菜单 · 权限 · V8 · 页面 · 打印 · 流程 · 微服务

远端回读 · 系统验收 · E2E · 压测 · 本地/远端同步

可以直接这样对 AI 说

text
请为当前租户创建一套设备维保系统:包含客户、设备、保养计划、工单、配件、
巡检记录和知识库;设计管理员、调度员、工程师三类角色;工单支持派单、接单、
处理、验收、回访和超时提醒;生成 PC 后台、移动端字段布局、运营驾驶舱、工单
打印模板、审批流与 Playwright 验收用例。先读取现有蓝图和数据库,给出 dry-run
计划,确认后再写入,最后验证系统并报告同步状态。

也可以从任意局部开始:

  • “把这份需求文档整理成业务蓝图和完整系统 Manifest。”
  • “为客户表补齐联系人子表、查询条件、列表列、统计字段和移动端卡片字段。”
  • “生成一个销售运营驾驶舱,包含核心指标、趋势图、排行榜和待办列表。”
  • “设计一张 A4 工单打印模板,包含设备信息、处理明细、图片和签字区。”
  • “把这个复杂弹窗改成可维护的前端微服务,并在 Microi 中发布。”
  • “检查当前系统的表、字段、接口、菜单、工作流和蓝图是否发生漂移。”

AI 如何交付一套完整系统

插件把“自然语言”与“真实平台能力”连接起来,不依赖 AI 猜测表结构,也不只是生成一段无法落地的示例代码。

  1. 发现事实:读取当前服务器、OsClient、业务蓝图、数据库结构、菜单、接口引擎以及已有 Web / UniApp / MicroService 应用。
  2. 理解业务:梳理角色、业务域、数据关系、状态机、权限、流程、页面、打印和验收标准。
  3. 生成计划:将需求转换为完整 Manifest,通过 microi_plan_systemmicroi_generate_system dryRun:true 预演,不直接写入。
  4. 确认执行:用户确认后,创建或升级表、字段、模块、权限、接口、事件、数据源、页面、打印、工作流和任务。
  5. 补齐定制界面:常规业务优先使用表单引擎和界面引擎;复杂交互通过前端微服务实现,并保留完整源码。
  6. 回读与验收:验证每个资源是否真实存在、字段和菜单配置是否完整、工作流拓扑是否正确、远端代码是否生效。
  7. 自动化交付:生成并运行 Playwright E2E、网络与资源守卫,按需执行性能测试,再检查本地与远端同步状态。

所有关键写入工具都保留确认、审计、超时回读与幂等保护。全系统生成默认先 dry-run;真实写入需要明确的 confirmExecution,避免一句含糊的对话直接改动业务系统。

核心能力

能力说明
自然语言生成完整系统从需求直接生成业务蓝图、Manifest、表、字段、表单布局、菜单树、权限、接口、事件、数据源、页面、打印、工作流、任务和测试。
内置 Microi MCP ServerVSIX 已打包 MCP Server,普通用户无需克隆 microi.mcp;一键配置后,AI 可直接读取和操作当前 Microi 租户。
80+ 个平台工具覆盖系统发现、低代码建模、V8、页面、打印、流程、微服务、测试、文件、Redis 和 MongoDB 日志等能力。
AI 知识库与 Skills 自动注入自动生成 AGENTS.mdCLAUDE.md、Copilot/Cursor 指令、V8 类型定义和 microi.skills/,AI 无需反复“喂文档”。
实时数据库理解AI 可通过 MCP 查询实时表结构,也可按需读取每个 OsClient 的 .microi-db-schema.md 快照;大型数据库不会塞满公共指令文件。
V8 全资源本地化接口引擎、表单事件、字段事件、模块按钮/Tab、工作流节点代码均可拉取为本地 .js 文件。
远程执行与逐行调试在 VS Code 内真实执行接口引擎,查看日志和错误定位;支持断点、继续、Step Over / In / Out、变量和表达式求值。
安全同步与冲突检测支持单文件推送、服务器一键同步、远端 Diff、同步结果下钻和双端修改冲突拦截。
前端微服务全生命周期创建、拉取、构建、发布、同步私有源码、维护路由清单并检查源码冲突。
AI 模型统一配置在插件中维护模型库,并分别同步到 Claude Code、Codex 和 GitHub Copilot;内置 DeepSeek、通义千问、MiniMax、腾讯混元、OpenRouter 等快捷预设。
Playwright E2E生成 Microi 专用测试工程、登录与接口辅助方法、冒烟测试、契约测试、网络守卫、视觉与资源检查,并打开 HTML 报告。
性能压力测试对接口引擎、V8 事件和表 CRUD 执行并发/升压测试,输出 RPS、平均耗时、P95/P99、错误率、趋势与错误 Top。
多服务器 / 多租户同一工作区可管理多个服务器和 OsClient,连接、Token、MCP 配置和本地目录彼此隔离。

80+ MCP 工具覆盖哪些平台能力

插件内置 MCP 不是一个“万能写入接口”,而是一组按 Microi 业务对象设计、带参数校验与安全边界的专业工具。

领域代表能力 / 工具
系统与结构发现microi_get_statusmicroi_get_db_schema、字段、模块、角色、接口、事件和应用清单读取
业务架构蓝图microi_get_blueprint_schemamicroi_list_blueprintsmicroi_get_blueprint、保存、校验与历史追踪
全系统 Manifestmicroi_get_manifest_schemamicroi_plan_systemmicroi_generate_systemmicroi_validate_system
表单与数据模型创建表、添加/批量更新字段、关联字段修复、字段控件配置、表属性更新、结构缓存刷新
菜单与权限创建菜单模块、维护列表/搜索/统计/移动端字段、按钮与 Tab、角色和菜单权限
V8 与接口引擎创建/读取/保存/执行接口引擎,表单与字段事件,模块按钮代码,工作流节点 V8,匿名访问配置
数据源与业务数据SQL/V8/JSON 数据源,表数据查询/新增/修改/种子数据,文件上传
界面引擎从自然语言生成、校验和保存 Page Engine 页面与运营驾驶舱
打印引擎从自然语言生成、校验和保存 hiprint 打印模板与运行数据结构
工作流与任务工作流包、拓扑检查、条件路线测试、节点 V8、定时任务
在线 AI 应用发现 Web / UniApp / MicroService,读取完整源码上下文,创建、同步和发布前端微服务
测试与验收Playwright 上下文、E2E 计划、系统后置验收、页面/打印/菜单配置校验
运行维护Redis 统计、SCAN、读取、删除、替换、重命名、TTL;MongoDB 日志查询与写入

Codex 大工具集兼容

部分 Codex 版本不会稳定注入超大 MCP 工具集。插件会为 Codex 配置 microi_codex 单入口:AI 可先用 list_tools / describe_tool 发现全部原始工具,再通过同一入口调用;参数校验、写入确认、审计和远端回读不会被绕过。

如果当前 Codex 仍未注入工具,MCP 还提供 microi://codex/statusmicroi://codex/tools 和通用 action 资源模板作为兼容通道。VS Code/Copilot、Cursor 与 Claude Code 继续使用完整 MCP 工具集。

支持的 AI 客户端

执行 Microi: 初始化AI配置 后,插件会针对不同 AI 客户端生成各自能够自动识别的指令与 MCP 配置。

AI 客户端项目知识与规则MCP 配置模型配置
GitHub Copilot / VS Code Agent.github/copilot-instructions.md、V8 typings、Skills.vscode/mcp.json支持同步吾码模型库到 Copilot Provider
Cursor.cursorrules.cursor/rules/microi-skills.mdc、V8 typings.cursor/mcp.json使用 Cursor 自身模型能力
Claude CodeCLAUDE.md、Skills工作区根 .mcp.json支持检测/安装 Claude Code,并同步模型库
CodexAGENTS.md、Skills~/.codex/config.toml支持同步 Provider、模型目录与环境配置

插件同时支持:

  • 本地 stdio MCP:推荐方式,由 AI 客户端自动启动 VSIX 内置 MCP Server。
  • 远程 SSE MCP:适合团队共享,需要提前部署远程 MCP 服务。
  • 一键诊断:真实执行 initializetools/listmicroi_get_status,区分“配置已存在”与“当前真的可调用”。
  • 生命周期管理:在 Microi 侧栏启动、停止、重启、查看输出、查看配置、启用/禁用或移除 MCP Server。

Codex 已打开的会话通常不会热加载新增 MCP。首次生成配置后,请新开 Codex 对话或重载 Codex;其他客户端也可能要求首次批准新 MCP Server。

零配置知识库:AI 自动理解 Microi

插件把稳定知识、专项规范和实时业务结构分层管理:

  • 公共知识层:V8 API、_Where 语法、上下文变量、表单事件、HTTP/缓存/数据库/Office 等稳定知识。
  • Skills 规范层:低代码建模、V8、表单布局、菜单按钮、界面引擎、打印引擎、UniApp、前端微服务、E2E、性能测试和全系统交付规范。
  • 实时事实层:当前 OsClient 的数据库、菜单、接口、事件、应用与蓝图,优先通过 MCP 查询。
  • 本地快照层.microi-db-schema.md 与本地 V8/前端源码,便于离线分析、Diff 和 Git 管理。

即使当前 VS Code 打开的只是一个空目录,也可以直接初始化。插件会生成或维护:

text
工作区根目录/
├── AGENTS.md
├── CLAUDE.md
├── .github/copilot-instructions.md
├── .cursorrules
├── .cursor/rules/microi-skills.mdc
├── microi.skills/
├── .vscode/mcp.json
├── .cursor/mcp.json
├── .mcp.json
└── Microi-V8-Engine/
    ├── .microi-typings/v8-engine.d.ts
    ├── jsconfig.json
    └── {服务器}/{OsClient.Type.Network}/
        ├── .microi-db-schema.md
        ├── 接口引擎/
        ├── 表单引擎/
        ├── 模块引擎/
        ├── 流程引擎/
        └── AI应用/

MCP 配置、Token 文件、数据库快照和运行态元数据会加入本地 Git exclude,避免把个人服务器信息误提交给团队。插件升级 Skills 时使用逐文件 hash 判断:插件生成且用户未修改的文件可以安全升级,本地已经改过的文件会被保留。

快速开始

1. 安装插件

要求:VS Code 1.85.0 或更高版本,并拥有可访问的 Microi吾码服务器与账号。

  • 扩展市场:在 VS Code 扩展面板搜索 Microi吾码
  • VSIX:在扩展面板右上角选择“从 VSIX 安装…”,打开 v8-engine-x.x.x.vsix

安装后,Activity Bar 会出现 Microi吾码 图标。

2. 添加服务器并登录

打开 Microi: 插件配置,在“服务器连接”中:

  1. 输入 API Base URL。
  2. 输入 OsClient;可留空让服务器自动识别。
  3. 点击“检测服务器,登录并保存连接”。
  4. 输入账号、密码;服务端开启验证码时一并输入。

登录凭据使用当前工作区作用域的 VS Code SecretStorage 保存。插件支持 Token 自动刷新;远端状态失效时会优先使用当前连接的已保存凭据恢复登录。

3. 初始化 AI 配置

执行 Microi: 初始化AI配置。它会生成 AI 指令、Skills、V8 类型定义、jsconfig.json 和各客户端 MCP 配置,但不会拉取或覆盖本地 V8 代码。

4. 配置并诊断 MCP

执行 Microi: 配置 MCP(AI 工具连接)

  1. 选择一个或全部服务器。
  2. 推荐选择“本地 stdio”。
  3. 插件写入 Copilot / Cursor / Claude Code / Codex 对应配置。
  4. 插件自动做一次真实握手诊断。
  5. 如需复查,执行 Microi MCP: 诊断 MCP 可调用性

5. 开始自然语言开发

在 Copilot、Cursor、Claude Code 或 Codex 中描述系统需求即可。建议让 AI 明确执行以下流程:

text
先读取当前租户状态、业务蓝图、数据库结构和已有在线应用;
整理完整方案并 dry-run;
我确认后再真实写入;
写入后回读验证、生成 E2E 测试,并检查同步状态。

6. 按需拉取本地源码

如果需要人工编辑、Git 管理或远程调试,在左侧服务器节点执行 “拉取此服务器代码”。插件会把 V8 资源与数据库结构同步到 Microi-V8-Engine/

V8 本地开发、执行与调试

插件支持以下 V8 资源:

  • 接口引擎代码。
  • 表单前端/后端 V8 事件。
  • 字段 V8CodeKeyupV8Code、模板事件等代码。
  • 模块按钮、批量按钮、表单按钮、页面按钮与 Tab 显隐代码。
  • 工作流节点 V8 事件。

表单事件文件采用“实时字段 Label(EventType)”命名。SubmitFormV8前端表单提交前V8事件(SubmitFormV8).jsOutFormV8前端表单提交后V8事件(OutFormV8).js;插件拉取时会迁移旧名“前端表单提交V8事件/前端表单退出V8事件”,并同步更新 .microi-meta.json

典型人工开发闭环:

  1. 从左侧服务器、表或模块节点拉取资源。
  2. .js 文件中输入 V8. 获得类型提示和智能补全。
  3. 保存文件;保存只会更新“本地已修改”状态,不会静默覆盖远端
  4. 执行“推送当前文件到数据库”或服务器“一键同步”;插件会为接口引擎和 V8 事件维护语义版本,服务端只在代码内容真实变化时写入新的代码版本记录。
  5. 对接口引擎执行“远程执行”或“远程逐行调试”。
  6. 在“同步结果”视图查看本地、远端和冲突差异。

远程执行

对接口引擎文件执行 Microi: 远程执行当前接口引擎,在参数面板填写 JSON:

  • 使用目标服务器的真实 V8 环境和登录态。
  • 输出结果与 console.log 记录到 Microi Output。
  • 异常会尽量定位到对应源代码行。

远程逐行调试

执行 Microi: 远程逐行调试当前接口引擎,支持:

  • 行断点与启动时暂停。
  • Continue、Step Over、Step In、Step Out。
  • 局部变量、作用域与表达式求值。
  • 调试控制台和停止会话。

也可以使用 launch.json

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

本地与远端同步

每个服务器都有独立 .microi-meta.json 基线。同步检查会区分:

  • 本地未推送:本地文件较新或尚未建立远端基线。
  • 服务器端已修改:远端较新,本地未改。
  • 冲突:同一资源本地和远端都发生修改。
  • 已同步:正文和同步基线一致。

“一键同步此服务器代码”会在无冲突时先推送本地较新的文件,再拉取服务器最新代码;存在冲突时停止自动操作并展示冲突列表。首次空目录拉取可以直接执行,已有本地内容时会先提示检测同步状态,避免强制覆盖。

同步结果支持:

  • 按服务器或接口/表单/模块/流程分类检查。
  • 下钻到资源 Key、名称、文件路径和时间。
  • 连续打开 VS Code Diff,不必每次重新扫描。
  • 前端微服务文本 Diff 与二进制 SHA-256 状态检查。
  • 重新检测和清空结果。

前端微服务与复杂定制页面

三个以上字段、复杂联动、上传、表格、Tab、步骤条、代码编辑器或长期维护的弹窗,不需要在 V8 中拼接大段 HTML。AI 可以创建或扩展一个 MicroService,由 Microi 宿主以标准方式打开。

插件提供完整的本地微服务工作流:

操作说明
创建前端微服务生成项目元数据、基础源码、.microi-micro-app.json 和路由清单
拉取服务器前端微服务获取在线 AI 应用的私有源码到本地
构建执行项目构建并检查 dist 产物
推送上传构建产物并更新 Microi 微服务元数据
构建并推送一次完成构建、版本更新和发布
同步源码到在线 AI 应用保存可继续被在线 AI 或其他开发者维护的私有源码
查看同步状态比较本地与远端源码,识别本地修改、远端修改和冲突

前端微服务统一放在当前租户的 AI应用/{appKey}/microi.routes.json 作为路由事实源,发布与迁移时会保留必要的历史菜单 URL / 组件路径兼容信息。

Playwright E2E 自动化测试

插件会把自动化工程生成到目标前端项目的 .microi-e2e/,不污染业务源码目录。

命令作用
Microi: 初始化端到端自动化测试(Playwright E2E)生成配置、Microi helpers、环境变量示例和基础测试
Microi: 运行端到端自动化测试(Playwright E2E)运行项目的 test:e2e
Microi: 打开端到端测试报告(Playwright Report)打开 HTML 报告

初始化时会读取当前连接,并尝试通过后端获取菜单路由与接口引擎上下文,写入 .microi-playwright-context.json。生成的基础用例覆盖:

  • 公共页面和接口引擎冒烟。
  • DosResult 接口契约。
  • 登录 Token 注入与认证会话。
  • API 4xx/5xx、空响应、字符串 null 和无效 JSON 守卫。
  • 图片加载、第三方占位资源、横向溢出和明显“开发中/请求失败”文案检查。
  • Desktop 与 Mobile 两套浏览器项目。

性能压力测试

打开 Microi: 性能测试,可直接复用当前 Microi 连接测试:

目标说明
接口引擎真实调用 /apiengine/{ApiEngineKey},支持 JSON 参数、并发、总次数、持续时间、升压和超时
V8 事件读取已有表单事件或执行临时代码,通过 ExecuteV8Event 隔离测试
表 CRUD对测试表执行新增、查询、修改、删除闭环,真实触发服务端 V8 事件

报告展示完成数、成功/失败、RPS、平均耗时、P95、P99、错误率、每秒趋势和错误 Top,并可保存到工作区 .microi-performance/。表 CRUD 会产生真实写入,建议使用测试表并保持“每次迭代后删除测试行”开启。

多服务器与身份管理

  • 同一工作区可保存多个服务器 / OsClient Profile。
  • 服务器标题优先从 SysShortTitle / SysTitle 获取。
  • 每个 Profile 独立保存凭据、Token 和本地资源目录。
  • Token 临近失效时自动刷新;服务端状态已失效时按 Profile 精确清理并恢复登录。
  • 支持有验证码和无验证码登录。
  • MCP Server key、显示名称和设备标识会转换为安全的 ASCII 传输格式,兼容中文 Windows 主机名与不同 AI 客户端。
  • Windows 工作区会自动启用当前 Git 仓库的 core.longpaths=true,降低深层 V8 目录的长路径问题。

插件配置项

在 VS Code 设置中搜索 microi

设置项默认值说明
microi.apiBaseUrl""单连接模式的 Microi 后端 API 地址
microi.profiles[]多服务器连接配置列表
microi.osClient""单连接模式的默认 OsClient
microi.localDir""本地同步目录;留空使用工作区 Microi-V8-Engine/
microi.showConsoleOnExecutetrue远程执行时自动显示 Output
microi.playwright.defaultBaseUrlhttp://127.0.0.1:5180Playwright 默认前端地址
microi.playwright.defaultApiBaseUrl""Playwright 默认 API;留空使用当前连接
microi.playwright.defaultOsClient""Playwright 默认 OsClient;留空使用当前连接
microi.playwright.browserChannel""浏览器 channel,例如 msedge
microi.playwright.appTypeuniapp-h5uniapp-h5pc-vueweb

完整命令清单

Ctrl+Shift+P(macOS:Cmd+Shift+P),输入 Microi 查看命令。

连接、AI 与 MCP

命令
Microi: 插件配置
Microi: 登录
Microi: 退出登录
Microi: 切换 OsClient
Microi: 初始化AI配置
Microi: 配置 MCP(AI 工具连接)
Microi MCP: 刷新 MCP 状态
Microi MCP: 诊断 MCP 可调用性
Microi MCP: 启动全部 MCP 服务器
Microi MCP: 启动 MCP 服务器
Microi MCP: 停止 MCP 服务器
Microi MCP: 重启 MCP 服务器
Microi MCP: 显示 MCP 输出
Microi MCP: 显示 MCP 配置
Microi MCP: MCP 服务器选项(启用/禁用)
Microi MCP: 显示已安装 MCP 服务器
Microi MCP: 删除 MCP 配置

V8、资源与同步

命令
Microi: 新增接口引擎
Microi: 新建表单V8事件文件
Microi: 新建流程节点V8事件文件
Microi: 新建按钮V8事件文件
Microi: 拉取此服务器代码
Microi: 一键同步此服务器代码
Microi: 拉取此表字段V8事件
Microi: 拉取此模块子树
Microi: 搜索引擎文件
Microi: 拉取数据库结构到AI知识库
Microi: 推送当前文件到数据库
Microi: 与远程版本对比
Microi: 查看同步状态
Microi: 检测同步冲突
Microi: 查看同步差异
Microi: 重新检测同步状态
Microi: 清空同步结果
Microi: 打开文件
Microi: 在资源管理器中打开
Microi: 复制 ApiEngineKey
Microi: 刷新

执行与调试

命令
Microi: 远程执行当前接口引擎
Microi: 远程逐行调试当前接口引擎
Microi: 停止调试会话

前端微服务

命令
Microi: 创建前端微服务
Microi: 拉取服务器前端微服务
Microi: 构建前端微服务
Microi: 推送前端微服务到数据库
Microi: 构建并推送前端微服务
Microi: 同步微服务源码到在线 AI 应用
Microi: 查看前端微服务同步状态

测试

命令
Microi: 性能测试
Microi: 初始化端到端自动化测试(Playwright E2E)
Microi: 运行端到端自动化测试(Playwright E2E)
Microi: 打开端到端测试报告(Playwright Report)

使用截图

Microi 连接配置Microi 运行调试

常见问题

MCP 显示已配置,但 AI 仍说没有工具

先执行 Microi MCP: 诊断 MCP 可调用性。它会验证配置、进程启动、initializetools/list 和只读状态调用,而不只是检查 JSON 文件是否存在。

如果诊断成功但 Codex 当前对话仍没有工具,请新开对话或重载 Codex;当前会话通常不会热加载新 MCP。还可以使用 microi_codex 单入口或 MCP 资源兼容通道。

保存文件后为什么远端没有变化

当前版本采用显式发布策略:保存只标记本地变更。请执行 “推送当前文件到数据库”,或在服务器节点执行 “一键同步此服务器代码”。这样可以避免普通保存动作无提示地覆盖远端生产代码。

拉取会不会覆盖本地代码

首次空目录可以直接拉取;已有同步基线或本地文件时,插件会先提示检测同步状态。建议先查看同步结果,处理冲突后再一键同步,不要直接强行拉取。

空工作区可以使用吗

可以。打开任意空文件夹,执行 Microi: 初始化AI配置,插件会生成 Skills、AI 指令、V8 typings 和 jsconfig.json;添加服务器并登录后,还会生成对应的 MCP 配置。无需提前克隆 Microi 源码或 microi.skills

远程执行与调试不可用

  • 确认当前文件属于已拉取的接口引擎,而不是普通 JavaScript 文件。
  • 确认目标 Profile 已登录且 Token 有效。
  • 检查 Microi Output 中的后端错误。
  • 远程逐行调试需要服务器部署对应的 V8 调试能力;不能使用时仍可先远程执行和查看日志。

数据库结构很大,会不会拖慢 AI

公共 AI 指令不会内嵌全部业务表。实时结构由 MCP 按需查询,本地结构则按 OsClient 单独保存在 .microi-db-schema.md。即使数据库有数百张表,也不会把完整 schema 强塞进每次对话上下文。

相关链接

License

MIT

MIT License.