LWC Agent 首次引导与就绪状态使用时机在 LWC 安装、首次项目使用、Agent 集成、会话开始/压缩就绪检查或项目缺少物理文档图或 CodeGraph 能力时使用本文档。跳过时机当 Agent 集成和所需项目能力已经就绪时跳过首次引导。不要将就绪状态变成每条用户消息上的提示。最小流程使用 Agent 检测和所选范围进行安装lwc agentinstalllwc agentinstall--yeslwc agentinstall--print-config codex安装器会在 Agent 支持 MCP 时配置一个稳定的lwc serve --mcp启动器。其唯一的只读lwc_explore工具默认读取有界 Wiki 记忆并且可以在不暴露第二个 MCP 服务器的情况下显式添加 CodeGraph 上下文。其projectPath被限制在 MCP 宿主的启动工作区内。所有已注册的 AgentTarget 都是强适配针对所选宿主和范围安装每个官方的基于文件的表面而由 UI 管理、preview 或不支持的表面会被明确报告。Pi 因没有内置 MCP使用其官方扩展桥。每个原生 target 调用PATH上的全局lwc命令不需要私有 Skill 管理器或维护者特定环境。CodeGraph 保持为 LWC MCP 内部能力绝不被注册为第二个 Agent 服务器。在全新初始化或边界 Hook 处检查LWC_READINESS。当两个图都缺失且当前任务具有实质性时使用这个可移植的文本协议询问一次不要要求勾选支持1. 同时启用物理文档图和 CodeGraph推荐 2. 仅启用物理文档图 3. 仅启用 CodeGraph 4. 稍后选择1是一次合并授权。在同意后立即执行现有命令仅当项目已存在时跳过项目初始化lwc--scopeproject init lwc--scopeproject configset--graphgrafeo lwc--scopeproject workwatchIDlwc--scopeproject graph status lwc--scopeproject graph verify lwc--scopeproject cg init lwc--scopeproject cg status物理图 Work 和 CodeGraph 状态是独立的验收结果。报告任一失败时不要隐藏另一个成功。选择4不改变任何内容主要任务继续。就绪状态还会报告md_trans.setting、其配置来源、PATH上可用的引擎以及所选可执行文件是否可用。如果转换相关且被禁用或缺失解释两个可选引擎和配置命令绝不要从 Hook 安装或启用任一引擎。授权边界Agent 检测、安装、Hook 执行和就绪事实不是图授权。Hook 是有界的本地只读检查它们绝不停初始化 Wiki、启用图、下载 CodeGraph、构建索引、读取记录或写入记忆。原生插件信任仍是单独的宿主/用户决策。完成证据lwc agent status报告预期的 target 和全局/本地位置。重新安装/刷新逐字节幂等卸载只移除拥有的 MCP、标记和 Hook。一旦两个能力都获得持久同意图授权选择就会消失有界的就绪事实仍会暴露待处理或失败的初始化以供路由和修复。相同的编号含义在纯文本和可选的原生 UI 中都有效。
