SmartCode AI编码助手 VSCode插件

SmartCode 为使用 Visual Studio Code IDE 的开发者提供了简单易用的 AI编码助手 插件，提供多种开发语言 包括：JavaScript、Node.JS、Java、Kotlin、Python、Go、C#等的支持。提供智能代码补全、智能代码生成、智能代码重构、智能代码导航、智能代码分析等功能，帮助开发者提升编码效率，降低编码成本，提高代码质量。本文档将引导用户完成SmartCode插件的安装和登录AISE系统的基本操作，同时对插件更新机制和插件配置进行说明。

安装、配置和登录系统

本文档引导用户完成 SmartCode 插件的安装和登录AISE系统的基本操作，同时对插件更新机制和插件配置进行说明。

强烈建议：所有初次使用SmartCode的用户完成此练习内容。

获取插件安装包

SmartCode VSCode 插件作为 AISE系统针对 Visual Studio Code 提供的 AI编码助手 插件，可以通过 AISE服务 进行获取。您需要首先从您组织指定的 AISE管理员 处获取以下信息:

  • AISE服务地址
  • 您的AISE账号

获取以上信息后，请按以下操作步骤进行操作：

  1. 打开浏览器，并输入 【AISE服务地址】

  2. 输入您的 【AISE账号】，即可进入如下界面

用户登录首页

  1. 点击左侧菜单的 应用 | 应用市场 ，即可进入如下界面

应用市场首页

  1. 根据您所使用的IDE点击对应应用上的 安装 按钮，即可下载最新的 插件安装包。VSCode安装包为vsix格式。

插件安装和更新

插件安装和服务地址配置

  1. 下载完成后，打开 Visual Studio Code，在左侧工具栏上点击 插件 图标，在右上角的 … 菜单 上选择 从 VSIX 安装，在弹出的文件选择对话框中选择上一步下载的 vsix 文件，即可完成安装。

VSCode 插件安装

  1. 安装完成后会出现类似以下提示信息，并在工具栏上显示 SmartCode 字样，表示安装成功。

VSCode 插件安装

  1. 配置 【AISE服务地址】，如果您的插件是通用插件，可能需要先配置服务地址才能使用。

点击上图中的 打开设置，或者点击 SmartCode图标，在弹出的菜单中选择 设置。

VSCode SmartCode 配置入口

这个操作会开启 VSCode 内置的设置界面，同时过滤到 SmartCode 相关的配置项上，在其中找到 AISE服务地址 配置项，输入您的 【AISE服务地址】。如果您的地址正确，底部状态栏会变成 SmartCode [请登录] 的状态。

VSCode SmartCode 配置服务地址

登录

以上配置好服务地址后，用户即可使用自己的 【AISE账号】登录系统。

  1. 点击状态栏上 SmartCode 图标，在弹出的菜单中选择 登录

VSCode SmartCode 登录

  1. VSCode 会提示用户打开浏览器或者通过复制登录地址方式手工登录，点击 打开 按钮。

VSCode SmartCode 登录

  1. 在开启的浏览器中使用您的【AISE账号】完成登录，浏览器显示如下信息，即代表登录成功。插件端应该在几秒钟内检测到登录状态，自行完成登录。完整登录过程视频如下

获取插件信息

SmartCode 插件提供一个 关于 界面，包含了插件和IDE的基本信息，这些信息有助于在遇到问题时的定位。用户可以通过点击状态栏 SmartCode图标 并选择 插件信息 开启。

插件信息

弹出的视图中包含一个 复制 按钮，可以用来复制所有信息。

插件信息

插件配置

SmartCode for VSCode 的插件配置分为 通用配置 和 Chat配置 两部分，通用配置通过 VSCode 内置的配置系统实现，属于静态配置；Chat配置则嵌入在 SmartCode Chat 界面中，为用户提供更灵活的动态配置能力。

管理通用配置

管理通用配置可以通过点击 SmartCode 状态栏图标，并选择 配置 进入以下界面

插件信息

当前支持的配置项和功能说明如下

