LWC 操作手册目录操作约定Bootstrap 与范围命令族回忆与检索来源与摄入页面与 changeset强标签与生命周期上下文Agent 集成图引擎与文档粒度 Work维护与 checkpoint结构化失败恢复安全配方操作约定直接使用全局安装的lwc命令。Bootstrap 验证其版本并报告解析出的lwc_path作为诊断信息不要将该路径变成常规 shell 变量。将 stdout 作为 JSON 读取。失败时读取 stderr.error处的 JSON 对象按.code分支并保留.details用于恢复。人类可读的 stderr 文本不是 API。在版本特定工作之前运行lwc--versionlwc--helplwcCOMMAND--help绝不要编辑.lwc/wiki.db、其 WAL、Work 文件、Changeset 数据库、生成的 Markdown 或图 sidecar。SQLite 对文档和历史是权威的Markdown 和可选图存储是派生的。Bootstrap 与范围从当前已授权的项目目录shskill-directory/scripts/bootstrap.shBootstrap 不安装任何东西默认不初始化全局记忆。在使用LWC_AUTO_INSTALL1或LWC_GLOBAL_INIT1进行一次性重试之前先获得明确的当前授权。解码其 JSON 并要求scope_conflictfalseproject_root和project_wiki保持在宿主授权的根目录内project_boundary对正常的 cwd 发现为空或等于显式指定的根目录一个明确的活动项目。从该项目目录运行常规项目命令。CLI 从 cwd 发现最近的项目 Wiki因此不需要环境前缀lwc--scopeproject context--limit25LWC_PROJECT_ROOT只用于显式指定的项目边界而不是当前目录发现。从该项目内部运行操作并为该单条命令设置变量而不是导出环境会话状态。范围用途变更project当前仓库知识允许在授权根目录内global稳定的跨项目偏好/实践允许仅真正可复用的知识all合并的项目/全局回忆仅search和context绝不写入显式$using-lwc仅允许在当前明确授权的根目录中进行初始化。无项目 Wiki 的隐式激活需要一次简洁的初始化问题在仅写回等待答案时继续主要任务而不进行项目记忆写入。命令族族目的正常副作用init、purpose、schema创建并治理一个 Wiki规范的元数据/Markdowncontext、search、span有界回忆只读除非search --recordsource不可变证据快照和谱系每个单元一次来源/路径观察ingest持久整合状态机一次来源任务转换page编译的持久知识一次页面事务tag、load tag显式强页面组和有界完整页面回忆索引成员/策略写入或只读加载agent原生 Agent MCP、指导和生命周期集成仅显式外部配置写入changeset审查几个相互依赖的变更稀疏草稿、受保护的原子发布graph、config可选 Grafeo/SurrealDB 投影和关系文档 Work 或一个关系事实weight显式检索调整一个文档/查询判断lint、log结构验证和审计只读除非--recordwork观察/取消/恢复长操作仅 Work 状态maintenance修复派生的搜索/Markdown 并压缩存储持久 Workcheckpoint可恢复的完整 SQLite 备份/恢复checkpoint 文件和受保护的恢复使用family --help查看当前参数 schema。已移除的图标志和值--physical、rslg、graphqlite、auto无效。回忆与检索从窄开始lwc--scopeall context--limit25lwc--scopeall searchtask terms--limit20搜索模式默认--type auto先编译页面raw-source 回退--type page仅维护的知识--type source精确的不可变证据--type all审计两层重复--kind缩小页面类型--explain诊断确定性排序信号--granularity sentence|passage获取精确 span--granularity all --group-by document获取有界混合回忆。用span get解析精确 span 文本用span expand在本地扩大。stale_span是修订边界——检查前后元数据而不是猜测替代品。搜索默认是私密/只读的。仅在查询本身属于持久历史时添加--record。不要记录敏感的查询措辞。强标签与生命周期上下文对一小部分必须在无搜索情况下完整加载的核心页面使用标签lwc--scopeproject tagsetoperationsincident-response\--priority100--reasonprimary response runbooklwc--scopeall load tagoperations--limit3lwc--scopeproject tag autoloadoperations--enable\--priority100--limit3--max-chars50000--reasonrequired at session boundariesload tag首先限制索引成员然后读取完整的所选页面。它从不扫描或返回每个 token 派生的关系。生命周期 Hook 只使用已启用的策略、对重叠页面去重、在页面边界停止并报告遗漏。用tag autoload TAG --disable禁用策略。Agent 集成直接为任何受支持的 Agent 安装基线集成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、全局范围和默认的 LWC 生命周期与 prompt Hook。当这些默认值不正确时显式使用--target auto|all|none|csv、--location global|local或--no-prompt-hook。安装和刷新逐字节幂等卸载恢复精确的拥有状态同时保留无关的 MCP 条目、Hook、指令和项目索引。--print-config是纯的。integrations/下可选的 Codex、Claude 和 Pi 包是替代的原生交付方式不要为同一个 Agent 同时安装直接集成和包集成。包安装绝不意味着原生信任或启用。来源与摄入单个来源lwc--scopeprojectsourceaddpath/to/file lwc--scopeproject ingest claimSOURCE_ID--source-max-chars100000lwc--scopeprojectsourceshowSOURCE_ID\--offset-charsNEXT--max-chars100000lwc--scopeproject ingest analyzeSOURCE_ID--fileanalysis.md lwc--scopeproject page put source-SOURCE_ID\--titleSource summary--kindsource--summaryContribution\--filesummary.md--sourceSOURCE_IDlwc--scopeproject page putSHARED-SLUG\--titleShared concept--kindconcept--summaryCurrent synthesis\--fileconcept.md--sourceSOURCE_IDlwc--scopeproject ingest completeSOURCE_ID继续source show直到window.has_morefalse。source add是收集不是整合。ingest complete需要一个带引用的来源页面加一个带引用的非来源页面除非有特定的经过审查的--no-derived-pages-reason适用。对于经过审查的集合使用source add-manifest路径相对于 manifest 解析。预检在写入前验证每个条目。显式领取返回的 ID而不是假设ingest next顺序。当所有后续分析/页面必须作为一个逻辑单元发布时使用 Changeset。在依赖被跟踪的实时文件之前lwcsourcestatusSOURCE_IDlwcsourcediffOLD_SOURCE_ID[--pathEXACT_PATH]lwcsourcerefsOLD_SOURCE_ID--limit1000--offset0使用--to-source进行不可变到不可变比较。截断的 diff 或分页的 refs 扫描在显式解决前是不完整的。source refs返回需要复核的候选不是自动受影响的页面。新观察创建/使用新的当前 head而先前的快照保持不可变。页面与 changeset在替换页面之前运行page show。重复每个仍然有效的--sourceID 和显式 provenance因为page put会替换这些集合。使用稳定的 slug、一行摘要和有意义的[[wikilinks]]。对两个或更多相互依赖的持久变更使用 Changeset或每当 ingest 状态和页面更新必须一起可见时lwc--scopeproject changeset beginNAMElwc--scopeproject--changesetNAMEsourceadd-manifest sources.json# 在同一草稿中分析、写入页面、完成 ingestlwc--scopeproject changeset showNAMElwc--scopeproject--changesetNAMElint lwc--scopeproject--changesetNAMEsearchfixed question--limit5lwc--scopeproject changeset commitNAMEchangeset show仅元数据不运行 lint。Commit 冻结草稿、验证它、原子发布触及的规范实体、只排队触及的当前图文档并返回精确的 Changeset ID。changeset_conflict/changeset_changed保留 live 状态丢弃过时草稿重新开始并重新应用审查过的变更。changeset_frozen重试同一次 commit 以恢复不要追加工作。committedtrue且存在 cleanup/materialization/projection 错误规范发布已成功精确遵循recovery_command。changeset rollback ID仅用于任何触及实体再次变化之前的即时错误提交。没有强制选项。图引擎与文档粒度 Work图默认禁用。正常的 source/page/search 操作不需要它。首先检查有效设置lwc--scopeproject config show当设置为disabled时每个项目会话推荐一次图激活。解释它添加页面/来源关系遍历、邻居/路径/影响/概述查询以及独立的奇偶校验验证。在更改配置前征求用户同意并在等待时继续规范工作。持久的项目策略可能提供同意Skill 激活本身不提供。当用户没有偏好时推荐 Grafeo 作为更简单的嵌入式本地选择。当用户或项目策略要求时选择 SurrealDB。运行恰好一个命令lwc--scopeproject configset--graphgrafeo lwc--scopeproject configset--graphsurrealdb捕获所选命令的work.id然后等待图查询或另一个配置更改lwc--scopeproject workwatchWORK_IDlwc--scopeproject graph status lwc--scopeproject graph verify要求statesucceeded。失败的 Work 保持停止直到检查其结构化错误并显式请求work resume WORK_ID。绝不要在 graph Work 排队或运行时切换或禁用引擎。启用/切换/重建排队当前文档键。worker 加载一篇当前 Page 或 Source在一次引擎事务中替换/删除该文档使其可查询记录进度然后选择下一篇。失败恢复仅通过显式work resume处理未提交的文档历史 Source 修订被冻结永不重新投影。因此批量进度意味着已提交的文档而不是隐藏的整库收尾。在 status/Work 就绪后才使用graph node、neighbors、explore、path、impact和overview。graph related是确定性的页面相关性。仅通过graph relation set/list/retract持久化语义声明并带有支持的类型、来源类型、原因、置信度以及基于来源时的来源 ID。禁用而不删除 sidecarlwc configset--graphdisabled绝不要复制、编辑、压缩或删除 live 图 sidecar。失败的图不会使规范页面/来源失效普通读取仍然可用。可选 Markdown 转换Markdown 适配器是部署本地的默认禁用。init返回设置指南但不执行任何安装、网络请求、适配器调用或配置写入。检查有效设置安装一个官方 CLI并选择恰好一个引擎lwc--scopeproject config shownpminstall--globalfirecrawl/anydoc lwc--scopeproject configset--transanydoc# 替代引擎python3-mpipinstallmarkitdown[all]lwc--scopeproject configset--transmarkitdown可选适配器设置使用--trans-timeout 1..900和重复的--trans-argvalue。不要在配置中存储凭证使用适配器的环境。LWC 不接受 URL 输入也不在引擎之间回退。lwc--scopeproject trans INPUT--outputOUTPUT.md# 首先检查 OUTPUT.md如果它具有权威性则显式摄入。lwc--scopeprojectsourceaddOUTPUT.md输入和输出都限制为 64 MiB。输出使用 create-new 语义转换从不覆盖文件或变更 Wiki。稳定失败必须先处理然后重试或切换配置的引擎。项目代码智能lwc cgCodeGraph 与可选的 Wiki 图引擎分开。仅当任务需要结构化代码答案符号定义、调用者、被调用者、流、影响或文件拓扑时使用它。它仅限项目级将所有内容存储在活动项目的.lwc下并保持遥测禁用。对每个非平凡代码任务检查一次。已初始化的索引是可用的项目能力因此主动使用只读结构查询而不是等待用户提到 CodeGraph。不要将它用于字面文本、注释、生成输出或精确运行时值那些使用原生文本搜索或直接文件读取。非平凡意味着跨符号/文件行为、调用或依赖流或变更影响分析。对单文件字面编辑、仅格式化工作或仅文档/配置更改跳过 CodeGraph。从非变更检查开始lwc--scopeproject cg status如果initializedfalse解释 CodeGraph 提供 tree-sitter 派生的符号/调用/依赖答案比重复扫描文件更快更精确。询问一次用户是否想要项目代码索引。不要静默下载或索引。同意后lwc--scopeproject cg init这会下载一次锁定版本的 SHA-256 校验运行时到~/.lwc/runtime/codegraph/PIN/TARGET/并构建当前项目的.lwc/codegraph。初始索引、同步、全量重建、删除、引用解析和恢复都在选择下一篇之前完整提交一个所有者文件。当前索引的文件在后续文件运行时保持可查询历史文件版本不被刷新。选择最窄的结构命令lwc cg queryWORDSlwc cgnodeSYMBOL_OR_FILElwc cg callersSYMBOLlwc cg calleesSYMBOLlwc cg impactSYMBOLlwc cg files lwc cgsync有目的地路由问题问题命令序列符号或文件在哪里定义cg query然后cg node获取精确来源/签名。什么调用了这个符号cg callers。这个符号调用了什么cg callees。如果它改变什么可能破坏cg impact然后检查返回的来源文件。哪些代码文件已被索引cg files。编辑的代码是否改变了结构cg sync然后重复相同的结构查询。什么包含这个精确字符串或注释使用原生文本搜索而不是 CodeGraph。一起使用三个 LWC 平面而不是将其中一个视为其他平面的替代品用 Wikicontext/search回忆先前的理由和已验证的事实。用 CodeGraph 查询已检出的实现结构。读取证明行为所需的最小精确来源表面。当已验证的结果以后会重要时更新适当的 Wiki 页面并运行其检索验收检查。当 CodeGraph 和 Wiki 记忆不一致时已检出的来源是当前实现证据Wiki 可能描述历史意图。在更新任一之前解决原因。绝不要引用 CodeGraph 数据库作为不可变来源证据绝不要将.lwc/codegraph摄入回 Wiki。如果任务依赖于当前的脏或未提交代码在第一次结构查询之前运行sync。在相关工作树文件变化后再次运行。不要将index作为常规新鲜度检查。绝不要通过另一个二进制调用全局 CodeGraph 生命周期命令LWC 阻止 install/uninstall/upgrade/telemetry/daemon/daemons。Agent 集成注册统一的lwc serve --mcp其代码模式通过锁定版本的项目运行时懒代理仅有界的codegraph_explore调用而不安装或初始化任何东西。只读项目查看器lwc view当用户要求以可视化方式检查 Wiki、当前来源、Markdown、状态、知识图或代码图时使用查看器lwc--scopeproject view lwc--scopeproject view--port4173--no-open它保持在前台仅绑定127.0.0.1只接受 GET/HEAD并且不迁移、同步、lint、刷新或构建任一图。用 Ctrl-C 停止它。将其图限制1000 节点、5000 边视为可视化边界而不是数据库总数。绝不要在公共接口上暴露它也不要从渲染页面推断写入接受。图使用受 Obsidian 启发的单一 3D 关系视图小节点、常驻标签、细连线并支持旋转与缩放。它从不改变图数据。UI 默认使用英文。中文/EN控件切换查看器界面语言并在浏览器本地存储中记住选择来源和 Wiki 页面从不被隐式翻译。维护与 checkpoint维护返回 Workresponse$(lwc--scopeproject maintenance reindex)lwc--scopeproject workwatchWORK_IDlwc--scopeproject lintmaterialize在缺失/过时时重建生成的 Markdownreindex仅为报告的索引/tokenizer 问题重建 FTScompact空闲窗口 WAL checkpoint/存储回收检查busy和after_bytes。在无法使用 Changeset 的大型直接维护之前使用checkpoint create NAME。checkpoint restore NAME验证备份并首先将当前状态保留为pre-restore-*。绝不要手动操作数据库/WAL 文件。结构化失败恢复错误/状态所需操作project_root_mismatch、scope_conflict停止项目记忆并解决授权根目录。graph_disabled继续规范工作仅当实际请求了图时才启用引擎。queued/runningwork检查/观察不要将其视为命令的最终结果。failed/cancelled/stale Work读取.error仅在安全和受支持时使用work resume。work_busy检查活动 Work不要启动竞争维护任务。possible_secret_detected审查安全快照绝不盲目确认。source_status_unstable重试精确的目标状态/差异。stale_span重新搜索当前内容不要模糊重映射 locator。page_in_use、source_in_use先修复引用/链接绝不绕过受保护的删除。wal_checkpointedfalse或 compactbusytrue规范写入可能有效仅在空闲窗口重试 checkpoint。未知代码保留 JSON运行命令帮助/版本并在变更前诊断。安全配方开始一个实质性任务Bootstrap 一次验证范围运行有界上下文加一次任务搜索打开最佳页面并仅对使用的说法检查引用的来源。保留一个持久的答案搜索概念如果存在则显示现有页面将验证的新知识与保留的引用/provenance 合并写入一个页面lint 该范围并重复固定的检索问题加改写。安全整合多个来源预检 manifest开始一个 Changeset添加/领取每个来源在下一个来源之前完整分析一个来源更新共享页面完成每个 ingestlint/搜索草稿提交然后对 live 状态重复验收。恢复图投影保留规范数据不动。检查graph status、work list和失败的 Work 错误。恢复剩余的文档队列或显式重新选择配置的引擎以排队逐文档重建观察成功并运行graph verify。结束一个会话只写入已验证的可复用结果lint 每个变更的范围运行有针对性的检索验收诚实报告任何待处理的 Work并将可选的语义清理留给后续任务而不是阻塞用户的交付物。