@blackwell-systems/gcf

中文文档
2.6.1发布于 2026/08/16MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 4.1万

结构化数据的AI-内置线条格式. 比JSON少出50-92%的代币,为代理环路提供多回合三角形编码. 百分之百理解每个前沿模型。 零从属.

中文使用文档
文档目录17 节
  1. 安装
  2. 国 际
  3. 图书馆
  4. 快速启动
  5. 解码
  6. 会话重复
  7. 正在流出编码
  8. Delta 编码
  9. 通用编码
  10. 一般文件三角洲(多回合)
  11. 重新锁定会话助手
  12. API 密码
  13. 类型
  14. 基准
  15. 执行情况
  16. 通过后
  17. 许可证

Playground Benchmarks npm License

gcf-typescript

gcf 类型标记

类型脚本执行 全球合作框架,是 LLMs 中最具象征性效率的线条格式。 用于任何结构化数据的JSON和TON的倒置替代.

gcf-typescript

为代理环所建,同一结构上下文会穿过模型边界后转弯. 单个有效载荷比JSON小50-92%,但GFS也使重复的结构跨个倒转并只在上下文变化时发送三角洲,因此到第5个重叠呼叫时,每次响应都比JSON花费99%的代币,一个10个呼叫会场运行比每次转弯重接JSON要便宜94.4%. 分会场和三角洲都需要本地的ID和多回合设计,JSON和TON都没有.

  • 100%理解每个前沿模式零训练 在16个数据集中,29%的代币比TON少,56%的代币比JSON少;在结构复杂的代码图上为91.2%(等于TON 68.8%,JSON 54.1%).
  • 证明无损失 5种形式和6种语言的43 000 000 000+往返旅行。 零运行时间依赖关系.
  • 一种格式,四种属性,没有其他单一格式同时持有: schema-free,无亏损,有符相通(50-92% vs JSON),并采用零训练可读模式. JSON是动词,Protobuf需要一个计划,MessagePack是二进制,而TOON也不是可靠的无损失.

2,500+ LLM评价. 全部基准。 。 。 .

文档 : gcformat.com (英语) • 妇女 游戏场 • 妇女 绿色气候基金对TON

安装

npm install @blackwell-systems/gcf

零从属. 类型脚本第一. 包括CLI. 不想改变代码吗? 使用 MCP 代理服务器 用于零码通过.

国 际

npx @blackwell-systems/gcf encode < payload.json    # JSON to GCF
npx @blackwell-systems/gcf decode < payload.gcf     # GCF to JSON
npx @blackwell-systems/gcf stats  < payload.json    # token comparison
Payload: 50 symbols, 20 edges

  JSON  ██████████████████████████████  4,200 tokens
  GCF   ████████░░░░░░░░░░░░░░░░░░░░░░  1,150 tokens

  Savings: 73% fewer tokens with GCF

或在全球安装: npm install -g @blackwell-systems/gcf 然后使用 gcf 直接说.

图书馆

快速启动

import { encodeGeneric } from '@blackwell-systems/gcf';

const output = encodeGeneric({
  employees: [
    { id: 1, name: 'Alice', department: 'Engineering', salary: 95000 },
    { id: 2, name: 'Bob', department: 'Sales', salary: 72000 },
  ],
});

输出 :

## employees [2]{id,name,department,salary}
1|Alice|Engineering|95000
2|Bob|Sales|72000

解码

import { decode } from '@blackwell-systems/gcf';

const p = decode(input);
console.log(p.tool, p.symbols.length, 'symbols', p.edges.length, 'edges');

会话重复

通过多个工具响应跟踪传输的符号. 先前存在的符号成为赤裸裸的参考,而不是全部声明:

import { Session, encodeWithSession } from '@blackwell-systems/gcf';

const sess = new Session();

const out1 = encodeWithSession(payload1, sess); // full declarations
const out2 = encodeWithSession(payload2, sess); // reused symbols as "@N  # previously transmitted"

到会话第5回:单从脱口而出,比JSON少了86%的代币,有99%被三角洲编码堆放.

正在流出编码

随着符号和边缘的到来,逐步写入全球合作框架产出。 零缓冲,每行O(1)内存. 对行走大图表或相接结果的 MCP 服务器的理想:

import { StreamEncoder } from '@blackwell-systems/gcf';

const enc = new StreamEncoder(writer, 'context_for_task', { tokenBudget: 5000 });

// Symbols emit immediately as they're discovered.
enc.writeSymbol({ qualifiedName: 'pkg.Auth', kind: 'function', score: 0.95, provenance: 'lsp', distance: 0 });
enc.writeSymbol({ qualifiedName: 'pkg.Server', kind: 'function', score: 0.60, provenance: 'lsp', distance: 1 });

// Edges emit immediately too.
enc.writeEdge({ source: 'pkg.Server', target: 'pkg.Auth', edgeType: 'calls' });

// Close emits the ##! summary trailer with final counts.
enc.close();

输出 :

GCF tool=context_for_task budget=5000
## targets
@0 fn pkg.Auth 0.95 lsp
## related
@1 fn pkg.Server 0.60 lsp
## edges [?]
@0<@1 calls
##! summary symbols=2 edges=1 counts=1,1,1

