docs: update codegen guide

Author: nicefan

docs/swagger/index.md

@@ -1,39 +1,51 @@
-# SwaggerGen
+# API Codegen
 
-SwaggerGen 用于把 DataModel 应用到接口自动化管理，根据 Swagger / OpenAPI 文档生成 TypeScript 类型和业务 Api。
+API Codegen 是 DataModel 的自动化生成工具。
+
+它根据 Swagger / OpenAPI 文档生成：
+
+- TypeScript 类型
+- 业务 Api 模块
+- Resource 请求代码
+- 模块导出文件
+
+生成结果遵循 DataModel 的 Resource → Api 模型。
 
 ## 配置
 
-推荐在项目根目录创建：
+创建：
 
 ```text
 api-datamodel.config.mjs
 ```
 
+示例：
+
 ```js
-/** @type {import('api-datamodel/swagger/config').ApiDatamodelConfig} */
 export default {
   output: 'src/api',
   httpPath: '@/api/dataModel',
   httpModule: 'createApi',
+
   generator: {
     cleanOutput: true,
     modular: true,
     routeTypes: true,
   },
+
   apis: {
     sys: {
       description: '系统管理',
-      url: 'http://127.0.0.1:8080/v3/api-docs/系统管理',
+      url: 'http://127.0.0.1:8080/v3/api-docs/sys',
       folder: 'sys',
     },
   },
 }
 ```
 
-## 生成命令
+## 生成
 
-在 `package.json` 中加入：
+package.json：
 
 ```json
 {
@@ -48,21 +60,36 @@ export default {
 
 ```bash
 pnpm genApi
+
 pnpm genApi:sys
 ```
 
-也可以直接传入文档地址：
+也可以直接指定：
 
 ```bash
 npx api-datamodel-swagger <文档地址> <输出目录> [业务前缀]
 ```
 
-查看完整帮助：
+查看帮助：
 
 ```bash
 npx api-datamodel-swagger --help
 ```
 
-::: warning
-开启 `cleanOutput` 后会清理对应输出目录，不要在自动生成目录中手写业务代码。
-:::
+## 生成目录
+
+推荐将生成代码作为接口文档的同步结果：
+
+```text
+src/api/
+├─ sys/
+│  ├─ User.ts
+│  └─ index.ts
+└─ dataModel.ts
+```
+
+不要直接在生成目录中编写业务逻辑，避免重新生成时覆盖。
+
+## 注意
+
+开启 `cleanOutput` 后会清理对应输出目录，请确认该目录只包含自动生成文件。