模型负责思考;kit 让它能看、改、运行、检查和撤销一个真实文件。

一个 kit 就是遵循 KHP 工具约定的 MCP 服务器,任何支持 MCP 的 agent 都能用任何 kit。

Scene 0.1.0:参考实现里的3D 场景 kit,由协议的维护者开发。声明的等级是 basic。

Scene · Still life.kscene
例子

调用记录

  1. scene_inspect (Still life.kscene, preview: true, target: {"view":"camera"}, maxSize: 1200) ok Opened `Still life.kscene`: 1920 × 1080
  2. scene_commands (Still life.kscene, query: "material keyframe parent") ok No command has every word of `material keyframe parent`; 30 have some of them; showing the best 12.
  3. scene_run (Still life.kscene, [material.set, add.icoSphere, material.assign, add.empty, object.parent, anim.insertKey, object.transform, anim.insertKey, anim.setInterpolation]) ok Ran 9 commands on `Still life.kscene` (saved): 1920 × 1080
  4. scene_check (Still life.kscene) ok Checked `Still life.kscene`: no errors, no warnings, 1 note.
  5. scene_inspect (Still life.kscene, preview: true, target: {"view":"camera"}, maxSize: 1200) ok Opened `Still life.kscene`: 1920 × 1080
  6. scene_inspect (Still life.kscene, preview: true, target: {"range":[0,3.75],"frames":6}, maxSize: 1200) ok Opened `Still life.kscene`: 1920 × 1080

预览

01 打开这个场景:对象、材质、灯光和摄像机以 JSON 列出,再加上 kit 渲染出来的摄像机视角。

kit 渲染的摄像机视角:浅色地面上一个蓝绿色的球、一个沙色的方块和一个圆环。

02 在命令目录里搜索材质、父子关系和关键帧的命令。

scene_commands(Still life.kscene, query: "material keyframe parent") · 5 找到

  • object.parent Parent Parents `objects` (names or ids; the selection without it) to `parent`, keeping their world transform.
  • object.clearParent Clear Parent Clears the parent of `objects` (names or ids; the selection without it), keeping their world transform.
  • object.parentArmature Parent to Armature Parents `objects` (names or ids; the selection without it) to `armature` with automatic, envelope or empty weights.
  • material.new New Material Creates a material with base color, metallic and roughness and answers its id.
  • material.set Change Material Changes material `material` (name or id): base color, metallic, roughness, emission, alpha, transmission and more.

03 要求是:把球改成有光泽的珊瑚红,加一颗小的多面体石子,再把物体放到一个四秒转一圈的转台上。这个 kit 不保留草稿,修改直接写进文件,只保存一次。

kit 渲染的摄像机视角:浅色地面上一个蓝绿色的球、一个沙色的方块和一个圆环。

scene_run → 9 steps · saved

✓ material.set ✓ add.icoSphere ✓ material.assign ✓ add.empty ✓ object.parent ✓ anim.insertKey ✓ object.transform ✓ anim.insertKey ✓ undefined

changes: 2 created, 5 changed

04 检查场景。

kit 渲染的摄像机视角:浅色地面上一个蓝绿色的球、一个沙色的方块和一个圆环。

scene_check → 1 note

scene.unusedMaterial: Material Material is not used by any object → fix: material.delete

05 再从摄像机看一遍。这段视频是转台转动的 48 张预览,每隔一帧一张,都由 kit 渲染。

06 看运动:从四秒的转动里取六帧,由 kit 画成一张图。

kit 渲染的一张图:转台转动的六帧,每帧标有时间。

录制于 2026-11-18 · KitionAI/kition-scene@afa92f1 每次调用都由固定脚本(scripts/record-kits.py)发出,不是模型选的。kit:Scene 0.1.0,由 kition 0.3.0(Kition SDK 的命令行)通过 MCP 提供。kit 是按这个提交从公开仓库构建的。图片是会话中 kit 自己渲染的预览。视频由 kit 通过场景摄像机渲染的 48 张预览(转动中每隔一帧一张)用 ffmpeg 连成。

01 · 缺口

agent 写代码有 harness,处理文件没有。

编程 agent 能做实事,是因为它的 harness 让模型能读代码、改代码、运行、测试,出错时回退。幻灯片、表格、文档、PDF、图片、视频工程和图纸都没有这样的环境。kit 就是某一类文件的 harness。

01 观察

代码 读源码

今天的文件 为存储设计的格式

通过 kit

文档的 JSON、带类型的对象、渲染出来的预览

_inspect_query_hit

02 操作

代码 编辑、跑 shell

今天的文件 凭猜测改格式的脚本

通过 kit

带参数 schema 的命令;成批的对象编辑

_commands_run_batch

03 执行

代码 编译器、运行时

今天的文件 计算和排版锁在桌面软件里

通过 kit

kit 自己的引擎重新计算、排版、渲染

引擎

04 验证

代码 测试、类型检查

今天的文件 没有东西告诉它改得对不对

通过 kit

kit 报告的文档诊断

_check

05 恢复

代码 分支、回退

今天的文件 改动直接落进文件

通过 kit

由人审阅并合并的草稿

_draft_ready人来合并

KHP 只规定 AI agent 怎样使用 kit。kit 内部怎么实现(引擎、数据模型、编辑器、存储)由它自己决定。 为什么需要 KHP →

