Runex 使用指南

Runex 是一个 Agent-Native Ontology Runtime：把你经营中的每个元素（任务、客户、规则、Agent、笔记）变成强类型、事务一致的图，人和 Agent 共享同一份持久事实。装好即最小可用，不需要配置服务器、数据库或任何第三方服务。

你能用它做什么

• 统一事实：让所有 Agent 和程序共享同一份最新事实，换会话、关窗口、换 Agent，状态都不会丢。
• 定义规则：将人、项目、目标等信息组成刚性约束，每件事都有明确的进度状态，状态之间定死了流转的规矩——把交代给 AI 的”口头提示词”变成 100% 确定执行的铁律。
• 全自动化：后台 Worker 常驻执行，状态一变，WorkItem / Proposal / 下游更新自动级联，无需人工介入。

信任信号

• 全程本地运行，数据不上云：图数据库和所有数据都在你的电脑上，没有第三方能看到。
• 装了就能用：不需要配置服务器、数据库或任何第三方服务。runex init && runex doctor 一条路走到底。
• 开源：核心引擎 MIT 开源。

快速开始

如果你已经拿到安装包，直接看：

→ 安装教程

装完以后：默认就绪

装完即最小可用，不需要任何额外组件：

1. runex init —— 建库 + 加载引擎系统 ontology（11 个模块：WorkItem / Agent / Proposal / ObsidianNote …）。三个平台的安装脚本都会自动执行（幂等，可安全重跑）
2. 唯一 skill —— install.sh / install.ps1 已把 runex skill 部署给 Claude Code / Codex / OpenCode / OpenClaw，Agent 打开即会用
3. 极简基座 —— 业务类型（Task / Person / CRM）、Obsidian 连接、vault 均不预设。需要时按需配置：runex ontology load <file>、runex connection configure、runex vault bind（详见 runex skill 教程）

日常使用

直接对 AI 说话：

记一下，周四给王总发合同大纲。
今天该做什么？
规划本周。
把我最近关于知识管理的想法提炼一下。

AI 会自动把指令写成图里的节点，并在后续所有会话里保持状态一致。换会话、关窗口、换 AI，状态不会丢。

文档与帮助

• 安装教程 —— 从 zip 包到可用（macOS / Windows / Linux 全流程）
• 快速上手 —— 5 分钟建第一个模型（见 guide 目录）
• 教它你的业务规则 —— 自定义类型与规则（见 guide 目录）

系统要求

通用：已安装 Claude Code / Codex / OpenCode / OpenClaw 中的至少一个。