用途:该技能是 Freshworks FDK 的安装与版本管理执行层,用于在本地配置 FDK 与对应 Node.js 环境,面向 Platform 3.0 应用开发。仅支持 Platform 3.0,不支持已弃用的 Platform 2.3。
主要能力:按触发词或斜杠命令执行五类操作——安装(默认 FDK 10.x)、升级(至最新 FDK 10.x)、降级(FDK 10.x 到 9.x,带弃用警告)、卸载、状态检查。安装与切换版本时使用 nvm 管理 Node,不全局安装 Node,不使用 sudo npm。
版本与安装源:FDK 10.x 搭配 Node 24.11.x,安装命令为 npm install -g https://cdn.freshdev.io/fdk/latest-v24.tgz;FDK 9.x 搭配 Node 18.x,命令为 npm install -g https://cdn.freshdev.io/fdk/latest.tgz。资料指出 @freshworks/fdk 未发布在 npm 公共 registry 上,不应通过 registry 全局安装。FDK 9.x 已弃用(2026 年 3 月结束),仅可用于开发,不能用于发布;发布需 FDK 10.x 与 Node 24。
使用方式:安装、升级、降级、卸载均通过子代理执行,并在操作后强制验证:命令是否存在、新 shell 中是否可用(如 zsh -c 'fdk version')、版本是否匹配、~/.fdk 缓存状态、npm 全局包状态、nvm 默认别名。降级与卸载需完整清理,包括删除 ~/.fdk、清理 npm 缓存、备份并修改 shell 配置。本地非阻塞运行可执行 scripts/fdk-run-background.sh,停止用 scripts/stop-fdk-shell-tasks.sh。
适用场景:需要为 Platform 3.0 开发准备或切换 FDK 环境、排查 fdk: command not found、处理多 Node 版本或 PATH 冲突、macOS 与 Windows 特定安装问题。
限制:资料未提供具体价格、平台覆盖范围或效果数据;复杂多 Node、PATH 冲突及系统特定问题需加载对应参考文件(cross-scenarios.md、macos.md、windows.md、error-command-not-found.md)。若无法 100% 确定,应回复“Insufficient FDK installation certainty.”。