（占位符写作 PKG,不用尖括号:GitHub 正文消毒会把「尖括号+字母」当 HTML 标签吃掉。)
现象
两处面向人和 agent 的入门文档,把 #3378 里那条会静默假绿的调用当作推荐用法写着:
QUICK_REFERENCE.md:26-27
pnpm --filter @object-ui/console test # Run just the console tests
pnpm --filter @object-ui/core test # Run a single package's tests
skills/objectui/guides/project-setup.md:309
pnpm --filter @object-ui/core test # Test single package
按 #3378 的机制,这条命令让 vitest 的 root 落在包目录,根级 projects 的 include
(packages/** 等)相对它匹配不到任何文件,只有以绝对路径引进来的 apps/console project
仍解析成功 —— 于是跑的是 @object-ui/console 的 22 个文件、报 Test Files 22 passed (22),
而文档里点名的那个包(core / console 自己的包级语义)一个都没按预期跑。注释写的
"Run a single package's tests" 与实际行为不符。
为什么现在必须改
PR #3437(fixes #3378 / #3288)给 vitest.config.mts 加了 invocation guard:vitest root
不是仓根即拒绝。该 PR 合并后,上面这三行文档命令会直接以非零退出,并打印指向正确跑法的
报错。也就是说:
- 合并前:文档教的命令假绿(更糟);
- 合并后:文档教的命令报错(不再骗人,但文档仍然是错的)。
两种情况下这几行都该换成仓根的正确跑法:
pnpm exec vitest run packages/PKG/ # 只跑一个包
pnpm exec vitest run packages/PKG/src/FILE.test.ts
pnpm test # 全量
范围
我这次的 dispatch 文件围栏只包含 AGENTS.md 的测试章节(已写入正确跑法与两条陷阱),
QUICK_REFERENCE.md 与 skills/** 不在围栏内,因此不在 PR #3437 里顺手改 —— 单开此条。
顺带:content/docs/guide/plugin-development.md:422 的 pnpm vitest run packages/plugin-board
是正确形状(仓根 + 路径),无需改。
相关
（说明:提交前尝试搜索重复 issue 时 GitHub API 多次返回 rate limit,只跑成功了两次关键词检索,
均无命中。若已有孪生条目,请直接关掉这条。)
（占位符写作
PKG,不用尖括号:GitHub 正文消毒会把「尖括号+字母」当 HTML 标签吃掉。)现象
两处面向人和 agent 的入门文档,把 #3378 里那条会静默假绿的调用当作推荐用法写着:
QUICK_REFERENCE.md:26-27skills/objectui/guides/project-setup.md:309按 #3378 的机制,这条命令让 vitest 的 root 落在包目录,根级 projects 的 include
(
packages/**等)相对它匹配不到任何文件,只有以绝对路径引进来的apps/consoleproject仍解析成功 —— 于是跑的是
@object-ui/console的 22 个文件、报Test Files 22 passed (22),而文档里点名的那个包(core / console 自己的包级语义)一个都没按预期跑。注释写的
"Run a single package's tests" 与实际行为不符。
为什么现在必须改
PR #3437(fixes #3378 / #3288)给
vitest.config.mts加了 invocation guard:vitest root不是仓根即拒绝。该 PR 合并后,上面这三行文档命令会直接以非零退出,并打印指向正确跑法的
报错。也就是说:
两种情况下这几行都该换成仓根的正确跑法:
范围
我这次的 dispatch 文件围栏只包含
AGENTS.md的测试章节(已写入正确跑法与两条陷阱),QUICK_REFERENCE.md与skills/**不在围栏内,因此不在 PR #3437 里顺手改 —— 单开此条。顺带:
content/docs/guide/plugin-development.md:422的pnpm vitest run packages/plugin-board是正确形状(仓根 + 路径),无需改。
相关
pnpm --filter @object-ui/app-shell test跑的是 @object-ui/console 的 22 个文件,app-shell 自己的 276 个一个没跑,却报绿 #3378 包级 cwd 跑 vitest 的假绿(本条的成因)pnpm --filter <pkg> test -- --run <paths>静默忽略路径过滤:新加的测试文件根本没跑,而输出看起来正常 #3288 路径挂在--后面被丢弃仓根跑法)
（说明:提交前尝试搜索重复 issue 时 GitHub API 多次返回 rate limit,只跑成功了两次关键词检索,
均无命中。若已有孪生条目,请直接关掉这条。)