PSF Guard：天文摄影图像管理工具

项目简介

PSF Guard 是一款天文摄影图像管理与自动化工具，用于编目、检查、规划、校准和叠加天文摄影图像。它可以导入 FITS 或 XISF 文件，在原位置建立目录，不要求使用特定拍摄软件；N.I.N.A. 和 Target Scheduler 是可选集成。既可以安装 Windows、macOS、Linux 桌面应用，也可以在服务器或 NAS 上运行并通过浏览器访问。

主要功能

• 图像审阅与评分：按项目、目标、观测夜、滤镜或评分浏览，支持同步缩放对比、批量评分和撤销评分更改。
• 质量检查：查看星点测量、云层与遮挡迹象、指向误差、跟踪丢失、像素对齐的卫星轨迹等；在更改评分前先查看建议。
• 校准检查：浏览 bias、dark、dark-flat、flat 帧及其 master，检查评分和匹配决策，对比不同夜晚与旋转角度的 flat 组。
• 叠加与处理：校准和整合通道，合成 RGB、LRGB 或窄带颜色，调整背景、拉伸与反卷积，下载线性或处理后的 FITS 结果。
• 跨设备拍摄规划：为多个 rig 设置构图和曝光目标，检查可见性，预览激活到各 rig 的 Target Scheduler 项目。
• 天空覆盖图：在同一张天空图上浏览所有目录，查看解析后的图像叠加，并按观测夜回放覆盖情况。
• 导出与同步：导出带有匹配校准帧的 lights，运行 PixInsight WBPP，生成 AstroBin 采集 CSV，并与 N.I.N.A. 交换计划和评分。
• 目录管理：安排备份、审查导入、预览并删除被拒绝的帧，跟踪后台任务。
• 脚本与集成：提供 CLI、REST API 和 MCP server，便于脚本或 agent 使用。

安装与使用

桌面版可从 GitHub Releases 下载，支持 Windows、macOS 和 Linux。服务器或 NAS 场景可参考 README 中的 Docker 方式运行，然后在浏览器中打开。使用文档见 psf-guard.com/docs。

基本流程：

1. 打开 Settings → Databases & rigs → New / import → New Database from Images。
2. 添加图像文件夹，按需设置 Scan rules，选择 Create & Import。
3. 在 Library 中选择项目，再打开 Images 或 Sequence 进行审阅与评分。

使用 N.I.N.A. 时，可在 N.I.N.A. 的插件仓库添加 https://nina-plugins.psf-guard.com/，安装 PSF Guard Sync 并重启；随后在 PSF Guard 中生成配对码，在插件里填写服务器 URL 和配对码完成连接。配对码一次性使用，一小时后过期。

注意事项

• 图像文件夹可以保持只读用于审阅和评分；但目录本身需要可写才能保存评分和计划，上传、导出和删除文件也需要目标文件夹可写。
• 首次导入会读取文件头。若想快速导入，可先关闭 Queue background quality analysis，需要时再运行质量分析。
• Target Scheduler 的直接数据库访问计划在 0.13 或更高版本移除，后续会迁移到 PSF Guard 自有目录；当前 0.12 仍可继续使用原有设置。
• N.I.N.A. Director 插件和协作功能处于 early beta；Target Scheduler + PSF Guard Sync 是文档描述的受支持拍摄工作流。
• 远程服务器建议使用 HTTPS；HTTP 仅适用于回环连接。

本作品整理自 GitHub 开源项目 theatrus/psf-guard，原作者 @theatrus，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。