用途:将含 manifest.json 的 Freshworks Platform 3.0 应用文件夹打包为 dist/*.zip,并通过 MCP 工具发布到 Freshworks Marketplace。当前仅支持 test 状态。
主要能力与流程:发布前必须先运行 fw-review 技能做市场合规审查(检查 iparams、前端文件、安全模式并生成审计报告),审查通过且用户明确同意后才可发布。流程包括:调用 list_custom_apps 做鉴权连通性冒烟测试;确定应用目录;确认 API key 对应正确产品;检查 Node.js 与 FDK 版本是否匹配 manifest 的 engines 字段;运行 fdk validate 作为上传有效性门槛(需零平台错误、零 lint 错误);询问开发者体验反馈;写入 .meta.json 指标;执行 fdk pack --skip-coverage --skip-lint 生成 zip;用 unzip -l 校验 zip 根目录含 manifest.json 与 .meta.json;提示自定义应用数量限制;在发布时询问是新上架还是更新已有应用;新上架需提供 supportEmail;调用 create_app_upload_url 获取 uploadId 与 uploadUrl;用内置脚本 PUT 上传 zip;最后调用 submit_custom_app(新上架)或 add_app_version(更新)。
使用方式:通过托管 MCP 地址 https://mcp.freshworks.dev/mcp 调用工具,工具名与参数对应 Freshworks openai-server。鉴权需在 https://developers.freshworks.com/developer/ 获取 API key 并配置到 IDE 的 MCP 设置中。
限制:发布在沙箱或限制出站 HTTPS 的代理、网关、IAM 角色环境中不可用,S3 可能返回 403/AccessDenied,需在非沙箱、允许网络的环境运行,必要时让用户在本地机器执行上传命令。fdk 缺失时须停止,不得自动安装。版本不匹配须停止或由用户明确覆盖。.meta.json 只能通过 ~/.fw-dev-tools/scripts/ 下的脚本读写,禁止手写 JSON。zip 布局校验失败须重新打包。具体命令与脚本参数以资料为准。