texo:个人知识库编译器
Karpathy LLM-Wiki 模式的个人生活版:用户随手记录的碎片落进 raw/,本技能把它们增量编译成互相链接的 wiki(概念 / 观点演变 / 决策 / 实体页),并提供问答、召回、回顾等读取操作。全部纯 markdown。
用法:先路由,再读文档
本技能是一个入口 + 九个操作。确定操作后,先完整读取对应的 references/<操作>.md(与本文件同目录),再按其步骤执行——本文件只负责路由和公共规则,不含操作细节。
| 操作 | 何时用 | 文档 |
|---|---|---|
import |
存量导入:Apple Notes(macOS 直读)或任意 .md/.txt 文件夹 → raw | references/import.md |
ingest |
预处理新 raw:补转写、图片描述+OCR、抓收藏链接全文 | references/ingest.md |
compile |
核心:把新碎片织进 wiki,维护别名、互链、观点演变 | references/compile.md |
lint |
健康检查:矛盾、断头线索、孤儿页、冲突副本 | references/lint.md |
answer |
用户主动问自己的记录("我去年对 X 怎么想的"),带引用回答,可归档 | references/answer.md |
recall |
执行其他任务时自调用:只读召回用户在相关话题的既有立场,补进上下文 | references/recall.md |
review |
月度/年度回顾 + 可分享卡片数据 | references/review.md |
profile |
生成 Texopedia 主页(wiki/profile.md):关于用户的 Wikipedia 式概览 | references/profile.md |
watch |
设置/管理自动编译(launchd / cron / systemd / agent 内置定时任务) | references/watch.md |
分不清 answer 和 recall:用户开口问 → answer(产出给人读、带引用、可归档);你在干别的活需要用户立场 → recall(只读、产出紧凑上下文、不归档)。
辅助文件(部分操作会用到,均在本技能目录下):
scripts/recall.py— tool_search 同构的页面匹配器(recall 检索 + compile 收尾的reindex);scripts/recall-hint.sh— SessionStart hook 模板(安装到~/.texo/);runtime/— watch 模式的无人值守脚本(只复制,不重写)。
公共前置(所有操作)
- 定位 Texo 文件夹:用户指定路径 →
~/.texo/lib文件内容 →$TEXO_DIR→~/Library/Mobile Documents/iCloud~com~mallorb~texo/Documents/Texo→~/Texo(判据:含schema.md+raw/);找不到就停下询问; - 通读库里的
schema.md——它是这座库的宪法,含文末用户个人偏好,必须遵守(recall 为省 token 可跳过,见其文档)。
公共红线(所有操作)
raw/不可变:任何操作都永不修改 raw 原文件(生成物只能是 sidecar:.desc.md、.transcript.md);- wiki 历史只追加不抹除;观点变化写入演变段,不覆盖旧立场;
- 每个论断必须带
[来源](raw:id)或[[页]]引用;库里没有就明说"你没记录过",禁止用世界知识补完关于用户的事实; - 页面是关于用户的(他的想法、决定、遇到的实体),不是资料摘要库。