用途:将现有 Obsidian 库内容或外部文件、文件夹摄入 LLM Wiki,可整理笔记文件夹、摄入单个文件、扫描外部目录、把获准的外部文件归档到受管 raw/,并据此生成 sources、topics、projects、entities、sops 页面。
主要能力与用法:外部文件夹默认采用路径索引模式,流程为扫描、分类、计划、确认、处理已批准项,不直接把外部文件复制进 raw/。单个明确批准的文件可用 payload 模式 archive-import,先预览并确认精确的计划校验和,由 Core 生成 raw/<source-id>/<safe-name> 并在库锁之外暂存、发布,不替换原文件也不删除源。写入前须先解析目标 Obsidian 中控:可用 python "<runtime-script>" root resolve --cwd <working-directory> --format json,首次设置可用 root discover 与 root configure --root <path> --activate --confirm。摄入应用命令为 python "<runtime-script>" ingest apply --root <vault-or-control-center> --payload <file|-> --format json,确认后追加 --confirm --plan-checksum <sha256>;随后用 python "<runtime-script>" doctor validate --root <vault-or-control-center> --format json 验证。运行脚本为 <skills-root>/obsidian-wiki-runtime/scripts/llm_wiki.py,缺失时停止并建议 npx skills add huajiexiewenfeng/obsidian-llm-wiki --skill '*' --copy --yes。
适用场景与限制:适合把外部资料变成 Obsidian 图谱中可发现的页面,生成页面须写入真实控制中心(00-知识库中控/)而非项目工作区。所有写入以图谱优先,每个已批准来源至少有一个 sources/ 下的索引或摘要页,批量摄入须记入顶层 ingest/index.md。读取 PDF、Word、Excel 或大体积目录、处理可疑或敏感文件夹、批量创建页面、广泛修改既有页面、归档外部文件前均须确认。退出码 1 表示预期未执行状态,需读取 JSON 区分待确认与配置缺失。不得直接编辑 .meta 注册表、受管页面区域、ingest/index.md、wiki/index.md 或 wiki/log.md。生成页面不得包含原始秘密值,敏感来源只记录路径、类型、风险与建议。缺失信息暂未提供。