@vibecuting/component-project-helper

NPM 地址：

• https://www.npmjs.com/package/@vibecuting/component-project-helper

组件工程辅助包。

职责：

• 作为可发布的 npm 包承载组件工程辅助逻辑。
• 提供组件注解、schema、发现器、元数据生成、技能说明生成和安装期生命周期逻辑。
• 安装时会优先把当前工程识别为包含 src/components 或 src/video/chapters 的独立项目，再扫描 src/components/**/*.tsx、src/video/chapters/**/*.tsx 以及 node_modules/@vibecuting/*/src/**/*.tsx，把组件元数据生成到 .agents/skills/project-allow-component/components/。
• 宿主工程的 update-component-skills 会基于 .vibecuting/video-resource-meta.generated.ts 生成技能说明，不再执行模板源码文件本身。
• 宿主工程也可以直接运行 pnpm run update-component-skills 手动刷新同一套生成结果。
• 作为主工程之外的独立 helper 包，避免把辅助逻辑重新塞回主站代码里。

目录结构：

• src/decorators：注解定义和元数据读写
• src/schemas：zod schema
• src/discovery：组件发现与解析
• src/meta：元数据和技能说明生成
• src/runtime：安装根与输出路径解析
• src/lifecycle：postinstall / preuninstall 生命周期逻辑

常用命令：

• pnpm typecheck
• pnpm test
• pnpm update-component-skills

发布与安装：

• 发布到 npmjs 公共 registry 时使用 @vibecuting/component-project-helper
• 组件模板和主工程只依赖这个包的已发布版本，不依赖 workspace 软链接