by 运行时依赖
安装命令
点击复制技能文档
企业微信 命令行工具 安装引导与自然语言翻译
wecom-命令行工具 是企业微信提供的命令行程序，让人类和 AI 代理 都能在终端中操作企业微信。
本技能分为两大部分：
自动安装 — 强制自动完成 命令行工具 和 技能s 的安装与初始化，无需询问用户 自然语言翻译 — 将用户的自然语言请求翻译为具体的 wecom-命令行工具 命令并执行
⚠️ 重要：当本技能被激活时，你必须立即自动执行第一部分的全部检查与安装步骤，不要询问用户是否要安装，直接执行命令。只有在遇到无法自动解决的错误时（如 Node.js 未安装且无法自动安装）才向用户报告。
第一部分：自动安装（强制执行）
强制规则：本部分的所有步骤必须自动执行，不要向用户询问"是否要安装"或"是否继续"。直接运行命令，只在失败时报告错误。
步骤 1：检查 Node.js 版本（强制）
立即执行：
node --version
Node.js >= 18 → 继续下一步 未安装或版本过低 → 停止并告知用户：
Node.js 18 或更高版本是必需的前置依赖，请先安装后重试。
macOS/Linux 推荐使用 nvm：nvm 安装 18 && nvm use 18 Windows 推荐使用 nvm-windows 或直接从 Node.js 官网 下载安装 步骤 2：检查并安装 wecom-命令行工具（强制）
立即执行：
wecom-命令行工具 --version
已安装 → 记录版本号，继续下一步 未安装（命令不存在）→ 立即自动安装，不要询问用户：
macOS / Linux：
导出 NPM_CONFIG_PREFIX="$QCLAW_NPM_GLOBAL_PREFIX" && npm 安装 -g @wecom/命令行工具 --force
Windows：
$env:NPM_CONFIG_PREFIX=$env:QCLAW_NPM_GLOBAL_PREFIX; npm 安装 -g @wecom/命令行工具 --force
安装完成后验证：
wecom-命令行工具 --version
如果安装失败（如权限问题），macOS/Linux 尝试：
导出 NPM_CONFIG_PREFIX="$QCLAW_NPM_GLOBAL_PREFIX" && sudo npm 安装 -g @wecom/命令行工具 --force
仍然失败时才向用户报告错误。
⚠️ 必须在 npm 安装 -g 前设置 NPM_CONFIG_PREFIX 为 QCLAW_NPM_GLOBAL_PREFIX 的值（macOS/Linux 用 导出，Windows 用 $env:）。代理 子进程虽然注入了 QCLAW_NPM_GLOBAL_PREFIX（macOS: ~/库/应用 Support/QClaw/npm-global/，Windows: %应用DATA%/QClaw/npm-global/），但 NPM_CONFIG_PREFIX 可能在 exec 工具 的 shell 环境中丢失，导致 npm 使用系统默认 prefix 安装到错误位置。 ⚠️ 禁止引导用户在外部终端手动执行 npm 安装 -g——外部终端的 npm prefix 不同，安装后 代理 子进程仍然找不到。
步骤 3：检查并安装 代理 技能s（强制，不可跳过）
⚠️ 此步骤绝对不可跳过，即使 命令行工具 已安装、凭证已存在也必须执行此检查。技能s 是 LLM 调用企微功能的前提。
首先检查 技能s 是否已安装：
macOS / Linux：
ls ~/.代理s/技能s/wecom命令行工具-contact/技能.md ~/.代理s/技能s/wecom命令行工具-doc/技能.md ~/.代理s/技能s/wecom命令行工具-meeting/技能.md ~/.代理s/技能s/wecom命令行工具-msg/技能.md ~/.代理s/技能s/wecom命令行工具-schedule/技能.md ~/.代理s/技能s/wecom命令行工具-todo/技能.md 2>/dev/null | wc -l
Windows：
@("wecom命令行工具-contact","wecom命令行工具-doc","wecom命令行工具-meeting","wecom命令行工具-msg","wecom命令行工具-schedule","wecom命令行工具-todo") | Where-Object { Test-Path "$env:USER性能分析\.代理s\技能s\$_\技能.md" } | Measure-Object | Select-Object -ExpandProperty Count
判断逻辑：
结果为 6（6 个 技能.md 都存在）→ 技能s 已安装，继续下一步 结果 < 6（任何一个缺失）→ 先检查 Git，再安装：
检查 Git 是否可用：
git --version
Git 可用 → 立即执行安装，不要询问用户： npx 技能s 添加 WeComTeam/wecom-命令行工具 -y -g
Git 未安装 → 停止并告知用户：
Git 是安装 技能s 的必要依赖（技能s 添加 需要从 GitHub 拉取文件）。请先安装 Git：
macOS: xcode-select --安装 或 brew 安装 git Windows: 下载 Git for Windows Linux: sudo apt 安装 git 或 sudo yum 安装 git
安装完成后再次使用上述对应平台的检查命令验证。
验证结果为 6 则继续，否则报告安装失败。
步骤 4：检查凭证状态（强制）
立即检查凭证目录：
macOS / Linux：
ls ~/.config/wecom/机器人.enc ~/.config/wecom/mcp_config.enc 2>/dev/null
Windows：
Test-Path "$env:USER性能分析\.config\wecom\机器人.enc"; Test-Path "$env:USER性能分析\.config\wecom\mcp_config.enc"
⚠️ 注意：凭证目录可通过环境变量 WECOM_命令行工具_CONFIG_DIR 自定义，若该变量已设置，检查该目录下的 机器人.enc 和 mcp_config.enc。
判断逻辑：
机器人.enc mcp_config.enc 结论 操作 ✅ 存在 ✅ 存在 已初始化 跳过步骤 5，直接验证（步骤 6） ✅ 存在 ❌ 不存在 配置不完整 执行步骤 5 ❌ 不存在 任意 未初始化 执行步骤 5 步骤 5：初始化配置（仅凭证缺失时执行）
当步骤 4 判断需要初始化时，立即告知用户需要执行初始化并执行：
wecom-命令行工具 init
wecom-命令行工具 init 是交互式命令（需要用户扫码或输入凭证），因此这一步需要用户参与。告知用户：
推荐扫码接入：终端会显示二维码，用企业微信 应用 扫描即可 备选手动输入：输入 机器人 ID 和 Secret（获取方式参考 企业微信说明） 步骤 6：验证安装（强制）
立即执行验证命令：
wecom-命令行工具 contact 获取_user列出 '{}'
返回正常结果 → 安装成功，展示功能概览卡片 返回错误 → 凭证可能失效，提示用户重新执行 wecom-命令行工具 init 自动安装完整流程（AI 必须遵循） 技能激活 │ ├── 1. [自动执行] node --version │ ├── >= 18 → 继续 │ └── 未安装/版本低 → 停止，告知用户安装 Node.js │ ├── 2. [自动执行] wecom-命令行工具 --version │ ├── 已安装 → 继续 │ └── 未安装 → [自动执行] 导出 NPM_CONFIG_PREFIX="$QCLAW_NPM_GLOBAL_PREFIX" && npm 安装 -g @wecom/命令行工具 --force │ ├── 3. [自动执行] 检查 ~/.代理s/技能s/wecom命令行工具-*/技能.md 是否齐全（6个） │ ├── 6 个都存在 → 继续 │ └── 有缺失 → [自动执行] npx 技能s 添加 WeComTeam/wecom-命令行工具 -y -g │ ├── 4. [自动执行] ls ~/.config/wecom/机器人.enc ~/.config/wecom/mcp_config.enc │ ├── 两个文件都存在 → 跳到步骤 6 │ └── 文件缺失 → 继续步骤 5 │ ├── 5. [需用户参与] wecom-命令行工具 init（交互式扫码/输入凭证） │ └── 6. [自动执行] wecom-命令行工具 contact 获取_user列出 '{}' ├── 成功 → 展示功能概览 └── 失败 → 提示重新 init
安装问题排查 问题 自动处理方案 npm: command not found 停止并告知用户安装 Node.js >= 18 安装后 wecom-命令行工具: command not found 强制重装：macOS/Linux 导出 NPM_CONFIG_PREFIX="$QCLAW_NPM_GLOBAL_PREFIX" && npm 安装 -g @wecom/命令行工具 --force；Windows $env:NPM_CONFIG_PREFIX=$env:QCLAW_NPM_GLOBAL_PREFIX; npm 安装 -g @wecom/命令行工具 --force npm 全局安装权限不足 macOS/Linux 尝试 导出 NPM_CONFIG_PREFIX="$QCLAW_NPM_GLOBAL_PREFIX" && sudo npm 安装 -g @wecom/命令行工具（Windows 通常不需要 sudo） 初始化提示"凭证验证失败" 告知用户 机器人 ID/Secret 不正确或企业不满足条件（≤ 10 人） 扫码超时 告知用户重新执行 wecom-命令行工具 init 第二部分：自然语言翻译为 命令行工具 命令 翻译总则
当用户用自然语言描述企业微信操作时，按以下规则翻译为 命令行工具 命令：
识别意图 → 判断属于哪个品类（contact/doc/meeting/msg/schedule/todo） 确定方法 → 匹配具体的工具方法 提取参数 → 从自然语言中提取参数值，构建 JSON 执行命令 → 运行 wecom-命令行工具 <品类> <方法> '' 解读结果 → 将 JSON 返回值翻译为用户友好的自然语言
⚠️ Windows (PowerShell) JSON 参数引号规则：PowerShell 对引号处理与 bash 不同。
简单 JSON（无嵌套双引号）：wecom-命令行工具 contact 获取_user列出 '{}' 可正常工作 复杂 JSON（含双引号键值）：需将外层改为双引号并转义内部双引号