docs: 简化依赖管理文档,聚焦 Bun Catalog 版本控制

- 简化依赖管理文档,聚焦使用 Bun Catalog 统一版本控制,并提供清晰的安装与查询命令参考。
This commit is contained in:
2026-01-26 16:40:44 +08:00
parent 900cd28a04
commit 1f6592739b

View File

@@ -17,39 +17,16 @@
## 依赖管理
### Bun Catalog 系统
项目使用 **Bun Catalog** 统一管理依赖版本。
项目使用 **Bun Catalog** 统一管理依赖版本(定义在根目录 `package.json``catalog` 字段)
> **详细流程**: 加载 skill `bun-catalog-package` 获取完整指南
**安装依赖的正确方式**
**快速参考**
```bash
# ✅ 正确:使用 catalog: 前缀
bun add <package-name>@catalog:
# ❌ 错误:直接安装会绕过版本统一管理
bun add <package-name>@latest
bun info <pkg> version # 查询最新版本
bun add <pkg>@catalog: # 在子包中安装
```
**示例**
```bash
# 添加 systeminformation 依赖到 packages/utils
cd packages/utils
bun add systeminformation@catalog:
# 添加 react 依赖到 apps/server
cd apps/server
bun add react@catalog:
```
**为什么使用 Catalog**
- 确保 monorepo 中所有包使用相同版本
- 集中管理依赖版本,避免版本冲突
- 简化依赖升级(只需修改根 package.json
**添加新依赖的步骤**
1. 在根目录 `package.json``catalog` 字段添加依赖及版本
2. 在目标包中使用 `bun add <package>@catalog:` 安装
## 构建、Lint 和测试命令
### 开发