create-jnrs-vue 1.2.37 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. package/README.md +2 -44
  2. package/bin/create.mjs +11 -3
  3. package/jnrs-vue/AGENTS.md +78 -0
  4. package/jnrs-vue/README.md +8 -5
  5. package/jnrs-vue/package.json +5 -5
  6. package/jnrs-vue/src/assets/styles/root.scss +1 -1
  7. package/jnrs-vue/src/layout/RouterTabs.vue +2 -2
  8. package/jnrs-vue/src/layout/TopHeader.vue +2 -2
  9. package/jnrs-vue/src/views/examples/program-management/subPage/index.vue +2 -8
  10. package/jnrs-vue/src/views/home/index.vue +6 -6
  11. package/jnrs-vue/src/views/login/index.vue +1 -1
  12. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## ✨ 介绍
4
4
 
5
- 巨能前端工程化开发，Vue 项目模板脚手架
5
+ 巨能（JNRS）前端工程化开发，Vue 项目模板脚手架
6
6
 
7
7
  ## 💻 技术栈
8
8
 
@@ -33,46 +33,4 @@ pnpm add create-jnrs-vue
33
33
 
34
34
  ## 🤖 AI Agent 使用说明
35
35
 
36
- - 前置准备
37
- - 将业务功能原型图作为生成前端代码的参考图
38
- - 从 api 工具（如 ApiFox） 中导出 openapi 文档，或接入其提供的 MCP 服务
39
- - 使用 AI Agent 读取并分析当前 `README.md` 文件及 `/AGENTS/README_BASE.md` 文件并作为 IDE AI Agent 的记忆
40
- - 预置提示词
41
- - 保存记忆：`读取并分析当前 README.md 文件及 /AGENTS/README_BASE.md 文件并作为 IDE AI Agent 的记忆`
42
- - 生成菜单：`根据提供的菜单原型图，生成菜单`
43
- - 生成服务文件：`根据提供的 openapi 文档或 MCP 服务，生成API 服务文件`
44
- - 生成增删改查页面文件：`根据提供的界面原型图，生成增删改查页面文件`
45
-
46
- ## 📂 模板项目主要结构
47
-
48
- ```Text
49
- jnrs-vue/
50
- ├── AGENTS/ # AI Agent 规则与提示词
51
- ├── viteMockServe/ # Mock 服务配置
52
- ├── public/ # 静态资源
53
- ├── src/ # 源码目录
54
- │ ├── components/ # Vue 组件
55
- │ ├── composables/ # 组合式函数
56
- │ ├── layout/ # 布局
57
- │ ├── views/ # 页面视图
58
- │ ├── router/ # 路由配置
59
- │ ├── api/ # 接口定义（已含 request 实例）
60
- │ ├── types/ # 类型定义
61
- │ ├── stores/ # 状态管理
62
- │ ├── utils/ # 工具函数
63
- │ ├── locales/ # 国际化
64
- │ └── main.ts # 应用入口
65
- ├── index.html # HTML 入口文件
66
- ├── eslint.config.js # ESLint 配置文件
67
- ├── package.json # 包管理配置
68
- └── vite.config.ts # Vite 构建配置
69
- ├── tsconfig.json # TypeScript 配置
70
- ├── auto-imports.d.ts # 自动导入类型声明
71
- ├── components.d.ts # 全局组件类型声明
72
- ├── README.md # 项目文档
73
- ├── .env.development # 开发环境变量
74
- ├── .env.production # 生产环境变量
75
- ├── .gitignore # Git 忽略规则
76
- ├── .prettierrc.json # Prettier 格式化配置
77
- ├── .cspell.json # Cspell 拼写检查
78
- ```
36
+ 详见 `jnrs-vue/AGENTS.md`
package/bin/create.mjs CHANGED
@@ -114,15 +114,23 @@ async function main() {
114
114
  await fs.cp(templateDir, root, { recursive: true })
115
115
 
116
116
  // 定义可选的内部模块
117
- const allWorkspaceDeps = ['@jnrs/shared', '@jnrs/vue-core', '@jnrs/lingshu-smart']
118
- const defaultSelected = ['@jnrs/shared', '@jnrs/vue-core']
117
+ const allWorkspaceDeps = ['@jnrs/shared', '@jnrs/vue-core', '@jnrs/lingshu-smart', '@jnrs/skills-biz']
118
+ const defaultSelected = ['@jnrs/shared', '@jnrs/vue-core', '@jnrs/skills-biz']
119
+
120
+ // 依赖备注
121
+ const depNotes = {
122
+ '@jnrs/shared': '【必选】通用工具库',
123
+ '@jnrs/vue-core': '【必选】Vue 专用核心功能包',
124
+ '@jnrs/lingshu-smart': '【可选】2D数字孪生系统（灵枢智造）',
125
+ '@jnrs/skills-biz': '【可选】AI Agent 业务技能库（service/views/script/menu 生成器）'
126
+ }
119
127
 
120
128
  const { selected: selectedWorkspaceDeps } = await prompts({
121
129
  type: 'multiselect',
122
130
  name: 'selected',
123
131
  message: '请选择要包含的内部依赖模块（默认已选中必要模块）:',
124
132
  choices: allWorkspaceDeps.map((dep) => ({
125
- title: dep,
133
+ title: `${dep} ${depNotes[dep] || ''}`,
126
134
  value: dep,
127
135
  selected: defaultSelected.includes(dep)
128
136
  })),
package/jnrs-vue/AGENTS.md CHANGED
@@ -0,0 +1,78 @@
1
+ # jnrs-vue 工程 AI 开发指南
2
+
3
+ 本文档面向在 jnrs-vue 工程中进行业务开发的开发者，说明如何使用 `@jnrs/skills-biz` 技能库加速开发。
4
+
5
+ ## 技能库配置
6
+
7
+ `@jnrs/skills-biz` 随项目依赖安装，位于 `node_modules/@jnrs/skills-biz/`。**使用前需将技能目录配置到 AI IDE 的 skills 目录中**（如 Trae 的 `.trae/skills/`），供 AI Agent 自动加载调用。
8
+
9
+ ## 技能清单
10
+
11
+ | 技能 | 作用 | 依赖 |
12
+ | ----------------- | ------------------------------------------------- | -------------------- |
13
+ | service-generator | 生成接口服务层代码（TS 类型 + API 函数） | OAS 文档或 mock 模式 |
14
+ | views-generator | 生成视图显示层及部分脚本控制层代码（ .vue 文件（`<template>` + `<script setup>`）） | 接口服务层 |
15
+ | script-generator | 生成完整控制层代码 `<script setup>` patterns 参考 | 接口服务层 |
16
+ | menu-generator | 生成 `public/system/menu.json` 菜单配置代码 | 视图层 |
17
+
18
+ ## 开发流程
19
+
20
+ ```
21
+ 1. service-generator → 生成 src/api/<module>/*.ts
22
+ 2. views-generator → 生成 src/views/<module>/*.vue（含 template + script setup）
23
+ ↑ 生成 script setup 时参考 script-generator 的 patterns
24
+ 3. menu-generator → 在 public/system/menu.json 中追加菜单项
25
+ ```
26
+
27
+ ### 各技能使用方式
28
+
29
+ | 技能 | 触发方式 |
30
+ | ----------------- | ------------------------------------------------------------------------------------------------------ |
31
+ | service-generator | 向 AI 描述：**"生成 <模块名> 的服务层"** 或 **"生成 <模块名> 的 API"**。OAS 模式需确保 `OAS/` 目录存在 |
32
+ | views-generator | 向 AI 描述：**"生成 <模块名> 的页面"**。自动检测多栏布局，内部参考 script-generator 生成控制层代码 |
33
+ | script-generator | 通常由 views-generator 自动查阅。也可单独向 AI 描述：**"查看 <模块名> 的脚本模式"** |
34
+ | menu-generator | 向 AI 描述：**"生成菜单"** 或 **"新增菜单项"**。列出待生成菜单项供确认后写入 |
35
+
36
+ ### 约束
37
+
38
+ - **必须**按 service → views → menu 顺序生成
39
+ - **禁止**跳过接口服务层直接生成视图
40
+ - 菜单生成前必须列出清单供用户确认
41
+
42
+ ## 架构说明
43
+
44
+ 业务模块采用三层架构（逻辑分离，非物理文件分离）：
45
+
46
+ | 层级 | 物理位置 | 职责 | 生成器 |
47
+ | ---------- | ------------------------------------------- | ---------------------------- | ----------------- |
48
+ | 接口服务层 | `src/api/<module>/*.ts` | TS 类型定义 + API 请求函数 | service-generator |
49
+ | 控制层 | `src/views/<module>/*.vue` `<script setup>` | 状态管理、数据获取、事件处理 | views-generator |
50
+ | 视图层 | `src/views/<module>/*.vue` `<template>` | 模板代码、组件引用 | views-generator |
51
+
52
+ ## 命名规范
53
+
54
+ | 类型 | 规范 | 示例 |
55
+ | --------- | ------------ | ------------------------------ |
56
+ | 目录 | kebab-case | `project-management/` |
57
+ | .vue 文件 | camelCase | `editDialog.vue`、`index.vue` |
58
+ | TS 文件 | kebab-case | `project-management.ts` |
59
+ | API 函数 | `*Api`小驼峰 | `projectTableApi` |
60
+ | 路由 name | 小驼峰 | `examplesProjectManagement` |
61
+ | 路由 path | kebab-case | `/examples/project-management` |
62
+ | 权限 | 两段式 | `module:view`、`module:edit` |
63
+
64
+ ## 术语
65
+
66
+ - **OAS**：OpenAPI Specification，由接口管理工具（如 ApiFox）导出，存放于 `OAS/` 目录
67
+ - **JSDoc Tags**：自定义注签（`@dict`、`@enumValues`、`@independentModification`、`@useSelectComponent`、`@fileField`、`@foreignKey`），在服务层代码中标记字段特性，供视图生成时识别处理
68
+ - 后端 api 中所说的 `列表、分页列表` 即为前端的 `表格`
69
+
70
+ ## 常用 @jnrs/ 库参考
71
+
72
+ | 导入 | 来源 | 文档 |
73
+ | ----------------------------------------------------- | --------------------------- | --------------------------------------- |
74
+ | `JnTable`, `JnPagination`, `JnDialog`, `JnFileUpload` | `@jnrs/vue-core/components` | `node_modules/@jnrs/vue-core/AGENTS.md` |
75
+ | `useRouter`, `useRoute` | `@jnrs/vue-core/router` | `node_modules/@jnrs/vue-core/AGENTS.md` |
76
+ | `useSystemStore`, `useMenuStore` | `@jnrs/vue-core/pinia` | `node_modules/@jnrs/vue-core/AGENTS.md` |
77
+ | `debounce` | `@jnrs/shared/lodash` | `node_modules/@jnrs/shared/AGENTS.md` |
78
+ | `objectMatchAssign`, `dateFormatsToObject` | `@jnrs/shared` | `node_modules/@jnrs/shared/AGENTS.md` |
package/jnrs-vue/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  ## ✨ 介绍
4
4
 
5
- 巨能前端工程化开发，Vue 项目信息化管理系统
5
+ 巨能（JNRS）前端工程化开发，Vue 项目信息化管理系统
6
6
 
7
7
  ## 💻 技术栈
8
8
 
@@ -18,15 +18,18 @@ pnpm build
18
18
 
19
19
  ## 🤖 AI Agent 使用说明
20
20
 
21
+ 本脚手架模板现支持自动化生成业务模块前端代码。
22
+
21
23
  - 前置准备
22
- - 必须：从接口管理工具（如 ApiFox）中导出 OAS 文件（如 openapi.json）放入 skills 目录下
24
+ - 重要：从接口管理工具（如 ApiFox）中导出 OAS 文件（如 openapi.json）放入 `skills-biz/OAS/` 目录下
23
25
  - 可选：将业务功能原型图作为生成前端代码的参考文件，调用多模态能力
24
26
 
27
+ 详细说明及提示词请参考[AGENTS.md](./AGENTS.md)
28
+
25
29
  #### 项目结构
26
30
 
27
31
  ```Text
28
32
  jnrs-vue/
29
- ├── skills/ # AI Agent 项目级技能目录
30
33
  ├── viteMockServe/ # Mock 服务配置目录
31
34
  ├── public/ # 静态资源目录
32
35
  ├── src/ # 源码目录
@@ -48,8 +51,8 @@ jnrs-vue/
48
51
  ├── tsconfig.json # TypeScript 配置
49
52
  ├── auto-imports.d.ts # 自动导入类型声明
50
53
  ├── components.d.ts # 全局组件类型声明
51
- ├── README.md # 项目文档
52
- ├── AGENTS.md # AI Agent 规则与提示词
54
+ ├── README.md # 项目使用说明
55
+ ├── AGENTS.md # AI Agent 使用说明
53
56
  ├── .env.development # 开发环境变量
54
57
  ├── .env.production # 生产环境变量
55
58
  ├── .gitignore # Git 忽略规则
package/jnrs-vue/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jnrs-vue",
3
- "version": "1.2.37",
3
+ "version": "1.2.39",
4
4
  "description": "JNRS 信息化管理系统",
5
5
  "author": "talia_tan",
6
6
  "private": true,
@@ -19,9 +19,9 @@
19
19
  },
20
20
  "dependencies": {
21
21
  "@element-plus/icons-vue": "^2.3.2",
22
- "@jnrs/lingshu-smart": "2.2.30",
23
- "@jnrs/shared": "1.1.31",
24
- "@jnrs/vue-core": "1.2.25",
22
+ "@jnrs/lingshu-smart": "2.2.31",
23
+ "@jnrs/shared": "1.1.32",
24
+ "@jnrs/vue-core": "1.2.26",
25
25
  "@vueuse/core": "^14.1.0",
26
26
  "element-plus": "^2.13.3",
27
27
  "pinia": "^3.0.4",
@@ -30,7 +30,7 @@
30
30
  "vue-i18n": "^11.2.8"
31
31
  },
32
32
  "devDependencies": {
33
- "@jnrs/skills": "1.0.2",
33
+ "@jnrs/skills-biz": "1.0.3",
34
34
  "@tsconfig/node22": "^22.0.5",
35
35
  "@types/node": "^22.19.1",
36
36
  "@typescript-eslint/parser": "^8.48.1",
package/jnrs-vue/src/assets/styles/root.scss CHANGED
@@ -14,5 +14,5 @@
14
14
 
15
15
  .el-message-box,
16
16
  .el-dialog {
17
- border: 1px solid var(--jnrs-font-primary-06);
17
+ border: 1px solid var(--jnrs-font-primary-05);
18
18
  }
package/jnrs-vue/src/layout/RouterTabs.vue CHANGED
@@ -223,7 +223,7 @@ onUnmounted(() => {
223
223
  height: var(--jnrs-routerTabs-height);
224
224
  }
225
225
  :deep(.el-tabs__item) {
226
- color: var(--jnrs-font-primary-06);
226
+ color: var(--jnrs-font-primary-05);
227
227
  font-size: 12px;
228
228
  height: var(--jnrs-routerTabs-height);
229
229
  transition: all 0.3s ease;
@@ -264,7 +264,7 @@ onUnmounted(() => {
264
264
  padding: 8px 16px;
265
265
  cursor: pointer;
266
266
  font-size: 13px;
267
- color: var(--jnrs-font-primary-08);
267
+ color: var(--jnrs-font-primary-07);
268
268
  transition: all 0.2s;
269
269
 
270
270
  &:hover {
package/jnrs-vue/src/layout/TopHeader.vue CHANGED
@@ -164,7 +164,7 @@ $topHoverSize: 35px;
164
164
  background: var(--jnrs-background-head);
165
165
  }
166
166
  .userMenu_icon {
167
- color: var(--jnrs-font-primary-06);
167
+ color: var(--jnrs-font-primary-05);
168
168
  }
169
169
  }
170
170
  .userMenu_dropdown {
@@ -190,7 +190,7 @@ $topHoverSize: 35px;
190
190
  color: var(--jnrs-font-primary);
191
191
  }
192
192
  .loginDateTime {
193
- color: var(--jnrs-font-primary-06);
193
+ color: var(--jnrs-font-primary-05);
194
194
  }
195
195
  .userMenu_dropdown_btn {
196
196
  .el-button {
package/jnrs-vue/src/views/examples/program-management/subPage/index.vue CHANGED
@@ -109,13 +109,7 @@ onActivated(() => {
109
109
  <template #header>
110
110
  <div class="jn-flex-between-center">
111
111
  <span class="jn-card-title">子项目</span>
112
- <el-button
113
- type="primary"
114
- size="small"
115
- :icon="Plus"
116
- :disabled="!props.programId"
117
- @click="handleEdit()"
118
- >
112
+ <el-button type="primary" size="small" :icon="Plus" :disabled="!props.programId" @click="handleEdit()">
119
113
  新增
120
114
  </el-button>
121
115
  </div>
@@ -130,7 +124,7 @@ onActivated(() => {
130
124
  :showIndexColumn="false"
131
125
  :showSelectionColumn="false"
132
126
  :autoHeightOptions="{
133
- bottomGap: 0
127
+ bottomGap: 80
134
128
  }"
135
129
  >
136
130
  <el-table-column prop="code" label="子项目编码" min-width="180" sortable show-overflow-tooltip />
package/jnrs-vue/src/views/home/index.vue CHANGED
@@ -170,17 +170,17 @@ onDeactivated(() => {
170
170
  }
171
171
 
172
172
  .greeting {
173
- color: var(--jnrs-font-primary-08);
173
+ color: var(--jnrs-font-primary-07);
174
174
  }
175
175
  }
176
176
 
177
177
  .welcome-meta {
178
178
  font-size: 13px;
179
- color: var(--jnrs-font-primary-06);
179
+ color: var(--jnrs-font-primary-05);
180
180
 
181
181
  .divider {
182
182
  margin: 0 12px;
183
- color: var(--jnrs-font-primary-02);
183
+ color: var(--jnrs-font-primary-01);
184
184
  }
185
185
  }
186
186
  }
@@ -200,7 +200,7 @@ onDeactivated(() => {
200
200
  .date-info {
201
201
  margin-top: 4px;
202
202
  font-size: 14px;
203
- color: var(--jnrs-font-primary-06);
203
+ color: var(--jnrs-font-primary-05);
204
204
 
205
205
  .date {
206
206
  margin-right: 12px;
@@ -253,7 +253,7 @@ onDeactivated(() => {
253
253
 
254
254
  .stat-label {
255
255
  font-size: 14px;
256
- color: var(--jnrs-font-primary-06);
256
+ color: var(--jnrs-font-primary-05);
257
257
  margin-top: 4px;
258
258
  }
259
259
  }
@@ -310,7 +310,7 @@ onDeactivated(() => {
310
310
 
311
311
  .entry-title {
312
312
  font-size: 14px;
313
- color: var(--jnrs-font-primary-08);
313
+ color: var(--jnrs-font-primary-07);
314
314
  text-align: center;
315
315
  }
316
316
  }
package/jnrs-vue/src/views/login/index.vue CHANGED
@@ -299,7 +299,7 @@ const submitForm = async () => {
299
299
  .light {
300
300
  .card_right {
301
301
  &::after {
302
- background: var(--jnrs-card-primary-06);
302
+ background: var(--jnrs-card-primary-05);
303
303
  }
304
304
  }
305
305
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "create-jnrs-vue",
3
- "version": "1.2.37",
4
- "description": "巨能前端工程化开发，Vue 项目模板脚手架",
3
+ "version": "2.0.2",
4
+ "description": "巨能（JNRS）前端工程化开发，Vue 项目模板脚手架",
5
5
  "keywords": [
6
6
  "vue",
7
7
  "vite",