桌面端：数据、更新与排错
数据放哪里
项目目录内
| 路径 | 用途 |
|---|---|
.zhiling/ |
运行时数据（会话索引、计划、临时文件等）。运行中勿随意删除。 |
.md-cache/ |
PDF/DOCX 等衍生的 Markdown 缓存。 |
应用用户数据
设置、会话索引、最近项目等还可能在 Electron 用户数据目录（因系统与安装方式而异）。重装前请自行备份重要项目与 .zhiling。
更新（概要）
| 平台 | 说明 |
|---|---|
| Windows / macOS | 支持热更新与 electron-updater 全量安装包。 |
| Linux | 可能不提供应用内更新，需从官网重新下载安装包。 |
热更新失败（Windows）
查看安装目录 resources 下 hot_update_apply.log（与 hot_update_apply.ps1 并列）。若持续失败，请下载全量安装包覆盖安装。
常见问题
-
无法登录或 API 报错
查网络、代理、账户套餐；BYOK 核对 URL/Model/Key；MinerU 关注余额类错误 → 充值与订单、常见问题。 -
SSH 连接失败
核对主机、端口、密钥；使用界面重试；查防火墙与服务器MaxSessions。 -
搜索异常
远程项目先确认文件树正常；超大仓库首次可能较慢。 -
终端找不到命令
Windows 修改 Shell 后重开终端；远程确认module/conda 已加载。 -
智能体误改文件
使用 问答/只读模式、开启确认选项；重要文件先 Git 提交。 -
任务长期排队
核对队列名、账号、资源请求是否超限；登录集群用squeue查看原因。
反馈与支持
仍无法解决时，请通过 意见反馈 联系官方，并附上：版本号、系统、本地/远程、复现步骤与相关截图。