用途：面向 Node.js 与 JavaScript 项目开发，提供实用模式、常见陷阱和库兼容性说明，覆盖 package.json 脚本检查、TypeScript、React、antd 等场景。
主要能力：
- 项目准备：先查看 package.json 了解可用脚本；新项目执行 npm install 后再运行脚本；用户指定脚本时严格按指定内容执行。
- 库兼容性：@lobehub/ui 与 antd-style 内部打包 Zustand 3.x，与 Zustand 5 混用会导致状态更新崩溃（TypeError: h.use is not a function），可用 find node_modules -path 'antd-stylezustand*' 排查，替代方案为 antd + theme.useToken()；Playwright 对 antd TextArea 用 page.fill() 不触发 onChange，应改用 page.type()；bun:sqlite 是 Bun 内置模块，在 Vitest 中需从测试排除或改用 bun test。
- SSE 流式状态机：done 处理器中应先把 isStreaming 置为 false，再追加消息，并在读循环结束后补兜底；Claude SSE 输出为交错序列（thinking 一次，然后 text 分片与 tool_use/tool_result 循环），需用 segments 数组并在 tool_use 时刷新文本缓冲。
- MCP stdio 服务器：用 @modelcontextprotocol/sdk 的 StdioClientTransport，启动时创建一次传输，退出时清理会话并按需重建；env 需先展开 process.env 以继承 PATH 等变量。
- Astro：v5+ 内容集合配置移至 src/content.config.ts 并需显式 loader；渲染用独立 render()，路由参数用 entry.id；public/ 脚本需 is:inline，绝对路径在 file:// 下会静默失败，自包含页面可用?raw 配合 Fragment set:html 及 build.inlineStylesheets: 'always'；MDX 表格单元格中的 < 需写为 <；开发服务器不把 public/index.html 映射到根路径，生产构建正常。
适用场景：基于 Node.js 的前端或全栈项目开发、调试上述库冲突、流式接口集成与 Astro 站点构建。
限制：内容为经验性注意事项，具体版本行为可能变化；资料未提供分类、收费与平台信息。