虚空传说索引

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install void-lore-index
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 void-lore-index。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

虚空传说索引是面向世界构建项目和角色扮演服务器的正典维基管理器。它会为本地传说资料库中的 Markdown 文件建立索引（包括角色、地点、派系、规则和神器），然后返回相关的、限定在标题范围内的摘录及来源条目 ID，而不是编造答案。它为 Openclaw Skills 带来可靠、有来源支持的连续性工作流程。
条目可以包含 WITH 到期规则，使过时的正典不再影响答案；而保留或经过改写的条目则可在需要时继续发挥影响。该 skill 还可以标记即将到期的正典、帮助查找条目，并向配置的资料库添加新条目。

应用场景

回答有关既定设定细节的问题，例如旅行规则、地点、派系或神器。
检查哪些传说条目支持某项连续性决定，并引用其条目 ID。
在故事或角色扮演环节中使用正典之前，识别已到期或即将到期的内容。
当你知道主题或术语、却不知道相关文件时，搜索大型 Markdown 资料库。
当问题没有匹配的来源时，添加新的传说条目。
使用 retcon 在到期后保留有意设置的例外。

工作原理

配置该 skill，指定 Markdown 传说文件所在目录的路径。
运行 index，从资料库建立或重建可搜索索引。
回答连续性问题前，如果资料库可能已更改，请运行 vacuum；使用 status 查看即将到期和已到期的 WITH 规则。
使用 ask 提交问题，或使用 search 查找候选条目。匹配采用词汇匹配，并对标题、标签和正文文本进行加权。
仅返回 ask 提供的摘录，标明其条目 ID，并说明来源是否已到期或已保留。如果没有匹配项，请如实说明，不要猜测。
使用 get 获取完整条目，使用 add 向配置的资料库写入新条目，或使用 retcon 在条目到期后保留其影响力。

配置指南

确保 python3 可用。
设置资料库目录并建立索引：
L=~/.openclaw/plugin-skills/void-lore-index/lore_index.py
python3 $L config --vault ~/lore/my-universe
python3 $L index
可选：通过 config 选项配置当前篇章、摘录大小、top-k 结果数、limbo 天数和字符预算等设置，包括 --arc、--excerpt-chars、--top-k、--with-limbo-days 和 --token-budget。
使用 --json 获取结构化命令输出。使用 vacuum 刷新索引，以重新扫描资料库并检查 WITH 状态变化。

数据架构

资料库可以是任何包含 .md 文件的目录；支持子目录。索引器会读取 frontmatter 和行内 WITH 注释。条目元数据示例：
title: Sector 4 Travel
tags: travel, sector-4, FTL
with: arc-4
stamp: 2026-03-01
influence: retained
字段或规则 用途
title, tags 提供可搜索的名称和主题元数据。
with 设置到期规则；也可以行内形式 [[WITH: arc-4]] 出现。
stamp 作为按时长计算到期时间的基准；若未提供 stamp，则使用文件修改时间。
influence: retained 使条目在到期后仍具影响力，包括软规则。
arc-4 当配置或资料库声明的篇章超过 4 时到期。 90d, 2w, 36h 从 stamp 或文件修改时间起，在指定时长后到期。 on 2027-01-01 设置固定的日历到期日期。
~90d 标记软到期；除非影响力设为保留，否则不会纳入答案。
无法解析的 WITH 规则会标记为 unknown，不会被悄悄丢弃。索引和配置状态存储在 ~/.openclaw/void-lore-index/index.json 和 ~/.openclaw/void-lore-index/config.json。除使用 add 时外，skill 对资料库文件仅有只读权限；add 是唯一会向配置的资料库写入新条目的命令。retcon 会更改索引状态，而不是用户的文件。

高级特性

支持基于篇章、时长、固定日期和软 WITH 规则的到期正典管理。
vacuum
会重新扫描资料库，并报告新增、移除或发生变化的 WITH 状态。
status
会突出显示即将到期和已到期的条目；默认 limbo 窗口为 7 天。
retcon
会使条目在 WITH 到期后继续具有影响力， --clear 可清除这种处理状态。
ask
会在可配置的字符预算内返回限定在标题范围内的摘录；尽管设置名称为
token_budget
，限制单位实际为字符。
search
可通过 --expired 纳入已到期条目，而
get
可获取完整条目及其 WITH 状态。
stats
会汇总资料库计数、WITH 状态、保留条目和解析错误；命令也支持结构化的 --json 输出。
匹配采用词汇方式而非语义方式，因此请使用资料库中的术语，或搜索候选 ID。摘录不够充分时，请使用
get
。

name: void-lore-index description: > Lore & universe wiki keeper for world-building / roleplay servers.
Indexes a local markdown lore vault (characters, places, factions,
rules, artifacts) and answers canon questions with sourced excerpts —
"What are the rules of travel in Sector 4?" returns the actual canon
text, never a guess. Entries can carry WITH expiry rules (retire at
arc N, or N days/weeks after their stamp) so superseded canon stops
influencing answers; retcon marks keep deliberate exceptions alive.
user-invocable: true