第 1 篇：写一条笔记，它自己就动了

先看一个画面

第 1 期你装好助理，第一次让它整理笔记、替你回一段话，爽到了。

但用上几天，你会撞到一件扫兴的事:它只在你开口的那一刻活着。

你在 Obsidian 里随手记一句”下周跟进老王的合同”，然后呢?然后它就躺在那当一行死字。除非你哪天翻到、且刚好想起来要处理，否则它永远只是一行字。你不问，它不动;你一天不喊，它就像尸体一样躺一天。

说白了，第 1 期给你的是一只召唤兽——你喊，它才出来。

而这一期要把它换成员工——员工不用你天天盯着喊。

这一篇只做一件事

今天不聊任何原理。我们只做一个动作，然后盯着它自己发生:

你在 Obsidian 里写下那行字、按保存 —— 不用你再点任何按钮 —— 它自己被认成一个任务、进了待办、有一个 agent 开始替你往前推。

跑通这一个，你就懂了这一期的全部。

动手:5 步跑通

先跑通，别停下来纠结每一步为什么。原理第 2 篇补。

1. 装 runex

下载对应平台的包，解压，跑安装脚本(macOS 为例，Windows 见文末附录):


unzip runex-macos-arm64.zip
cd runex-macos-arm64/
./install.sh

验证一下装好了:


runex --version
runex doctor        # 全绿就行

下载地址:https://github.com/runex/runex/releases

2. 接上你的 Obsidian

装 Obsidian pack，然后在你的 agent 里跑一次接入向导:


bash extensions/packs/obsidian-assistant/install.sh


> /obsidian-onboard

跑完，你的整个 vault 就被接进来了——runex 托盘会在后台保持同步，你在 Obsidian 里改一个字，它这边立刻知道。

3. 让引擎”学会”任务这个词

刚接进来的时候，引擎只把你的笔记当”文件”看。要让它认得出”这是一个任务”，先给它加载一套业务词汇:


runex scm add business

这一步就是告诉引擎:以后看到 type: [[Task]] 的笔记，按”任务”来对待——它会自动追踪、按生命周期往前推。

4. 配一个干活的 agent

引擎负责”认出任务、派活”，真正动手干的是 agent。把你已经在用的 agent(比如 Claude)注册进来:


runex agent register agent-claude \
  --command claude \
  --capabilities code,plan,search \
  --approval-policy direct_when_low_risk \
  --low-risk-ops upsert,add_link

注册好之后，引擎派出来的活会自动落到这个 agent 头上。

5. 回 Obsidian，写下那条笔记

现在，回到 Obsidian，新建一篇笔记，顶上写这几行 frontmatter，正文写你想干的事:


---
type: [[Task]]
---
 
下周跟进老王的合同，把上次的报价单更新一版发过去。

按保存。 然后——什么都别做。

见证时刻

回到终端，看引擎那边发生了什么:


runex agent inbox --unread          # 看有没有新派出去的活
runex agent messages <run_key> --follow   # 盯着 agent 一步步在干什么

你会看到:这条笔记被认成了一个任务、生成了一个不会丢的工作项、被 agent 认领、然后开始处理——全程你没点过任何一个”开始”按钮。

刚刚发生了什么

就一句话:你”写下”这个动作本身，就是信号。

你不需要去哪里点”运行”。引擎一直在听;你保存笔记的那一瞬间，它接住信号 → 建了个持久化的工作项(哪怕这时断网、关机也不会丢)→ agent 认领 → 干活。

这就是所谓的 reactive(响应式)。它怎么”听”、怎么把 frontmatter 变成能追踪的状态——第 2 篇细拆。这一篇你只要记住四个字:

写，就是触发。

再变一个:关掉窗口，它还在跑

如果你还没被上面那下震到，再试一个:

写完笔记、看到活派出去之后，直接把终端关掉、甚至合上电脑。 过一会儿再回来:


runex agent messages <run_key>

活照样干完了。因为那个工作项是落在磁盘上的，不是吊在你那次对话里的——后台 worker 会自己认领、自己续跑。

这一点，正是第 1 期那只”召唤兽”死活做不到的:你一关窗口，它就断了。而现在，它是个下了班还在把活干完的员工。

卡住了看这里(附录)

Windows 安装:


Expand-Archive runex-windows-amd64.zip
cd runex-windows-amd64
pwsh install.ps1

runex doctor 不全绿: 大概率是某个连接没接上，按它给的提示逐条处理;实在不行，runex connection list 看看哪条源是红的。

写了笔记但没派活:

确认 frontmatter 里是 type: [[Task]](双方括号别漏)
确认第 3 步 runex scm add business 跑过了
确认第 4 步的 agent 在:runex agent list 看它是不是 available

要求: macOS 13+(Apple Silicon)或 Windows 10+(x64)。

你可能已经在犯嘀咕:它凭什么看一眼 type: [[Task]] 就知道这是任务、还知道”下一步该干嘛”?

第 2 篇就拆这个——你笔记顶上那几行 frontmatter，是怎么变成引擎能理解、能追踪的”状态”的。从那以后，你和 AI 看的，是同一份事实。