5 分钟上手

登录、接客户端、干第一件事。不需要安装任何东西,也不需要手工贴 token。

1 · 登录

打开 console.rulith.com,用 GitHub 或 Google 登录。登录即开通,不需要邀请码;我们不存密码。

登录后你会看到账户页,以及一个默认智能体——它就是你的第一份可核对的记忆。

2 · 把客户端接上来

Claude Code:

claude mcp add --transport http rulith https://api.rulith.com/mcp

Codex(~/.codex/config.toml):

[mcp_servers.rulith]
url = "https://api.rulith.com/mcp"

其他 MCP 客户端:加一个 Streamable HTTP 服务,地址 https://api.rulith.com/mcp,认证选 OAuth(自动发现)。

首次连接会弹浏览器让你授权。你在那里选 GitHub 还是 Google,就绑到对应的账户——同一个人用两种登录方式会得到两个独立账户(身份键使然),这一点值得注意。授权一次之后自动续期,不用再管。

控制台的已连接客户端页能看到每个客户端,可以单独撤销某一个(撤销后它必须重新登录,其他客户端不受影响)。

3 · 让它干第一件事

在客户端里直接说人话:

用 rulith 记下这几行订单(钢筋 3850×12、水泥 420×80),立一条"金额=单价×数量"的规则,再算个总额,最后解释总额是怎么来的。

回控制台的我的智能体页点进去,结论那一栏会写着:

金额:钢筋 46200
依据:按规则「金额 = 单价 × 数量」,从你提供的 1 项材料推导得出

这就是可核对的形态:数不是模型报的,是板算的;每条结论都能问"凭什么"。

4 · 用目标驱动它(推荐)

比"你去做某事"更好的用法,是让智能体先声明什么算做完

先用 declare_goal 声明目标:钢筋这一项已定价。然后按板给的提示补齐缺口。

板每一批都会回它还差什么:

needs via AX_PRICED: checked(item=steel)

于是智能体的下一步不靠猜——它照着缺口去补证据或补规则。目标翻成 [satisfied] 的唯一方式是闭包真的支持它

这个用法的价值在长任务上特别明显:智能体不会"以为自己做完了",也不会在原地反复确认。

5 · 装领域能力

到控制台的领域能力页,选一个智能体,一键装上「审批」或「工单」。装上之后它就按那套判据办事——比如材料不齐不进入审批、没有签字就挂在待签。

现成的不够用?写自己的——一个包就是一组词加一组判据,控制台里粘 JSON、点校验、装上。

智能体手上有哪些工具

工具做什么
update_working_memorySubmit a batch of working-memory operations to a board; the kernel applies them, recomputes the rule closure once, and returns the updated working memory (derived facts, goal satisfaction, hypothesis verdicts, and hints about which facts to observe next)
get_logic_contextRead the current working memory of a board: goals (with satisfied flags), facts, hypotheses, findings, axioms, actions, results, conflicts, vocabulary
explain_factExplain WHY a derived fact is true: the rule that derived it and its supporting facts recursively back to asserted/effect leaves, each marked [derived]/[asserted]/[effect]
close_taskFinish a task: archive its tree (the goal node and everything under it) and get an honest capsule of what was actually established

注意这里没有"建板/选板"这类工具:一个连接对应一个智能体,它不需要知道"板"这回事。少一个概念就少一份认知负担。

多个智能体

一个账户可以有多个智能体,每个有自己的记忆与领域能力——比如"采购审批"一个、"客服工单"一个,互不干扰。

我的智能体页新建,然后在客户端里用带名字的地址各接一个:

claude mcp add --transport http rulith-purchase "https://api.rulith.com/mcp?agent=purchase"

同一个登录、同一份凭证,换的只是驱动哪一个。控制台的已连接客户端页会给你每个智能体的专属命令。

任务做完了怎么办

一个智能体的板是长期存在的(领域能力装在它上面),任务做完不是换板,而是收工归档那棵任务树:智能体调用 close_task,板会先检查这件事是不是真的做完了——验收没达到、证据没接地、有未清的覆盖缺口,都会被挡回来并告诉它差什么。挡回来是特性:一个能被"我觉得做完了"糊过去的收工门,等于没有门。

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