这个 writer 是带有一个 write(s: string) 方法(Node.js流,web WritableStreams,或简单的回调). 标准 decode() 处理无变化的流出.

Delta 编码

当消费者已经有前置上下文包时,只发送已改变的内容:

import { encodeDelta, type DeltaPayload } from '@blackwell-systems/gcf';

const delta: DeltaPayload = {
  tool: 'context_for_task',
  baseRoot: 'aaa111',
  newRoot: 'bbb222',
  removed: [{ qualifiedName: 'pkg.OldFunc', kind: 'function', score: 0, provenance: '', distance: 0 }],
  added: [{ qualifiedName: 'pkg.NewFunc', kind: 'function', score: 0.85, provenance: 'rwr', distance: 0 }],
  removedEdges: [],
  addedEdges: [],
  deltaTokens: 30,
  fullTokens: 200,
};

const output = encodeDelta(delta);

81.2%的储蓄来自小包稍有变化的再饮.

通用编码

将任何联署材料价值(不只是图表载荷)编码成全球合作框架表格格式:

import { encodeGeneric } from '@blackwell-systems/gcf';

const output = encodeGeneric({
  employees: [
    { id: 1, name: 'Alice', department: 'Engineering', salary: 95000 },
    { id: 2, name: 'Bob', department: 'Sales', salary: 72000 },
  ],
});

输出 :

## employees [2]{id,name,department,salary}
1|Alice|Engineering|95000
2|Bob|Sales|72000

研究对象、阵列和原始物 统一物体的阵列得到表格行. 使用嵌入式对象 ## key 区域标题.

一般文件三角洲(多回合)

在代理循环中,同一个按键表在转后会转动。 不再每次重排整个表格,只发送已更改的行(SPEC §10a):

import {
  diffGenericSets,
  encodeGenericDelta,
  verifyGenericDelta,
  type GenericSet,
} from '@blackwell-systems/gcf';

const base: GenericSet = {
  key: 'id',
  fields: ['id', 'status'],
  rows: [
    { id: 1001, status: 'pending' },
    { id: 1002, status: 'shipped' },
  ],
};
const next: GenericSet = {
  key: 'id',
  fields: ['id', 'status'],
  rows: [
    { id: 1001, status: 'shipped' }, // changed
    { id: 1003, status: 'pending' }, // added (1002 removed)
  ],
};

const d = diffGenericSets(base, next);          // GenericDeltaPayload
const wire = encodeGenericDelta(d);             // ## added / ## changed / ## removed
const held = verifyGenericDelta(base, d, d.newRoot); // atomic apply + new_root verification

以内容为主的组合根 至第5次重叠通话时,相较于JSON重发的代号为~97%.

重新锁定会话助手

GenericDeltaSession 为您管理三角洲/再锚地:每个 next() 返回一个紧凑的三角洲,或者在其下方有一个完整的再锁定器(重新定位消费者),更新其控取的基数.

import { GenericDeltaSession, sizeGuard } from '@blackwell-systems/gcf';

const sess = new GenericDeltaSession(base, 'orders', sizeGuard());
let wire = sess.currentFull();                  // transmit the base once to establish it
for (const snapshot of stream) {                // each turn's current GenericSet
  const { wire, isFull } = sess.next(snapshot); // a compact delta, or a periodic full re-anchor
}

fixedN(15) 每转N个转弯时均重新锁定; sizeGuard() 一旦累积三角洲达到一个完整的有效载荷大小,(建议)重新锁定。 它没有引入新的线语法,而解码器保持了cadence-agnostic,所以重制解码器只是协议的"完全"在时间表上的结果.

API 密码

函数说明
encode(p: Payload): string将一个图表有效载荷编码到全球合作框架文本
encodeGeneric(data: unknown): string将任意值编码到全球合作框架表格格式
decode(input: string): Payload将 GFC 文本重新分析到有效载荷
encodeWithSession(p: Payload, s: Session): string用会话分解编码
new StreamEncoder(w, tool, opts)创建流码器( 0- 缓冲)
encodeDelta(d: DeltaPayload): string编码三角洲( 仅添加/ 取消)
diffGenericSets(base, next): GenericDeltaPayloadDiff 二个按键记录集( generic profile)
encodeGenericDelta(d): string 编号 : decodeGenericDelta(s)通用三角铁丝网(§10a)
verifyGenericDelta(base, d, root): GenericSet原子应用 + new_root 核查
new GenericDeltaSession(base, tool, policy)生产者-侧式再接力辅助器(第10a.8节)
new Session()创建新会话跟踪器

类型

类型目的
Payload全球合作框架的全部有效载荷:工具、预算、符号、边缘、包根
Symbol图表节点:合格名称、类型、分数、出处、距离
Edge定向关系:来源、目标、边缘类型
DeltaPayload介于两包之间:添加/删除的符号和边缘
GenericSet 编号 : GenericDeltaPayload密钥记录集及其通用缩写(§10a)
GenericDeltaSession指定三角洲对全再锁定的国有生产商(第10a.8节)
Session用于多点调试的跟踪器
KIND_ABBREV 编号 : KIND_EXPAND双向类型缩略图

