用途:用 create-surf-app 和 @surf-ai/sdk 构建加密货币数据类全栈 Web 应用、仪表盘或可视化页面。与仅通过 CLI 研究数据的 surf 技能不同,本技能面向带 Web UI 的应用开发。
主要能力:脚手架生成 Vite + React 19 + Express + Tailwind 项目,内置类型化数据钩子与服务端 API;前端通过 @surf-ai/sdk/react 的 hooks 调用内置 /proxy/* 路由,后端通过 @surf-ai/sdk/server 的 dataApi 访问数据;支持 Drizzle ORM 数据库、cron 任务、Web 搜索等。
使用方式:依次执行 npx create-surf-app .、npm install --prefix backend、npm install --prefix frontend,然后先读 CLAUDE.md 再写代码,最后启动 npm run dev --prefix backend & 与 npm run dev --prefix frontend。用 surf sync、surf list-operations -g、surf market-price --help 等 CLI 命令发现端点,再映射为 SDK 代码。CLI 参数为 kebab-case,SDK 参数为 snake_case。
限制:不要使用 npx vite 或传 --port,端口已在 frontend/.env 预配置;npm install 后无需重启开发服务器;不要修改 vite.config.ts、server.js、entry-client.tsx、entry-server.tsx、index.html、index.css;写 ECharts 代码前必须阅读 CHARTS.md。其余细节暂未提供。