用途:在 monorepo 中针对特定工作区包运行命令,避免影响其他包。
主要能力:使用 pnpm --filter <包名> <命令> 在指定包内执行操作,例如运行测试、构建、启动开发服务器或添加依赖。
常见包名:@cartridge/controller(主 SDK 包)、@cartridge/keychain(Keychain UI 应用)、@cartridge/connector(连接器包)、@cartridge/profile(Profile 应用)。
用法示例: 运行测试:pnpm --filter @cartridge/keychain test 构建指定包:pnpm --filter @cartridge/controller build:deps 仅启动 keychain 开发服务器:pnpm --filter @cartridge/keychain dev 向指定包安装依赖:pnpm --filter @cartridge/controller add <package-name>
步骤:先确定目标包,再执行 pnpm --filter <包名> <命令>,最后确认命令在正确包内运行。
限制与注意:按包名(含 @scope)过滤,而非目录路径;工作区依赖会自动链接;跨所有包递归执行可使用 pnpm -r。