项目状态

K2F 处于 0.3.x 发布线。格式规范 是磁盘上的契约。本页概述哪些内容稳定、哪些属于预览质量，以及哪些仍在计划中。

桌面阅读器：打包构建 — 在 k2f.dev/download 下载安装程序。macOS 文件关联与操作系统代码签名 / 公证仍在路线图中。
MCP：stdio 已发布 — 从仓库检出运行本地 k2f_mcp 适配器。远程 HTTP MCP尚未发布。

概览

0.3.x 中已发布

格式与完整性

• 包模型 — ZIP 容器、语义树、主题、嵌入字体、编译后的 lock
• 验证 — 哈希链与查看器横幅（SIGNED、UNSIGNED、BROKEN_INTEGRITY 等）。参见完整性。
• 注册表 — pip install k2f（PyPI）、npm i @openk2f/k2f（npm）、cargo install k2f（crates.io）。npm 使用带作用域的 @openk2f/k2f，因为无作用域的 k2f 已被占用。

查看器与导出

• Web 查看器 — 仅绘制 lock（正文文本不使用 DOM fillText）。指南：Web 查看器。
• Markdown 桥接 — markdown_to_k2f / k2f_to_markdown（显示 $$...$$ 节点；行内 $...$ 修饰符）。
• 原生数学 — 显示 $$ 与行内 $ 编译为字形（TeX 子集，包括可伸缩 \left/\right 以及 matrix / align / cases；未知命令在编译时失败）。
• 可填写字段 — content.type: "form_field"；查看器叠加输入控件；保存使用 replace_text + relock；默认 PDF 导出写入 AcroForm（--flatten 绘制 lock 字形）。DOCX/PPTX 导出 lock DrawBox / DrawText（无 Word 内容控件）。
• Office 导出 — PDF、PPTX、DOCX 与 IDML 从已发布的 lock 绘制（导出概览）。

智能体与自动化

• 智能体技能 — 工作流、目录与脚本位于 k2f（skills/core/k2f/SKILL.md）；使用 npx skills add suzheng/k2f --skill k2f 安装。站内镜像：/skills/core/k2f。
• 分层 — skill（指令）→ SDK（实现）→ MCP stdio（engine/k2f_mcp；契约位于 mcp_tools.json，可在 k2f.dev/roadmap/mcp 浏览）。

预览

• 桌面阅读器 — 原生 lock 执行器（与 Web 查看器规则相同：打开不会重新编译；像素与导出均来自 document.K2F.lock）。打包构建见 k2f.dev/download。从源码运行：cargo run -p k2f_reader -- path/to/file.K2F。精准编辑、表单保存与 lock 导出与 Web 技术栈一致。详情：k2f.dev/roadmap/desktop。

路线图（尚未发布）

仅存在于本公开仓库之外的工作轨道不属于公共契约。

版本管理与兼容性

格式规范 v0.3 与 SDK 0.3.x 匹配。补丁版本保持该规范，除非 schema 或 lock 格式发生破坏性变更。关于 lock 上的 engine_version 匹配，参见 COMPATIBILITY.md。发布说明：CHANGELOG。