跳转到内容

常见问题

在你首次启动时选择的那个数据文件夹里(默认建议 ~/ilearnassist)。控制面板会显示这个路径,并有 一个按钮可以在文件管理器里打开它。

里面包含:

  • db/sqlite/ilearnassist.sqlite —— 数据库
  • users/<用户名>/workspaces/ —— 工作区与对话文件
  • users/<用户名>/sources/ —— 上传的资料

复制上面那个文件夹就是完整备份。应用本身可以随时重装。

其中 <数据文件夹>/backups/升级数据库前自动留下的快照(最近 5 份)。数据库结构变化时, 应用会在升级之前先复制一份,因为一次「成功但结果不对」的升级没有别的退路。

用桌面控制面板的 重置管理员密码。它不需要服务在运行——忘了密码往往和别的问题一起被发现, 所以恢复手段不能依赖一个可能已经出问题的服务。

从源码运行时:

终端窗口
pnpm --filter @ilearnassist/server cli reset-admin --username <用户名> --password-stdin

出于安全考虑,超级管理员自己的密码只能这样重置,不能在网页的控制台里改。

没有填 API Key。到 平台管理 → 模型服务 配置一个,它会立刻出现在模型选择器里。见 配置模型服务商

可以。控制面板里有 局域网共享 开关,打开后会显示一个二维码,手机连同一个 Wi-Fi 扫码即可。

不会。程序和数据在两个地方,卸载程序不动你的数据文件夹。想彻底清除,手动删除该文件夹。

数据库自动升级,不用你做任何事。 新版本第一次启动时会自己完成,并且升级前会把数据库快照到 <数据文件夹>/backups/。面板会显示「数据库已从 vX 升级到 vY」,并给出快照路径。

应用本身需要你动手换一次:面板上会提示有新版本,点一下去下载新的安装包,覆盖安装即可—— 你的数据在数据文件夹里,覆盖安装不会碰它。

这里没有做「一键自动更新」,原因见安装

macOS(Apple 芯片与 Intel)、Windows、Linux 都有安装包。也可以直接从源码跑,任何能装 Node.js 20+ 的系统都行。