SuperAPI AI 工具集

llm-wiki

通用与其它

查看项目

更新于 10-16 06:50

技能介绍

用途:让 AI 通过本地 HTTP JSON API 查询用户正在使用的 LLM Wiki 桌面应用(127.0.0.1:19828),不是 Obsidian、Notion、Apple Notes、Logseq 等其它知识工具。仅当用户以应用名、wiki 或知识库措辞明确指向 LLM Wiki 时才调用;若用户只说“搜索我的笔记”,应先与用户确认,不要默默调用该 API。

主要能力:列出项目;浏览 wiki/sources 文件树;读取文本文件内容;关键词或向量/混合检索(POST search,含 path、title、snippet、score、vectorScore);读取 wikilinks 关系图谱;触发 sources 重新扫描索引。chat 端点在 v1 未实现(501)。除 rescan 外均为只读,v1 无写入端点。

用法:用环境中已有的 HTTP 工具直接调用,无需安装 SDK。先探测无鉴权的 GET /api/v1/health,再带 Bearer token 调用其它端点。项目 id 可用 current、UUID 或 URL 编码的绝对路径;按名称需先 GET /api/v1/projects 匹配。常用命令示例:curl -s $BASE/api/v1/health;curl -s -H "Authorization: Bearer $TOKEN" $BASE/api/v1/projects;搜索用 POST /api/v1/projects/current/search,body 为 {"query":"rope embedding","topK":5};读页面用 GET /api/v1/projects/current/files/content?path=wiki/concepts/rope.md;图谱用 GET /api/v1/projects/{id}/graph。

鉴权与限制:仅限本机;token 来自 LLM_WIKI_API_TOKEN 环境变量、设置中保存的 token 或用户显式开启的免鉴权模式。若未配置鉴权,需提示用户在 Settings → API Server 生成 token。不要记录或输出 token。常见限制:文件内容仅支持文本,最大 2 MB;文件树有节点上限;请求体上限;全局速率限制 120 请求/秒,超限退避至少 1 秒;503 表示 API 被关闭或并发上限;连接失败说明桌面应用未运行,应提示用户启动 LLM Wiki。回答时应引用所读页面路径,默认只读,不臆造写接口。

适用场景:用户问“我的知识库/LLM Wiki 里关于 X 的内容”、按页面标题读取或交叉链接、查看知识图谱与结构、新增文档后重新索引。其它个人笔记工具或通用网络检索不适用。