loongsuite-pilot-ops

LoongSuite Pilot — 安装 / 配置 / 卸载

LoongSuite Pilot 是面向研发团队的 AI Coding 数据采集与效能评估工具，支持 Cursor、Qoder IDE/CLI、Claude Code、Codex 的数据自动采集与上报。

诊断排查请查阅 ~/.loongsuite-pilot/skills/loongsuite-pilot-ops/references/diagnostics.md； 观测面板与运维手册请查阅 ~/.loongsuite-pilot/skills/loongsuite-pilot-ops/references/monitoring.md。 以上两个文件在 pilot 安装完成后自动写入本地，可直接打开阅读。

重要说明

所有命令必须在完整权限环境下执行（Shell 工具调用时设置 required_permissions: ["all"]）。 沙箱环境下 nvm、sudo 及 PID 读取会受限，导致安装或诊断结果不可信。

---

1. 前置条件

• Node.js >= 18，必须通过 nvm 安装并使用 nvm 管理的 Node（推荐 v22）
• 支持 Mac / Linux 8U 开发机 / Linux ECS（Linux 需 sudo 权限）
• Linux 7U 开发机：需额外执行 glibc 兼容补丁（见第 5 节）

⚠️ 务必使用 nvm 的 Node，不要使用任何 Agent 自带的 Node 环境

部分 AI Coding Agent（例如 Codex、以及其他自带运行时的 CLI 工具）会在安装时 内置一份 Node，并可能把 node 指向其私有目录（例如 ~/.codex/... 或 Agent 自身安装目录下的版本）。这类 Node 仅供该 Agent 内部使用，用它安装 pilot 会导致依赖错乱、hook 失效等问题。安装前务必确认：

which node    # 路径应包含 .nvm，例如 ~/.nvm/versions/node/v22.x.x/bin/node
node -v       # 输出应 >= v18.0.0

若 which node 指向任一 Agent 的私有目录（如 ~/.codex/、Agent 安装目录等）， 请先执行 nvm use 22（或在新终端中确认 nvm 已加载）后再继续安装。

---

2. 安装

执行以下两步完成标准安装（Mac / Linux 8U / ECS）：

# 步骤一：安装 nvm + Node.js（已有 node >= 18 可跳过）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22

# 步骤二：安装 LoongSuite Pilot（将 <工号> 替换为 6 位员工号，含前导 0）
curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite/loongsuite-pilot/loongsuite-pilot-installer-inner.sh \
  | bash -s -- install --user.id <工号>

安装成功后验证：

~/.local/bin/loongsuite-pilot status
~/.local/bin/loongsuite-pilot info
# diagnostics 与 monitoring 参考文档已自动写入 loongsuite-pilot-ops/references/
ls -l ~/.loongsuite-pilot/skills/loongsuite-pilot-ops/references/

---

3. 自定义 Logstore（可选）

安装时或安装完成后，询问用户是否需要使用自定义 Logstore 上报数据。

• 如果用户不需要自定义 Logstore，跳过本节，使用默认配置即可。
• 如果用户需要自定义 Logstore，先询问用户选择哪种访问方式，然后按对应流程操作：

询问用户：是否使用 AK/SK 进行访问？