LIWENJSON v1.5.2
检测引擎…
LLM 输出的执行门 · 本地 MCP

不要等合法 JSON,
先问我已经知道了什么。

LIWENJSON 是 LLM 输出的执行门:模型给出的工具参数与结构化结果,先过它,再决定能不能执行。 它以一个本地 MCP server(liwenjson mcp)运行 —— 不联网、不需要 API key、 被检查的文本不离开本机。底层是纯 MoonBit 的流式 JSON 修复与部分解析引擎:这一页的每一次修复、 每一帧快照、每一个判定,都由同一份引擎编译出的 liwenjson.js 在浏览器里现场完成, 页面里没有第二份实现。

01

本地 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 的结果字段

executable decision exactness ambiguity value retry.prompt

文本通道 content[0].text 是给模型的摘要(判定、能否执行、回灌的句子),structuredContent 是完整载荷; 不支持 MCP 2025-06-18 的客户端退回文本通道即可。

真实 JSON-RPC 往返

—

—

客户端配置 · liwenjson mcp --print-config

—

这是 CLI 的真实输出;CLIENT 省略时默认 json。

一行接入

claude mcp add liwenjson -- liwenjson mcp

别名 liwenjson-mcp 等价于 liwenjson mcp; 支持 claude / cursor / vscode / codex / windsurf / zed / json 七种配置。

02

修复工作台

repair · analyze · 五种安全档位

输入任意破损 JSON(围栏、注释、单引号、尾逗号、裸词、NaN、截断、多个根值……), 选择安全档位后查看修复文本、完整决策计划与逐条修复记录。执行门始终按精确度判定: Info 只改记法可以执行,Warning 发明或丢弃了信息就拒绝。切到 strict(或遇到有损修复时的 execution),结果会从「修好了」 变成「拒绝执行 + 可直接回灌模型的提示」。

输入

快捷键 Ctrl/⌘ + Enter

预设样本

执行门判定

—
decision
—
exactness
—
ambiguity
—
execution
—
valid_json
—
normalized
—

—

—
03

执行门 · 工具参数

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 原文)

—
—
04

流式部分解析

PartialParser · Delta 协议 · 三个就绪数字

模型是一个码元一个码元写 JSON 的。拖动进度或播放,看引擎在当前前缀上已经知道什么: 部分结果、未闭合路径、每个成员是否定稿、以及 syntax ready / schema ready / settled ready 三个比例。第三个数字回答的不是 「JSON 写完了吗」,而是「我已经知道答案了吗」——长尾参数下 30% 就可以停。 完整四条场景在 live.html。

场景

—

模型流(已喂入的前缀)

—

Delta 事件流(RFC 6901 指针)

尚未喂入任何码元

实时结构

—

成员就绪

就绪比例

syntax ready
—
schema ready
—
settled ready
—
declared
—
—
05

22 条修复规则

R001–R022 · 单次左到右扫描

每条规则都能当场触发:点「试用」把它自己的样本送进工作台,修复记录里就会出现这条码。 规则在单次从左到右扫描中即时生效,不回溯、不二次遍历;同一位置可能命中多条,按扫描顺序各产生一条记录(实现按扫描顺序登记,不按编号重排)。 Info 只改记法(Cosmetic),Warning 发明或丢弃了信息(Lossy)。

22 条规则
规则级别动作触发条件可复现样本操作
06

字段就绪曲线

watch_readiness · ReadinessEvent

每个声明过的成员在输入消耗到多少时定稿,是一次事件流而不是离线测量。 field_ready / field_invalid / field_rejected / root_ready / root_invalid 都在值定稿的那个 delta 上发出, 所以「值不对」可以在流还没结束时就被拒绝,从而取消整次生成。

场景

—
syntax
—
schema
—
settled
—
—

每个成员的定稿位置

事件流

事件路径位置细节
07

命令行

liwenjson · 退出码 0/1/2/3/4/5/70

同一个引擎的原生 CLI。勾选参数、选择子命令,右边就是可以直接粘贴的一行。 --check 只检查不输出,需要修复时退出码 1;--strict 与 --for-execution 拒绝时退出码 5,并把可直接回灌模型的提示打到标准错误。

命令构造器

liwenjson broken.json
文件为 - 或缺省时读取标准输入。

退出码

码含义

致命错误(LIWENJSONError,12 个变体)

码变体退出码触发
08

六种接入方式

MCP · stdio · npm · pip · HTTP · MoonBit

按「谁来决定使用」区分:模型主动调用的 MCP(上面第 01 节,默认入口)、宿主应用的长驻协议、 两个语言包、HTTP facade,以及进程内直接用的 MoonBit 库。每一条命令都能从仓库检出直接跑。