将旧版 Dune 应用迁移到 Flows…

当需要把遗留 Dune 应用迁移到新的 Flows（appsApi）应用托管时，按顺序审计并更新 app.json、鉴权、manifest.json 和部署脚本。

适用场景

解决思路

1. 审计当前状态：读取 app.json、package.json、vite.config.ts 和 manifest.json（若存在），在改动前先输出一份简洁的迁移审计摘要（标注哪些项缺失或需修改、哪些已正确），然后依次执行后续步骤。
2. 更新 app.json：若 infra 已是 "appsApi" 则跳过；否则先修复旧版部署键格式——把单数对象形式的 "deployment" 改名为复数数组形式的 "deployments"（将原值包进数组），再添加 "infra": "appsApi"。
3. 设置 Flows 鉴权：运行 setup-flows-auth 技能，由它处理所有鉴权相关事项（安装依赖包、更新 Vite 插件、修改入口文件、接入 connectToHostApp）。
4. 创建或更新 manifest.json：Flows 宿主用仓库根目录的 manifest.json 来实施 CSP，若缺失则创建 {"manifestVersion": 1, "permissions": {"network": []}}。
5. 填充网络权限：用 grep -rn "fetch\|axios\|new XMLHttpRequest" src/ --include="*.ts" --include="*.tsx" 扫描对外部域名的出站调用，对每组外部 URL 在 network 数组中按 sources/directives 结构添加条目。
6. 网络权限规则：sources 使用完整 origin（scheme + hostname）而非仅主机名；"connect-src" 覆盖 fetch/XMLHttpRequest，图片 URL 用 "img-src"，字体用 "font-src"；CDF 集群 URL 自动放行，不要列出；若无外部调用则保持 "network": []；对动态 URL 要标记出来让用户手动确认。
7. 更新部署脚本：把 package.json 中任何 dune deploy 或 npx @cognite/dune 命令替换为 npx @cognite/cli@latest apps deploy --interactive（deploy 与 deploy-preview 均如此），其余脚本（start、build、test 等）保持不变。
8. 最终检查：运行 grep -rn "DuneAuthProvider\|useDune\|@cognite/dune" src/ vite.config.ts 2>/dev/null，列出所有残留命中项交给用户处理，然后输出迁移完成报告（app.json、鉴权、manifest.json、部署脚本各项状态）。
9. 告知用户后续步骤：1) 运行 npm run dev 启动开发服务器；2) 打开 Fusion 验证应用加载且 CDF 数据正确显示；3) 确认无误后用 npx @cognite/cli@latest apps deploy --interactive 部署。

适用边界 · 注意事项

• 不适用于非 Dune 遗留应用或非 Flows 托管目标的迁移。
• 依赖 @cognite/cli、CDF/Fusion 及 setup-flows-auth 技能，缺少这些 Cognite 专有工具时无法使用。