跳转到主要内容

install-issues

安装问题​

详细参考：https://qcnp3evdcnt3.feishu.cn/wiki/DqmfwOjZOiSr2nktooacOldpnEC

安装时一直显示正在安装，但是始终无法成功安装​

  • 现象如图：
VS Code应用商店中的YouCode扩展安装界面
  • 问题原因：vscode版本过低
  • 解决办法：升级vscode，版本至少要1.100。官网下载，或者svn上下载

安装时报错Can't install'szlanyou.you-code-next' extension because it is not compatible with the current version of Visual Studio Code (version 1.xx.x).​

  • 问题原因：vscode版本过低
  • 解决办法：升级vscode，版本至少要1.100。官网下载，或者svn上下载

IDEA端插件市场中搜索不到友码NEXT​

  • 问题原因：没有添加本地仓库
  • 解决办法：添加本地仓库
  • 解决步骤: 点击查看

安装或者升级后报错Node.js缺失或者Node.js environment missing​

  • 问题原因：node.js未安装或者版本太低
  • 解决办法：安装22版本的node.js，到联友桌面助手搜索node，点击安装

安装了node.js以后，在cmd执行node -v正常返回，在IDEA的终端中执行node -v时，显示node不存在​

  • 问题原因：公司桌面助手限制导致的
  • 解决办法：找联友桌面助手运维人员（毛进）解决

IDEA打开友码NEXT后，一直显示友码正在初始化​

  • 问题原因：
    • node没有安装或者node版本过低(必须大于20)，先安装node.js
    • 若已经安装node，可能是IDEA正在加载索引，等待加载完毕
  • 解决办法：等待idea把索引加载完毕，idea下方会有提示消息

IDEA打开友码NEXT后，提示Something went wrong​

详细错误：

