用途:fw-setup 是 Freshworks Development Kit(FDK)的安装与版本管理执行层,负责在开发机上安装、升级、降级、卸载 FDK,并管理配套 Node.js 版本,服务于 Platform 3.0 应用开发。
主要能力:支持安装 FDK 10.x(Node 24,推荐,发布必需)与 FDK 9.x(Node 18,已弃用,2026 年 5 月 31 日结束支持);支持升级到最新 10.x 或指定版本、降级到 10.0.y 或 9.x、完全卸载;提供状态检查、故障诊断与按仓库切换 Node/FDK 栈(.nvmrc)。双栈可通过 nvm 共存。
使用方式:通过斜杠命令触发,如 /fw-setup-install、/fw-setup-upgrade、/fw-setup-downgrade、/fw-setup-uninstall、/fw-setup-status、/fw-setup-troubleshoot、/fw-setup-use。安装源为 CDN tarball,而非公共 npm registry:FDK 10.x 使用 npm install -g https://cdn.freshdev.io/fdk/latest-v24.tgz(Node 24.11.x);FDK 9.x 使用 npm install -g https://cdn.freshdev.io/fdk/latest.tgz(Node 18.x)。始终使用 nvm,不使用全局 Node 或 sudo npm。
限制与注意:FDK 10.1.0+ 要求 Node 24.11.x;@freshworks/fdk 未发布在公共 npm registry,使用 registry 安装会 404;卸载需同时移除 @freshworks/fdk 与旧的无作用域 fdk 包,并删除 ~/.fdk 缓存;每次变更操作后需在新 shell 中验证 fdk version;FDK 9.x 会显示弃用警告。具体命令细节与平台差异以官方文档为准。