02 · 证据

试点测到了什么

khp-bench 让 agent 做同样的文件任务,分别通过 KHP kit、同一引擎上“一个命令一个工具”的扁平 MCP 服务器,以及普通 Python 脚本,然后给它留下的文件打分。

比扁平 MCP 服务器少的工具定义 token 倍数(一个幻灯片 kit)

关闭工具搜索时。开启 Claude Code 的工具搜索后差距变小。

评测 · 工具定义

三个 kit 共用一组 KHP 工具,对比 1,023 个扁平工具

差距随 kit 的数量增长。

评测 · 工具定义

多轮对话回到前面某一页时的干净修改

扁平 MCP:18/30(p = 0.0001)。原因在寻址:命令里写明页面的扁平服务器也做到了。

评测 · 回到前面某一页

有预览时,两种渲染器下都通过的排版任务

同一个 kit 不给图片:42/50。

评测 · 排版
测量

这些是试点结果,不是完成的评测:任务少,大多是一个模型、一个 agent harness。只改一个文件的小修改,工具层不改变成功率。评测由协议的维护者自己做,参考实现也出自维护者。 看局限 →

03 · 协议

KHP 规定了什么

三个角色。kit 是某一类文件的 MCP 服务器,在一个工作区文件夹上启动,带一份清单。agent harness 运行模型、它的工具和循环,通过 MCP 连接 kit。人启动 agent,审阅它的草稿,决定合并或丢弃。

一次调用经过 KHP MCP 审阅 · 合并或丢弃(只有人) 人 审阅 · 合并 Agent harness 模型 + 工具 + 循环 Kit MCP 服务器 · 引擎 draft plan.gantt
  1. 01 request 人提出要改 plan.gantt。
  2. 02 gantt_inspect → document JSON agent 把计划读成 JSON。
  3. 03 gantt_commands → schemas 找到要用的命令。
  4. 04 gantt_run → ok · draft 在文件旁的草稿里移动三个任务。
  5. 05 gantt_check → dependency-cycle · fix 检查报告一个依赖环,并给出修复提示。
  6. 06 gantt_run → ok 执行修复。
  7. 07 gantt_check → no errors 再检查一次:没有错误。
  8. 08 gantt_draft_ready → ready 请人审阅草稿。
  9. 09 review 人对比草稿和文件。
  10. 10 merge 只有人能合并。agent 没有合并工具。
示意 依据规范里的完整例子(第 4 节):一个带草稿的 Gantt kit。

三个等级,每级包含前一级

定义见 工具页第 10 节; 等级和 khp check 讲怎样测试。

  1. Basic basic

    inspect、commands、run、check;每个面向 agent 的命令都有 schema;结构化错误;安全规则。给现有的文件库包一层就够。

  2. Agent-ready agent-ready

    不开编辑器也能工作;真实的预览和带目录的检查;新建和导出;有对象模型时提供 query 和 batch;不联网。

  3. Agent-ready complete agent-ready-complete

    分页类 kit 的排版回答;给模型的使用指南;只改动所指对象的编辑;在沙箱里运行。

05 · 开始

从你的角色开始

A

把 kit 接到你的 agent

把 kit 注册成 MCP 服务器。下面用的是 khp 的示例 kit,先按它的 README 装好。

Claude Code

claude mcp add docx -- "$KHP_PYTHON_ENV/bin/python" -B \
  "$REPO_ROOT/examples/docx-python/server.py" \
  --workspace "$WORKSPACE" --actor "Your Name"

Codex

# ~/.codex/config.toml (absolute paths)
[mcp_servers.docx]
command = "/path/to/venv/bin/python"
args = ["-B", "/path/to/khp/examples/docx-python/server.py",
        "--workspace", "/path/to/workspace", "--actor", "Your Name"]

其他 MCP 客户端

{
  "mcpServers": {
    "docx": {
      "command": "/path/to/venv/bin/python",
      "args": ["-B", "/path/to/khp/examples/docx-python/server.py",
               "--workspace", "/path/to/workspace", "--actor", "Your Name"]
    }
  }
}
让 agent 接入 →

B

做一个 kit

把你的文件库包一层,再用 khp check 测试。检查工具还没有发布到 npm,要从 khp 仓库构建。

sh
git clone https://github.com/kitharness/khp && cd khp
pnpm --dir tools/conformance install --frozen-lockfile
pnpm --dir tools/conformance build
node tools/conformance/dist/cli.js check \
  --kit "my-kit --workspace {workspace}" \
  --package <kit-package> --level basic
实现一个 kit →

C

读论文和评测

规范在公开仓库里,一共四页。论文讲设计的来由;评测写方法、试点结果和局限。

sh
git clone https://github.com/kitharness/khp
ls khp/spec
# agent.md  conformance.md  index.md  manifest.md

06 · 状态

KHP 现在的状态

版本
KHP 1.1, edition 2026.11, draft
状态
开源的协议草案
来源
在公开仓库 kitharness/khp 中开发。本站的规范页面复制自提交 70fab29 (2026-11-16),只有英文。
一致性
khp check 在同一个仓库里,还没有发布到 npm。
维护者
Kition,它也是参考实现的开发者。协议打算以后移交给中立的基金会。