配置项 说明
Smartcode:Language
SmartCode 语言		 控制在Chat中大模型回复所使用的默认语言，支持：
• 中文（默认）
• 英文
说明：此配置可以与VSCode的界面语言不同，允许用户实现英文版VSCode上使用中文大模型进行交互
Smartcode:Version Check Mode
SmartCode 自动更新模式		 控制SmartCode的自动更新行为
• Always（默认）- 在新版本出现时总是提示用户，由用户选择安装
• AlwaysUpdateQuite - 在新版本出现时立即下载并更新，只提示用户重新启动VSCode应用更新
• Manual - 不会自动检查新版本，由用户通过菜单中的 版本检查 触发新版本检查和更新动作
Smartcode:Version Check Notification
SmartCode 自动更新通知提示方式		 控制SmartCode在检测到新版本时对用户的通知行为
• On（默认）- 在检测到新版本是立即通知用户
• Off - 不通知用户
• OffUntilRestart - 在下次重启VSCode之前停止通知
说明：新版本通知上提供按钮，允许用户设置为 Off 或者 OffUntilRestart。
Smartcode:Aise Host
AISE服务地址		 控制SmartCode插件所连接的服务器地址
说明：企业版插件一般都会内置服务器地址。
Smartcode:Enable
编程语言代码补全控制		 针对代码补全特性，允许用户控制在某种开发语言中开启或者禁用代码补全特性。需要通过手工编辑 setting.json 的方式实现。
Smartcode:Inline Suggest:Enable
是否提供行内代码补全		 控制是否启用代码补全功能
Smartcode:Editor: Enable Auto Completions
自动显示行内代码补全		 控制是否在编辑器中自动显示补全内容
Smartcode:Emoji Enabled
简化版Emoji表情符号作为Git提交信息		 控制是否在生成提交注释时使用Emoji表情符号
Smartcode:Full Git Moji Spec
完整的 GitEmoji 表情符号作为Git提交信息		 控制是否在生成提交注释时使用完整的 GitEmoji 表情符号

管理Chat配置

点击Chat窗口右上角的 设置图标 即可进入Chat配置页面

插件信息

当前支持的配置项和功能说明如下

配置项 说明
模型 控制当前对话所使用的大模型实例。
AISE服务允许配置多个大模型实例，并允许管理员根据用户在部门控制面板可见的对话模型。此列表中列出的是当前用户可用的大模型实例。
AI助理 控制当前对话为大模型设定的AI助理角色。
AISE服务允许管理员为不同用户设定不同的AI助理角色行为，即大模型的系统消息设置（System Message），通过系统消息可以控制模型当前的角色设定，确保模型行为符合企业组织策略。
AISE服务也允许用户通过AISE服务
行为 控制大模型行为模式，提供以下选项
• 精确（默认）- 适用于大多数软件开发场景，确保模型在同样提示下所生成的内容尽量保持一致
• 平衡 - 适当放宽模型的自由度，适合于需要尝试不同选择的场景，模型在同样提示下产生不同生成内容的可能性适当增加
• 创造力 - 允许模型进行发挥和创造
回复长度 控制每次大模型请求生成内容的最大token长度，提供以下选项
• 400（默认）
• 800
• 1000
• 2500
说明：由于不同模型所支持的最大生成token宽度不同，此设定需要根据当前模型的能力适当调整
历史 控制是否为当前大模型请求添加历史消息，提供以下选择
• 自动（默认）：根据当前用户上下文token余量，自动添加尽量多的历史消息
• 不包含：禁用历史消息，每次对话均独立

自动升级

SmartCode for VSCode 插件配合 AISE服务 支持自动升级能力，此功能不依赖VSCode插件市场，可以在企业内部实现新版插件的推送和自动更新，并允许用户或者管理员对于升级行为进行细化控制。 版本检测或者升级过程如下

  1. 当用户重新启动VSCode时，SmartCode会自动连接服务器检查是否存在可升级的新版本。用户也可以通过点击 状态栏的SmartCode图标，在弹出的菜单中选择 版本检查 的方式手工触发。 一旦检测到新版本，会弹出以下消息提示用户。用户可以选择 升级 或者 取消 本次升级。

插件升级

  1. 用户点击 升级 按钮后，SmartCode会在后台自动下载新版本安装包并更新当前环境的插件。升级完成后会有如下提示。

插件升级

  1. 点击 重新加载 即可完成整个升级过程。