常见问题速查

Documentation Index

Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt

Use this file to discover all available pages before exploring further.

以下为高频问题的图文说明，可按需滚动查阅。如您的问题不在列表中，可查看本手册中对应功能的详细说明。

​

登录不弹出跳转提示

授权成功后，浏览器通常会询问是否打开 SoloEnt，页面底部也有备用按钮：

• 在弹窗中选择 Open SoloEnt，允许打开桌面应用
• 若没有弹窗，点击页面上的 Click here to open SoloEnt 手动唤起

若仍无反应，多半是浏览器拦截了弹窗。以 Chrome 为例：设置 → 隐私和安全 → 网站设置（可控制网站使用位置、摄像头、弹窗等），进入后为 account.soloent.ai 允许弹窗和重定向。 在 网站设置 中打开 弹出式窗口和重定向，将 SoloEnt 相关站点设为允许后重试登录。

​

找不到充值入口

有两个入口可以进入订阅控制台：

• 入口一：点击账号头像打开菜单，选择 Dashboard，跳转至 account.soloent.ai/en/dashboard

• 入口二（v0.3.5 起）：打开应用内 设置（齿轮图标）→ API Configuration，在免费模型列表下方点击 Upgrade subscription

进入网页控制台后，切换到 Subscription Plan 标签，选择方案（Lite、Pro 或 Max）及计费周期（月付或年付）。

​

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

在控制台中，当前激活方案的按钮会显示为 Cancel subscription，点击确认后订阅即取消。

• 取消后，当期会员不退款，权益持续到期末，不再自动续费
• 如果订阅额度消耗完，可以升级至更高档位，也可以单独加购额外额度（注意：未开通会员无法直接充值额度）

通过 Stripe 可以使用微信和支付宝进行充值。充值金额仅在当月订阅周期内生效，次月订阅续费或发生订阅变更（升降级、切换周期）时恢复为套餐基础额度，充值金额不会结转。 详情请见 管理订阅 和 完成支付。

​

第三方 API Key 怎么配置

大部分第三方服务商的 Key 需要通过 OpenAI Compatible 配置，在设置的 API Provider 下拉列表中可以找到。 需要同时填写三个字段，缺一不可：

• Base URL
• API Key
• Model ID

如配置后无法正常使用，请先检查这三项是否填写正确。购买前请与服务商确认，部分第三方服务可能存在不稳定情况。 详情请见 API 配置。

​

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

从 v0.3.8 起，右侧 Agent 面板提供两项独立的语言设置。请先确保已更新至最新版本，然后点击 Agent 面板右上角的设置图标，在通用设置中配置：

• Preferred Language：控制 AI 回复时使用的语言，即与 Agent 对话时收到的回复语言
• Interface Language：控制 Agent 面板界面的显示语言（菜单、按钮等），支持简体中文、English、日本語、한국어、Español

如果你切换主界面语言为中文，但右侧 Agent 面板界面显示为英文，请检查 Interface Language 是否已切换。详见语言设置。

​

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

请依次检查以下两项设置。 1. 自动审批
在 Agent 设置 → 自动审批（或等价入口）中，是否允许 **Edit（编辑）**写入项目文件。若已开启，Agent 可直接改文件；若未开启，每次写入往往需要你的确认。详见 自动审批。 2. 后台编辑（Background Edit）
在 设置 → Feature Settings（左侧双勾图标）中，EDITOR 区块的 Background Edit 控制是否在不抢走编辑器焦点的情况下允许后台改文件。若你希望改稿前始终自行把关，可保持关闭。

​

提示安装 Git（与 checkpoints）

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

​

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

每个会话窗口都有上下文长度限制。在对话框上方可以看到当前已使用的上下文量，例如下图中的 38.5k / 128.0k——左侧是已消耗的 token 数，右侧是该模型单个会话的上下文上限。 当上下文消耗较多时，模型对早期内容的”记忆”会变得模糊，执行长任务时容易偏离方向。建议在以下情况开启新窗口：

• 当前任务已完成，准备开始下一个独立任务
• 上下文占用超过约 60–70%，感觉模型开始”忘事”
• 切换到与当前话题无关的新方向

长篇写作的建议做法：在项目中用 /init 生成 SOLOENT.md，将角色、大纲、当前进度等关键上下文写入其中。这样每次开新窗口，模型都能通过读取 SOLOENT.md 快速恢复项目全貌，而不依赖单一会话窗口积累的上下文。适时新开窗口，反而有助于模型保持专注和执行力。 详情见 SOLOENT.md 指南。

​

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

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