Title: 🧭 源码架构与模块地图
Canonical: https://microi.net/doc/getting-started/source-code-architecture.html
Page-Modified: 2026-10-25T04:58:01.000Z
Source: published HTML document body; page revision is not a capability verification date.

# 🧭 源码架构与模块地图

Microi吾码不是单一的后台管理模板。完整工程由低代码运行时、Vue 前端、多端客户端、V8 引擎、MCP、VS Code / CLI、Skills、设计系统和发布工具共同组成。

官方主仓库同时维护 GitHub (https://github.com/itdos/microi.net) 与 Gitee (https://gitee.com/ITdos/microi.net)。本文按当前源码职责说明每个目录，帮助二次开发者先找到正确扩展点，再决定使用低代码配置、接口引擎、前端源码或后端模块。

## Microi吾码系统架构全景

[Microi吾码 AI 平台系统架构图，展示全部核心系统引擎: https://file.microi.net/itdos/official-docs/images/af8f0aad7815c1f68e224cbce706d5723c5223bd1557e1eea71a19b45891d169/202610/microi-ai-platform-architecture-2026_10_25_1.svg] (https://file.microi.net/itdos/official-docs/images/af8f0aad7815c1f68e224cbce706d5723c5223bd1557e1eea71a19b45891d169/202610/microi-ai-platform-architecture-2026_10_25_1.svg)

点击架构图可放大查看。图中优先展示当前平台真实存在的 30+ 系统引擎，并以 V8 引擎为在线运行核心；下文继续把这些能力映射到具体源码目录与扩展边界。

## 中大型应用不是高代码与低代码二选一

中大型软件的长期优势通常来自分层组合：高频、标准化能力交给平台复用；差异化业务留给可测试的代码；底层性能、协议和安全边界继续由专业源码承担；AI 贯穿各层，但不替代架构、权限、测试与治理。

开发层	|	最适合解决	|	Microi吾码的承载方式	|	核心收益	|

可视化低代码	|	表单、CRUD、菜单、权限、流程、报表、常规工作台	|	表单 / 模块 / 界面 / 工作流 / 报表等成熟引擎	|	少造轮子，快速形成可运行基线	|

V8 在线编程	|	业务校验、接口编排、事务事件、第三方集成、自动化	|	接口引擎、表单事件和平台原子能力	|	保留代码表达力，保存即生效，复用租户与权限上下文	|

专业源码扩展	|	复杂交互、微服务、原生能力、高吞吐处理、协议与安全内核	|	Vue / UniApp / .NET / SDK 与前端微服务	|	性能、体验与底层边界不受低代码天花板限制	|

AI 协作与治理	|	结构理解、建模、生成、调试、测试、发布和回读	|	VS Code / Codex / Copilot / Cursor / Claude + MCP + Skills	|	AI 获得真实上下文，并在同一套交付规则中工作	|

这类组合在行业中通常称为 Fusion Development 或平台工程：微软强调低代码与 code-first 组件协同，AWS 的内部开发平台指南强调可复用服务与“黄金路径”，Spotify 也通过统一开发门户、模板和标准降低工程认知负担。Microi吾码的定位因此不是“用低代码替代专业开发”，而是把低代码、V8、专业源码与 AI 组织成一条连续开发路径。

公开实践参考：Microsoft Fusion Development (https://learn.microsoft.com/en-us/power-platform/developer/fusion-development) · AWS Internal Developer Platform (https://docs.aws.amazon.com/prescriptive-guidance/latest/internal-developer-platform/introduction.html) · Spotify Developer Platform (https://engineering.atspotify.com/2026/6/code-with-claude-coding-is-no-longer-the-constraint)

## 先判断应该改哪一层

需求	|	首选实现位置	|	说明	|

表、字段、菜单、权限、页面、打印、流程、任务	|	低代码元数据 / 应用商城包	|	可配置、可升级、可跨租户安装，不应先写定制 Controller	|

业务校验、数据编排、第三方 HTTP、定时业务	|	V8 表单事件 / 接口引擎	|	保存即生效，可继续使用 DiyToken、租户、角色和事务上下文	|

复杂交互页面	|	界面引擎或前端微服务	|	常规 CRUD 继续复用表单与模块引擎，复杂 UI 才独立开发	|

跨端原生交互	|	microi.uniapp 或 microi.app	|	原生小程序与 WebView 壳是两条不同技术路线	|

协议网关、可信鉴权、运行时内核、存储边界	|	C# 后端模块	|	只提供可复用的最小原子能力，业务编排仍优先留在接口引擎	|

## 顶层工程

目录	|	技术与职责	|	继续阅读	|

Microi.Server/	|	.NET 10 后端解决方案，包含 API、核心引擎、缓存、文件、消息、AI、OCR、任务与多数据库能力	|	本页“后端项目”	|

Microi.Client/	|	Vue 3 + Vite + Element Plus 管理端；同时承载经典界面、WebOS、移动 Web 页、表单/页面/打印/流程/可视化设计器	|	PC、WebOS 与移动端 (https://microi.net/doc/system-engine/multi-end-client.html)	|

Microi.UI/	|	跨 Web、UniApp 的 MCI-UI 设计令牌、组件与交付规范	|	吾码 UI (https://microi.net/doc/system-engine/microi-ui.html)	|

Microi.Unity/	|	Unity 2022.3 LTS 的 UPM SDK：V8/DiyToken 客户端、WebGL 宿主桥、可恢复 Editor 工具箱和构建能力；不是 .NET 服务端类库	|	Unity 3D 与 WebGL (https://microi.net/doc/system-engine/unity-integration.html)	|

microi.uniapp/	|	uni-app + Vue 3 原生动态小程序/H5/App 基线，支持 Profile 与租户定制隔离	|	PC、WebOS 与移动端 (https://microi.net/doc/system-engine/multi-end-client.html)	|

microi.app/	|	HBuilderX 5+App/Wap2App 壳，把远程 Microi.Client 包装为 APK/IPA 并提供 plus 原生 API	|	PC、WebOS 与移动端 (https://microi.net/doc/system-engine/multi-end-client.html)	|

microi.mcp/	|	TypeScript MCP Server，让 AI 按租户读取结构、生成系统、维护 V8/页面/流程/微服务并回读验收	|	MCP Server (https://microi.net/doc/v8-engine/mcp-server.html)	|

microi.skills/	|	面向 AI Agent 的平台规范、工作流和安全边界，避免只知道函数名却不知道正确交付顺序	|	AI 编程 (https://microi.net/doc/v8-engine/ai-apiengine.html)	|

microi.doc/	|	当前官网与官方文档，VitePress 构建；中文 docs/doc/ 是维护源	|	平台介绍 (https://microi.net/doc/)	|

Microi-V8-Engine/.../AI应用/{appKey}/	|	插件或 CLI 面向当前服务器、租户生成的 AI 应用工作副本；普通租户应用默认以此为可编辑源码根	|	应用商城 (https://microi.net/doc/system-engine/app-store.html)	|

数据库、案例、文档、资料/	|	演示库、空库、案例和部署辅助资料；使用前核对版本与目标数据库类型	|	数据库扩展 (https://microi.net/doc/system-engine/databases.html)	|

以下目录常在完整开发工作区中出现，但用途与主仓库源码不同：

- Microi.Agent/ 是 VS Code 插件与 @microi.net/cli 的伴随源码仓库，包含同步、远程执行、调试、MCP 打包和 AI 配置生成。详见 AI 开发工具 (https://microi.net/doc/v8-engine/microi-agent.html)。

- Microi-V8-Engine/ 通常由插件或 CLI 在本机生成，按服务器与 OsClient 保存接口引擎、事件、数据库快照和同步基线。普通 Web、UniApp、MicroService 及无前端 AI 应用默认以对应租户的 AI应用/{appKey} 作为唯一可编辑源码根；它可能包含本机 Token 或租户代码，不应整体提交到公开产品仓库。

- AI-Project/ 可以是单独版本管理的官方或客户项目源码仓库，不属于主产品仓库。只有发布契约明确指向其中某个应用时，该目录才是该应用的正式源码根；同名 Microi-V8-Engine 目录此时只是在线租户同步镜像，不能再参与构建或测试取源。禁止同时把两处都当作可编辑事实源。

### 平台内置微服务的源码与运行链

microi-platform-service 承载应用商城、个人中心、租户系统设置、数据库备份和离线包安装等平台页面。它采用“一个可编辑源码根、两个相同内置包、一个稳定宿主入口”的交付链，而不是把完整业务源码再复制到 Microi.Client：

text

```
platform-service-release.json 指定的独立 Git 源码根
  → Vue/Vite dist 与 SourceManifestHash / RuntimeManifestHash
  → app.microi.saas-engine.json + app.microi.store.json（同一份 DatabaseOnly 资产）
  → Microi.Upgrade 幂等导入目标租户数据库
  → MicroAppController 稳定入口 /micro-app/{OsClient}/microi-platform-service/index.html
  → Microi.Client/src/views/micro-app/ 宿主、Resolve 与兼容入口回退
```

正式构建和跨工程测试必须读取 Microi.Server/OfficialApplications/Resource/platform-service-release.json，不得硬编码 AI-Project 或某个 Microi-V8-Engine 镜像路径。embed-platform-service-bundle.mjs --verify-only 会同时核对源码版本、源码清单哈希、dist 逐文件哈希、路由以及两个内置包；官网资源正式发布还要求源码根来自无未提交修改的 Git 提交，任一处漂移即阻止发布。

数据库内联产物是平台启动和恢复权威，受 256 文件、5MB、无可编辑源码的严格边界约束。HDFS/CDN 可以保存正式源码或作为运行资产镜像，但只有回读哈希与同一 RuntimeManifestHash 完全一致后才可启用；HDFS 不可用或镜像不一致时继续使用数据库产物，不能反向覆盖它。Microi.Client 只保留通用宿主、错误诊断和通知中心恢复入口，不保留第二份平台业务实现。

## 后端项目

Microi.Server 当前由下列项目组成。业务入口通常位于 Microi.net.Api，领域实现位于 Microi.net / Microi.Core，其余项目提供可替换的基础能力。

项目	|	主要职责	|	对应文档	|

Microi.net.Api	|	ASP.NET Core HTTP 入口、Controller、中间件、后台 Worker、健康与运行诊断；V8EngineController.cs 只声明 MCP/V8 HTTP 路由并转发至 Microi.MCP，MicroAppController.cs 解析并输出前端微服务运行资产	|	安全基线 (https://microi.net/doc/more/security.html)	|

Microi.net	|	表单、接口、模块、工作流、数据源、应用商城等核心业务运行时	|	系统引擎 (https://microi.net/doc/#%E6%A0%B8%E5%BF%83%E5%BC%95%E6%93%8E)	|

Microi.Core	|	公共接口、模型、租户上下文、FormEngine 基础实现、V8/MCP 领域逻辑	|	表单引擎 (https://microi.net/doc/form-engine/form-engine-info.html)	|

Microi.MCP	|	MCP 参数处理、权限过滤器、资产流、V8 代码同步与 WebSocket 调试；独立闭源类库	|	源码本地运行 (https://microi.net/doc/getting-started/local-run.html)	|

Microi.AI	|	AI 代理、模型订阅、Schema/V8 文档上下文、NL2V8 与系统级 AI 工作流	|	AI 引擎 (https://microi.net/doc/system-engine/ai-engine.html)	|

Microi.AI/Microi.AI.Tests	|	AI 授权门禁、NL2SQL 安全、租户向量隔离、知识上下文与恢复行为测试	|	AI 引擎 (https://microi.net/doc/system-engine/ai-engine.html)	|

Microi.V8Engine	|	V8 扩展注册表以及图片、微信、支付、系统信息等可信扩展	|	后端 V8 函数 (https://microi.net/doc/v8-engine/v8-server.html)	|

Microi.Cache	|	Redis、租户缓存、L1/L2 缓存与 Redis 管理原子能力	|	系统设置 (https://microi.net/doc/more/sys-config.html)	|

Microi.HDFS	|	MinIO、阿里云 OSS、Amazon S3、私有/公有文件与外部对象同步、CAD 转换	|	分布式存储 (https://microi.net/doc/more/hdfs.html)	|

Microi.Job	|	Quartz 任务、接口引擎 Job、监听器与调度注册	|	任务调度 (https://microi.net/doc/system-engine/job.html)	|

Microi.MongoDB	|	MongoDB CRUD、Where 解析与 V8.MongoDb	|	后端 V8 函数 (https://microi.net/doc/v8-engine/v8-server.html#v8-mongodb)	|

Microi.MQ	|	RabbitMQ 连接、发布、消费与 V8.MQ	|	消息队列 (https://microi.net/doc/system-engine/mq.html)	|

Microi.MQTT	|	MQTT 服务端/客户端事件与 IoT 消息入口	|	MQTT 引擎 (https://microi.net/doc/system-engine/mqtt-engine.html)	|

Microi.SearchEngine	|	Elasticsearch 查询、排序、索引帮助器	|	搜索引擎 (https://microi.net/doc/system-engine/search-engine.html)	|

Microi.Spider	|	采集任务与浏览器 Worker 的后端协调	|	采集引擎 (https://microi.net/doc/system-engine/spider-engine.html)	|

Microi.Office	|	Excel、Word、PowerPoint、邮件与模板导出	|	Office (https://microi.net/doc/more/office.html)	|

Microi.OCR	|	租户绑定的 OCR 网关，模型服务地址与密钥保留在可信后端	|	OCR 识别引擎 (https://microi.net/doc/system-engine/ocr-engine.html)	|

Microi.Vision	|	ONNX Runtime 通用视觉特征、连续帧与向量比较原子能力	|	视觉引擎 (https://microi.net/doc/system-engine/vision-engine.html)	|

Microi.Captcha	|	登录验证码生成与可选识别适配	|	安全基线 (https://microi.net/doc/more/security.html)	|

Microi.WeChat	|	公众号、小程序、模板消息等微信能力	|	消息通知 (https://microi.net/doc/system-engine/message-notification.html)	|

Microi.Upgrade	|	应用商城运行前必需的物理兼容、协议与核心种子升级	|	应用商城 (https://microi.net/doc/system-engine/app-store.html)	|

Dos.ORM	|	自研多数据库 ORM、SQL 编译、参数与数据库兼容层	|	Dos.ORM (https://microi.net/doc/more/dos-orm.html)	|

Dos.Common	|	加密、序列化、HTTP 参数、运行诊断等通用基础库	|	DosResult (https://microi.net/doc/more/dos-result.html)	|

Microi.Tests	|	后端安全、兼容、升级、分布式与全栈发布门禁测试	|	源码本地运行 (https://microi.net/doc/getting-started/local-run.html#%E5%90%8E%E7%AB%AF%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95%E4%B8%8E%E5%8F%91%E5%B8%83%E9%97%A8%E7%A6%81)	|

tools/Microi.DatabaseSeedConverter	|	多数据库种子与资源转换工具	|	数据库扩展 (https://microi.net/doc/system-engine/databases.html)	|

tools/SysLogQueueLoadTest	|	系统日志异步队列的受控压力测试工具	|	源码本地运行 (https://microi.net/doc/getting-started/local-run.html)	|

### MCP 类库与引用方式

microi.mcp/ 继续提供 MCP 客户端工具。后端实现集中在 Microi.Server/Microi.MCP/， 保留 /api/V8Engine/*、/api/V8Debug/* 和 /api/V8Debug/ws 的现有协议。

构建入口	|	MCP 引用方式	|

Microi.Anderson.sln	|	加载独立内部 Git 仓库中的 Microi.MCP.csproj 源码	|

Microi.net.sln	|	引用与平台版本一致的 Microi.MCP NuGet 包	|

单项目构建	|	默认按本地源码是否存在自动选择，也可设置 MicroiClosedSourceReferenceMode	|

一键发布将 Microi.MCP.dll 纳入与 Microi.AI.dll 相同的 Obfuscar 处理、包内 DLL 替换和发布验收。升级时须配套更新 Microi.Core、Microi.MCP 与 API，不能只替换其中 一个 DLL。Microi.MCP 源码禁止进入根公开仓；通用管理员复核和任务调度原子仍归 Core， 避免 Core 反向依赖 MCP。

## Microi.Client 功能入口

源码区域	|	作用	|

src/views/form-engine/	|	动态表单、表格、字段设计器、全部表单控件和 V8 事件宿主	|

src/views/page-engine/、print-engine/	|	页面与打印设计/渲染	|

src/views/workflow/	|	审批工作流 v4	|

src/views/ai-workflow/、blueprint/、state-machine/、flow-engine/、process-mining/	|	AI 工作流、业务蓝图、数据状态机、自动化流与流程分析	|

src/views/micro-app/	|	前端微服务宿主、认证与路由桥	|

src/views/go-view/、3d-engine/、cad-preview/	|	数据大屏、Three.js 场景与 CAD 预览	|

src/views/webos/	|	macOS / Windows 风格桌面、Dock、小组件和应用容器；缺少该可选目录时自动回退经典界面	|

src/views/mobile/	|	同一 Web 工程内的移动工作台、消息、聊天、AI 助手和个人中心	|

src/views/file-manage/	|	文件管理、预览、CAD 转换结果与对象存储交互	|

src/utils/diy.common.js	|	前端 V8、FormEngine、HTTP、客户端类型与平台公共能力的主要适配入口	|

## MCP、插件、CLI 与 Skills 的关系

层	|	负责什么	|	不负责什么	|

MCP	|	当前服务器/OsClient 的实时读取、受控写入、确认、审计与远端回读	|	不替代业务权限，也不把任意 SQL/V8 当成万能写口	|

VS Code 插件	|	资源树、编辑器 Diff、同步、远程执行、逐行调试、MCP 生命周期与可视化命令	|	不另建一套 Token 或业务模型	|

CLI	|	无 IDE 场景下的连接、登录、AI/MCP 初始化、同步与诊断	|	不复制 VS Code 的断点调试 UI	|

Skills	|	告诉 AI 正确的实现层、调用顺序、安全约束和验收标准	|	不作为数据库、服务器或运行状态的事实源	|

典型 AI 交付链路是：先通过 MCP 读取真实结构，再让 Skills 约束方案，生成 dry-run 计划；用户确认后写入，并以远端回读与真实页面验收收尾。

## 二次开发边界

- DiyToken 始终是平台会话与权限入口；新增登录方式在验证成功后仍签发 DiyToken。

- OsClient、服务器地址和连接身份必须绑定，不能把另一个租户的结构或 Token 当成当前事实。

- 后端业务配置进入 SaaS 引擎；API 容器只保留规定的启动引导配置。

- 多节点部署下，任务唯一性、幂等、进度与租约进入共享 Redis/数据库，不能依赖本机静态变量。

- 修改共享服务前先确认端口、PID、命令行和工作区归属，不能批量结束所有 Node、dotnet 或浏览器进程。

- 源码测试、构建、部署、在线回读与 PC/移动真机验收是不同证据，应分别报告。

## 建议阅读顺序

- 源码本地运行 (https://microi.net/doc/getting-started/local-run.html)

- 表单引擎 (https://microi.net/doc/form-engine/form-engine-info.html) 与 接口引擎 (https://microi.net/doc/v8-engine/api-engine.html)

- MCP Server (https://microi.net/doc/v8-engine/mcp-server.html) 与 AI 开发工具 (https://microi.net/doc/v8-engine/microi-agent.html)

- AI 工作流、蓝图与状态机 (https://microi.net/doc/system-engine/ai-workflow-suite.html)

- PC、WebOS 与移动端 (https://microi.net/doc/system-engine/multi-end-client.html)

- 3D、CAD 与数据大屏 (https://microi.net/doc/system-engine/visualization-engine.html)