XParseKit

monorepo 常用命令参考

• pnpm install
  安装所有工作区（workspace）中的依赖。

• pnpm add <package> -w
  在整个 monorepo 的根目录（workspace root）添加依赖。

• pnpm add <package> --filter <package_name>
  只在指定的子包中添加依赖。

• pnpm install --filter <package_name>
  只为指定的子包安装依赖。

• pnpm run <script> --filter <package_name>
  只在指定的子包中运行脚本。

• pnpm -r run <script>
  在所有子包中递归运行脚本。

• pnpm list -r
  递归列出所有子包的依赖树。

• pnpm update -r
  递归更新所有子包的依赖。

• pnpm exec --filter <package_name> <command>
  在指定的子包中执行命令。

• pnpm why <package>
  查看某个依赖被哪些包依赖。

更多命令和用法请参考 pnpm 官方文档。

开始

1. 安装依赖

   在项目根目录下执行：

   pnpm install

2. 开发模式启动

   进入需要开发的子包目录（如 packages/visualizer），运行：

   pnpm run dev

   或在根目录一次性启动所有包的开发模式：

   pnpm -r --parallel run dev

3. 版本管理

   项目使用 changeset 进行版本管理。

   • 新增功能或修复 bug 时，执行：

     pnpm changeset

     会提示你输入变更类型（major， minor）和变更描述。 按空格键进行选择 一般情况下，破坏式更新选择major，非破坏式更新选择minor

• 然后提交变日志，进行版本更新 pnpm changeset:version

  pnpm changeset:version

• 最后使用git 提交至仓库

4. 发布

   根据项目的发布流程进行发布。

其他

1. 构建产物

   进入子包目录，执行：

   pnpm run build

   若需构建所有包，在根目录执行上面的命令即可

   构建产物会输出到对应包的 dist 目录。

2. 清理构建产物

   pnpm run clean 

3. 包结构说明

   • 所有包源码位于 packages/ 目录下。
   • 每个包均采用 ESM 格式，类型声明自动生成，产物在 dist/ 目录。
   • 依赖管理、构建、类型检查等均通过 pnpm 脚本统一管理。

包列表

• @xparse-kit/visualizer - 文档解析、分chunk结果回溯可视化组件