Something went wrong (v1.1.7)
Please report this issue on our GitHub: Open GitHub IssueCopy error details below to include in your report:Error Stack:TypeError: window.cefQuery_34696266_1 is not a functionat window.sendMessageToPlugin (http://localhost:12345/index.html:19:36)at Object.postMessage (http://localhost:12345/index.html:48:48)at postMessage (../../../../webview-ui/src/utils/vscode.ts:35:18)at <anonymous> (../../../../webview-ui/src/context/ExtensionStateContext.tsx:480:9)at markComponentLayoutEffectMountStarted (../../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.development.js:25352:18)at invokePassiveEffectMountInDEV (../../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.development.js:27404:13)at invokeEffectsInDev (../../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.development.js:29657:11)at invokeEffectsInDev (../../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.development.js:29666:11)at commitPassiveMountEffects (../../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.development.js:29638:9)at flushPassiveEffects (../../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/cjs/react-dom.development.js:29497:11)
  • 问题原因：IDEA插件崩溃，可能是电脑内存、cpu资源不足
  • 解决办法：关闭不使用的软件，重启IDEA

点击登录没有反应或者登录后浏览器无法跳转回VSCode​

问题原因：部分机器的配置或者部分公司的安全桌面导致跳转受限 解决方式：

  1. 登录开发云
  • 点击后，可以在调试页面看到对应的token信息，拷贝下来，不要带 "Bearer" 只获取后面即可

2.打开命令行

  • 打开命令行(win+r)， 输入cmd，进入命令行终端界面
  • 输入 start vscode://szlanyou.you-code-next/kilocode?token=刚才拷贝的token
  • 回车，切回vscode，vscode弹出对话框，点击open（确认）。

vscode安装友码后页面加载不出来​

  • 现象如图：
  • 问题原因1：vscode本身问题或者vscode版本过低
  • 解决办法1：
    • 重启vscode，如果显示正常，不用执行第二步；
    • 升级vscode，版本至少要1.100。官网下载，或者svn上下载。

之前可以正常使用，更换网络环境、重新登录后页面加载不出来​

  • 问题原因：网络问题
  • 解决办法：
    • 打开https://youcode.szlanyou.com/youcode-docs/， 如果无法打开次网页，说明网络不通，请联系it；如果可以打开，进入下一步
    • 切换网络，比如使用手机热点(可选)
    • 删除vscode配置
      • 打开我的电脑，输入C:\Users\你的用户名\AppData\Roaming\Code\User\globalStorage（注意替换你的用户名）
      • 删除文件state.vscdb、state.vscdb.backup、storage.json
    • 重启vscode
    • 重新登录友码

提问时显示API流式传输失败​

  • 现象如图：
  • 问题原因：电脑没有配置powershell的环境变量
  • 解决办法：设置powershell的环境变量，在环境变量的PATH字段中添加powershell的路径

使用非联友的VPN时提示网络错误​

  • 问题原因：非联友的VPN可能有网络限制
  • 解决办法：
    • 联系VPN负责人把youcode.szlanyou.com加入白名单
    • 手动修改hosts文件（这里解决步骤以修改hosts文件为例）
  • 解决步骤：
    • 先关闭VPN工具
    • 打开cmd工具，执行ping youcode.szlanyou.com，复制里面的ip为172.24.167.5（以实际为准）
    • 以管理员权限打开hosts文件（或者使用联友桌面工具），路径为C:\Windows\System32\drivers\etc\hosts
    • 增加一行，保存文件 
      172.24.167.5 youcode.szlanyou.com

环境变量或者hosts如何修改​

步骤

  • 打开联友桌面桌面
  • 打开软件商城
  • 打开全部软件->系统工具
  • 安装windows环境变量编辑器和windows-hosts编辑器

使用问题​

对话后显示API Request FailedInternal endpoint failed: OpenAI completion error: Connection error..​

  • 问题原因：网络问题
  • 解决办法：排查网络问题
  • 步骤:
    1. 排查是否能访问友码
      1. 浏览器输入:https://youcode.szlanyou.com/youcode-docs/
      2. 如果能够访问，查看第二步；如果不能访问，请联系公司网络维护人员
    2. 排查是否开启了vpn
      1. 使用了客户方自己的vpn工具，点击查看解决办法
      1. idea开启了代理工具：
          1. 打开idea的设置
          1. 输入proxy，修改为无代理，点击确定,重新对话

友码回答问题时不是中文​

  • 问题原因：vscode的语言设置默认为英文，导致友码安装后默认也使用了英文
  • 解决办法：手动设置友码版本为中文
  • 步骤：打开友码->设置->语言，选择简体中文

如何使用自动补全功能​

自动补全默认关闭，需要手动打开 开启步骤

  1. 打开友码->设置->内联辅助，勾选 启用内连辅助
  2. 点击保存

如何减少自动读取太多文件​

解决方法:

  • 通过全局规则进行限制

步骤

  1. 增加全局规则 read_file_rule.md
  2. 增加内容如下
# read_file_rule.md

文件读取使用指南

## 指导原则

- 优先在不读取文件的情况下，完成任务
- 必须读取文件时，尽量减少需要读取的文件数量

如何关闭模式自动切换​

解决方法:

  • 修改配置

步骤

  1. 打开友码->设置->自动批准
  2. 在自动批准启动中，点击按钮模式可以开关模式切换功能
  3. 点击保存

回到检查点功能没有生效​

原因:

  • 检查点功能依赖git，工程没有使用git初始化是无法使用检测点功能的

解决方法:

  • 在工程中执行git init

使用时出现友码遇到问题…这可能表明模型思维过程失败或无法正确使用工具，可通过用户指导来缓解（例如 "尝试将任务分解为更小的步骤"）。​

原因:

  • 大模型调用工具失败

解决方法:

  • 切换别的模型，新开一个任务，重新执行

使用时报错API Request Failed:nternal endpoint failed: OpenAI completion error: 429...​

原因:

  • 当前使用此模型人数过多

解决方法:

  • 切换别的模型或者等一会

使用时"警告: JCEF 不支持。"​

原因:

  • JCEF（Java Chromium Embedded Framework）是 YouCode 基于网页的界面在 JetBrains IDE 中正确显示的必要条件。大多数 JetBrains IDE 默认支持 JCEF，但部分配置可能需要手动激活。

解决方法:

Android Studio:​

JCEF 可在 Android Studio 中使用，但可能需要手动启用：

1.打开设置/偏好设置：

  • Windows/Linux：文件→设置
  • macOS：帮助→寻找行动

2.导航到启动 Java 运行时：

  • 选择IDE启动Java Runtime......

3.选择一个新的运行时

  • 选一个名字里有“与JCEF合作”的

4.重启Android Studio：

  • 关闭并重新打开Android Studio，更改才会生效

5.验证：

  • 打开友码面板
  • JCEF警告应该已经消失，接口也能正常加载

IntelliJ IDEA​

IntelliJ IDEA 默认应启用 JCEF。如果你看到JCEF的警告：

1.更新IntelliJ创意：

  • 确保你使用的是最新版本
  • 前往帮助→查看更新

2.验证JetBrains运行时间：

  • IntelliJ IDEA 默认应该使用 JetBrains 运行时（JBR）
  • JBR包括JCEF的支持

3.查看高级设置：

  • 进入文件→设置（Windows/Linux）或 IntelliJ IDEA →偏好设置（macOS）
  • 进入高级设置
  • 寻找任何与JCEF相关的选项，并确保它们已启用

其他 JetBrains IDE​

针对WebStorm、PyCharm、PhpStorm、RubyMine、CLion、GoLand、DataGrip和Rider：

1.更新至最新版本：

  • 大多数JCEF问题在近期版本中已得到解决
  • 使用内置更新器：帮助→检查更新

2.验证JetBrains运行时间：

  • 这些IDE默认应该使用 JetBrains 运行时
  • JBR包括全面的JCEF支持

3.检查设置：

  • 进入文件→设置（Windows/Linux）或[IDE名称]→偏好设置（macOS）
  • 进入高级设置
  • 启用任何与JCEF相关的选项