NexFade for Grok

NexFade for Grok 可为文件和笔记创建一次性加密链接，而无需将明文发送到 NexFade。该插件在 Grok Bot/Grok Build 计算机上使用 AES-256-GCM 加密，仅上传密文，并将解密密钥作为收件人链接的 URL fragment 附加。

隐私边界

在此工作流中，Grok 是受信任的处理方。附加到 Grok 的文件和最终链接均按照 Grok 的隐私条款存储。NexFade 不会收到明文、AES 密钥或 URL fragment。此插件没有任何工具可用来打开或解密现有链接。

该插件只读取当前 Grok 工作区内显式提供的常规文件。它会拒绝工作区之外的路径、符号链接逃逸、环境文件、私钥和常见凭据目录。它只向配置的 NexFade HTTPS API 以及该 API 返回的预签名 HTTPS 上传目标发送网络请求。它不包含遥测、钩子、安装后脚本、包依赖、下载的二进制文件或动态代码执行。

要求

• 支持插件和 MCP 的 Grok Bot 或 Grok Build

• 代理计算机中的 Node.js 20 或更高版本

• 一个 NexFade 账户

• 文件大小不超过 NexFade 套餐上限和 100 MB 中的较小值

Grok Bot 目前接受最大 25 MB 的普通文档附件。更大的受支持本地文件可能在 Grok Build 中可用，而更大的 NexFade 文件应使用浏览器发送流程。

Grok Bot 部署要求

Grok Bot 使用现有的 Cursor 团队插件和 MCP 策略。团队管理员必须在团队插件页面启用该插件，并且如果团队使用 MCP 允许列表，则必须允许其 MCP 服务器。然后，该插件在 Bot 的受管计算机上运行，该计算机上预装的 Node.js 运行时必须满足上述 Node 20 要求。用户在 Bot 浏览器中完成 NexFade 登录；不会将 API 令牌复制到聊天中。使用 grok inspect（Grok Build）或 Bot 的插件页面确认插件已启用且受信任。

本包是 Grok Bot 和 Grok Build 的本地插件通道。grok.com/connectors 自定义连接器是单独的通道：xAI 要求该连接器的 MCP 服务器可通过公共 HTTPS 访问，因此在添加托管的远程 MCP 服务之前，不得将本本地 stdio 包宣传为 grok.com 连接器。

安装与连接

在私有测试期间，将此目录作为受信任的本地插件安装。公开版本将从 NexFade 官方 GitHub 仓库发布，并以固定提交提交到 xAI 的插件市场。

安装后，让 Grok 连接 NexFade。该插件会返回 NexFade 授权页面；登录后，批准所显示的三个作用域，然后告诉 Grok 批准已完成。无需复制 API 令牌。

访问凭据存储在宿主提供的插件数据目录中，并采用仅所有者可读的文件权限。可随时从 NexFade 集成页面撤销该凭据。

工具

• nexfade_connect

• nexfade_account_status

• nexfade_send_file

• nexfade_send_note

• nexfade_list_links

• nexfade_get_link_status

• nexfade_revoke_link

0.1 版有意仅支持一次性链接。收件人投递通过用户选择的电子邮件或消息连接器执行，并且需要明确批准。

开发

npm test
npm run check
npm run validate

无需安装依赖。

发布与发现

1. 部署 NexFade Web 应用和 PocketBase schema，配置 GROK_DEVICE_FLOW_SECRET，并使用一个 Free 账户和一个付费账户运行私有端到端金丝雀测试。

2. 在 NexFade 官方所有的公共仓库中发布此目录，并验证从其不可变提交直接安装。

3. 将该固定提交提交到发布时可用的 Grok Build 市场/目录流程。除非 xAI 已单独批准，否则不要宣称已列入 grok.com 连接器。

4. 将安装和隐私说明放在 nexfade.com/integrations/grok 上，然后在 NexFade 服务端衡量连接、首次链接、配额用尽、升级点击和付费转化事件。插件本身有意不包含遥测。

市场发布、生产部署和外部仓库创建属于发布操作，不由本源代码包执行。

有关精确可重复的目录命令、SHA 规则、验证步骤和最终列表检查，请使用市场发布清单。在审查后的提交公开后，此包即可生成目录对象：

npm run marketplace:entry -- \
  --repo-url https://github.com/<official-nexfade-org>/<repo>.git \
  --sha <40-character-commit-sha>

推荐的公共源是一个仅包含插件的仓库，本包位于其根目录。如果该包改为从公共 monorepo 发布，则还需传递 --path integrations/grok-plugin。