autograph 是一个类型化知识库引擎，宣称“一个模式、一张图谱，适用于任何 Obsidian 库”。它不预设任何领域、类型或路径，而是由代理先从数据中发现结构、构建模式，再对库进行强制校验与维护。所有脚本共享 common.py，零外部依赖，仅使用 Python 标准库，API 调用通过 urllib 完成。
主要用途与能力
工具围绕五个工作流组织。BOOTSTRAP 用于新库、批量导入或首次设置：先运行 discover.py 扫描库并输出枚举候选，再由 generate_schema.py 生成草案模式，并经过代理集群（swarm_prepare.py、Wave 1、swarm_reduce.py、Wave 2）补充分类，人工审核后执行 engine.py init 与 enforce.py --apply 应用模式，随后依次进行链接清理、标签富化、去重、链接富化、MOC 生成，最后用 graph.py health 与 enforce.py 验证，目标健康分 90 以上。HEALTH 用于日常维护：运行 graph.py health 检查分数，低于 90 时排查断链、孤立文件与描述覆盖率，再依次执行修复、MOC 重建、衰减计算与复检。CREATE 用于新建知识卡片：按模式选择节点类型、通过 domain_inference 反查目标目录、写入 frontmatter（描述、标签、状态），并强制添加与领域枢纽及 2 至 3 张同类型同领域卡片的链接，最后执行 engine.py touch。SEARCH & LINK 用于查找信息并强化连接，导航路径为枢纽→链接→目标，最多两跳，并提供孤立文件救援与链接强化。ORCHESTRATE 用于自动化多代理工作流，无需 API 密钥，由 Claude Code 代理直接完成判断。
使用方式
所有命令以 uv run 执行（部分编排命令用 python3）。典型命令包括：graph.py health、graph.py fix --apply、moc.py generate、engine.py decay、engine.py touch、engine.py creative、engine.py stats、graph.py backlinks、graph.py orphans、daily.py extract、engine.py init、enrich.py swarm-links、enrich.py tags、link_cleanup.py、dedup.py、orchestrate.py 等。标签与链接富化需要设置 OPENROUTER_API_KEY 环境变量。默认模型为：tags 使用 google/gemini-3-flash-preview，swarm-links 使用 google/gemini-2.0-flash-001，均可通过 --model 覆盖。项目强调始终先不带 --apply 进行 dry-run，确认后再应用；去重必须在链接富化之前执行；链接富化只使用 swarm-links 子命令，不使用已废弃的 links。
衰减引擎
衰减系统基于艾宾浩斯遗忘模型，包含三个机制：访问次数带来的间隔效应（strength = 1 + ln(access_count)，有效速率 = 基础速率 / strength，相关度 = max(floor, 1.0 - 有效速率 * 天数)）；按领域配置的衰减速率（如 contact 0.005、crm 0.008、learning 0.010、project 0.012、daily 0.020、默认 0.015）；以及渐进式召回（archive → cold → warm → active，每次 touch 只晋升一级，并设置中间日期，避免直接跳到活跃）。无 access_count 的文件默认按 1 计算，无 type 的文件使用默认速率。
适用场景与限制
适用于使用 Obsidian 管理知识、需要模式化校验与图谱健康维护的场景，尤其是新库初始化、批量导入后整理、日常维护、卡片创建与链接强化。限制包括：标签与链接富化依赖 OpenRouter API 密钥；模式生成必须经过代理集群分类，不能仅靠脚本；需要人工审核模式，不能自动应用；编排工作流依赖 Claude Code 代理环境；项目未说明具体定价或商业支持信息；详细效果与性能数据暂未提供。