SuperAPI AI 工具集

do.organize

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:作为 DeepOrbit 的 Vault Custodian,让整个知识库保持整洁有序。它会分析根目录杂乱、分类混乱、概念重叠、失效链接、孤立笔记和缺失元数据等问题,先给出重组方案,经用户批准后再执行。

主要能力:

  • 根目录卫生:根目录只允许模板定义的编号文件夹、系统目录(.gemini、.agent、.obsidian、.git 等)和配置文件;其余 Markdown 建议移入 00_Inbox/ 或对应编号文件夹,未知文件夹建议合并或归档,媒体移入 99_System/ 或项目文件夹,临时文件建议删除。
  • 结构扫描:运行 python3 scripts/analyze_vault.py 获取 JSON 报告,识别 empty_folders、orphan_files、missing_metadata、ghost_links。
  • 分类审查:依据 99_System/Templates/Vault_Tree_Template.md 检查 40_Wiki、30_Research 等,执行扁平层级与语义优先规则,合并重叠文件夹。
  • 孤立笔记聚类:对 00_Inbox 之外的孤立文件用 deeporbit --vault . rag "<内容>" 找相似位置;00_Inbox 内容不自动 RAG、不自动移动,留给用户手动分诊。
  • 生命周期分诊:deeporbit --vault . status 查看 active/paused/done/archived,done 项建议 /do:archive。

使用方式:先读模板,再跑分析脚本,生成提案(根目录清理、分类合并、孤立笔记、结构健康),用户可全部批准、部分批准或反馈,批准后才执行移动、合并、用 python scripts/update_metadata.py <file-path> --set area=XXX --set tags=XXX 更新元数据、清理空文件夹。

限制:未经用户明确批准不得做结构变更;deeporbit.json 中 readonly.directories 的只读区(如 weread-vault 导出)不得移动或合并;作者信息只写在 frontmatter,不添加可见徽章;创建或修改 Markdown 用 do.obsidian-open 打开,失败不致命。交互语言由 deeporbit.json 决定,Obsidian 文件夹路径始终为英文。