Search and Context zh CN

搜索与上下文载入

语言： English · 简体中文

LWC 会主动限制召回范围。Agent 先读取精简 context，再用确定性词法搜索找到已维护知识，只在需要时打开准确的 Page、Source 或文本片段。

选择最小召回工具

需求	命令
Purpose、Schema、页面索引和最近操作	lwc context
已维护知识及来源回退	lwc search
一篇完整 Page	lwc page show
不可变证据的准确窗口	lwc source show
准确句子或段落文本	lwc span get
文本片段附近上下文	lwc span expand
不经过搜索载入完整核心页面	lwc load tag

始终从小范围开始。回答一个明确问题不需要加载整套 Wiki。

有界 Context

lwc --scope all context --limit 25

每个选中的存储都会返回：

• Purpose 与 Schema；
• 上限内的页面元数据和摘要；
• 上限内的最近操作；
• 准确作用域与数据库身份。

context 不会返回所有完整页面正文。应先根据索引决定要打开哪些页面。

搜索层

lwc search "question keywords" --limit 20

搜索词使用普通文本，LWC 会自动转义原始 FTS 语法。

Type	行为
auto	默认模式：优先排列维护页面，隐藏已经有对应 source 摘要页的原始 Source，必要时再回退到 Source
page	只搜索维护页面
source	只搜索不可变来源
all	同时审计两层结果

重复传入 --kind 可以限制页面类型：

lwc search "storage policy" --type page --kind concept --kind synthesis --limit 10

需要精确证据时使用 --type source；不要用原始来源替代已经维护的综合知识。

作用域行为

lwc --scope project search "local architecture"
lwc --scope global search "reusable release practice"
lwc --scope all search "shared convention"

all 会在同一确定性尺度上合并项目与全局结果；完全同分时项目结果优先。它只能用于系统支持的读取。引用和 Wiki 链接不会跨存储自动建立关系。

检索粒度

默认按文档检索。只有整篇结果过于粗糙时才请求更小粒度：

lwc search "projection consistency" --granularity passage
lwc search "projection consistency" --granularity sentence --type page
lwc search "projection consistency" --granularity all --group-by document

all 粒度使用确定性的倒数排名融合组合文档、段落和句子候选。按文档分组可以避免同一页面的多个片段占满结果列表。

解析一个定位：

lwc span get <span-id>
lwc span expand <span-id> --before 1 --after 1 --children 20

Span ID 包含文档指纹与分段版本。stale_span 表示文档已经变化；应重新搜索当前内容，不能静默复用相似文本。

CJK 搜索

多字符 CJK 查询使用相邻双字，并保留非停用单字；拉丁文本使用小写字母数字词项。这样无需词典或嵌入服务，也能提供确定性的中文技术检索。

直接输入自然词语，不要手工拼接 FTS 表达式。

排名与解释

rank 数值越低，相关性越高。结果顺序不符合预期时运行：

lwc search "payment rules" --limit 20 --explain

--explain 会展示有界的标题、路径、通用、图、文档权重和查询反馈信号及其准确计算。该命令只读，也不能证明排名靠前的声明一定正确。

检索权重与反馈

只有先改善页面标题、摘要、正文和链接，并检查 --explain 后，才考虑使用调整项。

文档权重与具体查询无关：

lwc weight set page payment-rules \
  --value 2 \
  --reason "Current canonical specification" \
  --provenance agent-observed

查询反馈只作用于相同的有序 tokenizer 指纹：

lwc weight feedback page payment-rules \
  --query "payment rules" \
  --signal relevant \
  --reason "Expected page and evidence verified" \
  --provenance agent-observed

文档权重只允许 -2、-1、1 和 2；反馈值为 relevant 或 irrelevant。两者都只重排现有词法候选，不会创造语义匹配。

只有用户明确判断时才使用 user-provided。过时记录应直接清除，不能叠加相反调整来抵消。持久 reason 字段不得重复敏感查询文本。

记录搜索与私密搜索

搜索默认只读且不记录。只有查询措辞本身值得进入持久操作历史时才添加 --record：

lwc search "durable research question" --record

不要记录敏感查询。配合 --scope all 时，记录搜索会分别向每个选中的存储写入一条操作。

召回流程

1. 只运行一次有界 context。
2. 运行一次面向任务的搜索。
3. 打开一到五篇相关页面。
4. 只有声明需要精确证据或新鲜度时才检查引用来源。
5. 检索失败后每次只扩大一个维度。
6. 根据当前证据解决任务。
7. 适当保存经过验证、值得复用的结果。

空结果不能证明知识不存在。下结论前应检查术语、页面摘要、作用域、kind 和证据。

检索验收

页面发生实质变化后，为每个测试主题预先声明预期页面，并使用一个代表性问题和一个自然改写：

lwc lint
lwc search "original question" --type auto --limit 5
lwc search "natural paraphrase" --type auto --limit 5
lwc page show <expected-page>

两种问法都必须在前五名返回预期页面，并且打开后能够通过预先声明的 Source 或 provenance 支持答案。看到失败结果后不得改写测试问题。

完成证据

成功召回应满足：

• 选定作用域与上限明确；
• Agent 只打开任务相关文档；
• 没有静默复用过时 span 或过时 Source；
• 使用排名调整时有证据支持且范围有界；
• Wiki 发生实质更新后通过固定检索验收。

下一篇：文档知识图（记忆图网）