LWC — 面向 AI Agent 的主动记忆Agent 驱动 · 持久化 · 来源可追溯English · 简体中文lwc是一个由 Agent 驱动的主动记忆 CLI让 AI Agent 能够跨会话自主召回、维护和演进持久化、来源可追溯的知识。兼容 Claude Code、Codex、Cursor、OpenCode、Gemini CLI、Kiro、Hermes、Antigravity 和 pi。LWC 把经过筛选的文档转化为可长期维护的 Wiki。Agent 负责理解与综合lwc负责保存来源、页面、引用、链接、索引和历史让知识持续积累而不是每次查询都从原始片段重新发现。LWC 是 Agent 记忆不是 RAGRAG 和 LWC 都能帮助大模型使用外部文档但二者把状态留在不同的地方。典型的 RAG 请求会在查询时检索原始片段并构建一次性答案查询 - 检索片段 - 生成答案LWC 会把请求之间的有效工作保留下来任务 - 读取持续维护的 Wiki - 结合来源与已有综合进行推理 - 把值得复用的改进写回检索只是 LWC 的一项操作而不是它的组织原则。LWC 的核心产物是一个来源可追溯、持续修订的 Wiki其中的页面、引用、链接、矛盾和历史会随着认识变化而更新。因此LWC 不依赖 embedding 或向量数据库也不会在回答完成后丢弃本次综合结果。它可以与 RAG 配合但它本身不是查询时 RAG。LWC 应当由 Agent 操作lwc是提供给 Agent 的机器接口不是面向人类的笔记应用。正常使用时人类负责选择来源、提出目标和问题并审阅答案或投影出来的 MarkdownAgent 负责调用 CLI、管理作用域、整合来源、维护引用与链接以及判断哪些知识值得读取或写回。除非正在开发或排查lwc本身否则不要手工驱动常规的lwc工作流。请让你的 Agent 激活内置的规范using-lwcSkill通常以$using-lwc调用。推荐让你的 Agent 配置 LWC把下面的提示词粘贴给你使用的 Agent。它会安装全局 CLI把所有受支持宿主的配置委托给 LWC 幂等的 AgentTarget 安装器并且仅对未注册的 Agent 使用原生自配置。复制完整配置提示词请为当前用户完整安装并配置 LWC。请直接执行并验证不要只输出一份让我手工执行的 教程。 权威来源 - https://github.com/JanYork/llm-wiki-cli - https://github.com/JanYork/llm-wiki-cli/tree/main/skills/using-lwc 要求 1. 阅读本 README、SECURITY.md 和 skills/using-lwc/SKILL.md。如果 lwc 尚不能 全局调用安装经过 checksum 校验的官方 Release日常命令不得拼接私有二进制路径 或 LWC_PROJECT_ROOT。 2. 运行 lwc --version全局记忆缺失时仅执行一次 lwc --scope global init然后 执行 lwc agent install --yes。该命令会自动检测已安装的受支持 Agent并按官方 路径安全安装 MCP、Skill、Hook 与 Instructions。不得手工重写这套逻辑也不得给 同一个 Agent 同时安装原生包和直接配置。 3. 检查 lwc agent status --target all --location global。按需重启受影响的 Agent 并完成宿主正常的 Hook 信任审查。没有项目级明确授权时不得初始化项目 Wiki 或 任一图能力。 4. 如果当前运行时不在 LWC 已注册 AgentTarget 中才按该运行时的官方用户级规范安装 规范 using-lwc Skill、追加式指导区块、lwc serve --mcp并只在官方支持时安装 有界会话 Hook。保留已有配置、保证幂等没有官方表面就报告不支持不得猜路径或 配置键。 最后报告 LWC 版本、检测并配置的 Target、status 结果、修改文件、不支持的能力以及 仍需完成的重启或信任操作。思想来源与致谢lwc以 Andrej Karpathy 提出的 LLM Wiki 模式为核心准则让 LLM 增量构建并持续维护一个持久、互联的 Wiki而不是每次查询都从原始文档重新构建知识。项目的 CLI 架构与部分实现细节也参考了nashsu/llm_wiki。本项目将这些想法改编为一个以 Agent 为先、基于 SQLite 的 Rust CLI。核心设计持久化知识模型分为三个逻辑层层内容约束Raw sources经过筛选的输入内容的不可变快照通过source加入永不改写来源事实。WikiAgent 维护的页面、引用、链接和来源类型通过page更新引用来源并分类需要长期保留的非来源知识。Schema and purpose维护规则与项目目标约束后续每一次 ingest 和修订。SQLite 是唯一的规范事实源。Markdown 树是供人和 Obsidian 等工具使用的可重建投影。Agent 通过lwc修改知识而不是直接编辑.lwc/wiki.db或投影出来的 Markdown。命令成功时向 stdout 返回 JSON失败时向 stderr 返回结构化 JSON。对于当前格式的 store读取命令保持只读新版 CLI 第一次打开可写的旧版 store 时会先在事务中完成一次 schema 迁移再继续读取。分层检索与知识图每个当前 Source 和 Wiki 页面都会被确定性索引为段和句。SQLite 仍是权威数据源Span FTS 与可选的外部文档图都是可重建索引。除非请求了粒度否则现有搜索仍只返回文档lwc searchprojection consistency--granularitysentence--typepage lwc searchprojection consistency--granularitypassage lwc searchprojection consistency--granularityall --group-by document lwc span getSPAN_IDlwc spanexpandSPAN_ID--before1--after1--children20Span locator 绑定文档指纹和切分器版本。页面正文替换后旧 locator 会以stale_span失败并返回新旧元数据LWC 不会把它模糊映射到相似文本。无需关键词也可使用有界、类型化图 API 进行探索lwc graph explore# 代表性的宏观视图lwc graphnodepage:projection-policy lwc graph neighbors page:projection-policy--directionoutgoing lwc graph path page:implementation page:policy --max-depth6lwc graph impact page:policy --max-depth4lwc graph overview lwc graph status lwc graph verify自动边只表达结构或可证明的证据关系语义关系必须显式写入并可审计lwc graph relationsetpage:implementation DEPENDS_ON page:policy\--provenancesource-grounded--source12\--reasonSource 12 states the required policy--confidence0.95lwc graph relation list--frompage:implementation lwc graph relation retract page:implementation DEPENDS_ON page:policy\--reasonThe dependency was superseded关系理由是持久内容绝不要在它们中写入凭证、秘密或原始思维链。SQLite 文档仍是唯一权威数据。图默认禁用需要图遍历时显式选择一个外部引擎。配置按内置默认、全局和项目文件分层解析lwc config show lwc configset--graphgrafeo lwc configset--graphsurrealdb lwc configset--graphdisabled lwc configunset--graphMarkdown 转换是独立的可选操作。lwc init会返回同样的机器可读配置指引但不会安装或启用转换器。安装一个适配器显式选择它转换为新的本地 Markdown 文件审查后再导入# 二选一未配置时两者都不会启用。npminstall--globalfirecrawl/anydoc lwc configset--transanydoc# 或python3-mpipinstallmarkitdown[all]lwc configset--transmarkitdown lwc trans INPUT--outputOUTPUT.md lwcsourceaddOUTPUT.md配置支持--trans-timeout 1..900并可为当前适配器重复传入--trans-argvalue选项。LWC 只会直接执行已选择的固定适配器不会自动回退到另一个适配器仅接受本地文件输入输出均限制为 64 MiB且绝不覆盖已有输出。凭证应由适配器从环境变量读取不要写入 LWC 配置。格式和可选参数以官方 Anydoc 与 MarkItDown 文档为准。Grafeo 与嵌入式 SurrealDB 使用.lwc/下可重建的 sidecar。每个graph-projectWork 会先完整提交一篇当前 Source/Page 及其自有链接、引用和显式关系确认可用后才开始下一篇。更新和删除只排入实际触及的文档重建和恢复也使用相同的单文档单元。历史 source 版本保持不可变永不重新分词或投影。使用work list、work status或work watch观察进度中断后使用work resume。graph status报告当前引擎与已投影文档数graph verify对照 SQLite 的当前文档键。安装大多数用户应直接使用上面的 Agent 配置提示词。下面的手动命令主要用于维护者、排障或无法安装配套 Skill 的 Agent 环境。使用 Homebrew 安装提供 Apple 芯片 macOS 与 x86_64 Linux 预编译 BottlebrewinstallJanYork/tap/lwc使用 npm 安装Node.js 22npminstall--globali-xor/lwc从 crates.io 安装cargoinstall--lockedlwc从 GitHub 安装installer$(mktemp)curl--protohttps--tlsv1.2-fsSL\https://github.com/JanYork/llm-wiki-cli/releases/download/v0.14.7/install.sh\-o$installerless$installer# 执行前先检查脚本sh$installer安装脚本支持 x86_64/aarch64 的 macOS、glibc Linux 和 Windows Git Bash校验 Release 文件的 checksum 后安装或更新lwc。默认使用~/.local/bin或更新~/.local/bin或~/.cargo/bin中已有的副本。要选择其他目录installer$(mktemp)curl--protohttps--tlsv1.2-fsSL\https://github.com/JanYork/llm-wiki-cli/releases/download/v0.14.7/install.sh\-o$installerless$installer# 执行前先检查脚本LWC_INSTALL_DIR$HOME/binsh$installer也可以使用 Cargo 从 GitHub 源码构建并安装cargoinstall--locked--githttps://github.com/JanYork/llm-wiki-cli或者安装本地检出的源码gitclone https://github.com/JanYork/llm-wiki-cli.gitcdllm-wiki-clicargoinstall--locked--path.配套 Agent Skill仓库内置skills/using-lwcAgent Skill让lwc在有长期价值的会话中主动承担外部记忆层。可从 skills.sh 安装npx skillsaddJanYork/llm-wiki-cli--skillusing-lwc-g或者从本地检出复制到当前 Agent 运行时的用户级 Skills 目录。以 Codex 为例mkdir-p$HOME/.agents/skillscp-Rskills/using-lwc$HOME/.agents/skills/规范调用名是$using-lwc。Skill 触发后会查找兼容 CLI如需安装经过显式批准、checksum 校验的 Release则先报告报告缺失的全局记忆并仅在明确批准后初始化在重复调查前读取有界的全局与项目上下文用户显式调用时初始化当前项目否则先询问拒绝向当前授权工作区根目录之外写入项目内容区分项目事实与可跨项目复用的全局知识完整整合来源并把值得保留的答案写回 Wiki。SKILL.md只保留精简路由不再充当一篇超长总手册。它会分别链接基础记忆、触发时机、主动记忆、物理文档图、有界词网图、CodeGraph、强标签、文档转换、Agent 首次引导以及恢复维护十篇能力文档每篇都明确说明何时使用、何时跳过、最小流程、授权边界与完成证据。Skill 默认从当前目录发现活动项目并直接调用全局安装的lwc命令。LWC_PROJECT_ROOT只用于明确指定项目边界不是在你已经位于当前项目时每条命令都要导出的前缀。默认不自动安装 CLI。取得明确批准后只在一次 bootstrap 命令中设置LWC_AUTO_INSTALL1。Skill 随附、经过审查的本地安装器固定使用 LWCv0.14.7并以脚本中经过审查的各平台 SHA-256 验证下载归档该校验是完整性保护不是发布者代码签名。升级必须重新审查并更新固定版本。全局记忆初始化同样只在明确批准后以一次性LWC_GLOBAL_INIT1重试启用。Release 二进制覆盖 x86_64/aarch64 的 macOS、glibc Linux以及 Windows Git Bash。SKILL.md遵循 Agent Skills 的资源目录形式agents/openai.yaml提供 OpenAI/Codex 元数据。CLI 本身不绑定具体运行时任何能够执行 CLI并加载或适配 Skill 指令的 Agent 都能使用 LWC。Skill 命令、全局指令和 Hook 的注册方式由各运行时决定因此上面的配置提示词会先识别并适配当前宿主。原生 Agent 配置LWC 可以检测已安装的 Agent并配置一个统一只读的 LWC MCP。全部 12 个已注册 AgentTarget 都是强适配针对每个宿主和范围安装官方支持的 MCP、Skill、Hook 与 Instructions由 UI 管理、处于 preview 或官方不支持的能力会被明确报告。lwc agentinstall--yeslwc agent status--targetall--locationglobal lwc agentinstall--print-config codex lwc agent refresh--targetcodex,claude lwc agent uninstall--targetcodex,claude--yes--yes选择检测到的 Agent、全局范围和各 Target 的默认生命周期/prompt Hook使用--no-prompt-hook可省略 Claude 的逐 prompt Hook。安装项固定为lwc - serve --mcp唯一的lwc_explore工具默认读取有界 Wiki 记忆并支持显式code/all模式。请求的projectPath必须位于 MCP 宿主启动 LWC 时的工作区内。它绝不会下载或初始化 CodeGraph。重复安装和刷新逐字节幂等卸载只恢复 LWC 拥有的状态保留项目索引。integrations/提供可选的 Codex、Claude Code 和 Pi 原生包安装包不等于授权或信任也不要为同一个 Agent 同时安装直接安装器和原生包。每个原生包都内置完整的using-lwcSkill因此安装不依赖任何第三方 Skill 管理器或维护者特定环境。Pi 因官方没有内置 MCP通过其官方扩展桥暴露 LWC MCP。其余 Target 只注册lwc serve --mcpCodeGraph 是 LWC 内部的代码上下文平面绝不会作为第二个 Agent MCP 注册。由官方 UI 管理的信任和权限设置仍由用户管理。Preview 表面会被明确标记部分项目范围安装支持的能力而不是削弱或拒绝整个 Target。Kiro 全局路径遵循KIRO_HOME。Target 接口、注册顺序、检测规则和 MCP 路径参考 CodeGraph 的 MIT 许可安装器适配设计LWC 在其上增加统一 LWC MCP、逐表面能力报告、Skills 和 Hooks、共享文件所有权和精确回滚。许可证声明见THIRD_PARTY_NOTICES.md。新项目执行lwc init后以及会话/压缩 Hook 中都会输出有界的LWC_READINESS事实包括 Wiki、物理文档图、CodeGraph 运行时与项目索引以及 Agent 集成命令。物理图就绪状态区分已配置的授权与待处理或失败的投影。检测只读不会启用或初始化任何图。当两个图都需要授权时最低兼容协议使用纯文本因此不支持勾选框的 Agent 行为一致1. 同时启用物理文档图和 CodeGraph推荐 2. 仅启用物理文档图 3. 仅启用 CodeGraph 4. 稍后用户明确选择1后Agent 才按需初始化缺失的项目 Wiki、启用 Grafeo、等待并验证投影 Work、初始化 CodeGraph并分别核验两个结果。选择稍后不会修改任何状态也不会阻塞主要任务。原生插件可以把相同编号渲染成自己的 UI但绝不依赖勾选能力。强标签用于不经过搜索、按上限完整载入核心规则和手册lwc tagsetoperationsincident-response--priority100--reasonprimary runbooklwc load tagoperations--limit3lwc tag autoloadoperations--enable--priority100--limit3\--max-chars50000--reasonrequired at session boundaries这是显式的强载入机制不是基于 token 的搜索在完整页面进入 Agent 上下文之前就应用限制和字符预算。快速开始本节记录的是 Agent 实际执行的 CLI 协议正常使用时人类不需要手工运行这些命令。1. 初始化项目 Wikicdyour-project lwc initprintf# Schema\nEvery page declares provenance; source-grounded claims cite sources.\n|lwc schemaset-printf# Purpose\nBuild a durable project Wiki.\n|lwc purposeset-初始化项目时LWC 会按需把项目相对路径.lwc/加入 Git 的本地info/exclude文件不会修改仓库.gitignore。只有明确准备版本化 Wiki 时才使用lwc init --no-git-exclude。2. 加入来源材料lwcsourceadd-dir docs/没有显式标题的文件会确定性地使用来源路径作为稳定、可读的回退标题内容相同的文件会通过 SHA-256 去重。解析后位于当前 Wiki 根目录之外的项目来源必须显式传入--allow-external-source。检测到高置信度凭证标记时默认拒绝除非经过审查的来源被显式确认即传入--acknowledge-sensitive-source。每次成功加入来源时LWC 还会记录观察到的文件路径及其当前不可变快照。依赖文件证据前只检查与任务真正相关的来源lwcsourcestatus712该只读命令会流式计算实时文件的 SHA-256并分别返回路径版本状态current或superseded与文件系统状态current、modified、missing、unreadable、oversized或unstable。source status --all的成本与所有被跟踪文件的总字节数成正比只应在明确的维护任务中使用。发现文件变化后先检查差异和直接引用者lwcsourcediff7lwcsourcerefs7--limit1000source diff比较不可变来源与其实时文件也可用--to-source与另一个快照比较。它返回有界的统一 diff每侧最多 8 MiB、200,000 行默认返回 20,000 个 Unicode 字符--max-chars最高 100,000。一个来源对应多个路径时必须用--path精确选择。截断的 diff 只是预览。source refs列出直接引用、需要复核的候选页面它并不证明哪些页面受到语义影响。确认同一路径包含有意义的修订后才在审查后重新执行source add。即使内容从 A 变为 B 后又回到 ALWC 仍保留三次路径观察只复用 A 原有的 source ID。检查外部实时路径时必须再次传入--allow-external-source实时文本触发敏感信息标记时还必须在检查后传入--acknowledge-sensitive-source。从旧 store 迁移的来源会明确保持未跟踪因为 LWC 不会猜测历史路径对目标文件重新执行一次source add即可建立第一条被跟踪的修订。如果检查期间文件或路径头发生变化LWC 会返回source_status_unstable应重试不要采信跨时点结果。需要原子导入经过筛选的一组来源时JSON manifest 中的路径从 manifest 所在目录解析{sources:[{path:ARCHITECTURE.md,title:Architecture contract},{path:src/store.rs,title:SQLite store}]}lwcsourceadd-manifest lwc-sources.json3. 分析并整合一个来源lwc ingest next --context-limit50--source-max-chars100000lwc ingest analyze1--fileanalysis.md如果 manifest 或调度器已经选定明确的 pending source ID使用lwc ingest claim 7精确领取。如果source_window.has_more为 true就从source_window.next_offset_chars继续读取lwcsourceshow1--offset-chars100000--max-chars100000完成 ingest 之前既要创建带引用的 source-summary 页面也要把这个来源的贡献整合进至少一个非 source 页面lwc page put source-1\--titleSource 1 Summary\--kindsource\--summaryWhat this source contributes\--filesource-summary.md\--source1lwc page put durable-concept\--titleDurable Concept\--kindconcept\--summaryHow this source changes shared knowledge\--fileconcept.md\--source1lwc ingest complete1两层都必需source 页面负责导航和来源追溯非 source 页面让知识真正持续积累。如果某个来源确实不应改变任何共享页面用一条具体且可审计的说明完成它lwc ingest complete1\--no-derived-pages-reasonDuplicate evidence; existing synthesis already covers every supported claim页面只要带--source引用就会自动暴露source-grounded来源类型。如果长期知识来自用户陈述、Agent 观察或明确的假设不要伪造来源按需重复传入--provenancelwc page put architecture-decision\--titleArchitecture decision\--kindquery\--summaryAccepted constraint and remaining uncertainty\--filedecision.md\--provenanceuser-provided\--provenancehypothesispage put会整体替换引用集合和显式 provenance 集合。更新前先读取旧页面再重复传入所有仍有效的--source以及非来源类的--provenance值。不要显式传source-grounded它由引用自动推导。页面读取、context、search、source refs 和 Markdown 投影都会返回 provenance但 provenance 不参与搜索排序。4. 查询已沉淀的 Wikilwc context--limit50lwc searchquestion keywords--limit20lwc searchquestion keywords--limit20--explainlwc searchconcept only--typepage--kindconcept lwc searchexact evidence--typesourcelwc page show source-1Agent 工作流标准工作流如下收集不可变来源。用有界的lwc ingest next领取一个 ingest 任务已经明确 source ID 时使用ingest claim ID。读完所有返回的来源窗口以及 schema、purpose 和有界上下文。先分析再生成页面。用显式--source引用写入或修订 source 摘要与共享知识页面。只有两道整合门禁都通过或记录无需共享页面变化的原因后才能 complete。多命令 ingest 或大范围修订放进一个 changeset先验证草稿再原子发布。用search、context、graph和lint持续维护 Wiki 的一致性。完整操作约定见 docs/agent-workflow.md。运行lwc --help或lwc command --help可以查看面向 Agent 编写的前置条件、状态变化、副作用和下一步动作。原子化多命令变更单个source或page命令本身已有事务保护。当一个逻辑更新需要多条命令、又不能暴露半成品 Wiki 时使用 changesetlwc--scopeproject changeset begin architecture-refresh lwc--scopeproject--changesetarchitecture-refreshsourceadd-manifest sources.json lwc--scopeproject--changesetarchitecture-refresh ingest claim1# 使用同一个 selector 完成分析、引用页面写入和 ingest complete。lwc--scopeproject--changesetarchitecture-refresh lint lwc--scopeproject--changesetarchitecture-refresh searchexpected answer--limit5lwc--scopeproject changeset show architecture-refresh lwc--scopeproject changeset commit architecture-refresh草稿读取能看到已暂存写入而 live SQLite 与 Markdown 保持不变。草稿数据库从小型稀疏 overlay 开始不复制或 checkpoint 整个 live Wiki。changeset show只报告暂存操作、revision 和就绪状态不运行 lint。commit 只校验和应用触及实体因此无关的 live 写入会保留同一实体的 revision 冲突会失败不覆盖任何一方。空草稿和 lint 问题都会阻止提交没有强制提交或自动合并。只有经过审计、且并非本批变更新增的既有债务才能使用--allow-lint-issues --reason reviewed pre-existing debt。提交后还要用原先固定的检索检查在 live 状态复验。commit 会在发布前冻结已审查的草稿changeset_frozen会阻止任何后续暂存写入。此时只能重试同一次 commit 完成恢复或在报告冲突后 discard——绝不要向冻结草稿追加工作。lwc--scopeproject changeset discard architecture-refresh lwc--scopeproject changeset rollbackCHANGESET_IDdiscard 只删除未提交草稿。commit 会为触达实体写入带 checksum 的 inverse patch并返回精确的回滚 IDrollback 只恢复这些实体某个实体后来再次变化时会拒绝。project 与 global changeset 相互独立--scope all无效init、maintenance、checkpoint和嵌套 changeset 命令都会拒绝--changeset。草稿不会生成第二套 Markdown 投影。如果结构化错误返回committedtrue但仍有 cleanup 或 materialization 工作不要重复执行知识变更应执行响应中给出的恢复动作。稀疏 commit 当前为 Source 新增/ingest、Page put/remove、schema、purpose 和记录型 search 提供精确 patch。检索权重与显式语义关系变更会在 checkpoint 或获取 live 写锁之前以changeset_sparse_unsupported失败应将这些作为直接的单实体事务执行直到其稀疏 inverse patch 可用。作用域lwc支持三种 scopeScopeStore用途project最近祖先目录中的.lwc/wiki.db默认使用保存项目级知识global~/.lwc/wiki.db保存可跨项目复用的知识allproject 与 global store仅用于合并search和context示例lwc--scopeglobal init lwc--scopeglobalsourceaddshared.md lwc--scopeall searchshared termlwc--scopeall context知识写入始终是显式的。all不会隐式创建跨 store 的引用或链接search --record只会向每个选中的 store 追加查询操作记录。搜索与 CJK 文本搜索是词法型且确定性的。搜索词是纯文本不是原始 FTS 语法。默认的--type auto会优先返回已编译的页面、隐藏配对的 raw source并在 raw source 不足时提供回退召回。用--type page、--type source或--type all选择检索层可重复传入--kind限定页面结果例如--kind concept --kind synthesis。多字 CJK 查询使用相邻 bigram索引还会保留非停用词单字使单字查询仍可检索。拉丁文本会被切成小写的字母数字 token。排名会区分标题、来源文件名、路径/slug、摘要和正文证据标题与路径的精确或部分匹配使用有界加权。README、index、overview 和明确的导航枢纽会按查询条件降权让具体功能文档优先查询明确要求 README 或总览时禁用该惩罚。页面候选可以获得有界的直接链接或共享来源图加权。仅共同邻居的关系不会改变搜索顺序宽泛导航枢纽会得到有界图惩罚。--explain返回可精确复算的词法、通用、图、人工权重与查询反馈信号。它不会记录查询--record仍是唯一的搜索历史选项。固定系数和数值越低越相关的 rank 让--scope all中的 project/global 结果保持可比。这里刻意不依赖词典。目标是在产品名、代号、混合语言术语和新出现词汇上保持稳定行为而不依赖外部分词词典。显式检索权重与反馈文档权重用于长期、与具体查询无关的页面/来源判断反馈只作用于一个精确有序 token 的查询指纹lwc weightsetpage payment-rules\--value2\--reasonCanonical payment rules specification\--provenanceagent-observed lwc weight list page payment-rules lwc weight feedback page payment-rules\--querypayment reconciliation rules\--signalrelevant\--reasonVerified against the expected answer\--provenanceagent-observed lwc weight feedback-clear page payment-rules\--querypayment reconciliation rules\--provenanceagent-observed lwc weightclearpage payment-rules--provenanceagent-observed文档权重只能取-2、-1、1、2归零使用clear。两种机制都只重排已经通过词法召回的候选不会凭空召回不匹配文档。user-provided行优先于agent-observed行同时两者都保留供审计。反馈只保存 SHA-256 指纹不保存原始查询也不会泛化到 token 不同的改写。原因和操作记录会持久化因此绝不要把敏感查询复制到--reason。变更必须明确使用project或global范围--scope all会被拒绝。只读预览与 CodeGraphlwc view会以前台方式在本机回环地址启动项目预览并打开浏览器。它提供单个嵌入的 TS Lit 应用——运行时无 CDN、无 Node——并且只暴露 GET/HEAD API。页面、来源、Markdown、知识图以及可选代码图均从当前项目只读加载不会触发迁移、刷新或建图lwc view lwc view--port4173--no-open预览默认使用英文。使用页面内的中文/EN控件切换语言浏览器会记住选择但 Wiki 内容保持其创作语言。图使用受 Obsidian 启发的单一 3D 关系视图小节点、常驻标签、细连线并支持旋转与缩放。代码索引只支持项目级默认不启用。首次显式初始化时锁定版本的 LWC CodeGraph fork 会从其 GitHub Release 下载一次用 SHA-256 校验并缓存到~/.lwc/runtime/codegraph/PIN/TARGET/每个项目只保留自己的.lwc/codegraph索引。遥测始终关闭也不创建.codegraph状态。lwc cg status lwc cg init# 仅下载一次随后逐个完整文件建立索引lwc cgsynclwc cg query UserService lwc cgnodeUserService lwc cg callers UserService lwc cg callees UserService lwc cg impact UserService lwc cg filesCodeGraph 的查询能力均可通过lwc cg使用。全局生命周期命令install、uninstall、upgrade、telemetry、daemon、daemons会被拒绝。精确命令lwc cg serve --mcp仅保留为旧版手工桥接兼容新的 Agent 集成统一使用lwc serve --mcp在一个只读工具后融合有界 Wiki 与 CodeGraph 探索。LWC 管理运行时并强制项目边界。首次、增量、全量、更新、删除、引用解析和恢复写入都以所属文件为事务一篇文件完全可用后才处理下一篇当前图保持可读历史文档修订永不刷新。维护与投影常用维护命令lwc lint lwc maintenance reindex lwc maintenance materialize lwc maintenance compact lwc work list lwc work statusWORK_IDlwc workwatchWORK_IDlwc work cancelWORK_IDlwc work resumeWORK_IDlwc checkpoint create before-large-update lwc checkpoint list lwc log--limit20说明维护命令会立即返回持久化work。使用work status查看进度或使用work watch并在成功后检查work.result。v10 到 v11 的 schema 迁移也会自动进入同一机制因此普通命令不会在前台执行该迁移。lint默认完全只读只有这次检查确实需要进入持久操作历史时才加--record。maintenance reindex从 SQLite 重建派生搜索产物。maintenance materialize从 SQLite 重建投影出来的 Markdown 树。maintenance compact只尝试执行 WAL truncate checkpoint不再暗中执行全量 FTS 优化。应在 Wiki 空闲时运行并检查busy与after_bytes存在活动 reader 时会快速返回不修改 canonical 内容。搜索查询默认是私有的只有需要把查询文本写入持久操作日志时才加--record。lwc checkpoint create NAME使用 SQLite 在线备份 API。执行lwc checkpoint restore NAME时LWC 会先创建pre-restore-*安全 checkpoint再恢复数据库并重建投影。受保护删除使用source remove ID和page remove SLUG仍被页面引用的来源、仍有入链的页面都会被拒绝删除。删除某路径的当前来源时该路径会明确停止跟踪而不是悄悄把旧版本暴露为当前版本。多来源 ingest 或大范围页面替换应优先使用 changeset而不是手动 checkpoint成功的 commit 会写入稀疏 inverse patch在单个事务中只发布触达的 canonical 实体并增量物化变更的 Markdown。发布后会尝试 WAL truncatewal_checkpointedfalse表示活动 reader 阻止了立即截断不表示 canonical commit 失败。需要文件系统级外部备份时应先停止正在运行的lwc命令并复制完整.lwc/目录写入进程可能仍在使用 WAL 文件时不要只复制wiki.db。基准测试集可选基准会把本地 UTF-8 语料导入临时 Wiki并报告导入耗时、搜索 P50/P95、Recall5/10、MRR以及 compact 前后的存储占用。Ground truth 使用 JSONL 文件描述查询与期望命中的语料相对路径cargobuild--releaseLWC_BENCH_CORPUS/path/to/sanitized-corpus\LWC_BENCH_QUERY_SET/path/to/query-set.jsonl\LWC_BENCH_BINARY$PWD/target/release/lwc\cargotest--testsearch_benchmark ----ignored--nocapture常规cargo test --all-targets覆盖 page-first 搜索、type/kind 过滤、UTF-8 来源窗口、ingest 完成门禁、图精度、迁移、lint 与 WAL compact。工作负载约定和公平前后对比规则见 benchmarks/README.md。限制与非目标当前设计约束单机、单用户知识库UTF-8 文本工作流每个 schema、purpose、source 或 page body 的输入上限为 64 MiB提供词法搜索不提供语义向量检索。这个 CLI 当前明确不做不内置 LLM 调用不接入向量数据库不提供守护进程或后台服务不提供 Web UI 或桌面 UI不提供直接编辑数据库的工作模式。如果投影出来的 Markdown 漂移了就重建它如果 SQLite schema 有问题就通过 CLI 和迁移修复而不是手改。参与贡献欢迎提交 issue 和 pull request尤其是围绕以下方向Agent 工作流的人机工程确定性的投影行为持久化引用与页面维护约定面向多语言技术语料的搜索质量。提交 Pull Request 前请阅读 CONTRIBUTING.md。安全问题请按照 SECURITY.md 报告。许可证本项目使用 Apache License 2.0。