Amazon Q Developer - 命令行

本章介绍如何使用 Amazon Q Developer 为数百种流行的 CLI(如 git、npm、docker 和 aws)启用 IDE 样式的补全。

安装 Amazon Q

要安装 Amazon Q for command line，请完成以下步骤。

• 下载 Amazon Q for command line(仅限 macOS)
• 使用 Builder ID 或 IAM Identity Center(使用您的账户管理员提供给您的起始 URL)进行身份验证。
• 按照说明安装 shell 集成，并授予 macOS 可访问性权限。

支持的命令行环境

Amazon Q for command line 与以下环境集成:

• 操作系统:macOS
• Shell:bash、zsh、fish
• 终端模拟器:iTerm2、macOS 终端、Hyper、Alacritty、Kitty、wezTerm
• IDE:VS代码终端、Jetbrains 终端(Fleet 除外)
• CLI:500 多种最流行的 CLI，例如 git、aws、docker、npm、yarn

验证您的下载

下载 Amazon Q for command line 后，您可以按如下方式验证其代码签名:

codesign -v /Applications/Amazon\ Q.app

无输出表示应用程序的代码签名有效且未被篡改。

有关应用程序签名的更多详细信息，请运行:

codesign -dv --verbose=4 /Applications/Amazon\ Q.app

卸载 Amazon Q for command line

要卸载 Amazon Q for command line，请完成以下操作步骤。

• 打开终端窗口。
• 运行以下命令:

q uninstall

使用 CLI 与 Amazon Q 聊天

Amazon Q CLI 可让您在终端中与 Amazon Q 进行对话。

上下文集成

Amazon Q CLI 集成了来自本地开发环境的上下文信息。此上下文集成可帮助 AI 更好地理解您，从而提供更准确、更相关的答案。

上下文修饰符

Amazon Q CLI 支持以下上下文修饰符:

• @git: 修饰符为您提供有关 git 存储库的信息，例如当前分支、更改和提交历史记录。
• @env: 修饰符与 Amazon Q 共享您的本地环境变量，帮助其了解您的开发设置。
• @history: 修饰符为 Amazon Q 提供您最近的 shell 命令历史记录，帮助其了解您的操作和当前上下文。

用法

要开始使用 Amazon Q CLI，请按照以下步骤操作:

• 安装 Amazon Q CLI。
• 打开您的终端或命令提示符。
• 运行q 聊天命令来发起与 Q 的对话。
• 键入您的查询或输入，然后按 Enter。
• Amazon Q 使用任何提供的上下文处理您的输入并给出响应。
• 通过提供其他输入或提出后续问题来继续对话。

CLI 上的 Amazon Q Inline

要开始使用 Amazon Q CLI，请按照以下步骤操作:

• 安装 Amazon Q CLI。
• 打开新的终端或命令提示符。
• Amazon Q 根据您的输入历史记录在您输入时提供建议。按右箭头接受。

翻译

Amazon Q 的 q 翻译 命令可将您的纯英语指令(例如"将文件复制到 S3")转换为随时可用的 shell 命令，从而简化编码。当您忘记 git 操作、文件搜索或压缩等任务的确切语法时，这会有所帮助。

要开始使用，请运行以下任一命令

q translate prompt 
or
# prompt

调试

如果您在使用 Amazon Q Developer 命令行时遇到问题，请使用 q doctor。q doctor 可识别并修复常见问题。大多数情况下，您无需执行任何其他操作。

$ q doctor

✔ Everything looks good!

Amazon Q still not working? Run q issue to let us know!

贡献

完成规范是一种声明性架构，或者类似于命令行工具的蓝图。Amazon Q Developer 使用这些蓝图在您输入命令时为您提供建议。