提交代码

parallel-agents-vue-offline-pack/OFFLINE-README.md

@@ -0,0 +1,34 @@
+# 内网离线开发包说明
+
+本压缩包已包含 **完整 hoisted 模式 node_modules**（物理文件复制，无 pnpm 符号链接），解压后可直接开发，无需联网安装依赖。
+
+## 环境要求
+
+- Node.js 18+（建议 20 LTS）
+- 全局安装 pnpm：`npm install -g pnpm`（内网可离线安装 pnpm 的 tgz 包）
+
+## 使用步骤
+
+1. 解压到任意目录（路径尽量短，避免 Windows 路径过长问题）
+2. 进入项目目录
+3. 直接运行：
+
+```bash
+pnpm dev          # 开发调试 http://localhost:5183
+pnpm build:lib    # 构建组件库
+pnpm typecheck    # 类型检查
+```
+
+## 若 node_modules 损坏，可离线重装
+
+本包已附带 `.npmrc`（hoisted + copy 模式）。若需重建依赖：
+
+1. 删除 `node_modules`
+2. 在有 pnpm 本地 store 的机器上执行：`pnpm install --offline --frozen-lockfile`
+
+> 若内网机器从未装过依赖，请直接使用本包自带的 node_modules，不要删除。
+
+## 与直接压缩 node_modules 的区别
+
+pnpm 默认 node_modules 含大量符号链接/硬链接，WinRAR 等工具压缩后解压会断链导致缺依赖。
+本包使用 `node-linker=hoisted` + `package-import-method=copy` 重新安装，所有文件均为真实拷贝。