944 lines
23 KiB
Markdown
944 lines
23 KiB
Markdown
# JY1.0 项目结构、功能全景与 MCP 服务设计文档
|
||
|
||
## 1. 文档目标
|
||
|
||
本文档用于指导为「景耀 JY1.0」MES 前端项目创建配套 MCP 服务，使 AI 助手能够安全、可控地理解项目结构、查询业务功能、定位页面/API、生成代码建议、辅助排障，并在授权范围内调用项目相关工具。
|
||
|
||
本文档覆盖：
|
||
|
||
- 当前前端项目结构与技术栈。
|
||
- 现有业务功能模块全景。
|
||
- 前端与 ASP.NET `.ashx` 后端的通信规范。
|
||
- MCP 服务的资源、工具、提示词、权限和数据模型设计。
|
||
- MCP 服务的实施路线、部署方式和验收标准。
|
||
|
||
## 2. 项目概述
|
||
|
||
JY1.0 是江苏高精机械设备有限公司使用的制造执行系统前端，基于 Vue 2 和 Element UI 构建，后端以 ASP.NET 通用处理程序 `.ashx` 暴露统一入口。系统覆盖销售、基础资料、技术、精工车间、装配、采购、仓储、设备、可视化等制造业务。
|
||
|
||
项目特点：
|
||
|
||
- 前端为单页应用，基于 `vue-element-admin` 改造。
|
||
- 运行时路由主要由后端菜单数据动态注入。
|
||
- 业务请求统一 POST 到 `MESCommonBase.ashx` 一类端点。
|
||
- 业务字段大量使用中文数据库字段名。
|
||
- 页面以 Element UI 表单、筛选栏、表格、弹窗、分页为主。
|
||
- 文件上传下载、Excel 导出、图片/PDF 查看属于重要业务能力。
|
||
|
||
## 3. 技术栈
|
||
|
||
| 类别 | 技术 |
|
||
| --- | --- |
|
||
| 框架 | Vue 2.5.17 |
|
||
| 路由 | Vue Router 3.0.7 |
|
||
| 状态 | Vuex 3.0.1 |
|
||
| UI | Element UI 2.13 |
|
||
| HTTP | Axios 0.18 |
|
||
| 图表 | ECharts 4 |
|
||
| 构建 | Webpack 4 |
|
||
| 样式 | SCSS、Stylus |
|
||
| 文档/导出 | xlsx、xlsx-style、FileSaver、jsPDF、html2canvas、docxtemplater |
|
||
| 鉴权存储 | js-cookie |
|
||
| 富文本 | TinyMCE 4.7.5 |
|
||
| 预览 | v-viewer |
|
||
|
||
约束：
|
||
|
||
- 不使用 Vue 3。
|
||
- 不使用 TypeScript。
|
||
- 不使用 Composition API。
|
||
- 业务页面保持 Vue 2 Options API 风格。
|
||
- 请求封装沿用现有 `CreateData`、`ExecDatabase`、`getTable` 等全局方法。
|
||
|
||
## 4. 项目目录结构
|
||
|
||
根目录主要内容：
|
||
|
||
| 路径 | 说明 |
|
||
| --- | --- |
|
||
| `src/` | 前端源码 |
|
||
| `src/views/` | 页面视图，按业务模块组织 |
|
||
| `src/api/` | API 函数，部分新页面直接在视图内调用 `CreateData` |
|
||
| `src/utils/` | 请求封装、CRUD 工具、鉴权、通用方法 |
|
||
| `src/router/` | 静态路由与动态路由生成 |
|
||
| `src/store/` | Vuex 模块 |
|
||
| `src/components/` | 通用组件 |
|
||
| `src/icons/svg/` | SVG 图标 |
|
||
| `src/styles/` | 全局样式 |
|
||
| `static/config.js` | 服务地址、上传下载地址、WebSocket 地址 |
|
||
| `build/`、`config/` | Webpack 构建配置 |
|
||
| `dist/`、`dist.zip`、`dist.7z` | 构建产物 |
|
||
|
||
`src/views` 已识别的业务目录：
|
||
|
||
| 模块目录 | 功能定位 |
|
||
| --- | --- |
|
||
| `SalesManagement` | 销售、合同、订单、发货、售后、统计分析 |
|
||
| `BasicData` | 基础资料、人员、角色、菜单、工艺、班次、日历、物料 |
|
||
| `TechnologyCenter` | 技术中心、BOM、图纸、物料查询、图纸确认 |
|
||
| `SeikoWorkshop` | 精工车间、工艺制定、生产计划、派工、执行、质检、追溯 |
|
||
| `AssemblyManagement` | 装配任务、装配执行、领料、补货、滑台/专机装配 |
|
||
| `PurchasingManagement` | 采购订单、到货通知、供应商、外协采购查询 |
|
||
| `WarehouseManagement` | 仓储、入库、出库、库存、盘点、调拨、补货、库位 |
|
||
| `DeviceManagement` | 设备状态、点检、维修、实时监控、能耗、异常原因 |
|
||
| `ManufacturingCenter` | 制造中心相关页面 |
|
||
| `WarehouseVisualization` | 仓库可视化 |
|
||
| `dashboard` | 首页仪表盘 |
|
||
| `login` | 登录页 |
|
||
| `layout` | 主框架、导航、侧边栏、标签页 |
|
||
|
||
## 5. 业务功能全景
|
||
|
||
### 5.1 登录、权限与菜单
|
||
|
||
核心文件：
|
||
|
||
- `src/api/login.js`
|
||
- `src/store/modules/user.js`
|
||
- `src/store/modules/permission.js`
|
||
- `src/router/index.js`
|
||
- `src/router/getRouter.js`
|
||
- `src/permission.js`
|
||
|
||
功能：
|
||
|
||
- 用户名密码登录。
|
||
- Cookie 保存 token、用户姓名、人员流水号、工号等。
|
||
- 登录后获取用户信息和角色菜单。
|
||
- 后端返回菜单数据，前端按 `pid` 递归构建路由。
|
||
- 动态组件路径映射到 `src/views` 下的 Vue 文件。
|
||
- 路由 `meta.title` 为中文标题，`meta.icon` 对应 `src/icons/svg` 文件。
|
||
|
||
动态路由核心模式：
|
||
|
||
```js
|
||
component: () => import(`@/views${data[i].component}`)
|
||
```
|
||
|
||
### 5.2 统一请求机制
|
||
|
||
核心文件：
|
||
|
||
- `src/utils/request.js`
|
||
- `src/utils/curd.js`
|
||
- `static/config.js`
|
||
|
||
请求入口：
|
||
|
||
- Axios `baseURL` 来自 `static/config.js` 的 `request_config`。
|
||
- 业务请求 `url` 通常为空字符串。
|
||
- 由后端统一入口根据 `name` 字段路由到存储过程或 SQL 逻辑。
|
||
|
||
标准请求字段：
|
||
|
||
| 字段 | 说明 |
|
||
| --- | --- |
|
||
| `type` | 操作类型，常见为 `1` 查询、`2` 增删改、`7` 批量，也存在项目内扩展值如 `11`、`12`、`2001` |
|
||
| `name` | 后端过程名、业务路由名或特殊 SQL 字符串 |
|
||
| `param` | 参数，旧 API 多为 `key=value&key2=value2`，新全局方法多为参数数组 JSON 字符串 |
|
||
| `pageSize` | 分页大小 |
|
||
| `pageList` | 当前页 |
|
||
| `UserID` | 当前用户，来自 Cookie |
|
||
| `ModularID` | 当前路由路径 |
|
||
|
||
全局工具：
|
||
|
||
| 方法 | 用途 |
|
||
| --- | --- |
|
||
| `CreateData(type, name, data, pageSize, pageList)` | 构建后端请求参数 |
|
||
| `ExecDatabase(num)` | 向主服务发送 POST |
|
||
| `ExecDatabase1(num)` | 向备用服务发送 POST |
|
||
| `getTable(requestData, param, e)` | 分页表格查询并格式化日期 |
|
||
| `getData(requestData, carrier, param)` | 普通查询 |
|
||
| `getSelect(requestData, select, carrier, param)` | 下拉框查询 |
|
||
| `addForm(form, callback)` | 打开新增表单并重置 |
|
||
| `editForm(row, form, callback)` | 行数据填充到编辑表单 |
|
||
| `addTable(...)` | 新增表格行 |
|
||
| `editTable(...)` | 编辑表格行 |
|
||
| `deleteRow(...)` | 删除表格行 |
|
||
| `exportExcel_NPOI(param)` | 触发后端 NPOI Excel 导出 |
|
||
| `setColumnWidth(str)` | 按中文字段名设置表格列宽 |
|
||
|
||
### 5.3 基础数据
|
||
|
||
目录：
|
||
|
||
- `src/views/BasicData`
|
||
- `src/api/BasicData`
|
||
|
||
覆盖功能：
|
||
|
||
- 菜单管理。
|
||
- 系统角色维护。
|
||
- 用户权限管理。
|
||
- 人员管理。
|
||
- 车间人员角色管理。
|
||
- 班次管理。
|
||
- 工厂日历。
|
||
- 物料维护。
|
||
- 零件编号维护。
|
||
- 工艺分类、工艺名称、工艺要求维护。
|
||
- 设备能力设置。
|
||
- 设备人员维护。
|
||
- 项目管理显示。
|
||
|
||
MCP 需识别这些页面与 API 名称，支持按中文功能名定位文件、定位后端 `name` 调用点。
|
||
|
||
### 5.4 销售管理
|
||
|
||
目录：
|
||
|
||
- `src/views/SalesManagement`
|
||
- `src/api/SalesManagement`
|
||
|
||
覆盖功能：
|
||
|
||
- 客户管理。
|
||
- 公司信息维护。
|
||
- 产品维护。
|
||
- 报价创建。
|
||
- 销售合同、机床合同、售后合同。
|
||
- 合同查询、合同审核、合同新版页面。
|
||
- 订单管理、订单下发、订单查询、订单审核。
|
||
- 订单进度、订单进度总览、订单追溯、物料追溯。
|
||
- 发货通知、发货记录、发货审核、产品发货、发货通知查询。
|
||
- 售后、售后查询。
|
||
- 统计分析：区域销售、订单趋势、产品类别、产品占比、产品定价、设备利用率、工时统计等。
|
||
|
||
### 5.5 技术中心
|
||
|
||
目录：
|
||
|
||
- `src/views/TechnologyCenter`
|
||
|
||
覆盖功能：
|
||
|
||
- BOM 基础数据。
|
||
- BOM 维护、BOM 查询、BOM 库存查询。
|
||
- BOM 导入。
|
||
- 物料维护、物料查询。
|
||
- 零件图导入。
|
||
- 图纸确认、图纸确认分发、图纸确认查询。
|
||
|
||
### 5.6 精工车间
|
||
|
||
目录：
|
||
|
||
- `src/views/SeikoWorkshop`
|
||
|
||
覆盖功能：
|
||
|
||
- 工艺制定、工艺文档管理、工序查询。
|
||
- 生产计划、生产任务查询。
|
||
- 车间派工、生产执行、在加工零件。
|
||
- 零件追溯、订单工时、工时统计。
|
||
- 工况页面、设备监控。
|
||
- 物料审核、采购合同审核。
|
||
- 质检维护、自检记录、质检信息查询、采购质检、其他质检。
|
||
- 报废投产、其他工作完成、测试数据录入。
|
||
- Andon/异常提示相关页面。
|
||
|
||
### 5.7 装配管理
|
||
|
||
目录：
|
||
|
||
- `src/views/AssemblyManagement`
|
||
|
||
覆盖功能：
|
||
|
||
- 装配任务查询。
|
||
- 接收装配任务。
|
||
- 装配执行。
|
||
- 专机装配执行。
|
||
- 滑台装配执行。
|
||
- 补货单、滑台补货单。
|
||
- 装配领料、临时领料。
|
||
- 装配开始、完成、自检、暂停、恢复、打回。
|
||
- 装配参数、调试数据、滑台调试数据维护。
|
||
|
||
### 5.8 采购管理
|
||
|
||
目录：
|
||
|
||
- `src/views/PurchasingManagement`
|
||
|
||
覆盖功能：
|
||
|
||
- 供应商管理。
|
||
- 到货通知。
|
||
- 采购订单。
|
||
- 外协采购订单。
|
||
- 订单查询。
|
||
- 外协订单查询。
|
||
- 外购件查询。
|
||
- 外协件查询。
|
||
|
||
### 5.9 仓储管理
|
||
|
||
目录：
|
||
|
||
- `src/views/WarehouseManagement`
|
||
|
||
覆盖功能：
|
||
|
||
- 采购件入库。
|
||
- 外协入库。
|
||
- 入库扫描。
|
||
- 入库记录、采购入库记录、外协记录、主轴库存记录。
|
||
- 出库、出库明细、采购出库记录。
|
||
- 领料单查询、物料领用。
|
||
- 退料记录。
|
||
- 库存查询、库存记录、库存汇总、库存盘点。
|
||
- 调拨查询、外协调拨。
|
||
- 补货、补货查询、新补货查询。
|
||
- 库位管理、物料库位、模具管理。
|
||
- 外协厂维护。
|
||
- 仓库可视化。
|
||
|
||
### 5.10 设备管理
|
||
|
||
目录：
|
||
|
||
- `src/views/DeviceManagement`
|
||
|
||
覆盖功能：
|
||
|
||
- 设备状态。
|
||
- 设备状态监控。
|
||
- 设备信息。
|
||
- 实时信息、历史信息、当前监控。
|
||
- 点检、点检记录。
|
||
- 维修记录。
|
||
- 设备能耗。
|
||
- 灯控。
|
||
- 不合格原因。
|
||
|
||
### 5.11 文件、打印、导出和可视化
|
||
|
||
功能：
|
||
|
||
- 文件上传：`uploadFile.ashx`、`MESUploadFile.ashx`、`uploadOP.ashx`、`uploadPerson.ashx` 等。
|
||
- 文件下载：`downloadFile.ashx`、`MESDownloadFile.ashx`、`MESDownloadFileNew.ashx` 等。
|
||
- Excel 导出：通过 `ExcelDownLoad` 指向统一服务。
|
||
- 图片/PDF 查看：`v-viewer`、文件服务接口。
|
||
- 条码/二维码：`@xkeshi/vue-barcode`、`qrcode`。
|
||
- 图表：ECharts。
|
||
- 3D/可视化：仓储可视化、设备监控中存在图片、布局图和部分 Three.js 依赖。
|
||
|
||
## 6. MCP 服务总体设计
|
||
|
||
### 6.1 MCP 服务定位
|
||
|
||
MCP 服务作为 AI 助手和 JY1.0 项目之间的受控桥梁，负责提供：
|
||
|
||
- 项目结构检索。
|
||
- 页面、组件、API、路由定位。
|
||
- 业务功能索引。
|
||
- 后端 `name` 调用点分析。
|
||
- 中文字段与页面表格列提取。
|
||
- 代码规范检查。
|
||
- 文档知识库检索。
|
||
- 可选的只读运行状态查询。
|
||
- 经审批的代码生成建议。
|
||
|
||
MCP 服务不应直接绕过现有前端权限去修改生产业务数据。所有业务数据写操作必须默认关闭，除非后续建立明确的审批、审计和沙箱机制。
|
||
|
||
### 6.2 设计原则
|
||
|
||
- 只读优先：默认工具只读取代码、文档和元数据。
|
||
- 最小权限：按工具粒度授权，不暴露任意 shell。
|
||
- 中文友好：所有业务搜索支持中文字段、中文页面名、中文过程名。
|
||
- 可追溯：工具返回文件路径、行号、调用链、数据来源。
|
||
- 与现有规范兼容：保留 Vue 2、Element UI、统一 `.ashx` 请求模式。
|
||
- 安全隔离：生产数据库写操作不通过 MCP 直接暴露。
|
||
|
||
### 6.3 推荐技术选型
|
||
|
||
| 层 | 方案 |
|
||
| --- | --- |
|
||
| MCP SDK | Node.js MCP SDK 或 Python MCP SDK |
|
||
| 语言 | Node.js 18+ 优先，便于解析 JS/Vue 项目 |
|
||
| 传输 | 本地 stdio 用于 IDE/桌面助手；内网可选 Streamable HTTP |
|
||
| 索引 | ripgrep + 自建 JSON 索引 |
|
||
| 代码解析 | `@babel/parser`、`vue-template-compiler`、正则辅助 |
|
||
| 文档解析 | Markdown 原生、docx 可用 mammoth |
|
||
| 向量库 | 本地 Chroma/Qdrant/Milvus，轻量阶段可用 SQLite + 向量扩展 |
|
||
| 嵌入模型 | DeepSeek 不提供嵌入时，可选 bge-m3、bge-large-zh、text2vec |
|
||
| LLM | DeepSeek Chat / DeepSeek Reasoner |
|
||
|
||
## 7. MCP Resources 设计
|
||
|
||
Resources 用于暴露只读上下文。
|
||
|
||
| Resource URI | 内容 | 来源 |
|
||
| --- | --- | --- |
|
||
| `jy://project/overview` | 项目概览、技术栈、目录说明 | 自动生成 |
|
||
| `jy://project/package` | `package.json` 依赖、脚本 | `package.json` |
|
||
| `jy://project/config` | 服务地址配置摘要，敏感值脱敏 | `static/config.js` |
|
||
| `jy://router/static` | 静态路由 | `src/router/index.js` |
|
||
| `jy://router/dynamic-builder` | 动态路由生成逻辑 | `src/router/getRouter.js` |
|
||
| `jy://api/request-wrapper` | 请求封装说明 | `src/utils/request.js`、`src/utils/curd.js` |
|
||
| `jy://modules/list` | 业务模块目录与页面数量 | 扫描 `src/views` |
|
||
| `jy://api/list` | API 文件与导出函数 | 扫描 `src/api` |
|
||
| `jy://icons/list` | SVG 图标清单 | 扫描 `src/icons/svg` |
|
||
| `jy://docs/index` | 项目文档索引 | `docs/`、`AGENTS.md` |
|
||
|
||
## 8. MCP Tools 设计
|
||
|
||
### 8.1 项目结构工具
|
||
|
||
#### `scan_project_structure`
|
||
|
||
用途：返回项目目录树、模块数量、关键文件状态。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"maxDepth": 3,
|
||
"includeFiles": true
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
```json
|
||
{
|
||
"root": "D:/景耀/JY1.0",
|
||
"modules": ["SalesManagement", "BasicData"],
|
||
"keyFiles": ["package.json", "static/config.js"],
|
||
"tree": []
|
||
}
|
||
```
|
||
|
||
#### `list_business_modules`
|
||
|
||
用途：列出 `src/views` 下全部业务模块、页面数量、页面路径。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"module": "WarehouseManagement",
|
||
"includePages": true
|
||
}
|
||
```
|
||
|
||
输出需包含：
|
||
|
||
- 模块英文目录。
|
||
- 建议中文名称。
|
||
- 页面列表。
|
||
- 每个页面的 `index.vue` 路径。
|
||
|
||
### 8.2 页面与组件分析工具
|
||
|
||
#### `analyze_vue_page`
|
||
|
||
用途：分析指定 Vue 页面。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"path": "src/views/WarehouseManagement/PurchasePartsStorage/index.vue"
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 页面标题推断。
|
||
- template 使用的 Element UI 组件。
|
||
- 表格列中文字段。
|
||
- data 字段。
|
||
- methods 列表。
|
||
- 调用的 `CreateData`/`ExecDatabase`。
|
||
- 后端 `name` 清单。
|
||
- 上传下载/打印/导出能力。
|
||
|
||
#### `find_pages_by_keyword`
|
||
|
||
用途：按中文或英文关键词查页面。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"keyword": "入库",
|
||
"scope": "views"
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 命中文件。
|
||
- 命中行号。
|
||
- 上下文片段。
|
||
- 可能关联模块。
|
||
|
||
### 8.3 API 与后端过程分析工具
|
||
|
||
#### `list_backend_operations`
|
||
|
||
用途：扫描项目中所有 `CreateData`、API 文件 `name` 字段、SQL 字符串。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"module": "AssemblyManagement",
|
||
"operationType": "query"
|
||
}
|
||
```
|
||
|
||
输出字段：
|
||
|
||
| 字段 | 说明 |
|
||
| --- | --- |
|
||
| `file` | 文件路径 |
|
||
| `line` | 行号 |
|
||
| `type` | 请求类型 |
|
||
| `name` | 后端过程名或 SQL |
|
||
| `params` | 参数名列表 |
|
||
| `page` | 页面路径 |
|
||
|
||
#### `trace_backend_name`
|
||
|
||
用途：根据后端 `name` 反查调用点。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"name": "装配执行_开始装配"
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 调用页面。
|
||
- 方法名。
|
||
- 参数来源。
|
||
- 用户操作入口。
|
||
- 相关表格/弹窗。
|
||
|
||
### 8.4 字段与表格工具
|
||
|
||
#### `extract_table_columns`
|
||
|
||
用途：提取指定页面所有 `el-table-column` 的中文 label、prop、slot 字段。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"path": "src/views/SeikoWorkshop/PartTraceability/index.vue"
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
```json
|
||
{
|
||
"tables": [
|
||
{
|
||
"columns": [
|
||
{"label": "订单号", "prop": "订单号", "width": "140px"}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
#### `find_chinese_field`
|
||
|
||
用途：根据中文字段名搜索全项目引用。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"field": "订单编号"
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 页面引用。
|
||
- API 参数引用。
|
||
- 表格列引用。
|
||
- 表单字段引用。
|
||
|
||
### 8.5 代码规范检查工具
|
||
|
||
#### `check_jy_conventions`
|
||
|
||
用途：检查指定变更或文件是否符合本项目约束。
|
||
|
||
检查项：
|
||
|
||
- 是否使用 Vue 2 Options API。
|
||
- 是否引入 Vue 3/Composition API。
|
||
- 是否绕过 `CreateData`/`ExecDatabase` 自行封装业务请求。
|
||
- 是否使用中文字段名。
|
||
- 是否符合 `app-container > el-card > 搜索栏 + el-table` 模式。
|
||
- 是否使用 `.then().catch()` 而非 `async/await`。
|
||
- 是否新增第三方库。
|
||
- 深度选择器是否使用 `>>>`。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"paths": ["src/views/WarehouseManagement/NewPage/index.vue"]
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 违规等级。
|
||
- 文件路径和行号。
|
||
- 修改建议。
|
||
|
||
### 8.6 文档与知识库工具
|
||
|
||
#### `search_project_docs`
|
||
|
||
用途：检索 `AGENTS.md`、`docs/`、README、项目档案等文档。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"query": "新增页面开发流程",
|
||
"topK": 5
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 文档片段。
|
||
- 文件路径。
|
||
- 相关度。
|
||
|
||
#### `search_code_knowledge`
|
||
|
||
用途：从代码索引和向量知识库中检索相关页面/API/规范。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"query": "如何实现采购件入库页面的批量入库",
|
||
"topK": 8
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 命中代码片段。
|
||
- 相关文档。
|
||
- 可追溯引用。
|
||
|
||
### 8.7 可选业务查询工具
|
||
|
||
如需让 AI 助手查询真实业务数据，应单独设计白名单工具，不开放任意 SQL。
|
||
|
||
示例：
|
||
|
||
- `query_menu_by_user`
|
||
- `query_role_modules`
|
||
- `query_dictionary`
|
||
- `query_order_status`
|
||
- `query_inventory_summary`
|
||
|
||
要求：
|
||
|
||
- 只读。
|
||
- 参数校验。
|
||
- 绑定服务账号。
|
||
- 返回数据脱敏。
|
||
- 写审计日志。
|
||
|
||
## 9. MCP Prompts 设计
|
||
|
||
### 9.1 新增页面 Prompt
|
||
|
||
名称：`create_jy_vue_page`
|
||
|
||
用途：指导 AI 按项目规范新增 Vue 页面。
|
||
|
||
输入：
|
||
|
||
```json
|
||
{
|
||
"module": "WarehouseManagement",
|
||
"pageName": "库存预警",
|
||
"backendNames": ["仓储管理_库存预警_查询"],
|
||
"fields": ["物料名称", "图号", "库存", "最低库存"]
|
||
}
|
||
```
|
||
|
||
输出：
|
||
|
||
- 页面文件建议路径。
|
||
- API 调用建议。
|
||
- Vue 2 代码骨架。
|
||
- 表格列定义。
|
||
- 查询条件。
|
||
- 需要后端配置的菜单字段。
|
||
|
||
### 9.2 故障排查 Prompt
|
||
|
||
名称：`debug_jy_request`
|
||
|
||
用途：根据报错、页面、后端 `name` 定位问题。
|
||
|
||
输出：
|
||
|
||
- 请求链路。
|
||
- 可能原因。
|
||
- 需要检查的 Cookie、路由、参数、后端过程。
|
||
- 前端修改建议。
|
||
|
||
### 9.3 功能说明 Prompt
|
||
|
||
名称：`explain_jy_feature`
|
||
|
||
用途：解释某个页面或模块功能。
|
||
|
||
输出：
|
||
|
||
- 功能入口。
|
||
- 页面操作流程。
|
||
- 涉及后端过程。
|
||
- 关键字段。
|
||
- 相关页面。
|
||
|
||
## 10. MCP 服务内部索引设计
|
||
|
||
### 10.1 文件索引
|
||
|
||
```json
|
||
{
|
||
"path": "src/views/WarehouseManagement/PurchasePartsStorage/index.vue",
|
||
"module": "WarehouseManagement",
|
||
"type": "vue",
|
||
"mtime": "2026-04-23T16:54:00",
|
||
"size": 123456
|
||
}
|
||
```
|
||
|
||
### 10.2 页面索引
|
||
|
||
```json
|
||
{
|
||
"path": "src/views/AssemblyManagement/AssemblyExecution/index.vue",
|
||
"module": "AssemblyManagement",
|
||
"components": ["el-table", "el-dialog", "el-select"],
|
||
"methods": ["searchTable", "submitStart", "submitFinish"],
|
||
"backendNames": ["装配执行_开始装配", "装配执行_完成装配"],
|
||
"fields": ["订单号", "产品名称", "状态"]
|
||
}
|
||
```
|
||
|
||
### 10.3 后端操作索引
|
||
|
||
```json
|
||
{
|
||
"name": "仓储管理_采购件入库_循环执行",
|
||
"type": "12",
|
||
"params": ["物料流水号组", "实际到货数量组", "入库人员流水号"],
|
||
"callers": [
|
||
{
|
||
"file": "src/views/WarehouseManagement/PurchasePartsStorage/index.vue",
|
||
"method": "submitInStorage",
|
||
"line": 800
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
### 10.4 字段索引
|
||
|
||
```json
|
||
{
|
||
"field": "订单号",
|
||
"occurrences": [
|
||
{
|
||
"file": "src/views/SalesManagement/OrderInquiry/index.vue",
|
||
"kind": "table-column"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
## 11. 安全设计
|
||
|
||
### 11.1 权限分层
|
||
|
||
| 等级 | 能力 | 默认 |
|
||
| --- | --- | --- |
|
||
| L0 | 读项目文档 | 开启 |
|
||
| L1 | 读项目代码 | 开启 |
|
||
| L2 | 生成建议，不写文件 | 开启 |
|
||
| L3 | 写项目文档 | 需授权 |
|
||
| L4 | 修改前端代码 | 需授权 |
|
||
| L5 | 调用只读业务接口 | 需服务账号和审计 |
|
||
| L6 | 调用写业务接口 | 默认禁止 |
|
||
|
||
### 11.2 敏感信息处理
|
||
|
||
- `static/config.js` 中 IP、文件服务地址可展示，但生产账号、密钥必须脱敏。
|
||
- 用户提供的账号密码不写入文档和代码。
|
||
- DeepSeek API Key 只能放环境变量或密钥管理服务。
|
||
- MCP 日志不得记录完整 Cookie、token、密码、身份证、手机号等敏感数据。
|
||
|
||
### 11.3 业务写操作限制
|
||
|
||
禁止通过通用工具暴露：
|
||
|
||
- 任意 SQL 执行。
|
||
- 任意 `type=2/7/12` 写操作。
|
||
- 任意文件删除。
|
||
- 任意生产数据库更新。
|
||
|
||
如后续确需写操作，必须满足：
|
||
|
||
- 白名单过程名。
|
||
- 参数 schema。
|
||
- 人工确认。
|
||
- 审计日志。
|
||
- 回滚方案。
|
||
|
||
## 12. 部署设计
|
||
|
||
### 12.1 本地 stdio 模式
|
||
|
||
适合开发者 IDE、Codex、Claude Desktop 等本地 AI 工具。
|
||
|
||
启动方式：
|
||
|
||
```bash
|
||
node server.js --root D:/景耀/JY1.0
|
||
```
|
||
|
||
配置示例：
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"jy-mes": {
|
||
"command": "node",
|
||
"args": ["D:/景耀/JY1.0/mcp-server/server.js", "--root", "D:/景耀/JY1.0"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 12.2 内网 HTTP 模式
|
||
|
||
适合多人共享 AI 助手。
|
||
|
||
建议：
|
||
|
||
- 部署在内网服务器。
|
||
- 使用反向代理和 HTTPS。
|
||
- 增加用户认证。
|
||
- 按用户角色限制工具。
|
||
- 建立调用日志。
|
||
|
||
## 13. 实施路线
|
||
|
||
### 阶段 1：只读项目索引
|
||
|
||
目标：
|
||
|
||
- 搭建 MCP 服务骨架。
|
||
- 实现 `scan_project_structure`、`list_business_modules`。
|
||
- 建立页面/API/字段索引。
|
||
- 支持按关键词搜索。
|
||
|
||
交付：
|
||
|
||
- `mcp-server/` 服务。
|
||
- `index-store/` 索引文件。
|
||
- 基础 Resources 和 Tools。
|
||
|
||
### 阶段 2：Vue/API 深度分析
|
||
|
||
目标：
|
||
|
||
- 解析 `.vue` 页面结构。
|
||
- 提取 `el-table-column`。
|
||
- 提取 `CreateData` 调用和参数。
|
||
- 反查后端 `name` 调用链。
|
||
|
||
交付：
|
||
|
||
- `analyze_vue_page`。
|
||
- `list_backend_operations`。
|
||
- `trace_backend_name`。
|
||
- `check_jy_conventions`。
|
||
|
||
### 阶段 3：文档知识库接入
|
||
|
||
目标：
|
||
|
||
- 将 `AGENTS.md`、`docs/`、关键源码说明入库。
|
||
- 支持语义检索。
|
||
- AI 回答必须给出来源。
|
||
|
||
交付：
|
||
|
||
- 知识库构建脚本。
|
||
- 文档检索工具。
|
||
- 知识库更新机制。
|
||
|
||
### 阶段 4：AI 助手集成
|
||
|
||
目标：
|
||
|
||
- 接入 DeepSeek。
|
||
- 支持项目问答、功能解释、代码生成建议、排障。
|
||
- 支持 MCP 工具调用。
|
||
|
||
交付：
|
||
|
||
- AI 助手后端服务。
|
||
- Web 聊天界面或集成到现有系统。
|
||
- 权限和审计。
|
||
|
||
### 阶段 5：受控业务查询
|
||
|
||
目标：
|
||
|
||
- 增加只读业务查询白名单。
|
||
- 支持订单、库存、设备状态、任务状态等查询。
|
||
|
||
交付：
|
||
|
||
- 只读业务 API 代理。
|
||
- 参数 schema。
|
||
- 审计日志。
|
||
|
||
## 14. 验收标准
|
||
|
||
MCP 服务应满足：
|
||
|
||
- 能列出全部业务模块和页面。
|
||
- 能按中文关键词定位页面和后端调用。
|
||
- 能分析指定 Vue 文件中的表格列、方法、请求。
|
||
- 能反查某个后端 `name` 被哪些页面调用。
|
||
- 能根据项目规范检查新增页面。
|
||
- 能检索项目文档并返回来源。
|
||
- 不暴露任意 shell、任意 SQL、生产写操作。
|
||
- 生成代码建议符合 Vue 2、Element UI、现有全局 CRUD 方法。
|
||
|
||
## 15. 后续建议
|
||
|
||
- 为后端存储过程建立正式清单，补齐参数、返回字段和业务含义。
|
||
- 将页面中文标题、路由路径、组件路径、后端 `name` 维护成可生成的功能矩阵。
|
||
- 将编码异常文件逐步统一为 UTF-8，降低 AI 和工具解析难度。
|
||
- 将现有散落在页面内的 API 调用逐步沉淀到 `src/api`，便于 MCP 建模和复用。
|