用途：当用户问“我关于 X 知道些什么”“在 wiki 里找 Y”，或在外部检索前先查本地知识库时，用 ws-search 在用户的 wiki 中定位内容并仅依据已存资料作答，引用页面便于跳转，并明确说明 wiki 未覆盖的主题，不以额外知识填充答案。
主要能力：解析 wiki 结构（以 index.md 的 ## Spaces 为导航契约，空间可递归嵌套，普通文件夹仅做分组），按“用户显式路径 → 最近的 CWD 祖先 wiki → ~/.config/wiki-spaces/config 中的 wiki 键”顺序解析根目录；提供只读、零依赖的 Python3 脚本 scripts/ws.py，含 list（列出契约可达空间及描述）、files（列出可达 Markdown 文件）、grep（正则行搜索，-i 忽略大小写、-F 字面量，无匹配退出码 1）、check-size（按 UTF-8 字节上限检查文件，可 --stdin 预检）、audit（检查契约漂移、越界条目、超限或不可读文件、挂载问题）。默认可读写本空间，跨“自有”空间读取，进入 shared/、子模块或符号链接等外部空间需用户明确要求。
使用方式：以绝对路径调用脚本，例如 python3 <skill-dir>/scripts/ws.py list --wiki <root>；先 list 与 files 摸清结构，再按查询匹配空间标签、描述、文件名与路径；结构不足时优先用可用的 markdown 检索后端，回退到 grep，读取靠前的 2–4 个完整页面，逐条以 [[path/to/page]] 引用作答；若存在 log.md，每次操作追加一行日志。
适用场景与限制：适用于本地知识检索、预研究探测和“快速查一下”类问题（仅按名称/摘要作答）。脚本只解析结构不判断语义，读与判断由使用者完成；信任范围与大小纪律（index.md 5000、log.md 与 hot.md 100000、其他 .md 15000 字节，可由 _meta/limits.md 覆盖）需遵守，禁止截断或抬高上限，超限日志应归档到 _archives/。其他具体平台支持、收费与性能数据暂未提供。