@aws/lsp-codewhisperer

中文文档
0.0.133发布于 2026/10/29Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 3240

代码Whiper 语言服务器

中文使用文档
文档目录5 节
  1. 指南
  2. 代理服务器
  3. 网络工人运行时间
  4. 正在获取 Amazon Q 配置
  5. 支持的工作空间配置

代码Whiper 服务器

指南

代理服务器

要在代理服务器后方使用 CodeWhiper 服务器,请导入 CodeWhispererServerTokenProxy 作为服务器并设置环境变量 HTTPS_PROXY 或者说 https_proxy 到您正在使用的代理 URL. 你可以将环境变量传递到进程上,或者仅仅在你的系统上在全球设置.

export HTTPS_PROXY=https://proxy.example.com:5678
export https_proxy=https://proxy.example.com:5678

或者说

export HTTPS_PROXY=http://username:[email protected]:5678
export https_proxy=http://username:[email protected]:5678

网络工人运行时间

此软件包所执行的Amazon Q 服务器可能具有对NodeJS本土模块的依赖性,在非Node.js环境中无法提供.

要制作跨平台捆绑,使用允许有相容替代品(如Webpack)的压倒性模块的捆绑器.

此软件包中使用的节点JS模块

  • 代码WhiperServer:
    • path
  • 安全扫描服务器 :
    • path, (中文(简体) ), os

要覆盖模块,使用下一个选项:

正在获取 Amazon Q 配置

以下的 Amazon Q 配置可以随 : aws/getConfigurationFromServer 请求 Qfigation 服务器数字 :

  • 定制
  • 开发者配置文件

请求要求 section 参数,确认以下选项:

  • aws.q
    • aws.q.customizations
    • aws.q.developerProfiles

示例

await languageClient.sendRequest(getConfigurationFromServerRequestType.method, {
            section: 'aws.q',
        })
// result:
{
  'customizations': [customization1, customization2, ...],
  'developerProfiles': [profile1, profile2, ...] // (if enabled)
}

Granular 请求, 如 aws.q.customizations 将只返回特定的配置.

示例

await languageClient.sendRequest(getConfigurationFromServerRequestType.method, {
            section: 'aws.q.customizations',
        })
// result:
[customization1, customization2, ...]

开发者配置文件

默认情况下, 开发者配置文件不被获取 。 为了能够获取,客户端需要在初始化时发出支持信号 InitializeParams。 。 。 .

示例

const params: InitializeParams = {
  // ...
  aws: {
    // ...
    awsClientCapabilities: {
      q: {
        developerProfiles: true
      }
    }
  }
}

支持的工作空间配置

服务器支持如下 工作空间配置数字 :

  • aws.q.customization (类型 : string | undefined,默认值 : undefined(中文(简体) )
    • API 请求中使用的自定义 ARN, 空字符串将被解释为未定义 .
  • aws.q.optOutTelemetry (类型 : OPTOUT | OPTIN,默认值 : OPTIN(中文(简体) )
    • 此旗帜可以控制是选入还是选出遥测.
  • aws.q.inlineSuggestions.extraContext (类型 : string | undefined,默认值 : undefined(中文(简体) )
    • 要包含的额外上下文, 一个空字符串将被解释为未定义 。 见 下级 为更多背景.
  • aws.q.inlineChat.extraContext (类型 : string | undefined,默认值 : undefined(中文(简体) )
    • 内置聊天要包含的额外上下文, 一个空字符串将被解释为未定义 。 见 下级 为更多背景.
  • aws.codeWhisperer.includeSuggestionsWithCodeReferences: (类型 : boolean,默认值 : false(中文(简体) )
    • 此旗帜控制是否包含带有代码建议的引用 .
  • aws.codeWhisperer.shareCodeWhispererContentWithAWS: (类型 : boolean,默认值 : false(中文(简体) )
    • 此旗帜控制是否与 AWS 共享 Q 内容 .

客户端可以使用 DidChangeConfiguration 通知.

Q 内含建议的额外上下文

当客户端在需要定制建议的特定环境中运行时,服务器支持一个 aws.q.inlineSuggestions.extraContext 工作空间配置 。 此额外上下文将传递到文件开头的请求的左侧文件内容 .

Q 内置聊天的额外上下文

当客户端在需要定制内置聊天响应的特定环境中运行时,服务器支持一个 aws.q.inlineChat.extraContext 工作空间配置 。 这个额外的上下文将准备到请求的文件文本中,类似于内置建议是如何工作的.

版本与发布记录

@aws/lsp-codewhisperer 共发布 125 个版本,首次发布于 2024/03/08;过去 12 个月发布了 44 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.0.133latest2026/10/2910 天前
0.0.1322026/10/2316 天前
0.0.1312026/10/1623 天前
0.0.1302026/10/0929 天前
0.0.1292026/10/021 个月前
0.0.1282026/09/101 个月前

关于 @aws/lsp-codewhisperer 的常见问题

@aws/lsp-codewhisperer 是什么?

代码Whiper 语言服务器

如何安装 @aws/lsp-codewhisperer?

在项目目录运行 npm install @aws/lsp-codewhisperer,或使用 pnpm add / yarn add / bun add。

@aws/lsp-codewhisperer 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aws/lsp-codewhisperer 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@aws/lsp-codewhisperer 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aws/lsp-codewhisperer 可以商用吗?

@aws/lsp-codewhisperer 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws/lsp-codewhisperer 的下载量有多少?

根据 npm 官方下载统计,@aws/lsp-codewhisperer 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,240 次,日均约 108 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aws/lsp-codewhisperer 还在维护吗?

最新版本 0.0.133 发布于 2026/10/29(10 天前);至今共发布 125 个版本,其中过去 12 个月发布了 44 个;首次发布于 2024/03/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。