不要等合法 JSON,
先问我已经知道了什么。
LIWENJSON 是 LLM 输出的执行门:模型给出的工具参数与结构化结果,先过它,再决定能不能执行。
它以一个本地 MCP server(liwenjson mcp)运行 —— 不联网、不需要 API key、
被检查的文本不离开本机。底层是纯 MoonBit 的流式 JSON 修复与部分解析引擎:这一页的每一次修复、
每一帧快照、每一个判定,都由同一份引擎编译出的 liwenjson.js 在浏览器里现场完成,
页面里没有第二份实现。
本地 MCP 执行门
liwenjson mcp · 四个只读工具 · JSON-RPC 2.0 / stdio
LIWENJSON 的主入口是一个本地 MCP server:模型在执行工具参数前调用
liwenjson_gate,拿到 executable 与 retry.prompt。
它不联网、不需要 API key、被检查的文本不离开本机;四个工具都是只读的
(readOnlyHint),协议 2025-06-18,同时接受
2024-11-05。下面是一段真实 liwenjson mcp 的 JSON-RPC 往返。
四个只读工具
| 工具 | 用途 |
|---|---|
liwenjson_gate首选 |
执行门。不传 profile 时默认 agent;返回
executable / decision / exactness /
ambiguity / value / retry.prompt。 |
liwenjson_repair | 修复并返回文本与修复记录。要的是文档,不是一个裁决。 |
liwenjson_validate | 只校验、不修复:可修的文档仍然算 invalid,并指出宽松档会做哪条修复。 |
liwenjson_readiness | 每个声明字段在流里何时定稿:syntax / schema / settled 三个比例。 |
gate 的结果字段
真实 JSON-RPC 往返
—
客户端配置 · liwenjson mcp --print-config
—
这是 CLI 的真实输出;CLIENT 省略时默认 json。
一行接入
claude mcp add liwenjson -- liwenjson mcp
修复工作台
repair · analyze · 五种安全档位
输入任意破损 JSON(围栏、注释、单引号、尾逗号、裸词、NaN、截断、多个根值……),
选择安全档位后查看修复文本、完整决策计划与逐条修复记录。执行门始终按精确度判定:
Info 只改记法可以执行,Warning 发明或丢弃了信息就拒绝。切到
strict(或遇到有损修复时的 execution),结果会从「修好了」
变成「拒绝执行 + 可直接回灌模型的提示」。
输入
预设样本
执行门判定
- decision
- —
- exactness
- —
- ambiguity
- —
- execution
- —
- valid_json
- —
- normalized
- —
被拒绝 — 把这段原样回灌模型
—
—
—
| 规则 | 级别 | 动作 | 位置 | 歧义 | 置信度 |
|---|
执行门 · 工具参数
analyze · JSON Schema 子集 · retry.prompt
左侧是工具声明(骨架声明 {!query:string,!limit:integer} 或模型已经拿到的
inputSchema),右侧是模型这次写出来的参数。两者一起喂给引擎:语法修复、类型检查、
值约束、重复键语义歧义与资源上限,最后只给一个词——能不能执行。
不支持的 JSON Schema 关键字会被报成 E070,而不是被静默丢掉。
声明与参数
预设
判定
- decision
- —
- execution
- —
- schema
- —
- exactness
- —
声明成员核对
被拒绝 — 回灌模型
—
深度预算 · 1.5 起值上的遍历是迭代的
深度上限原本是栈深度;1.5 起,值上的四个遍历(拷贝、判等、骨架求值、渲染)都改成迭代,
于是深度由堆而不是原生栈决定:MAX_VALUE_DEPTH = 1048576 是防笔误的理智上界,
库默认的 max_depth 仍是 512。下面这份文档是现场生成的嵌套数组,
交给同一个引擎判定 —— 超过预算报 E020,放宽后就能解析。
决策计划 JSON(RepairPlan::to_json 原文)
—
流式部分解析
PartialParser · Delta 协议 · 三个就绪数字
模型是一个码元一个码元写 JSON 的。拖动进度或播放,看引擎在当前前缀上已经知道什么:
部分结果、未闭合路径、每个成员是否定稿、以及 syntax ready /
schema ready / settled ready 三个比例。第三个数字回答的不是
「JSON 写完了吗」,而是「我已经知道答案了吗」——长尾参数下 30% 就可以停。
完整四条场景在 live.html。
模型流(已喂入的前缀)
—
Delta 事件流(RFC 6901 指针)
实时结构
—
成员就绪
就绪比例
- syntax ready
- —
- schema ready
- —
- settled ready
- —
- declared
- —
当前前缀被拒绝 — 回灌模型
—
22 条修复规则
R001–R022 · 单次左到右扫描
每条规则都能当场触发:点「试用」把它自己的样本送进工作台,修复记录里就会出现这条码。
规则在单次从左到右扫描中即时生效,不回溯、不二次遍历;同一位置可能命中多条,按扫描顺序各产生一条记录(实现按扫描顺序登记,不按编号重排)。
Info 只改记法(Cosmetic),Warning 发明或丢弃了信息(Lossy)。
| 规则 | 级别 | 动作 | 触发条件 | 可复现样本 | 操作 |
|---|
字段就绪曲线
watch_readiness · ReadinessEvent
每个声明过的成员在输入消耗到多少时定稿,是一次事件流而不是离线测量。
field_ready / field_invalid / field_rejected /
root_ready / root_invalid 都在值定稿的那个 delta 上发出,
所以「值不对」可以在流还没结束时就被拒绝,从而取消整次生成。
场景
- syntax
- —
- schema
- —
- settled
- —
每个成员的定稿位置
事件流
| 事件 | 路径 | 位置 | 细节 |
|---|
命令行
liwenjson · 退出码 0/1/2/3/4/5/70
同一个引擎的原生 CLI。勾选参数、选择子命令,右边就是可以直接粘贴的一行。
--check 只检查不输出,需要修复时退出码 1;--strict 与
--for-execution 拒绝时退出码 5,并把可直接回灌模型的提示打到标准错误。
命令构造器
liwenjson broken.json
- 或缺省时读取标准输入。
退出码
| 码 | 含义 |
|---|
致命错误(LIWENJSONError,12 个变体)
| 码 | 变体 | 退出码 | 触发 |
|---|
六种接入方式
MCP · stdio · npm · pip · HTTP · MoonBit按「谁来决定使用」区分:模型主动调用的 MCP(上面第 01 节,默认入口)、宿主应用的长驻协议、 两个语言包、HTTP facade,以及进程内直接用的 MoonBit 库。每一条命令都能从仓库检出直接跑。