uniky 1.0.21 → 1.0.22

package/README.md

@@ -19,6 +19,26 @@ pnpm add uniky
 yarn add uniky
 ```
 
+## 安装后设置
+
+### 自动安装（推荐）
+
+安装 `uniky` 后，插件文件会自动安装到项目根目录的 `.uniky` 文件夹。
+
+如果自动安装失败或删除了 `.uniky` 文件夹，可以手动触发安装：
+
+```bash
+# 使用 npx
+npx uniky-install
+
+# 或者直接运行
+node node_modules/uniky/scripts/postinstall.js
+```
+
+### 自动检测安装
+
+如果 `.uniky` 文件夹缺失，在首次运行 Vite 时，插件会自动检测并安装所需文件。
+
 ## 使用
 
 ### 库功能
@@ -97,11 +117,35 @@ _To.back();
 在 `main.ts` 中安装全局定义：
 
 ```typescript
-import { installGlobals } from './autoGen/global.install';
+import { installGlobals } from './_unikey/global.install';
 
 installGlobals();
 ```
 
+## 目录结构
+
+安装后，项目根目录会生成 `.uniky` 文件夹：
+
+```
+your-project/
+├── .uniky/
+│   ├── index.ts
+│   └── plugin/
+│       ├── index.ts
+│       ├── pages.defined.ts
+│       ├── global.defined.ts
+│       ├── http.defined.ts
+│       └── lib.defined.ts
+├── src/
+│   └── _unikey/           # 插件自动生成的文件
+│       ├── global/
+│       │   ├── pages.ts
+│       │   └── ky.ts
+│       ├── global.d.ts
+│       └── global.install.ts
+└── vite.config.ts
+```
+
 ## 故障排除
 
 ### ESM 相关错误

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniky",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "uni-app 开发工具库，包含 hooks、http 请求和 vite 插件",
   "type": "module",
   "main": "./src/lib/index.ts",
@@ -16,6 +16,9 @@
       "import": "./src/plugin/index.ts"
     }
   },
+  "bin": {
+    "uniky-install": "./scripts/postinstall.js"
+  },
   "sideEffects": false,
   "files": [
     "src/lib",

package/scripts/postinstall.js

@@ -102,8 +102,4 @@ export * from './plugin/index.js';
   }
 }
 
-if (process.env.npm_config_global !== 'true') {
-  installPluginFiles();
-} else {
-  console.log('[uniky] 跳过全局安装的 postinstall 脚本');
-}
+installPluginFiles();

package/src/plugin/index.ts

@@ -1,6 +1,6 @@
 // created by zhuxietong on 2026-01-30 16:37
 import type { Plugin } from 'vite';
-import { copyFileSync, mkdirSync, existsSync, readdirSync, statSync } from 'fs';
+import { copyFileSync, mkdirSync, existsSync, readdirSync, statSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -40,11 +40,16 @@ function ensurePluginInstalled(projectRoot: string): void {
     const unikyDir = join(projectRoot, '.uniky');
     const pluginDir = join(unikyDir, 'plugin');
 
-    if (existsSync(pluginDir) && readdirSync(pluginDir).length > 0) {
+    // 检查关键文件是否存在
+    const keyFiles = ['index.ts', 'pages.defined.ts', 'global.defined.ts'];
+    const needsInstall = !existsSync(pluginDir) || 
+                         keyFiles.some(file => !existsSync(join(pluginDir, file)));
+
+    if (!needsInstall) {
       return;
     }
 
-    console.log('[uniky] 检测到 .uniky/plugin 目录不存在，正在自动安装...');
+    console.log('[uniky] 检测到插件文件缺失，正在自动安装...');
 
     if (!existsSync(unikyDir)) {
       mkdirSync(unikyDir, { recursive: true });
@@ -65,6 +70,11 @@ function ensurePluginInstalled(projectRoot: string): void {
 
     const copiedCount = copyDirectoryRecursive(sourceDir, pluginDir);
 
+    const indexContent = `// created by zhuxietong on 2026-01-30 16:37
+export * from './plugin/index.js';
+`;
+    writeFileSync(join(unikyDir, 'index.ts'), indexContent, 'utf-8');
+
     console.log(`[uniky] ✅ 插件文件已自动安装到 ${unikyDir} (${copiedCount} 个文件)`);
   } catch (error) {
     console.warn('[uniky] 插件自动安装失败:', error);