常见问题速查

以下为高频问题的图文说明，可按需滚动查阅。

​

登录不弹出跳转提示

授权成功后，浏览器通常会询问是否打开 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，点击确认后订阅即取消。

• 取消后，当期会员不退款，权益持续到期末，不再自动续费
• 如果订阅额度消耗完，可以升级至更高档位；目前不支持额外充值

详情请见 管理订阅。

​

第三方 API Key 怎么配置

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

• Base URL
• API Key
• Model ID

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

​

设置改了中文，右侧 Agent 面板还是英文

目前 SoloEnt 为海外版，界面切换中文后仅部分提示文字改为中文，右侧 Agent 设置区域仍为英文。中文版正在研发中，请关注手册更新。 如在使用中因语言问题需要帮助，欢迎联系客服小虾🦐（QQ：1744368730）。

​

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

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

​

提示安装 Git（与 checkpoints）

部分环境下界面会提示：Git must be installed to use checkpoints. 若你不需要对话检查点（checkpoint）与版本节点回退，可忽略，不影响日常写作。 Git 用于保存检查点并在需要时回退。Mac 常预装 Git；Windows 可到 git-scm.com 安装。

​

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

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