klode 发布 v0.4.1 · 笑来搜

这个版本更新了什么#

0.4.0 was prepared but never published, so v0.4.1 carries everything since v0.3.0.

Commands that could not do their work now exit 2 instead of 0.

command	condition	was	now
`check`	corpus absent, or any card's source not installed	`OK`, 0	`ABSTAINED`, 2
`check --entail`	the entailment backend could not load	`OK`, 0	`ABSTAINED`, 2
`build`	nothing to build	0	2
`normalize --check`	no file matched, or files were unreadable	0	2
`zoom --level content`	the source is not installed	0	2
`eval/extract_bakeoff.py`	nothing could be ranked	0	2
If your CI runs `klode check` on a machine without the corpus installed, it will now fail.
That is deliberate. `klode check --strict` used to print `OK: 0 errors` and exit 0 on a library
whose citation-rot check never ran — and a fresh clone has no corpus, because the corpus is
git-ignored. Every anchor could have rotted while the build stayed green. CI reads exit codes, not
notes.
The convention is now uniform: **1 = measured and failed · 2 = could not measure · 0 = the work
happened.** Pass `--allow-unmeasured` to `check`, `build`, or `normalize` to accept a gap
knowingly — the difference between an accepted limitation and a silent one.

A card's file: is confined to <lib>/<shelf>/<name>.txt. It was confined only to the library root, so a card could point at library/.env or library.toml and zoom --grep would print the matching lines. Cards travel through the registry, so that field is untrusted input.
Settings-backed CLI flags default to None rather than to their value; --max requires --grep; normalize --apply and --check are mutually exclusive; --json on a command that cannot emit it now refuses instead of printing prose.

Extraction integrity — an ingest can say whether the text it wrote represents the document, and refuses the shelf when it does not. Containment, inflation and per-page reading order, plus rendered-page ground truth (pdftoppm + tesseract) — the only signal not downstream of another extractor. Four states, and abstained is never verified.
~/.klode/settings.toml — argument → environment → file → default, with the winning source recorded. klode settings --explain describes every key; --lint validates the file including shadowed values. Credentials can never be settings, and a test enforces it.
Remote layout backends — point [ingest].docling_url / marker_url at docling-serve or marker_server. The GPU runs server-side, so klode keeps zero runtime dependencies. Preferred over a local install: remote conversions have a deadline that scales with the document, while the in-process backends have no wall-clock bound.
klode review --live-judge — the real rubric judge, behind an explicit flag. A config file is

（更新说明有删节，完整内容见下方链接。）

以上是作者写在 GitHub 上的英文更新说明原文，未经翻译。查看原页面