Skip to main content
以下为高频问题的图文说明，可按需滚动查阅。如您的问题不在列表中，可查看本手册中对应功能的详细说明。
仍未解决？ 邮件 team@soloent.ai，并提供以下信息：
  1. 您的登录用户账号（邮箱地址）
  2. 您所用的客户端版本号
  3. 详细的操作步骤
  4. 必要的界面截图

​
灵蟹创作和 SoloEnt 是什么关系？有什么区别？

灵蟹创作（soloent.cn）是 SoloEnt（soloent.ai）的独立中文版本，支持微信登录和微信支付。两者的用户体系和充值余额不互通。
  • 模型范围：灵蟹创作官方仅支持中国模型；SoloEnt 官方支持所有模型，也可以接入codex、claude code 等订阅使用
  • 相同之处：两者均支持 BYOK，也都可以使用官方提供的所有插件

​
登录不弹出跳转提示

授权成功后，浏览器通常会询问是否打开 SoloEnt，页面底部也有备用按钮：
  • 在弹窗中选择 Open SoloEnt，允许打开桌面应用
  • 若没有弹窗，点击页面上的 Click here to open SoloEnt 手动唤起
授权成功页：浏览器询问是否打开 SoloEnt，以及页面上的 Click here to open SoloEnt 备用按钮 若仍无反应，多半是浏览器拦截了弹窗。以 Chrome 为例：设置 → 隐私和安全 → 网站设置（可控制网站使用位置、摄像头、弹窗等），进入后为 account.soloent.ai 允许弹窗和重定向。 Chrome 设置：隐私和安全及网站设置入口示意 在 网站设置 中打开 弹出式窗口和重定向，将 SoloEnt 相关站点设为允许后重试登录。 网站设置中的「弹出式窗口和重定向」选项，设为允许网站发送弹窗并使用重定向

​
找不到充值入口

有两个入口可以进入订阅控制台： 通过账号头像菜单选择 Dashboard 进入控制台
  • 入口二（v0.3.5 起）：点击右上角Agent 设置 → API 设置，在免费模型列表上面有升级 VIP 的提示和入口。
设置中打开 API Configuration，免费模型列表下方的 Upgrade subscription 按钮 进入网页控制台（Dashboard）后，切换到 Subscription Plan 标签，选择方案（Lite、Pro 或 Max）及计费周期（月付或年付）。 控制台 Subscription Plan 标签下选择方案与计费周期

​
订阅可以退款吗？消耗完了怎么办？

在控制台中，当前激活方案的按钮会显示为 取消订阅，点击确认后订阅即取消。
  • 取消后，当期会员不退款，权益持续到期末，不再自动续费
  • 如果订阅额度消耗完，可以升级至更高档位，也可以单独加购额外额度（注意：未开通会员无法直接充值额度）
网页控制台订阅计划页：Lite 方案下的 Cancel subscription（取消订阅）与 Buy add-on quota（加购额度）入口
加购的金额仅在当月订阅周期内生效，次月订阅续费或发生订阅变更（升降级、切换周期）时恢复为套餐基础额度，充值金额不会结转。
订阅管理的更多详情请见 管理订阅 和 完成支付。

​
第三方 API Key 怎么配置

SoloEnt 支持免费使用 BYOK。 您只需要在 API 设置 页面选择 BYOK，在下拉列表中可以选择你的 API 服务提供商。 API 设置中选择 BYOK，并在 API Provider 下拉列表中选择服务商 大部分第三方服务商的 Key 需要通过 OpenAI Compatible 配置。 需要同时填写三个字段，缺一不可：
  • Base URL
  • API Key
  • Model ID
BYOK 下 API Provider 选择 OpenAI Compatible，需填写 Base URL、API Key、Model ID 三项 如配置后无法正常使用，请先检查这三项是否填写正确。购买前请与服务商确认，部分第三方服务可能存在不稳定情况。 大多数官方服务商的 API 也可以通过 OpenAI Compatible 配置，只要你填写的 Base URL 正确。
如果你使用第三方 API，我们无法协助解决 API 调用报错相关的问题。遇到报错时，请尝试切换到更稳定的 API 再使用。
详情请见 API 配置。

​
右侧 Agent 面板显示的不是我想要的语言

