SuperAPI AI 工具集

wiki-canvas

数据与分析

查看项目

更新于 10-16 09:57

技能介绍

用途:为用户的知识库(vault)生成可视化的结构地图,适合想查看库结构、页面连接关系,或在大量导入与重构后获取更新概览的场景。

主要能力:先运行 skillwiki graph build <vault> 在 <vault>/.skillwiki/graph.json 生成邻接图;再运行 skillwiki canvas generate <vault>,读取 graph.json 并写出 <vault>/vault-graph.canvas。完成后可向用户报告节点数、边数与输出路径。节点按类型分列:entities(红)、concepts(绿)、comparisons(橙)、queries(青)、meta(紫),未分类页面在 comparisons 列显示为黄色;边表示 wikilink 连接。

使用方式:在 Obsidian 中打开库文件夹,点击文件浏览器中的 vault-graph.canvas,或用 Quick Switcher(Cmd/Ctrl+O)搜索 vault-graph;点击节点可跳转源页面,可拖拽重排,缩放平移以浏览大型库。最后在 log.md 追加一条记录(节点/边数)。

需重新生成的时机:wiki-ingest 新增页面后;wiki-reingest 或 wiki-archive 改变或删除页面后;手动重构库目录后;运行 wiki-lint 并修复结构问题后。画布过期无害,但不会反映新增或删除页面。

限制与停止条件:graph build 返回非零退出码需先排查;graph.json 缺失或无效时画布命令会报错,应提示先构建;用户取消则停止。禁止手工修改生成的 vault-graph.canvas(应重新生成);库已变化时禁止不重建 graph.json 就直接生成画布;禁止在未生成替代文件前删除旧画布。另有预读四项(SCHEMA、index、log、项目上下文)与基础库路径解析步骤。未来可能增加 Obsidian Bases 表格视图,目前画布是主要可视化方式。