安装部署
Molore有三种安装形态，对应三类用户：普通个人用户用桌面端安装包（推荐，零命令行）；有服务器、想自己跑全栈的用 Docker Compose 自托管；要部署公开服务的参考云端生产栈。三种形态共享同一套后端代码，数据都以 SQLite 单文件库为核心，备份与迁移成本低。
桌面端（Windows，推荐）
桌面端安装包内嵌完整后端（PyInstaller sidecar，693MB，含 pymupdf / RapidOCR / onnxruntime 等 OCR 依赖），双击即用，不需要预装 Python 或 Node。
到官网 grzhishiku.com 下载，两种包任选：
| 形态 | 说明 | 数据位置 |
|---|---|---|
| 安装版（EXE） | 双击安装，支持自动更新（启动后 10 秒首查、之后每 6 小时检查） | %APPDATA%\psb-desktop\data\ |
| 便携版 | 解压即用，适合放 U 盘；不支持自动更新，需手动下载新版替换 | EXE 同级目录的 data\（优先于 %APPDATA%） |
注意事项：
- 首次启动内嵌后端需约一分钟健康检查，程序常驻系统托盘；桌面后端端口记录在数据目录的
backend-port.json（当前默认 53948）。 - 持久数据绝不落在安装目录：卸载只删程序本体，
%APPDATA%\psb-desktop\独立保留，重装后数据还在；要彻底清除需手动删除该目录。 - 全局热键：
Ctrl+Shift+N快记、Ctrl+Shift+J唤起对话。
国内网络通道
桌面端针对国内网络做了三层加速，均无需手动配置：
- 模型下载双源：自家镜像优先、Ollama 官方 registry 回落；
- Ollama 本体 zip 直装：不走官方安装器，直接解压部署；
- 镜像清单
mirrors.json热更新：镜像地址变更不需要等版本发布。
Docker 自托管
开源精简版（AGPL，GitHub motuo520/grzhishiku）支持 Docker Compose 一键起全栈：
git clone https://github.com/motuo520/grzhishiku.git
cd grzhishiku
cp backend/.env.example .env
# 编辑 .env：至少设置 SECRET_KEY、ADMIN_SECRET_KEY、DATABASE_ENCRYPT_KEY
docker compose up -d仓库根目录的 docker-compose.yml 会启动三个服务：backend（FastAPI）、frontend（80 端口，经 nginx 代理 /api 到 backend）、minio（9000/9001，云同步依赖的对象存储）。数据统一持久化在 ./server-data/（SQLite 库 + graphify 图谱产物），打包该目录即完成备份。生产环境叠加 docker-compose.prod.yml。
完整的环境变量、反向代理与 SSL、备份与升级说明见 自托管部署；必需配置项的语义见 配置详解。
云端生产栈参考
官方云端（grzhishiku.com 背后的部署）的形态，供自建生产环境参考：
| 组件 | 形态 | 说明 |
|---|---|---|
| 应用进程 | uvicorn 监听 127.0.0.1:8080 | pm2 托管，--max-memory-restart 1400M 内存安全网 |
| 反向代理 | nginx 443 | TLS 终止，/api 转发后端；需配置 TRUSTED_PROXY_IPS 让限流拿到真实客户端 IP |
| 本地模型 | Ollama 常驻 | qwen3.5:0.8b + bge-m3，全库嵌入统一 1024 维 |
| 数据库 | SQLite | backend/data/psb.db，定期备份单文件即可 |
要点：生产模式 ENV=production 会强制校验 SECRET_KEY / ADMIN_SECRET_KEY / DATABASE_ENCRYPT_KEY（见 app/core/config.py 的 validate_production）；生产限流默认 100/min；/docs、/redoc、/openapi.json 在生产关闭。