RULITH 规据 字段与错误码

字段与错误码

生成表来自实现源码快照;真正的生产开放状态见生产状态。工具与操作的用法见 MCP 工具

内建谓词(写在规则的 when 里)

可用
比较eq neq lt lte gt gte between contains
算术add sub mul div mod pow min max neg abs sqrt ln exp concat

算术是 exact-or-fail:±253 内精确,越界/无穷/非数一律失败,绝不静默舍入。

二元算术的形状是 {left, right, result}——result 写变量时它产出这个值,写常量时它校验这个值。

极性与缺席

写法含义
{"predicate":"p","args":{…}}p 成立
{"predicate":"p","args":{…},"negated":true}强否定:已验证 p 不成立
{"predicate":"p","args":{…},"naf":true}缺席:p 无法被证明(只能出现在 when 里)

negatednaf 的区别是要紧的:前者是"我查过,没有",后者是"我没查到"。审批场景里"还没签字"是后者。

包字段支持矩阵

字段状态说明
meta.name / meta.versiondomain支持包名与版本;同一个智能体不可重复安装同名包
vocab[].predicate / vocab[].argsdomain支持词汇:这一行的名词与它的参数名(args 是参数名字符串数组)
vocab[].descriptiondomain未开放暂不支持,带上会被拒绝——先去掉,说明文字写进判据规则的 label 里
vocab[].key(→ functional_dependency)domain未开放函数依赖声明暂未开放
axioms[]domain另有入口判据规则不写在这个字段——云上写作 rules,安装流程自动经可用通道上板;照本页模板写即可,控制台「装到智能体」已替你处理
actionsdomain支持运行时动作:name/label/preconditions/effects——装载即经 ApplyBatch define_action 落板,执行器领活按名配对(2026-07-31 点亮)
empirical / theorems / pins / planGuidancedomain未开放这些高级字段(经验规律/定理/固定结论/计划提示)暂不接收
tools[].name / kind / impl / desctools支持kind 分 read/write/run 三档治理等级;安装后记录在智能体的记忆里,现场有哪些工具随时可核对;desc 超 240 字截断
tools[].params / fencetools支持须为对象;全文存放在平台注册表、不占用智能体的记忆,注册者自行留存原件
channels[]channels另有入口通道(证据来源)不放进包里——装别人的包不能改写你的信任根。在控制台「连接」页注册:你决定信什么,平台发密钥、执行验签,模型碰不到这个开关。已上线(2026-07-30 生产验证)
norms(宪法)norms支持宪法(边界)单独存一份:{"format":"rulith-norms/1","meta":{…},"norms":[…]}——就在本页粘上、点「校验」、装到智能体。装上之后,模型不能自己放松它——改宽或撤掉已承诺的条款会被当场拦下;要放松只能由宿主/运营方经受信通道改。判据类"规定"直接写成 rules,今天可用

错误码

拒绝一律带教学文本(告诉你怎么改),错误码用于程序判断:

含义
unauthenticated没带令牌或令牌无效(客户端被撤销过也是它)——重新走一次浏览器授权
not_authorized认证通过但无权碰这个东西(多半是接入地址里的智能体名字写错)
bad_command请求形状不对(缺字段、JSON 不合法)——teaching 会指出缺哪个
not_found地址指向的东西不存在
unknown_board智能体的记忆不存在(名字核对控制台智能体页)
board_sealed这块板已封(案卷已结)——写入一律拒绝,读取照常;要继续办事就开一份新的案卷
stale_revision修订号过期(乐观并发,重拉后重试)
rejected语义被拒——读 teaching,它会说清差什么
unimplemented云端尚未开放这个操作

看到 unimplemented 时,以服务端拒绝为事实,不要通过换一种说法假装操作成功;同时在生产状态登记这次能力漂移。

正文住 content/*.md;能力清单、工具清单、字段矩阵由生成器从实现代码抽取 (快照在 facts.json)——改了实现而忘了改文档,校验会自己发现。