Skip to main content
当您修改 CLI 或其捆绑的任何包(核心、引擎、制作人、工作室)时,您需要针对 monorepo_外部_的真实项目测试这些更改 - 就像最终用户运行 hyperframes preview 的方式一样。

先决条件

首先构建 monorepo。每次更改源文件时,请在测试之前重新构建。

选项1:发髻链接(推荐)

bun link 使 $PATH 中的 hyperframes 二进制文件指向本地构建。它可以跨终端会话生存,并自动拾取新版本而无需重新链接。
现在在任何目录中正常使用 hyperframes
在每个 bun run build 之后,链接的二进制文件已经是最新的 - 无需重新链接。 完成后要恢复已发布的版本:

选项 2:节点别名(不更改 PATH)

如果您不想触及全局 $PATH,请添加 shell 别名或直接调用 node
/path/to/hyperframes 替换为您的实际 monorepo 路径。

选项 3:npm pack(测试确切发布的工件)

当您想要验证版本中实际发布的内容(包括捆绑的工作室和示例)时,请使用此选项。

测试修复分支

验证特定错误修复时,提取测试项目档案之一并运行场景:
常见测试场景:

故障排除

bun run build 之后未反映更改 CLI 二进制文件是位于 packages/cli/dist/cli.js 的单个捆绑文件。如果您的更改位于 @hyperframes/core 或其他工作区包中,请确保 bun run build 重建 all 包 — CLI 在构建时捆绑其依赖项。 hyperframes 仍然显示旧版本/旧 UI 全局安装的 hyperframes 包影子 bun link。检查哪个二进制文件处于活动状态:
如果它指向全局商店而不是您的单一存储库,请删除全局安装并重新链接:
端口已在使用 hyperframes preview 默认为端口 3002,并在被占用时自动递增。传递 --port 以使用特定端口: