CocosCopilot

更新说明

• 版本号：v_0.1.3
• 更新时间：2023.8.9
• 更新内容：
  1. 修复登录异常问题
  2. 优化代码补全功能，支持自助开关该功能；
  3. 优化选中代码时在对话框中展示并给出快捷操作；
  4. 优化代码补全响应速度；
  5. 优化登录掉线缺陷。

前言

Cocos Copilot 项目是 Cocos 对于 AI 工具的一次尝试，旨在提高 Cocos 开发者的游戏开发效率，为 Cocos 整体生态添砖加瓦，助力 Cocos 开发者更快更好地开发游戏。

目前 Cocos Copilot 仍处于内测阶段，我们将邀请一些有兴趣和想法的开发者进行内测体验，并根据反馈的内容和意见，对 Cocos Copilot 进行改进和优化，甚至可能进行大幅度的重构。

如果您是一名对 Cocos Copilot 项目感兴趣的开发者，可以扫描下方二维码，添加 Cocos 布道师老王 的微信号，并备注“Copilot+公司名称/个人名称”，我们会为您开通权限并安排加入 Cocos Copilot 内测交流群，与开发人员进行实时讨论和反馈。对于这个项目来说，包括模型调教、交互方式、支持功能等都还有很长的路要走，希望 Cocos 社区的伙伴能够参与进来，多提建议。在此对参与内测和为 Cocos Copilot 提出优化建议的小伙伴们表示衷心的感谢。

【注意】当前cocos copilot最低要求为vscode版本号为1.78.0

Cocos Copilot 简介

Cocos Copilot 是一款基于自然语言生成代码的 VS Code 插件工具，通过对 AI 大模型定制化及微调开发而来；可以回答开发者的问题、提供代码方案、查询代码含义等。具体表现为能够根据自然语言生成代码、快速插入生成的代码、一键复制生成的代码，并且支持生成多个候选代码，代码补全，以及根据当前选中的代码进行交互操作；

当前功能如下：

• 进行及删除对话
• 快速插入生成的代码
• 一键复制生成的代码
• 生成多个候选代码
• 代码优化
• 代码解释&注释
• 代码补全

同时也具备以下特性：

• 支持生成的代码语言为 JavaScript 和 TypeScript。
• 能够识别当前使用的 Cocos 引擎版本，根据引擎版本输出符合该版本的代码和问题答案。
• 针对选中代码进行互动
• 支持快捷键操作（Ctrl+K唤起代码生成命令窗口）
• 支持开发者进行偏好设置

我们也将在后续的内测过程中，对功能进行逐渐的增加和优化迭代。

使用说明

流程示意

由于 Cocos Copilot 目前还处于内测状态，需要联系 Cocos 官方人员 开通权限 后，才能进行测试使用。

下载与安装

Cocos Copilot 已经上架 VSCode 应用商店，开发可以通过 链接 跳转下载，或者在 VSCode 的 扩展 中搜索 CocosCopilot 下载插件。

授权登陆

安装完成后，在 VSCode 的左侧边栏中，会出现一个带有 Cocos 图标 Logo 的 Cocos Copilot 插件。点击该图标，就会在 VSCode 中弹出 Cocos Copilot 对话框。

第一次使用时，需要登录 Cocos 账号进行授权才能正常使用。点击对话框上显示的 login 按钮，就会自动跳转到 Cocos 网页中进行授权，点击同意后会自动返回到 VSCode 插件中。在授权完成后，开发者便可以开始正常使用 Cocos Copilot。

交互方式

问答对话模式（chat）：可以和copilot进行问答沟通，需要注意受限于产品定位 Cocos copilot在代码相关领域的回答会更具参考性，其它问题的答案可能会出现误导和偏差。

代码生成模式（generate）：代码生成模式，可以通过快捷键（Ctrl+K）唤起窗口进行代码生成活动（也可通过编辑区右键 Cocos copilot ->Generate code唤起）。

自动补全模式（auto completion）：当您停止输入时，会从当前光标处开始生成。生成完毕之后会以“灰色”显示，按Tab即可插入生成结果。

功能说明

输入及删除对话

安装完成后，点击左侧边栏的 Cocos Copilot 插件 Logo，即可在 VS Code 中看到插件界面。开发者可以在界面下方的对话框内输入问题，输入完毕后点击 Ask 按钮进行发送，等待几秒后即可在对话框内看到问题的反馈。

提问方式有以下两种：

1. 直接输入想要生成的代码需求或注释，Cocos Copilot 会根据需求生成代码。如果提供的信息不够完整，Cocos Copilot 可能会要求补充信息。

2. 选中一部分已有代码，让 Cocos Copilot 对这段代码进行注释、扩展或其他需求。

开发者可以根据反馈情况是否满意，决定是否继续输入问题。Cocos Copilot 插件支持进行上下文联系。当开发者觉得之前的问题可能会影响 Cocos Copilot 对问题的回答时，可以点击插件框右上角的删除按钮，清除之前的所有问题。

生成多个候选代码

开发者可以通过在与 Cocos Copilot 对话的时候，通过文字描述，要求 Cocos Copilot 一次性生成多种解决方案或代码，开发者可以在多种方案中选择适合自己情况的代码进行使用。

代码优化

除了生成新的代码，Cocos Copilot 还具备优化和拓展现有代码的功能。通过对选中的代码进行分析，工具可以识别出其中的潜在问题或优化空间，并为您提供相应的建议。这些建议可能包括代码的简化、性能的优化、逻辑的重构等方面。您可以选择接受这些建议并将其应用到您的代码中，以提高代码的质量和可维护性。

代码解释&注释

Cocos Copilot 提供了快速解释和注释代码的功能；

• 对于不理解的代码可以要求copilot给出解释；

• 而需要补充注释的代码，您无需手动编写注释内容，只需简单描述即可完成注释的生成。

复制生成代码

当开发者通过插件对话获得所需代码后，Cocos Copilot 插件支持快速将所生成的代码 一键复制到剪贴板，方便开发者粘贴使用到合适位置。

插入生成代码

Cocos Copilot 提供了将生成的代码一键式快速插入到开发者 当前脚本 的点击位置的功能。但需要注意的是，插入后的代码并不能自动去重，需要进行人工去重处理。

代码补全

在编码过程中Copilot会自动辅助你一起编码，当您停止输入时，会从当前光标处开始生成。生成完毕之后会以灰色显示，按Tab即可插入生成结果。

如果这干扰到您的编码工作，也可在设置中进行关闭此功能。

未来功能计划

目前，Cocos Copilot 处于邀请阶段，我们将不断增加相关功能，并对目前存在的不足之处进行优化。

下面是我们未来一段时间的计划：

• 辅助功能，快捷键输入指令（短期）
• 辅助功能，右键选择预置指令（短期）
• 核心功能，代码补全（中期）
• 核心功能，代码引入适配性（中等）
• 核心功能，提高代码可用性（长期）

当然，我们也会根据内测结果和反馈对未来计划进行增删修改。我们衷心希望 Cocos Copilot 能够成为利用人工智能辅助 Cocos 开发者提高开发效率的好工具。当然，这离不开各位开发者的支持和共同反馈。希望大家能够在当前阶段提出更多建议，让我们更好地改进。

再次真诚感谢各位的支持。

FAQ

Q: 为什么我下载安装 Cocos Copilot 插件后无法打开使用？

A: 首先需要确认自己的 Cocos 账号是否已经开通权限，其次需要确认是否已经成功登录。如果仍然无法使用，可以联系官方人员获取帮助。

Q: Cocos Copilot 和其他 Chat AI 大模型有什么区别？

A: Cocos Copilot 是基于 AI 大模型通过对模型进行相关定制化微调开发的 AI 工具。我们输入了大量的 Cocos 数据进行训练，使其更适合 Cocos 开发者，大大提高了 Cocos 开发者提问相关问题的准确性。同时，Cocos Copilot 也限制了只能咨询与 Cocos 开发相关的问题。

Q: 为什么我的 VSCode 不能安装使用 Cocos Copilot？

A: Cocos Copilot 插件需要在 VSCode 1.78.0 版本及以上才能使用。

联系我们

请扫码添加 Cocos 布道师老王微信，并备注“Copilot+公司名称/个人名称”，提供使用反馈或获取帮助。