create-jnrs-vue 1.2.36 → 2.0.1

package/README.md

@@ -2,7 +2,7 @@
 
 ## ✨ 介绍
 
-巨能前端工程化开发，Vue 项目模板脚手架
+巨能（JNRS）前端工程化开发，Vue 项目模板脚手架
 
 ## 💻 技术栈
 

package/bin/create.mjs

@@ -114,15 +114,23 @@ async function main() {
   await fs.cp(templateDir, root, { recursive: true })
 
   // 定义可选的内部模块
-  const allWorkspaceDeps = ['@jnrs/shared', '@jnrs/vue-core', '@jnrs/lingshu-smart']
-  const defaultSelected = ['@jnrs/shared', '@jnrs/vue-core']
+  const allWorkspaceDeps = ['@jnrs/shared', '@jnrs/vue-core', '@jnrs/lingshu-smart', '@jnrs/skills-biz']
+  const defaultSelected = ['@jnrs/shared', '@jnrs/vue-core', '@jnrs/skills-biz']
+
+  // 依赖备注
+  const depNotes = {
+    '@jnrs/shared': '【必选】通用工具库',
+    '@jnrs/vue-core': '【必选】Vue 专用核心功能包',
+    '@jnrs/lingshu-smart': '【可选】2D数字孪生系统（灵枢智造）',
+    '@jnrs/skills-biz': '【可选】AI Agent 业务技能库（service/views/script/menu 生成器）'
+  }
 
   const { selected: selectedWorkspaceDeps } = await prompts({
     type: 'multiselect',
     name: 'selected',
     message: '请选择要包含的内部依赖模块（默认已选中必要模块）:',
     choices: allWorkspaceDeps.map((dep) => ({
-      title: dep,
+      title: `${dep}  ${depNotes[dep] || ''}`,
       value: dep,
       selected: defaultSelected.includes(dep)
     })),

package/jnrs-vue/AGENTS.md

@@ -0,0 +1,78 @@
+# jnrs-vue 工程 AI 开发指南
+
+本文档面向在 jnrs-vue 工程中进行业务开发的开发者，说明如何使用 `@jnrs/skills-biz` 技能库加速开发。
+
+## 技能库配置
+
+`@jnrs/skills-biz` 随项目依赖安装，位于 `node_modules/@jnrs/skills-biz/`。**使用前需将技能目录配置到 AI IDE 的 skills 目录中**（如 Trae 的 `.trae/skills/`），供 AI Agent 自动加载调用。
+
+## 技能清单
+
+| 技能              | 作用                                              | 依赖                 |
+| ----------------- | ------------------------------------------------- | -------------------- |
+| service-generator | 生成接口服务层代码（TS 类型 + API 函数）              | OAS 文档或 mock 模式 |
+| views-generator   | 生成视图显示层及部分脚本控制层代码（ .vue 文件（`<template>` + `<script setup>`）） | 接口服务层           |
+| script-generator  | 生成完整控制层代码 `<script setup>` patterns 参考         | 接口服务层           |
+| menu-generator    | 生成 `public/system/menu.json` 菜单配置代码           | 视图层               |
+
+## 开发流程
+
+```
+1. service-generator → 生成 src/api/<module>/*.ts
+2. views-generator   → 生成 src/views/<module>/*.vue（含 template + script setup）
+                       ↑ 生成 script setup 时参考 script-generator 的 patterns
+3. menu-generator    → 在 public/system/menu.json 中追加菜单项
+```
+
+### 各技能使用方式
+
+| 技能              | 触发方式                                                                                               |
+| ----------------- | ------------------------------------------------------------------------------------------------------ |
+| service-generator | 向 AI 描述：**"生成 <模块名> 的服务层"** 或 **"生成 <模块名> 的 API"**。OAS 模式需确保 `OAS/` 目录存在 |
+| views-generator   | 向 AI 描述：**"生成 <模块名> 的页面"**。自动检测多栏布局，内部参考 script-generator 生成控制层代码     |
+| script-generator  | 通常由 views-generator 自动查阅。也可单独向 AI 描述：**"查看 <模块名> 的脚本模式"**                    |
+| menu-generator    | 向 AI 描述：**"生成菜单"** 或 **"新增菜单项"**。列出待生成菜单项供确认后写入                           |
+
+### 约束
+
+- **必须**按 service → views → menu 顺序生成
+- **禁止**跳过接口服务层直接生成视图
+- 菜单生成前必须列出清单供用户确认
+
+## 架构说明
+
+业务模块采用三层架构（逻辑分离，非物理文件分离）：
+
+| 层级       | 物理位置                                    | 职责                         | 生成器            |
+| ---------- | ------------------------------------------- | ---------------------------- | ----------------- |
+| 接口服务层 | `src/api/<module>/*.ts`                     | TS 类型定义 + API 请求函数   | service-generator |
+| 控制层     | `src/views/<module>/*.vue` `<script setup>` | 状态管理、数据获取、事件处理 | views-generator   |
+| 视图层     | `src/views/<module>/*.vue` `<template>`     | 模板代码、组件引用           | views-generator   |
+
+## 命名规范
+
+| 类型      | 规范         | 示例                           |
+| --------- | ------------ | ------------------------------ |
+| 目录      | kebab-case   | `project-management/`          |
+| .vue 文件 | camelCase    | `editDialog.vue`、`index.vue`  |
+| TS 文件   | kebab-case   | `project-management.ts`        |
+| API 函数  | `*Api`小驼峰 | `projectTableApi`              |
+| 路由 name | 小驼峰       | `examplesProjectManagement`    |
+| 路由 path | kebab-case   | `/examples/project-management` |
+| 权限      | 两段式       | `module:view`、`module:edit`   |
+
+## 术语
+
+- **OAS**：OpenAPI Specification，由接口管理工具（如 ApiFox）导出，存放于 `OAS/` 目录
+- **JSDoc Tags**：自定义注签（`@dict`、`@enumValues`、`@independentModification`、`@useSelectComponent`、`@fileField`、`@foreignKey`），在服务层代码中标记字段特性，供视图生成时识别处理
+- 后端 api 中所说的 `列表、分页列表` 即为前端的 `表格`
+
+## 常用 @jnrs/ 库参考
+
+| 导入                                                  | 来源                        | 文档                                    |
+| ----------------------------------------------------- | --------------------------- | --------------------------------------- |
+| `JnTable`, `JnPagination`, `JnDialog`, `JnFileUpload` | `@jnrs/vue-core/components` | `node_modules/@jnrs/vue-core/AGENTS.md` |
+| `useRouter`, `useRoute`                               | `@jnrs/vue-core/router`     | `node_modules/@jnrs/vue-core/AGENTS.md` |
+| `useSystemStore`, `useMenuStore`                      | `@jnrs/vue-core/pinia`      | `node_modules/@jnrs/vue-core/AGENTS.md` |
+| `debounce`                                            | `@jnrs/shared/lodash`       | `node_modules/@jnrs/shared/AGENTS.md`   |
+| `objectMatchAssign`, `dateFormatsToObject`            | `@jnrs/shared`              | `node_modules/@jnrs/shared/AGENTS.md`   |

package/jnrs-vue/README.md

@@ -2,7 +2,7 @@
 
 ## ✨ 介绍
 
-巨能前端工程化开发，Vue 项目信息化管理系统
+巨能（JNRS）前端工程化开发，Vue 项目信息化管理系统
 
 ## 💻 技术栈
 
@@ -18,23 +18,20 @@ pnpm build
 
 ## 🤖 AI Agent 使用说明
 
+本脚手架模板现支持自动化生成业务模块前端代码。
+
 - 前置准备
-  - 将业务功能原型图作为生成前端代码的参考图
-  - 从 api 工具（如 ApiFox） 中导出 openapi 文档，或接入其提供的 MCP 服务
-  - 使用 AI Agent 读取并分析当前 `README.md` 文件及 `/AGENTS/README_BASE.md` 文件并作为 IDE AI Agent 的记忆
-- 预置提示词
-  - 保存记忆：`读取并分析当前 README.md 文件及 /AGENTS/README_BASE.md 文件并作为 IDE AI Agent 的记忆`
-  - 生成菜单：`根据提供的菜单原型图，生成菜单`
-  - 生成服务文件：`根据提供的 openapi 文档或 MCP 服务，生成API 服务文件`
-  - 生成增删改查页面文件：`根据提供的界面原型图，生成增删改查页面文件`
+  - 重要：从接口管理工具（如 ApiFox）中导出 OAS 文件（如 openapi.json）放入 `skills-biz/OAS/` 目录下
+  - 可选：将业务功能原型图作为生成前端代码的参考文件，调用多模态能力
+
+详细说明及提示词请参考[AGENTS.md](./AGENTS.md)
 
 #### 项目结构
 
 ```Text
 jnrs-vue/
-├── AGENTS/               # AI Agent 规则与提示词
-├── viteMockServe/        # Mock 服务配置
-├── public/               # 静态资源
+├── viteMockServe/        # Mock 服务配置目录
+├── public/               # 静态资源目录
 ├── src/                  # 源码目录
 │   ├── components/       # Vue 组件
 │   ├── composables/      # 组合式函数
@@ -54,7 +51,8 @@ jnrs-vue/
 ├── tsconfig.json         # TypeScript 配置
 ├── auto-imports.d.ts     # 自动导入类型声明
 ├── components.d.ts       # 全局组件类型声明
-├── README.md             # 项目文档
+├── README.md             # 项目使用说明
+├── AGENTS.md             # AI Agent 使用说明
 ├── .env.development      # 开发环境变量
 ├── .env.production       # 生产环境变量
 ├── .gitignore            # Git 忽略规则

package/jnrs-vue/components.d.ts

@@ -19,11 +19,12 @@ declare module 'vue' {
     ElCard: typeof import('element-plus/es')['ElCard']
     ElCascader: typeof import('element-plus/es')['ElCascader']
     ElCol: typeof import('element-plus/es')['ElCol']
-    ElColorPicker: typeof import('element-plus/es')['ElColorPicker']
     ElContainer: typeof import('element-plus/es')['ElContainer']
     ElDatePicker: typeof import('element-plus/es')['ElDatePicker']
     ElDatePickerPanel: typeof import('element-plus/es')['ElDatePickerPanel']
-    ElDialog: typeof import('element-plus/es')['ElDialog']
+    ElDropdown: typeof import('element-plus/es')['ElDropdown']
+    ElDropdownItem: typeof import('element-plus/es')['ElDropdownItem']
+    ElDropdownMenu: typeof import('element-plus/es')['ElDropdownMenu']
     ElForm: typeof import('element-plus/es')['ElForm']
     ElFormItem: typeof import('element-plus/es')['ElFormItem']
     ElHeader: typeof import('element-plus/es')['ElHeader']
@@ -35,16 +36,17 @@ declare module 'vue' {
     ElMenuItem: typeof import('element-plus/es')['ElMenuItem']
     ElOption: typeof import('element-plus/es')['ElOption']
     ElPopover: typeof import('element-plus/es')['ElPopover']
+    ElProgress: typeof import('element-plus/es')['ElProgress']
     ElRow: typeof import('element-plus/es')['ElRow']
     ElScrollbar: typeof import('element-plus/es')['ElScrollbar']
     ElSelect: typeof import('element-plus/es')['ElSelect']
     ElSubMenu: typeof import('element-plus/es')['ElSubMenu']
     ElSwitch: typeof import('element-plus/es')['ElSwitch']
-    ElTable: typeof import('element-plus/es')['ElTable']
     ElTableColumn: typeof import('element-plus/es')['ElTableColumn']
     ElTabPane: typeof import('element-plus/es')['ElTabPane']
     ElTabs: typeof import('element-plus/es')['ElTabs']
     ElTag: typeof import('element-plus/es')['ElTag']
+    ElTree: typeof import('element-plus/es')['ElTree']
     ElWatermark: typeof import('element-plus/es')['ElWatermark']
   }
   export interface GlobalDirectives {

package/jnrs-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jnrs-vue",
-  "version": "1.2.36",
+  "version": "1.2.38",
   "description": "JNRS 信息化管理系统",
   "author": "talia_tan",
   "private": true,
@@ -19,9 +19,9 @@
   },
   "dependencies": {
     "@element-plus/icons-vue": "^2.3.2",
-    "@jnrs/lingshu-smart": "2.2.29",
-    "@jnrs/shared": "1.1.28",
-    "@jnrs/vue-core": "1.2.21",
+    "@jnrs/lingshu-smart": "2.2.31",
+    "@jnrs/shared": "1.1.32",
+    "@jnrs/vue-core": "1.2.26",
     "@vueuse/core": "^14.1.0",
     "element-plus": "^2.13.3",
     "pinia": "^3.0.4",
@@ -30,6 +30,7 @@
     "vue-i18n": "^11.2.8"
   },
   "devDependencies": {
+    "@jnrs/skills-biz": "*",
     "@tsconfig/node22": "^22.0.5",
     "@types/node": "^22.19.1",
     "@typescript-eslint/parser": "^8.48.1",
@@ -52,5 +53,11 @@
     "vite-plugin-mock": "^3.0.2",
     "vite-plugin-vue-devtools": "^8.0.5",
     "vue-tsc": "^3.1.5"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@parcel/watcher",
+      "esbuild"
+    ]
   }
 }

package/jnrs-vue/public/system/menu.json

@@ -10,39 +10,40 @@
       },
       "children": [
         {
-          "path": "/playground",
-          "name": "playground",
+          "path": "/examples/playground",
+          "name": "examplesPlayground",
           "meta": {
             "title": "基础功能测试",
             "todoCount": 8
           },
-          "component": "/demos/playground/index"
+          "component": "/examples/playground/index"
         },
         {
-          "path": "/agenticCrud",
-          "name": "agenticCrud",
+          "path": "/examples/project-management",
+          "name": "examplesProjectManagement",
           "meta": {
             "title": "项目管理",
             "todoCount": 0
           },
-          "component": "/demos/crud/index"
-        }
-      ]
-    },
-    {
-      "meta": {
-        "title": "业务功能测试",
-        "icon": "Operation"
-      },
-      "children": [
+          "component": "/examples/project-management/index"
+        },
         {
-          "path": "/businessPlayground",
-          "name": "businessPlayground",
+          "path": "/examples/program-management",
+          "name": "examplesProgramManagement",
           "meta": {
-            "title": "业务功能测试",
-            "todoCount": 8
+            "title": "项目集管理",
+            "todoCount": 0
           },
-          "component": "/businessPlayground/index"
+          "component": "/examples/program-management/index"
+        },
+        {
+          "path": "/examples/portfolio-management",
+          "name": "examplesPortfolioManagement",
+          "meta": {
+            "title": "项目组合管理",
+            "todoCount": 0
+          },
+          "component": "/examples/portfolio-management/index"
         }
       ]
     },
@@ -57,7 +58,6 @@
           "name": "lingshuSmartEditorPage",
           "meta": {
             "title": "编辑器",
-            "icon": "Operation",
             "noAuth": true,
             "global": true
           },
@@ -68,7 +68,6 @@
           "name": "lingshuSmartPreviewPage",
           "meta": {
             "title": "看板",
-            "icon": "Platform",
             "noAuth": true,
             "global": true
           },
@@ -98,25 +97,16 @@
           "name": "systemMine",
           "meta": {
             "title": "个人中心",
-            "permissions": ["mine:view", "mine:edit"]
+            "permissions": ["systemMine:view", "systemMine:edit"]
           },
           "component": "/system/mine/index"
         },
-        {
-          "path": "/system/user",
-          "name": "systemUser",
-          "meta": {
-            "title": "用户管理",
-            "permissions": ["user:view", "user:edit"]
-          },
-          "component": "/system/user/index"
-        },
         {
           "path": "/system/role",
           "name": "systemRole",
           "meta": {
             "title": "角色管理",
-            "permissions": ["role:view", "role:edit"]
+            "permissions": ["systemRole:view", "systemRole:edit"]
           },
           "component": "/system/role/index"
         },
@@ -125,7 +115,7 @@
           "name": "systemDict",
           "meta": {
             "title": "字典管理",
-            "permissions": ["dict:view", "dict:edit"]
+            "permissions": ["systemDict:view", "systemDict:edit"]
           },
           "component": "/system/dict/index"
         },
@@ -134,7 +124,7 @@
           "name": "systemMenu",
           "meta": {
             "title": "菜单管理",
-            "permissions": ["menu:view", "menu:edit"]
+            "permissions": ["systemMenu:view", "systemMenu:edit"]
           },
           "component": "/system/menu/index"
         }

package/jnrs-vue/src/api/examples/portfolio-management/portfolio.ts

@@ -0,0 +1,163 @@
+/**
+ * @File   : portfolio-management/portfolio.ts
+ * @Desc.  : 项目组合模块接口文档（左侧树）
+ */
+
+import type { IFullResponse } from '@jnrs/shared'
+import { axiosRequest } from '../../request'
+
+/**
+ * 项目组合 - 详情
+ */
+export interface Portfolio {
+  id: number
+  /** 组合名称 */
+  name: string
+  /** 排序 */
+  sequence: number
+  /** 是否有子组合 */
+  hasSubPortfolio: boolean
+  /** 描述 */
+  description: string
+}
+
+/**
+ * 项目组合 - 新增
+ */
+export interface AddPortfolio {
+  /** 组合名称 */
+  name: string
+  /** 描述 */
+  description: string
+}
+
+/**
+ * 项目组合 - 上方新增
+ */
+export interface UpSideAddPortfolio {
+  targetPortfolioId: number
+  name: string
+}
+
+/**
+ * 项目组合 - 下方新增
+ */
+export interface DownSideAddPortfolio {
+  targetPortfolioId: number
+  name: string
+}
+
+/**
+ * 项目组合 - 子组合新增
+ */
+export interface InnerAddPortfolio {
+  targetPortfolioId: number
+  name: string
+}
+
+/**
+ * 项目组合 - 修改
+ */
+export interface UpdatePortfolio {
+  id: number
+  name: string
+}
+
+/**
+ * 项目组合 - 列表
+ */
+export const portfolioListApi = (parentId?: number): Promise<Portfolio[]> => {
+  return axiosRequest({
+    url: '/agentic/portfolio/list',
+    method: 'get',
+    params: { parentId }
+  })
+}
+
+/**
+ * 项目组合 - 最外侧新增
+ */
+export const addPortfolioApi = (data: AddPortfolio) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/save',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 上方新增
+ */
+export const upSideAddPortfolioApi = (data: UpSideAddPortfolio) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/upSideAdd',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 下方新增
+ */
+export const downSideAddPortfolioApi = (data: DownSideAddPortfolio) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/downSideAdd',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 子组合新增
+ */
+export const innerAddPortfolioApi = (data: InnerAddPortfolio) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/innerAdd',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 修改
+ */
+export const updatePortfolioApi = (data: UpdatePortfolio) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/update',
+    method: 'put',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 上移
+ */
+export const moveUpPortfolioApi = (data: { targetPortfolioId: number }) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/moveUp',
+    method: 'put',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 下移
+ */
+export const moveDownPortfolioApi = (data: { targetPortfolioId: number }) => {
+  return axiosRequest({
+    url: '/agentic/portfolio/moveDown',
+    method: 'put',
+    data
+  })
+}
+
+/**
+ * 项目组合 - 删除
+ */
+export const deletePortfolioApi = (id: number): Promise<IFullResponse<unknown>> => {
+  return axiosRequest({
+    url: `/agentic/portfolio/delete/${id}`,
+    method: 'delete',
+    returnFullResponse: true
+  })
+}

package/jnrs-vue/src/api/examples/portfolio-management/program.ts

@@ -0,0 +1,149 @@
+/**
+ * @File   : portfolio-management/program.ts
+ * @Desc.  : 项目集模块接口文档（中间表格，归属项目组合）
+ */
+
+import type { IFullResponse } from '@jnrs/shared'
+import type { IPagination, IPageTableData } from '@/types'
+import { axiosRequest } from '../../request'
+
+/**
+ * 项目集（归属组合） - 详情
+ */
+export interface PortfolioProgram {
+  id: string
+  /** 项目组合Id */
+  portfolioId: number
+  /** 项目集编码 */
+  code: number
+  /** 项目集名称 */
+  name: string
+  /** 项目集描述 */
+  description: string
+  /** 项目经理Id */
+  managerId: number
+  /** 项目经理名称 */
+  managerName: string
+  /** 预算 */
+  budget: number
+  /** 开始日期 */
+  startDate: string
+  /** 结束日期 */
+  endDate: string
+  /**
+   * 项目集状态
+   * @dict programStatus
+   * @enumValues [0, 1, 2]
+   */
+  programStatus: number
+  /**
+   * 启用状态
+   * @independentModification portfolioProgramEnableApi
+   */
+  enable: boolean
+  /** 项目数量 */
+  projectCount: number
+}
+
+/**
+ * 项目集（归属组合） - 新增
+ */
+export interface AddPortfolioProgram {
+  portfolioId?: number
+  code: number
+  name: string
+  description: string
+  /**
+   * 项目经理
+   * @useSelectComponent SelectManager
+   */
+  managerId?: Record<string, unknown> | number
+  budget: number
+  startDate: string
+  endDate: string
+}
+
+/**
+ * 项目集（归属组合） - 修改
+ */
+export interface UpdatePortfolioProgram extends AddPortfolioProgram {
+  id: string
+}
+
+/**
+ * 项目集（归属组合） - 启用/禁用
+ */
+export interface PortfolioProgramEnable {
+  id: string
+  enable: boolean
+}
+
+/**
+ * 项目集（归属组合） - 查询
+ */
+export interface PortfolioProgramQuery extends IPagination {
+  /**
+   * 项目组合Id
+   * @foreignKey portfolioId
+   */
+  portfolioId?: number
+  code?: string
+  name?: string
+  managerId?: number
+}
+
+/**
+ * 项目集（归属组合） - 列表数据
+ */
+export const portfolioProgramTableApi = (params?: PortfolioProgramQuery): Promise<IPageTableData<PortfolioProgram>> => {
+  return axiosRequest({
+    url: '/agentic/portfolio-program/list',
+    method: 'get',
+    params
+  })
+}
+
+/**
+ * 项目集（归属组合） - 新增
+ */
+export const addPortfolioProgramApi = (data: AddPortfolioProgram) => {
+  return axiosRequest({
+    url: '/agentic/portfolio-program/save',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目集（归属组合） - 修改
+ */
+export const editPortfolioProgramApi = (data: UpdatePortfolioProgram) => {
+  return axiosRequest({
+    url: '/agentic/portfolio-program/save',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 项目集（归属组合） - 删除
+ */
+export const deletePortfolioProgramApi = (id: string): Promise<IFullResponse<unknown>> => {
+  return axiosRequest({
+    url: `/agentic/portfolio-program/delete/${id}`,
+    method: 'delete',
+    returnFullResponse: true
+  })
+}
+
+/**
+ * 项目集（归属组合） - 启用/禁用
+ */
+export const portfolioProgramEnableApi = (data: PortfolioProgramEnable) => {
+  return axiosRequest({
+    url: '/agentic/portfolio-program/enable',
+    method: 'put',
+    data,
+    returnFullResponse: true
+  })
+}