安裝

環境需求

• Vue 2.7（終點版本；不支援 2.6 及以下，不支援 IE11）
• 推薦 Node 20 + pnpm 10

套件管理器安裝

npm install @lh-ui/vue2
# 或
pnpm add @lh-ui/vue2
# 或
yarn add @lh-ui/vue2

@lh-ui/vue2 的唯一執行時依賴是 @lh-ui/share（共享層：core 純函式 / theme / constants / locales / types / 元件樣式源），會自動一併安裝。

私有伺服器安裝

若套件託管於私有伺服器而非公共 registry，按以下任一方式安裝。

方式一：tarball 直連

伺服器僅需提供靜態檔案託管即可。把 npm pack 產出的 lh-ui-vue2-x.y.z.tgz 放到伺服器目錄，然後：

npm install https://你的網域/pkg/lh-ui-vue2-1.0.0.tgz
# 或
pnpm add https://你的網域/pkg/lh-ui-vue2-1.0.0.tgz
# 或
yarn add https://你的網域/pkg/lh-ui-vue2-1.0.0.tgz

tarball 直連方式下，@lh-ui/share 仍會從當前 registry 解析，需保證該套件在公共 registry 或你的私有 registry 上可見。

方式二：自建 registry（如 Verdaccio）

自建 registry 支援 semver 拉取與版本管理。在專案根目錄的 .npmrc 中按 scope 精準路由（不影響其他套件的安裝來源）：

@lh-ui:registry=https://你的網域/

隨後照常安裝：

pnpm add @lh-ui/vue2

手動引入樣式

// 主題變數（明色 + 暗色）
import '@lh-ui/vue2/theme.css'
// 按需引入單元件樣式（可選——全量入口已包含）
import '@lh-ui/vue2/style/button'

版本策略

• @lh-ui/share 升級需遵循「share 先發版 → UI 庫升級回歸 → 再發版」紀律。
• 目前狀態：@lh-ui/vue2 已發布 1.0.0，@lh-ui/share 為 0.1.0。