SoloEnt 为国际版，在欢迎页面把界面语言改成某个语言后，仅主窗口界面的部分提示会变更。右侧 Agent的语言需要另外设置。 欢迎页/主界面右上角的 Language 与 Theme 选项 点击 Agent 面板右上角的设置图标，在通用设置中配置：
  • Preferred Language：控制 AI 回复时使用的语言，即与 Agent 对话时收到的回复语言
  • Interface Language：控制 Agent 面板界面的显示语言（菜单、按钮等），支持简体中文、English、日本語、한국어、Español
Agent 面板通用设置中的 Preferred Language 与 Interface Language 两项配置

​
Agent 不生成文件 / 不保存文件 / 总是要我手动保存

请依次检查以下两项设置。 1. 自动审批
在 Agent 窗口右下方 自动审批 设置中，选择允许 自动编辑，则 Agent 可以在你不审批的情况下自动写入项目文件。 如果没有开启，每次写入文件都需要你的确认。详见 自动审批。 自动审批设置中读取与编辑项目文件等权限开关 2. 后台编辑（Background Edit） 在 Agent 设置 → 工具设置（左侧第二项）中，编辑 区块的 后台编辑 控制是否在不抢走编辑器焦点的情况下允许后台改文件。 若你希望改稿前始终自行把关，这里请保持关闭。否则 Agent 可能在你不注意的情况下修改了文件。 Feature Settings 中 Editor 区块的 Background Edit 开关示意

​
提示安装 Git（与 checkpoints）

Windows 用户第一次使用 SoloEnt 时，可能会看到如图所示的提示。这是因为 Git 未安装，但不影响正常使用。 Git 用于在对话中保存状态节点（checkpoint），让你可以回退到某个节点重新开始。Mac 系统通常预装了 Git；Windows 系统大多需要手动安装。如果不需要节点恢复功能，可以暂时忽略此提示；需要时可前往 git-scm.com 下载安装。 SoloEnt 面板中 Git 与 checkpoints 相关的提示横幅（Git must be installed to use checkpoints）

​
上下文窗口是什么？什么时候该开新窗口？

每个会话窗口都有上下文长度限制。 在对话框上方可以看到当前窗口的会话上限和已使用的上下文大小，例如下图中的 30.2k / 300.0k——左侧是已消耗的 token 数，右侧是当前会话的上下文上限。 SoloEnt 对话框上方的上下文进度条，显示已使用 30.2k，上限 300.0k 当上下文消耗较多时，模型对早期内容的记忆会变得模糊，执行长任务时容易偏离方向。而且上限并非越大越好——过大的窗口反而会分散模型注意力、推高成本，建议把会话上限控制在 200K–300K。 建议在以下情况开启新窗口：
  • 当前任务已完成，准备开始下一个独立任务
  • 单窗口已用到约 100–150K（超过 200K 后继续使用还可能带来成本激增）
  • 切换到与当前话题无关的新方向
一般建议单个窗口超过 100k 即可考虑新开窗口。
开新窗口前，可以先用 /compact 把当前会话压缩为简短概要，或让 Agent 汇总要点并写入 SOLOENT.md，这样新窗口能快速恢复上下文，而不必从头堆积 token。 详情见 合理运用上下文窗口 与 SOLOENT.md 指南。

​
为什么项目不会自动生成 SOLOENT.md 了？

从 v0.2.0 起，SOLOENT.md 不再自动生成。你可以在项目任意阶段通过 /init 命令手动创建，短篇或无需跨会话上下文追踪时也可以选择不用。

​
为什么有时候文件写到一半失败或反复重新生成？

常见原因有以下几种：
  • 写入过程中被人工打断：Agent 正在编辑文件时，你同时编辑该文件、关闭 Agent 的操作编辑框，或在模型思考时改动内容，都可能造成内容重复或截断
  • BYOK 模型输出被截断：第三方接入的模型可能限制了最大输出长度，输出被截断会导致写文件的工具调用失败
  • 客户端版本过旧：旧版本对较新模型的支持较差，请检查当前客户端版本并保持更新
  • 单窗口上下文过长：上下文过长时，模型返回的工具调用格式容易出错。建议先整理好 SOLOENT.md 记忆文件，再开新会话继续，不要长期停留在同一个会话