Installation and Upgrades zh CN

安装与升级

语言： English · 简体中文

对大多数用户来说，最合适的方式是让 Agent 完成配置：先把全局可调用的 lwc 命令安装一次，再让 LWC 的幂等 AgentTarget 安装器配置你实际使用的 Agent 宿主所支持的能力。

环境要求

• x86_64 或 Apple 芯片的 macOS；
• x86_64 或 aarch64 的 glibc Linux；
• x86_64 或 ARM64 Windows；原生 Release 可直接使用，shell 安装脚本需要 Git Bash；
• 通过 npm 安装时需要 Node.js 22 或更高版本；
• 只有从 crates.io 或源码安装时才需要 Rust 与 Cargo。

可选的 MarkItDown、AnyDoc、Grafeo、SurrealDB 和 CodeGraph 各有独立的配置与授权边界。执行 lwc init 不会静默安装或启用这些能力。

推荐安装方式

Homebrew

Apple 芯片 macOS 与 x86_64 Linux 提供预编译 Bottle：

brew install JanYork/tap/lwc

npm

npm 包会下载匹配的 GitHub Release 二进制，并验证 SHA-256 校验和：

npm install --global @i-xor/lwc

GitHub 安装脚本

安装脚本会根据 SHA256SUMS 验证 Release 归档，再安装到用户可写的二进制目录：

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/JanYork/llm-wiki-cli/releases/latest/download/install.sh | sh

默认目录是 ~/.local/bin；如果 ~/.local/bin 或 ~/.cargo/bin 已经存在 lwc，脚本会原地更新。只为本次安装指定其他目录：

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/JanYork/llm-wiki-cli/releases/latest/download/install.sh | LWC_INSTALL_DIR="$HOME/bin" sh

crates.io

cargo install --locked lwc

从 GitHub 源码构建

cargo install --locked --git https://github.com/JanYork/llm-wiki-cli

安装本地检出的源码：

git clone https://github.com/JanYork/llm-wiki-cli.git
cd llm-wiki-cli
cargo install --locked --path .

验证 CLI

日常使用不应把二进制绝对路径赋给 shell 变量。lwc 应当能够在任意目录直接调用：

command -v lwc
lwc --version
lwc --help

如果安装器报告成功，但 command -v lwc 仍然失败，应把安装目录加入 shell 的 PATH，启动一个新 shell 后重新检查。

配置 Agent

LWC 可以检测已经安装的 Agent 宿主，并按照各宿主官方能力安装 MCP、Skill、Hook、Instructions 和权限配置：

lwc agent install --yes
lwc agent status --target all --location global

--yes 表示自动使用检测结果和默认全局设置，不进入交互询问；它不代表“安装所有可能的 Agent”。

如果某个 Agent 只在启动时读取配置，请完成重启。宿主出现正常的信任或权限审核时，应由用户按官方流程确认；LWC 不会绕过由 UI 管理的信任决定。

需要精确控制时：

lwc agent install --target codex,claude,pi --location global --yes
lwc agent install --print-config codex
lwc agent refresh --target codex,claude,pi --location global

--print-config 只输出建议配置，不会写文件。安装和刷新都具备幂等性；卸载只恢复 LWC 拥有的状态。

同一个 Agent 不要同时安装 AgentTarget 直接集成和可选原生包。

初始化全局记忆

全局记忆不是必需项，但适合保存能够跨项目复用的稳定偏好与实践：

lwc --scope global init

该操作只需执行一次。项目专属事实仍应留在项目作用域。

升级

优先沿用原来的安装渠道：

brew update
brew upgrade lwc

npm install --global @i-xor/lwc@latest

cargo install --locked --force lwc

GitHub 安装脚本也可以直接用于升级：

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/JanYork/llm-wiki-cli/releases/latest/download/install.sh | sh

升级完成后：

lwc --version
lwc agent refresh --target auto --location global
lwc agent status --target all --location global

Agent refresh 只更新 LWC 拥有的集成内容，不会生成重复条目，也不会覆盖无关配置。

安全提示

• 只从本页列出的官方仓库、Homebrew Tap、npm 包或 crates.io 包下载。
• Release 安装器会验证 SHA-256。校验和用于保障文件完整性，并不等同于发布者代码签名。
• 不要照搬维护者私人电脑上的配置路径。应遵循 Agent 宿主的官方约定，并使用 LWC 已注册的 AgentTarget 适配器。
• 适配器凭证应保存在适配器自己的环境中。不要把密钥写入 LWC 配置、Wiki 页面、标签、原因字段或操作历史。

下一篇：快速开始