Peach: Local-first video metadata scraper and media manager.
docs(docker): 说明无托盘诊断导出入口
longmeidao6d256e2271a6
diff --git a/docs/DIAGNOSTICS.md b/docs/DIAGNOSTICS.mdindex b75761148..e9bca07cd 100644--- a/docs/DIAGNOSTICS.md+++ b/docs/DIAGNOSTICS.md@@ -6,7 +6,7 @@## 反馈入口-馆藏处理失败时,重试失败项,再从托盘「导出诊断报告」或系统诊断页「下载诊断报告」取得 ZIP。用户只需提供一个 ZIP。下载限运行 Peach 的本机,已登录的同源设备可以上报浏览器错误;开放访问模式不提供匿名远程上报。+馆藏处理失败时,重试失败项,再从托盘「导出诊断报告」或系统诊断页「下载诊断报告」取得 ZIP。用户只需提供一个 ZIP。桌面部署下载限运行 Peach 的本机;Docker 部署允许已登录的私有网络客户端下载,拒绝代理转发。网页不可用时,可按 [Docker 诊断导出](DOCKER.md#导出诊断报告) 在容器内生成 ZIP。已登录的同源设备可以上报浏览器错误;开放访问模式不提供匿名远程上报。错误发生时必须实际记录底层证据。完整问题清单位于 `state/library-processing-<job_id>.issues.jsonl`。通用问题清单不能还原被丢弃的 FFmpeg 错误;没有原始记录的历史失败需要重试取证。diff --git a/docs/DOCKER.md b/docs/DOCKER.mdindex d5ec10dc9..78d0a9c04 100644--- a/docs/DOCKER.md+++ b/docs/DOCKER.md@@ -103,6 +103,24 @@ VAAPI 尝试顺序为硬件解码加 `scale_vaapi` / `h264_vaapi`、软件解码`/app/amane-runtime` 同时包含 GPL-3.0 许可证、来源说明和 `amane-corresponding-source.zip`;归档包含固定 revision 的完整 amane 源码、Peach 桥、锁文件、构建入口,以及 zhconv 和 certifi 的固定源码。依赖许可证保留在独立环境内。+## 导出诊断报告++Docker 部署使用网页「Peach 配置 → 系统诊断 → 下载诊断报告」,无需桌面托盘。已登录的私有网络客户端可以下载;通过反向代理或公网访问时,改用容器内导出。++网页不可用时,在 Compose 文件所在目录执行下面的命令,在正在运行的 `peach` 服务容器中生成脱敏 ZIP。目标文件已存在会拒绝覆盖;再次导出时同时更换两条命令中的文件名。++```text+docker compose exec peach python -m peach.support_bundle /tmp/peach-support.zip+```++将 ZIP 复制到当前目录:++```text+docker compose cp peach:/tmp/peach-support.zip ./peach-support.zip+```++报告包含版本、运行日志和任务状态,不包含数据库、媒体或配置原文。发送前检查内容,脱敏范围见 [日志与诊断](DIAGNOSTICS.md)。容器不连接宿主机桌面托盘;管理与诊断入口均在网页和 CLI 中提供。+## 更新与范围更新镜像并重建容器时保留 `/data`。数据库有待执行迁移时,先备份并按 [运行与配置](OPERATIONS.md) 的迁移流程处理;Docker 启动入口不会自动迁移已有数据库。健康检查使用 `/healthz?ready=1`。