主题
搜索与归组 wiki
通过 MCP 搜索 OpenWiki 页面，并把相关仓库 wiki 归组为工作区
OpenWiki 提供本地只读检索工具，让编码智能体无需启动生成流程，就能基于已有 wiki 回答具体问题。使用 openwiki link 把相关仓库的 wiki 归组为命名工作区，然后在该工作区内搜索与阅读。
搜索与阅读
让你的编码智能体在 wiki 中查找某个问题：
txt
Search this repository's OpenWiki for how retry handling works, then read the
relevant sections.openwiki_search：针对具体问题返回紧凑的、排序后的结果openwiki_read：根据你的智能体从结果中挑选的条目，取回完整章节
智能体会被引导在遇到具体的架构或依赖问题时使用检索，阅读相关章节，并在获得依据后停止。检索是可选的上下文，并不是每个任务开始时的固定步骤。这些工具不依赖模型：它们不会启动生成流程，也不自行发起任何模型调用。
当仓库被归组进工作区后，可用 openwiki_list_workspaces 与 openwiki_list_wikis 进行发现。工作区搜索结果会标识提供该结果的 wiki；把该 ID 连同结果里的页面与章节锚点一起传给 openwiki_read。
这些工具随编码智能体集成一起提供。安装集成后，重启宿主并让它搜索 wiki。
创建 wiki 工作区
一个服务常常横跨多个仓库。使用 openwiki link 把它们现有的 wiki 归组为命名工作区，让你的智能体能跨整个服务搜索，并读取任何成员 wiki 的章节。
从包含这些仓库的目录（例如 ~/dev）启动工作区管理器：
bash
cd ~/dev
openwiki link创建诸如 Payments 的工作区，然后选择要纳入的仓库。成员仓库保留各自的 wiki、可以属于多个工作区，也不必共享同一个父目录。查找器会从起始于启动目录的可编辑路径下拉流式列出 Git 仓库。没有 OpenWiki 文档的仓库会显示为灰色。注册表存储在 ~/.openwiki（或 OPENWIKI_CONFIG_DIR）下。
搜索范围
搜索按以下规则选择范围：
- 不属于任何工作区的 wiki 只搜索自身。
- 属于一个工作区的 wiki 自动搜索该工作区。
- 属于多个工作区的 wiki 使用其活动工作区。
- 若其属于多个工作区且没有活动选择，搜索返回
workspace_required，由智能体询问使用哪个工作区。
可在该仓库内的任意位置，为仓库设置、查看或清除持久的活动工作区：
bash
openwiki workspace use payments
openwiki workspace current
openwiki workspace clear