把 API 数据编码成 GCF 再解码回来

把 API 数据编码成 GCF 再解码回来

一个 n8n 工作流，从一个公开的 Web API 取一页记录，把它们打包成 GCF 格式的一小段文本，再把文本转回数据，让你看到什么都没丢。可以用它来测量一份数据在发给语言模型之前能缩小多少。

它需要一个社区节点 n8n-nodes-gcf，n8n 自带的没有它。请先读“开始之前”。

包里有什么

• workflow.json：n8n 导出的工作流，5 个节点，没有便签。里面没有任何凭据，也没有私有地址。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• 节点里什么都没改。文件里没有凭据，没有密钥，也没有需要修的代码。
• 导出里的标签和设置标记已删掉，所以这个工作流打开时没有标签，也没有保存的示例数据。

开始之前

• 一个自己托管的 n8n。社区节点装在你自己运行的 n8n 上。n8n Cloud 只能添加已验证的社区节点，而我们没有确认这一个是不是已验证。
• 这个 n8n 的 Owner 或 Admin 来安装节点：Settings，Community Nodes，Install，输入 n8n-nodes-gcf 并接受提示。
• 接受之前先读提示。社区节点在你的服务器上运行，权限和 n8n 本身一样，所以它能接触每个工作流里的数据，以及 n8n 能读的每个文件。n8n 不审核它。
• 我们查了什么：我们读了这个包的 0.1.3 版，它是 MIT 许可，没有安装脚本，只依赖 n8n 自己的库和一个小的编码库。它的代码里没有网络、文件或进程调用。这是一个新包，只有一位维护者，后来的版本我们没有读过。请读你要装的那一版。
• 不需要账号，也不需要密钥。工作流里的 API 是公开的。

设置

1. 按上面的方法安装社区节点，如果 n8n 要求重启，就重启。
2. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
3. 点 Execute workflow。
4. 打开 GCF Encode 读打包好的文本和大小对比，打开 GCF Decode (lossless) 看数据怎么回来。

一次运行的过程

1. When clicking 'Execute workflow' 手动开始一次运行。
2. GET /contributors (100 records) 向一个公开的 Web API 要某个开源仓库的贡献者列表，每页 100 条记录。API 为每位贡献者返回一条记录。
3. Batch into Array 是一个 Code 节点。它把这些记录合成一条，只有一个字段 payload，里面放着这个列表。
4. GCF Encode 读 payload，把它的 GCF 文本写进字段 data。token 指标的选项是开着的，所以这条记录还带着 tokenMetrics：数据作为 JSON 和作为 GCF 的估算大小、节省的 token 数和节省的百分比。
5. GCF Decode (lossless) 读 data，把解开的列表写进字段 decoded。

改变风格

• 来源：把 GET /contributors (100 records) 里的地址改成任何返回 JSON 的 API。字段名 payload 可以保留，或者在 Batch into Array 和 GCF Encode 里一起改。
• 大小检查：只需要文本时，在 GCF Encode 里把 token 指标选项关掉。
• 用法：把 GCF Encode 放在模型调用之前，在提示词里发 data，不发 JSON。这个文件里没有任何一步调用模型。

注意事项

• 速率限制：这个调用不带令牌，该服务每个地址每小时允许 60 次这样的调用。被拒的运行会在第一个节点失败。一页最多 100 条记录，列表可能已经是几小时前的。
• token 数字是估算：文本长度除以 4，再向上取整。它们不是真正分词器的计数。它们只出现在 GCF Encode 的输出里。GCF Decode (lossless) 只输出 decoded。
• 节点自己的页面宣称了大幅节省。我们没有核实，所以请在你自己的数据上运行这个工作流，看你的结果。
• 工作流依赖这个节点。如果你把它删掉，或者它加载失败，两个 GCF 步骤都会停止工作。
• 没有模型，也没有费用：这次运行不用任何付费服务。解码这一步让你把解开的列表和原来的对比。“无损”是节点自己的说法，所以请在你关心的数据形状上自己核对。