Limits and Glossary zh CN

系统限制与术语表

语言： English · 简体中文

LWC 会限制输入、检索、图遍历和 Agent 上下文，避免单条命令意外载入整个高密度知识空间。下列数值对应当前 release line；具体版本仍以已安装命令的 --help 和响应中的 request_limits 为准。

通用 CLI 限制

Surface	默认值	硬边界
Source 或 Page 文件输入	—	64 MiB
目录或 manifest 导入	—	100,000 个文档
search --limit	20	1–1,000
context --limit	50	每个 Store 1–1,000
lint --limit	100	1–1,000
log --limit	20	1–1,000
Source、Page 与 ingest list limit	100	1–1,000
source diff 输入	—	每侧 8 MiB、200,000 行
source diff --max-chars	20,000	1–100,000
Changeset 或 checkpoint 名称	—	单个安全文件名片段，最多 80 bytes
SQLite busy 边界	—	10 秒

分页 offset 从零开始，并且必须能放入 signed 64-bit integer。响应出现 has_more=true 时，应请求下一页，而不是提高 limit。

Span 限制

Surface	默认值	硬边界
Passage span	—	64 KiB
Sentence span	—	16 KiB
span expand --before / --after	1 / 1	各 0–20
span expand --children	20	1–200

过长的逻辑句子或段落会在合法 UTF-8 边界拆分。字节边界用于保护索引；文档明确说明的 CLI window offset 仍按 Unicode 字符计算。

Tag 与强上下文限制

Surface	默认值	硬边界
Tag 名称	—	1–128 个字符，不能含 control character
Membership 或 policy reason	—	1–512 个字符，不能含 control character
load tag --limit	10	1–100 个 Page
Autoload Page limit	10	1–100 个 Page
Autoload 字符预算	50,000	1–100,000 个字符
Hook 考虑的 autoload policy	—	100 条

字符预算作用于返回的完整 Page body 总量。预算用尽时，LWC 会报告 omission diagnostics，不会截断 Page，造成规则只有半句的误导结果。

文档图限制

命令	默认值	硬边界
graph related --limit	20	1–1,000
graph explore --depth	2	1–10
graph explore --limit	100	1–5,000 个 node
graph neighbors --limit	100	1–5,000 个 node
graph path --max-depth	6	1–10
graph path --limit	200	1–5,000 个 node
graph impact --max-depth	4	1–10
graph impact --limit	100	1–5,000 个 node
graph overview --limit	10	1–1,000
graph relation list --limit	100	1–1,000

遍历限制约束返回工作量，而不是整个图的规模。应优先使用 filter 和更精确的起点，不要反复请求最大值。

Word Graph 密度预算

预算	硬边界
可搜索 query term	8
每页候选文档	25
每次响应的 term	30
每次响应的 node	200
每次响应的 edge	500
检查文本总量	4 MiB
每份文档检查的 span	4
每份文档检查的 metadata	16 KiB
分页 offset	10,000

Viewer 会把文档和词项分页大小限制到上限，并返回 request_limits 与截断诊断。空 query 或超过八个可搜索词项的 query 会被拒绝。这是词图的核心性能契约：只采样有界邻域，绝不物化全部 token edge。

Viewer 与 CodeGraph 预算

Surface	硬边界
Viewer Page 或 Source metadata	1,000 条
Viewer knowledge-graph node / edge	1,000 / 5,000
CodeGraph overview node / edge	1,000 / 5,000
CodeGraph prompt-Hook 输出	2 秒内最多 20 KiB
CodeGraph runtime install-lock 等待	30 秒

Viewer 的边界只是只读展示限制，不会限制 canonical Store 规模。除 LWC bridge 的限制外，CodeGraph 查询命令还会应用上游自身的结果预算。

转换限制

Surface	默认值	硬边界
转换超时	120 秒	1–900 秒
输入文件	—	64 MiB
Markdown 输出	—	64 MiB 且必须是合法 UTF-8
错误预览	—	8 KiB

LWC 只创建新输出路径，绝不会覆盖已有文件。提高 timeout 也不会放宽 path、argument、secret 或 size 校验。

Agent Hook 与 MCP 限制

Surface	默认值	硬边界
Hook 输入信封	—	64 KiB
Hook 渲染上下文	—	100,000 个字符
MCP JSON-RPC frame	—	64 KiB
lwc_explore.query	—	1–10,000 个字符
projectPath	—	最多 4,096 个字符，且必须是项目绝对目录
maxDocuments	8	1–20
maxFiles	12	1–20
CodeGraph MCP request	—	10 秒

MCP 预算用于保护 Agent transport，不会因此授权写入、下载、初始化图、访问文件系统根或使用相对项目路径。

Work 时间参数

图与维护 Work 每 5 秒写一次 heartbeat。Running state 连续 30 秒没有更新后，才具备恢复条件。这些数值用于避免两个 runner 把一次短暂停顿误判成 abandoned，并不是任务总时长限制。

术语表

术语	含义
Agent	通过 CLI、Hook、Skill、Instructions 或 MCP 调用 LWC 的 AI 编码或研究宿主
AgentTarget	针对某个 Agent 宿主官方路径、格式与能力缺口编写的手写 adapter
canonical	权威状态；Wiki 知识以 SQLite 为准，不以生成 Markdown 或 graph sidecar 为准
changeset	隔离的稀疏草稿，可把多条受支持 mutation 原子发布
checkpoint	某个 Store 的完整、已验证 SQLite 恢复点
CodeGraph	保存 symbol、call、dependency 与 impact 的项目本地代码结构索引
文档知识图	Page、Source、citation、link、provenance 与 semantic relation 的物理投影，也称记忆图网
derived state	可重建的 Markdown、FTS、span、graph sidecar 与 index 等状态
FTS	用于确定性 lexical retrieval 的 SQLite full-text search index
global scope	位于当前用户 LWC home、可跨项目复用的用户级记忆
Hook	在 Agent lifecycle 中提供 readiness 与强上下文的有界 adapter
ingest	从收集证据到分析并更新 Page 的持久 Source 整合状态机
Instructions	安装到 Agent 官方 instruction surface、由 marker 限定的持久指导
lint	对 canonical Wiki 与 search-index invariant 执行的确定性结构校验
MCP	暴露单一只读 lwc_explore tool 的 Model Context Protocol transport
operation	成功状态迁移或显式记录 read 对应的持久审计记录
Page	由 Agent 维护、具有稳定 slug、正文、link、citation 与 provenance 的知识
projection	把 canonical document 渲染到可重建 secondary representation 的过程
project scope	从当前目录向上发现的最近合法项目 Wiki
provenance	说明 Page claim 来自何种证据的分类
receipt	Agent 集成所有权记录，供 status、refresh 与精确 uninstall 使用
Source	为后续知识整合收集的授权证据不可变 snapshot
span	带稳定 locator、指向 Source 或 Page revision 的已索引 passage 或 sentence
strong context	不经搜索排序，按 tag policy 载入的一小组完整 Page
tag	对核心 Page 的策展 membership relation，可附 autoload policy
trans	通过可选 MarkItDown 或 AnyDoc subprocess 把文档转成 Markdown 的适配能力
Viewer	只绑定 loopback 的前台 UI，只读当前状态，不负责刷新或修改
Wiki	一个 project 或 global 范围内的 canonical Source、Page、治理、索引与历史集合
Word Graph	根据共享 searchable term 按需生成的有界文档关系图
Work	具有 progress、cancel、resume、result 与 error state 的持久后台任务

实际使用参见常用工作流与实战配方，准确命令族参见 CLI 与配置参考。