用途:K2F 让智能体以语义方式撰写和编辑排版讲究的文档,而非用坐标定位。每个 .K2F 文件是一个 ZIP,包含可编辑的语义树(content/root.json,节点有稳定 id、role、可选 variant 与修饰符)和不可变的渲染锁(document.K2F.lock)。引擎通过 pack/compile 把语义树变成锁,所有查看器与导出均绘制该锁。
主要能力:创建或更新 .K2F(简历、传单、幻灯片、海报、报告,可按节点 id 打补丁);Markdown ↔ K2F 互转;从已发布锁导出 PDF、PPTX、DOCX、IDML;发布永久 /v/{appearance_hash} 链接;在网页应用中嵌入 <k2f-viewer>。可从 Gallery 模板或 starter 起步,首次草稿可复制 catalog/content/ex_*.json 的金示例节点。
使用方式:先安装工具,pip install k2f 提供 CLI 与 Python SDK;嵌入查看器用 npm i @openk2f/k2f;可选 cargo install k2f。用 k2f unpack … -o ./out/doc/source 解包,或在无匹配时用 python scripts/init_package.py --workspace ./out/doc 初始化。编辑后运行 scripts/pack_verify.py --render 生成预览 PNG 并迭代。文本修饰符需用 scripts/modifier_range.py 计算 UTF-8 字节范围,不要手数;表单空格用 catalog/content/ex_form.json。
限制:样式只能写在 styles/theme.json,节点上放样式字段是最常见的编译失败原因;不得手改 document.K2F.lock;PDF、PPTX、DOCX、IDML 是单向绘制而非第二来源;签名是独立的人类/组织步骤,智能体输出默认未签名;每次编辑后需校验,依 writing/errors.md 的错误码修复,不要直接打补丁锁。缺失事实:具体收费、价格与平台支持细节暂未提供。