管家阿福 · Afu

中文 | English

LLM Todo for Obsidian agents

Inbox -> Wiki -> Todo Card -> Calendar

Fork 改动记录： 个人 fork 相对上游 v1.3.4 的完整差异

演示视频

_{▲ 点击海报播放演示视频（GitHub README 不渲染外链 video 标签，所以用海报直链）}

事情是这样的。

我自己的 Obsidian 里，收件箱经常不是没有东西，是东西太多了。网页、帖子、论文、灵感、项目记录，全都在里面。真要开始做事的时候，反而会卡住。

普通 Todo 只能催你一声，告诉你还有一件事没做。

但很多时候，真正难的不是执行，是先从一堆材料里判断，哪几件事值得进入这周。

所以才有了管家阿福。

它不是来替代 Obsidian 的，也不是又一个任务管理器。它更像站在 Vault 门口的管家，先把收件箱里的材料整理成 Wiki，再把 Wiki 里已经长出来的判断，变成可以排进日历的待办卡。

Inbox -> Wiki -> Todo Card -> Calendar

安装给 Agent 用

如果你的 Agent 支持 Skill 安装，优先用这个方式：

npx skills add LearnPrompt/afu-llm-todo

安装后，把需求直接交给 Agent：

用管家阿福整理我的 Obsidian 收件箱，先编译 Wiki，再给我生成这周的待办卡。

触发方式

装完之后,这些话都能唤醒阿福:

• "整理我的 Obsidian 收件箱"
• "每天提醒我处理 Obsidian 收件箱"
• "把 inbox 这批资料编译成 Wiki"
• "从 Wiki 给我生成这周的待办卡"
• "把待办卡排进周历"
• 甚至只是:"我的 Obsidian 堆了一堆没处理的东西"

它不会接的活(免得抢错戏):非 Obsidian 的普通待办清单、改写润色你的笔记原文、Notion 类非 Markdown 知识库。

每日提醒怎么用

阿福也适合做一个很轻的每日收件箱提醒。

每天 23:30 提醒我处理 Obsidian 收件箱。先检查 `00_收件箱/YYYY-MM-DD/` 这个当天日期目录,再看今天修改的自动投递和候选选题;不要只靠文件修改时间,也不要把历史残留说成今日新增。如果今天没有新增,就明确告诉我。再单独列出历史 backlog,挑 3-5 个最值得处理的候选,说明它们应该保留、编译进 Wiki、生成待办卡,还是先等我判断。没有我确认时,不要删除、移动或改写原文。

它不只是喊你“该整理了”,而是每天把 inbox 里最该动的几件事捞出来,让你从判断开始,不是从翻箱倒柜开始。

想先看 UI

Demo 跑在 sample vault 里，你自己的笔记先原地不动。

git clone https://github.com/LearnPrompt/afu-llm-todo.git
cd afu-llm-todo
npm install
npm run demo:reset
npm run demo

打开：

open http://localhost:4317

你会看到三条 sample 素材。把它们送进 Wiki，生成待办卡，再拖进周排期。

不需要跟我一模一样的 Vault，你可以随便改

默认 sample vault 用的是这几个目录：

00_收件箱
30_研究/内容Wiki
15_自媒体/选题库

但这只是示例。

你自己的 Vault 可以叫别的名字。阿福真正需要知道的只有三个位置：

• 粗素材在哪里
• Wiki 写到哪里
• 待办卡写到哪里

剩下的路径，都可以在配置里改。Markdown 还在你的本地，阿福只是帮 Agent 找到入口和写回位置。

工作原理

阿福不是直接把收件箱里的每条东西都变成任务。

它先做一次中间整理。

Inbox
  -> Wiki packet
  -> Markdown Wiki
  -> Todo Card
  -> Calendar

这一步很关键。

因为收件箱里的东西通常是乱的。一个链接里可能只有半个观点，一段摘录里可能只有一个线索，一个项目记录里可能藏着真正要做的下一步。

阿福会先把这些材料放进 Wiki 语境里，让 Agent 有地方沉淀判断。等 Wiki 里已经能看出方向了，再生成待办卡。

所以它不是在帮你多列几个任务。

它是在帮你把资料变成能动起来的东西。

安全边界

阿福是管家,不是主人:

• 收件箱原文永不改写——它只移动、归档、编译,不动你写的字;
• 只写三类位置:Wiki 目录、待办卡目录、操作日志;不碰 vault 里其他任何文件;
• 每一步落日志:导入、排期、作废、Wiki 编译都有记录,出错可以照日志回滚;
• 写入前确认:待办卡入库需要你点头,不会先斩后奏;
• 本地优先:Markdown 是唯一真源,不引入外部数据库,第一版不强制外部 LLM API Key。

背后故事

这个项目一开始不是为了发布。

它只是我自己在 Obsidian 前面补的一层小工具。因为我真的经常遇到一个问题，收件箱里明明有很多好东西，但每次要排这一周的时候，还是得从头翻一遍。

翻着翻着就累了。

后来 Karpathy 提到 LLM Wiki，我一下子觉得这个方向很对。资料不应该永远躺在收件箱里，也不应该每次都靠临时搜索重新理解一遍。更好的方式，是让 Agent 把它们整理成一个会生长的 Wiki。

参考：https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

再往前走一步，Wiki 不应该只是被查询。

它应该长出行动。

这就是 Afu。

---

更多好用 Skill · More Skills → learnprompt.pro/skills

鲁班·Skill打磨 · 庖丁·博主蒸馏 · 蔡伦·对话造纸 · 阿福·LLM Todo · 愚公·Loop工程 · 搭子·结对开发 · AI雷达·零API资讯

淘金小镇·ClawHub日榜 · Irasutoya·正文配图 · Humanize PPT·演讲系统 · CC Harness·六件套 · 微信读书教练 · X Article发布

_{LearnPrompt 出品 · 公众号「卡尔的AI沃茨」 · X @aiwarts}