# 项目状态

K2F 处于 **0.3.x** 发布线。[格式规范](../spec/k2f-v0.3.md) 是磁盘上的契约。本页概述哪些内容稳定、哪些属于预览质量，以及哪些仍在计划中。

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

## 概览

| 领域 | 状态 |
|------|--------|
| 格式规范 [v0.3](../spec/k2f-v0.3.md) | 已发布 |
| PyPI、npm、crates.io 上的 CLI 与 SDK（**0.3.x**） | 已发布 |
| Web 查看器、Playground、永久发布 URL | 已发布 |
| 导出（PDF、PowerPoint、Word、InDesign IDML） | 已发布 |
| [K2F 智能体技能](https://k2f.dev/skills/k2f) 与 MCP stdio | 已发布 |
| 桌面阅读器安装程序 | 预览版（未签名） |
| 远程 HTTP MCP | 计划中 |

## 0.3.x 中已发布

### 格式与完整性

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

### 查看器与导出

- **Web 查看器** — 仅绘制 lock（正文文本不使用 DOM `fillText`）。指南：[Web 查看器](web-viewer.md)。
- **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 绘制（[导出概览](exporting.md)）。

### 智能体与自动化

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

## 预览

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

## 路线图（尚未发布）

| 项目 | 说明 |
|------|------|
| 远程 HTTP MCP | OAuth、多租户；stdio 已发布 |
| 幻灯片 / 无限画布 | 产品形态待定 |
| 桌面代码签名 / 公证 | 安装程序已存在；操作系统信任流程仍在路线图中 |

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

## 版本管理与兼容性

格式规范 [v0.3](../spec/k2f-v0.3.md) 与 SDK **0.3.x** 匹配。补丁版本保持该规范，除非 schema 或 lock 格式发生破坏性变更。关于 lock 上的 `engine_version` 匹配，参见 [COMPATIBILITY.md](../../COMPATIBILITY.md)。发布说明：[CHANGELOG](https://k2f.dev/changelog)。