qodo-setup

设置 Qodo

描述

验证可用的 Qodo 路径。安装技能并不能证明拥有账户或工具访问权限。

前提条件

用于 CLI 设置的 shell，或连接到主机的 QAR MCP 服务。切勿处理凭据。

说明

已连接的 MCP 路径

检查已连接的 QAR 工具架构和注释。使用无害输入调用一个只读工具；目录可见并不能证明拥有读取权限。先检查 isError，再检查 structuredContent；执行出错不代表已准备就绪。读取操作无法证明写入授权：在用户授权操作前，将写入权限报告为未验证。切勿进行测试写入。MCP 身份验证由主机和 QAR 负责。将缺少工具、MT-AUTH-FORBIDDEN 和连接错误报告为 MCP 访问问题；切勿索要 API 密钥。对于仅使用 MCP 的设置，报告已验证的范围并在此交接。跳过下面所有 CLI 步骤。仅当用户要求 CLI 访问或本地收集需要 CLI 访问时，才使用相同部署继续操作。

将 references/... 链接解析为相对于此已安装 SKILL.md 目录的路径。 运行时／登录设置不代表已获授权安装或维护企业版。 对于用户要求的企业版安装，在获得批准前披露软件包及维护事项； 保留用户选择的退出项、编辑内容、所有者和可选软件包选择。

1. 查找或安装运行时

在 PowerShell 中，先按照 runtime.md 解析已验证的原生／Node 调用方式；下文中的 qodo 代表该调用方式。在 POSIX 上，直接探测 PATH：

qodo --version

如果在 POSIX 上未找到，则尝试 "${QODO_HOME:-$HOME/.qodo}/bin/qodo" --version。 如果运行时缺失、版本过旧或无法解析，请遵循参考文档。设置请求涵盖安装，但安装须经主机批准；仅安装插件并不包括在内。保留所选部署。

将可执行文件保留为 <qodo>。身份验证前，必须确保 Qodo CLI 版本为 2.0.0 或更高版本。

2. 连接

运行：

<qodo> read whoami --json --skill qodo-setup --skill-version 1.0.11 --distribution skills-sh

复用成功的身份检查结果。如果失败，请先阅读 authentication.md，再选择登录方式。

对于 Cloud，若当前已退出登录，则运行 <qodo> login。对于客户部署，保留文档中指定的登录端点；切勿回退到 Cloud。等待登录完成，然后再次检查身份。

复用成功的执行上下文，并为每项所需操作请求相应的主机批准。诊断操作的批准不代表授予全面权限。若操作已取消或权限遭拒，请停止。

3. 验证工具

仅在身份验证成功后，运行：

<qodo> tools --refresh --json --skill qodo-setup --skill-version 1.0.11 --distribution skills-sh

必须确认目录可用，且具备任务所需的能力；无关工具不能证明拥有访问权限。 如果刷新失败，请报告登录成功但工具不可用，并提供准确错误信息，以及作为重试方式的 <qodo> tools --refresh。目录故障时不要重新登录。

配置

凭据、传输和运行时更新由 CLI 负责；技能由软件包生命周期所有者更新。仅在遇到 QODO_NOTICE 更新或 Kiro 反复请求读取批准时，才阅读 host-recovery.md。

错误处理

提供实际错误和一项后续操作。若身份验证失败、登录已取消或目录不可用，切勿报告已准备就绪。切勿禁用钥匙串、复制凭据、更改主机权限文件，或提供不受限制的命令批准来使设置通过。

4. 交接

确认 Qodo 已连接且相关工具已准备就绪，然后返回已获授权的任务。 已准备就绪并不能证明之后的工具调用一定成功。不要安装可选的 Standards。