SuperAPI AI 工具集

llm-wiki

写作与研究

查看项目

更新于 10-16 07:15

技能介绍

用途:把来源材料整理为互链的 markdown 知识库,而非每次查询重新检索。知识一次编译、持续维护,交叉引用与矛盾标注已就位。分工为人类选源并指引分析,智能体负责总结、互链、归档与一致性维护。

结构:三层。SCHEMA.md 定义约定与标签分类;index.md 为带一句话摘要的分节目录;log.md 为追加式操作日志。raw/ 存放不可变的原始来源(articles、papers、transcripts、assets),entities、concepts、comparisons、queries 为智能体维护的 wiki 页面。

路径:由 WIKI_PATH 环境变量设置(如 ${HERMES_HOME:-~/.hermes}/.env),未设置时默认 ~/wiki,即 WIKI="${WIKI_PATH:-$HOME/wiki}"。wiki 只是 markdown 文件目录,可用 Obsidian、VS Code 或任意编辑器打开,无需数据库或特殊工具。

恢复既有 wiki:每会话先读 SCHEMA.md 了解领域与标签分类,再读 index.md 了解已有页面,最后读 log.md 最近 20-30 条了解近期活动;之后才进行 ingest、query 或 lint。大 wiki(100+ 页)新建前先 search_files 搜查主题。

初始化新 wiki:确定路径、创建目录结构、询问领域、按领域定制 SCHEMA.md、写初始 index.md 与 log.md,然后确认可用并建议首批来源。

核心操作:ingest 抓取原始来源(URL 用 web_extract 存 raw/articles/;PDF 存 raw/papers/),加 source_url、ingested、sha256(仅对正文计算)等 frontmatter,重复摄入时比对哈希以跳过或标记漂移;随后与用户讨论要点、检查已有页面、按阈值创建或更新页面(每个新页至少 2 条 [[wikilinks]] 外链、只用分类中的标签、综合 3 个以上来源时加溯源标记、按需设 confidence),更新 index.md 与 log.md 并报告改动。query 时先读 index.md 定位相关页,大 wiki 再 search_files,综合答案并引用页面,值得保留的结果存入 queries/ 或 comparisons/。lint 检查孤立页、断链、索引完整性、frontmatter 必填字段与标签合法性、过期内容、矛盾、质量信号、来源漂移、页面大小(超 200 行建议拆分)、标签审计与日志轮换,并按严重度分组报告。

阈值与更新:实体或概念出现于 2 个以上来源或对单一来源至关重要时才建页;新信息冲突时先比日期,真正矛盾则记录双方并加 contradictions frontmatter,在 lint 中提请人工复核。index.md 某节超 50 条时拆分子节,总计超 200 条时建 _meta/topic-map.md。log.md 超 500 条时轮换为 log-YYYY.md。归档时移入 _archive/ 并保留原路径,从 index 移除,将指向它的 wikilink 改为纯文本加“(已归档)”。

批量摄入:先读完所有来源,统一识别实体与概念,一次搜索、一次创建更新,最后只更新一次 index.md 并写单条日志。

Obsidian:该目录可直接作为 vault,[[wikilinks]] 可点击,Graph View 可视化网络,YAML frontmatter 支持 Dataview;建议把附件目录设为 raw/assets/,启用 Wikilinks,安装 Dataview 以进行如 TABLE tags FROM "entities" WHERE contains(tags, "company") 的查询;若同时使用 Obsidian 技能,将 OBSIDIAN_VAULT_PATH 设为同一目录。无显示环境可用 obsidian-headless,需 Node.js 22+:npm install -g obsidian-headless,随后 ob login --email <email> --password '<password>'、ob sync-create-remote --name "LLM Wiki"、cd ~/wiki、ob sync-setup --vault "<vault-id>"、ob sync 完成设置与同步。

激活时机:用户要求创建或启动 wiki/知识库、把来源摄入 wiki、在配置路径存在 wiki 时提问、要求 lint 或审计健康状态、或在研究语境中提及 wiki、知识库、笔记时。

限制:资料未提供具体价格、支持的模型、性能指标、平台兼容性细节,也未提供独立安装命令或官方托管服务信息。