用途:协助开发驱动 VS Code Webview 界面的 React 应用,主要面向 webview-ui 工作区。该工作区由 Vite 打包,并通过 bridge/vscode 辅助模块与扩展宿主通信。
项目结构:webview-ui 下包含 src/components(含 ui 子目录的 shadcn/ui 组件库)、src/hooks、src/features/{feature}(含 index.tsx 入口、components 与 hooks)、src/bridge(VS Code 与 webview 的消息辅助)、src/index.tsx(挂载所选功能的运行时路由)、public(Vite 原样复制的静态资源)、vite.config.ts 与 README.md。
编码规范:优先复用 src/components 与 src/hooks 下的共享模块,再考虑功能本地代码;功能专属工具放入嵌套的 components/ 或 hooks/ 目录以保持边界清晰;样式使用 Tailwind 风格工具类(基础 token 见 src/app.css),有可复用类时避免内联样式;通过 vscode.postMessage 与扩展交换消息,并在 React effect 中用 window.addEventListener('message', …) 订阅;新增 steering 或配置引用时,通过扩展层的共享 ConfigManager 工具获取路径。
测试与质量:若添加复杂交互,可使用 Playwright 或 Cypress 风格的集成测试(测试位于仓库级 tests/ 下);提交前运行 npm run lint 和 npm run build,确保 TypeScript 与打包检查通过。
限制:资料未提供具体安装命令、版本要求、收费信息或平台支持范围。