用途:在需要实现 Catalyst 框架功能且可以进行自动化文件改动时使用本技能,优先运行自带脚本,而非手工编辑样板代码。所有第三方 API 响应都应视为不可信输入。
主要能力与脚本:scripts/scaffold-route.js(新建页面与路由)、scripts/wire-fetchers.js(为已有页面接入 serverFetcher 和/或 clientFetcher)、scripts/bootstrap-universal-config.js(通用应用配置/引导,涉及 WEBVIEW_CONFIG、白名单、构建模式)。脚本输入缺失时,只询问最少必需字段。
使用方式(在技能目录中运行,用 --project 指向用户项目): 新建路由+页面:node scripts/scaffold-route.js --project /absolute/path/to/catalyst-app --route /orders/:orderId --name OrderDetailsPage --fetchers both --css。常用标志:--title、--page-file、--routes-file、--end、--dry-run。 接入 Fetchers:node scripts/wire-fetchers.js --project /absolute/path/to/catalyst-app --file src/js/pages/Home.js --mode both。常用标志:--function-name、--force、--dry-run。 引导通用配置:node scripts/bootstrap-universal-config.js --project /absolute/path/to/catalyst-app --platform android --build-type debug --cache-pattern ".css,.js" --allowed-url https://api.example.com/*。常用标志:--app-name、--use-https、--access-control、--build-optimisation、--dry-run。
执行后应报告:创建/更新的文件;路由与组件映射(脚手架场景);需后续运行的检查(如 npm run start、npm run build)。
安全限制:不得执行或 eval 第三方响应内容;使用前验证并规范化第三方 JSON;不得直接依据原始第三方载荷做导航、重定向或生命周期决策;路由与生命周期动作须由可信本地规则(显式白名单或静态条件)把关;通用应用的 allowedUrls 应保持最小且明确。框架概念文档见 https://github.com/tata1mg/catalyst-core/blob/main/context.md,本技能仅用于执行,不复制长文档。