用途:对 Loom vault 进行治理,流程为校验→迁移→连接→演进→索引,适合检查知识库健康、迁移旧库、发现主题连接、生成演进摘要和重建索引。
主要能力与用法: 校验:运行只读健康检查,命令为 python3 ../shared/scripts/scan_vault.py <vault-root> 与 python3 ../shared/scripts/validate_vault.py <vault-root>,输出含阻塞错误与迁移警告的报告;不写文件,需区分阻塞错误与旧版兼容警告。 迁移:先扫描清点目录、按年份/状态统计笔记数、缺失 frontmatter、状态值、仅链接主题、断链与索引情况,再提出分阶段计划(初始化索引、补 frontmatter、按需规范化状态、将部分仅链接主题转为综述笔记、校验链接与索引),仅在用户明确要求写入时执行。默认只读,保留全部内容与未知 frontmatter,优先增量修改,不移动资源。 连接:发现并整理主题笔记间的结构化连接,默认增量模式,仅比较新增/更新主题,跳过已存在于 CONNECTION_INDEX 的组合;支持多视角对照与共享生成器映射。有效连接类型为迁移、混搭、反转,输出到 00_Index/CONNECTION_INDEX.md,最新连接在前。 演进:基于 TIMELINE_INDEX、TOPIC_INDEX、CONNECTION_INDEX 生成月度、季度、年度演进摘要,输出到 03_Content_Output/Longform/ 下对应文件,结构含新增主题、关键发现、知识演进趋势、跨领域连接发现与附录数据;不重新运行连接分析。 索引重建:先试运行 python3 ../shared/scripts/build_indexes.py <vault-root>,写入时加 --write;按标题精确匹配主题并保留行序,索引过程不生成新知识洞察。
限制:默认只读,写入需明确授权;迁移不移动资源;连接不重复已有主题对;演进不重跑连接发现;具体平台、收费与效果资料暂未提供。