基准

2500+LLM评价跨越了11个模型,4个供应商,50+独立测试运行.

全球合作框架东贾森
理解 (23跑道,10个型号)91.2% (单位:千美元)68.8%54.1%
生成 (28个运行,9个型号)第5/5条第1.0/5号决定第5.0/5号决定
输入符号 (500个符号)11 090个16 378个53 341美元 (单位:千美元)
输出符号 (100个符号)5 976个8 937个16 121个

全球合作框架在扩大后获得15/16个数据集 表示效率基准. 全面结果: gcformat.com/指南/基准

执行情况

语言软件包仓库
走开go get github.com/blackwell-systems/gcf-go开始
类型脚本npm install @blackwell-systems/gcfgcf 类型标记
蟒pip install gcf-pythongcf-平通语
锈cargo add gcfgcf-rust 函数
挥发Swift 软件包管理器gcf-swift (英语)
科特林语Name齐打包gcf-kotlin (英语)
MCP 代理服务器pip install gcf-proxygcf 代用键 (双向,会话解开, HTTP 前端)
克劳德代码插件/plugin installgcf-claude-plugin (英语) (一个命令安装, 会话 stats hook)
代码插件codex plugin addgcf-codex-插件 (一个命令安装, 会话 stats hook)
VS 代码ext install blackwell-systems.gcf-vscodegcf-vscode 编码 (语法突出显示)
无 8nnpm install n8n-nodes-gcfgcf-n8n-节点 (工作流程编码/解码)
植树人npm install tree-sitter-gcf树保姆- gcf

零运行时间依赖关系. 永远. 所有6个执行都只依赖于其语言的标准库. 没有过渡性依赖。 无供应链风险。 这是一项长期承诺:全球合作框架永远不会依赖外部运行时间。 麻省理工学院有执照 所有执行都支持这两个通用简介(第1段)encodeGeneric)和图表简介(encode所有6种语言都包含CLI.

规格 : SPEC v3.5.3 稳定 有279个符合性固定装置,43,000,000,000+无损失的往返路线经过5种格式和6种语言的核实。 目前版本:去v1.7.0,TypeScript v2.6.0,Python v2.6.0,Rust v3.0.0,斯威夫特 v2.7.0,克特林 v2.6.0,.NET v0.2.0. 所有7个SDK的交叉语言兼容性都得到验证.

通过后

项目
Chrome DevTools 磁共振47K★ → Google Chrome DevTools 团队的 MCP 服务器;将活浏览器状态(DOM,网络,控制台,性能)曝光给AI编码代理
说话方便OpenAPI 工具(客户包括Google, Verizon, Mistral AI, DocuSign, Vercel); GFPS是其本土输出格式 oq 国 际
欧姆尼鲁特17K★ AI网关,注册,以及AI客户端与模型提供者之间的代理;GFS销售其压缩引擎
网络Claw610★ 人工智能网络自动化(113个技能,66个MCP集成);在每个MCP服务器上用GFS取代TON
页:1552 * 克洛德码的实时上下文选择器;只从103K-节点知识图显示相关工具
林克尔531++ 用于 AI 编码客户端的本地 LLM 网关; GFS 与 TOON 并列作为入站工具结果压缩器
打开数据产品 SDKLinux基金会 · Python 工具包和用于数据产品标准的 MCP 服务器;用于代理环境的 GFS 侧车
欧元最高值第一次IDE;第一次商业全球合作框架的采用,涉及四个编码表面,并有会话解开和三角洲
雷克丝JSON 对GCF Raycast Store中的转换器扩展,用于 MacOS 生产率启动器

见所有收养人

许可证

麻省理工学院 戴安娜·布莱克威尔

版本与发布记录

@blackwell-systems/gcf 共发布 30 个版本,首次发布于 2026/06/04;过去 12 个月发布了 30 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.6.1latest2026/08/162 个月前
2.6.02026/08/152 个月前
2.5.22026/08/102 个月前
2.5.12026/08/083 个月前
2.5.02026/08/083 个月前
2.4.02026/07/133 个月前

关于 @blackwell-systems/gcf 的常见问题

@blackwell-systems/gcf 是什么?

结构化数据的AI-内置线条格式. 比JSON少出50-92%的代币,为代理环路提供多回合三角形编码. 百分之百理解每个前沿模型。 零从属.

如何安装 @blackwell-systems/gcf?

在项目目录运行 npm install @blackwell-systems/gcf,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gcf,可以用 npx gcf 直接运行。

@blackwell-systems/gcf 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@blackwell-systems/gcf 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@blackwell-systems/gcf 可以商用吗?

@blackwell-systems/gcf 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@blackwell-systems/gcf 的下载量有多少?

根据 npm 官方下载统计,@blackwell-systems/gcf 在 2026/10/09 – 2026/11/07 这 30 天内被下载 40,708 次,日均约 1,357 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@blackwell-systems/gcf 还在维护吗?

最新版本 2.6.1 发布于 2026/08/16(2 个月前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/06/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。