用途:当用户提供 URL、粘贴内容或本地文件,需要将其捕获进知识库(vault)时启用,产出类型化知识页面。
主要能力:
- 将来源登记为目标类型实体页、概念页、对比页或查询页。
- 通过 skillwiki ingest 进行确定性原始捕获,并委托共享发布器生成类型页、分类法、索引与结构化日志条目。
- 支持批量模式:对目录文件、URL 列表或多文档逐项处理,逐个执行一次 ingest 命令。
- 去重:同一来源内容已存在时跳过,原始捕获保持不可变。
使用方式与关键步骤:先运行 skillwiki path 与 skillwiki lang 解析知识库路径和输出语言;对每个 URL 运行 skillwiki fetch-guard <url>,非零则停止;用 web_fetch 抓取或读取本地文件;粘贴文本需先暂存为临时文件再传入命令: skillwiki ingest <staged-paste-path> --vault <resolved-vault> --type <entity|concept|comparison|query> --title "<title>" --tags "<tag1,tag2>" --provenance <research|project> 发布前运行 skillwiki page publish --help 做能力探测,不可用则失败关闭。页面正文、摘要使用解析出的语言,frontmatter 键、文件名、结构行、引用标记和 wikilink slug 保持英文。默认 provenance 为 research;若在 projects/{slug}/ 内则设为 project。
适用场景:把网页、文件和粘贴内容整理为带出处的结构化知识页面,并按批次批量入库。
限制与停止条件:fetch-guard 非零、抓取超时或超出大小限制、身份冲突(INGEST_VALIDATION_FAILED 且 source identity conflict)、来源或生成内容含未脱敏的凭据或密钥、发布功能不可用、ingest 返回非零、同源 sha256 已存在时停止。禁止跳过 fetch-guard,禁止直接创建最终类型页或编辑 index.md/log.md,禁止修改 raw/ 已有文件,禁止把原始临时数据写入云挂载的 wiki 路径,禁止链接不存在的页面。发布失败时保留原始捕获与命令输入以便重试。