SuperAPI AI 工具集

curator

通用与其它

查看项目

更新于 10-16 01:19

技能介绍

curator 是 Lumen 的操作层:把记忆源记录整理为保守的 Markdown 维基更新,并检查维基的结构性退化。它不调用模型提供方、不删除页面,也不覆盖运维者已确认的事实。方法论(OKF frontmatter、摄取/查询/lint 流程)见 lumen:wiki,本技能是 CLI 与适配器层。

用途:把近期记忆摄取进维基(run)或预览摄取(report);lint/validate 维基结构;按关键词、别名或标签搜索页面;配置 curator 读取的记忆源。

维基路径解析顺序:--wiki 覆盖、插件配置 paths.wiki_path、$WIKI_PATH、默认 ~/wiki。配置文件默认 <plugin>/shared/config/lumen.yaml,可用 --config 或 LUMEN_CONFIG 覆盖。memory_source 可取 sessions、auto、json-file、mnemosyne、none;auto 在存在可读 Hermes state.db 时优先用会话历史。

适配器 scripts/adapters.py 是只读记忆边界,输出 SourceItem(source_id、source_kind、title、text、timestamp、tags、people、entities、projects、raw),不回写记忆存储。记录缺 id 时按内容派生 id(memory_<摘要>)。

CLI 用系统 python3(stdlib + PyYAML)运行: CURATOR="${HERMES_SKILL_DIR}/scripts/wiki_curator.py" python3 "$CURATOR" run --since 24h python3 "$CURATOR" report --since 7d python3 "$CURATOR" validate # ERROR 时退出码 1 python3 "$CURATOR" lint --summary python3 "$CURATOR" search "Acme" --format json --limit 10 --since 接受 90m、24h、7d、2w,其他值为用法错误(退出码 2)。lint、validate、report、search 只读;run 写入,run --dry-run 预览;从不删除页面。

保守写入策略:仅从源项创建/更新人物、项目、实体、日报页面;保留运维者确认的事实;新增观察带 [source: id];只刷新 index.md 与 overview.md 的自动标记块,追加 log.md;文本被压成单行并中和 [source:、[[、行首 #;不覆盖已有页面标题或 created 值;frontmatter 无法解析的页面按字节保持不变并在报告中提示,下次修复后重试;默认每次最多处理 20 个源项(curator.max_write_pages,0 或负数取消上限);大批量(>5 项)前把维基树备份到 <wiki>/.lumen/backup/<timestamp>/。

OKF v0.2:每个页面需可解析的 YAML frontmatter 且 type 非空。Lint 检查缺失或格式错误的 frontmatter(ERROR)、缺 type(ERROR)、断开的 [[wikilinks]](WARN)、重复标题(WARN)、未出现在 index.md 的页面(WARN)、无入链孤儿页(INFO)、超过 90 天未更新(INFO)。文件名用小写连字符 ASCII slug;非 ASCII 名称回退为 untitled-<sha256 前 8 位十六进制>.md,跨运行稳定。常见陷阱包括跳过定位文件、未搜索就建重复实体页、直接把原始笔记当整理知识、缺 frontmatter/type、页面未加链接。验证清单:确认维基路径解析顺序、memory_source 与主机安装匹配、变更前先看 run --dry-run、lint 报告路径与严重级别、查询答案引用维基页面。