常见问题

激活与授权

激活提示"卡密无效"? 核对输入(格式 XXXX-XXXX-XXXX-XXXX,可含连字符);确认从正规渠道购买。仍无效请联系售卖渠道。

提示"已绑定其他设备"? 这张卡已绑在别的电脑上。旧电脑能开机就在旧电脑面板「解绑」;不能就用提示里的自助换绑链接(每卡 30 天一次)。

到期了怎么办? 买一张新卡,在面板同一个输入框输入即续费,授权记录不变,历史数据不受影响。

断网能用吗? 能。授权本地校验,网络恢复后续签;自令牌过期起 72 小时宽限。

想换电脑长期使用? 面板「解绑本机」→ 新电脑激活。解绑不清除剩余时长。

连接与使用

客户端里看不到工具?

1. 服务是否已启动(面板右上角开关);
2. 工作空间是否启用;
3. 客户端配置的 URL 是否与面板复制的完全一致(含 UUID);
4. 客户端是否支持 Streamable HTTP 传输。

手机 / 外网的 AI 连不上? 必须使用公网隧道地址(https 域名),不是 127.0.0.1。见公网访问。

搜索工具报错提到 ripgrep? 安装包已附带 rg.exe;便携版请安装 ripgrep(winget install BurntSushi.ripgrep.MSVC)或在配置指定 ripgrepPath。

诊断/符号工具返回空? 对应语言未配置语言服务器,见功能手册 · LSP。

程序从哪个目录启动就暴露哪个目录吗? 不会。工作空间只能显式添加(面板或 workspace add),启动目录不会自动注册。

再次运行程序提示"已有实例"? 正常行为:服务已在运行,新进程提示后退出。要把某个目录加进运行中的服务,用 -workspace <路径> 或面板添加。

性能与运维

服务端口能改吗? 配置文件 port(MCP,默认 18765)与 adminPort(面板,默认 18766);面板端口强制只绑定本机。

怎么排查环境问题?aeasymcp doctor 一键体检;再看面板日志页或 logs/ 下的错误记录。

升级会丢数据吗? 不会。配置、工作空间注册表、授权与记忆都在数据目录,升级安装直接覆盖程序文件。

卸载会留下什么?uninstall 移除 PATH 与程序;配置与数据目录保留,可手动删除。