Runex

命令行速览（想亲眼看看？） ​

这一页是可选的

平时你不用碰命令行——你只跟 Agent 说话。但如果你想亲眼确认"我的数据到底存哪了、都记了些啥、它背后做了什么"，下面这些命令给你这份安全感。

它们几乎都是只读的：你能看，但看不动数据。而且——你看到的，正是 Agent 在后台用的同一套界面，没有黑盒。

数据在哪、还好吗：runex doctor ​

最该先看的一条。它告诉你东西存在哪个文件里、有多少：

text
$ runex doctor
Runex v0.1.0
数据目录   ~/.runex/
数据库     ~/.runex/data/data.db   (本地 SQLite，一个文件)
对象       128 个 · 关系 64 条 · 事件 412 条
本体       core-memory + pkm + time + wiki-links  (17+ 类型)
状态       ✓ 一切正常

看到那个 .db 文件了吗——那就是你的全部数据，在你自己电脑上。想备份，拷走它就行。

都有哪些对象类型：runex schema ​

text
$ runex schema
内置对象类型（节选）
  Person 人     Client 客户    Organization 公司
  Project 项目  Task 任务      Goal 目标      Sprint 冲刺
  Thought 想法  Note 笔记      Document 文件
  Deal 交易     Product 产品   …

$ runex schema Task
Task 任务
  字段   标题 · 状态 · 计划日期 · 优先级 · 正文
  状态   open → in_progress → done   (也可 cancel)

搜一搜、看一个：search / query / inspect ​

text
$ runex search "客户"
Task     给客户发方案            计划 2026-06-26
Thought  张总：预算卡在财务      2026-06-20

$ runex query --tag Task            # 列出某一类
$ runex inspect node "给客户发方案"  # 看一个对象的全部细节
Task  给客户发方案
  状态     open
  计划日期  2026-06-26
  创建于    2026-06-23 · 来源 capture

它都做过什么：runex ontology events ​

每一次创建、修改、状态跃迁都记在事件日志里，可回溯、可重放——这是它"不黑盒"的底气：

text
$ runex ontology events --limit 5
2026-06-23 09:12  created  Task    给客户发方案
2026-06-23 09:30  created  Thought 认知负荷理论…
2026-06-22 23:55  ran      close_sprint  W25 → closed

一个对象能走哪些状态：runex state ​

text
$ runex state Task
open ──→ in_progress ──→ done
   └────────────────────→ cancelled

装好了吗 / 还能干啥 ​

text
runex --version      # 看版本
runex --help         # 列出所有命令
runex <命令> --help   # 某个命令的用法

关于"动数据" ​

上面都是只读的。真正的修改，日常都交给 Agent——它会先预览给你看、确认了再写，不会闷头改。

如果你愿意，也能手动改（runex node create / runex node update），但绝大多数时候没必要——对 Agent 说人话更省事。

一句话总结

Agent 在后台跑的，就是这套命令。你随时能用同样的命令亲自看一眼——数据在你手上，过程看得见。