用途:为基于 Apify 的应用提供生产级架构模式,覆盖从单一爬虫到全栈集成的三种方案:单 Actor(一个爬虫部署到 Apify 平台)、多 Actor 流水线(发现→抓取→转换链)、全栈集成(应用将 Apify 作为数据源,置于服务层之后)。技能帮助选择合适模式、规划目录结构并接入骨架代码。
主要能力:推荐所选模式的目录布局;生成骨架 TypeScript 模块(main.ts、types.ts、服务层、配置加载器、健康检查);按环境分层配置策略与 Apify 健康信号;流水线模式下提供编排器报告各阶段条目数与总美元成本,示例输出为 === Pipeline Summary === Discovered: 320 URLs / Scraped: 298 items / Clean: 271 items / Total cost: $0.4120。完整目录树、图表与代码见 references/architecture-patterns.md,服务层、配置加载器与健康检查见 references/implementation.md。
使用方式:前提为 Node.js >=18、TypeScript、Apify CLI(npm i -g apify-cli);包包括 Actor 内的 apify 与 crawlee、在应用中调用 Actor 的 apify-client、输入校验的 zod;需要 Apify API token,通过环境变量设置 APIFY_TOKEN,SDK 与 apify-client 自动读取,切勿硬编码,启动时校验。先选模式,再 Grep 现有仓库中的 apify、apify-client 与 Actor.main,按模式树布局目录,将路由、抽取与校验分离;用 zod 做类型化输入校验,使错误输入在 Actor 边界快速失败;模式 3 中用 ApifyService 类隔离所有 Apify 调用;通过 loadConfig() 在启动时一次性加载配置并按环境覆盖;暴露 Apify 健康检查。
适用场景与限制:适用于设计爬取基础设施、构建多 Actor 流水线或让应用消费抓取数据。应用技能产出的是架构而非可运行命令,输出为目录布局建议、骨架模块、配置策略与健康信号。错误处理涉及循环依赖(用依赖注入)、缺失配置(启动时校验)、流水线阶段失败(按阶段重试)、状态管理(webhook 加数据库)、结果未就绪(轮询 getRunStatus 或使用完成 webhook)。多环境设置另见配套 apify-deploy-integration 技能。其余细节资料未提供。