安装¶

环境要求¶

pip install myastro

可复现安装（使用开发时验证过的版本）：

pip install -c constraints.txt myastro

可选 extras：

Extra	内容	用途
`processing`	photutils、astroalign、ccdproc、scipy、matplotlib、skyfield	notebook 与规划中的测光/成像
`asassn`	pyasassn	休眠的 ASAS-SN 源
`ztfquery`	ztfquery	本地构建 ZTF 场索引

pip install "myastro[processing]"

默认值：

内容	默认	覆盖变量
数据根（FITS/parquet）	`~/myastro-data`	`MYASTRO_DATA`
账本（SQLite）	`~/.local/state/myastro/astro.db`	`MYASTRO_DB`

export MYASTRO_DATA=/你的/数据根              # 例如 NAS 挂载点
export MYASTRO_DB=~/.local/state/myastro/astro.db

若数据放在非默认位置，把这两行写进你的 shell 配置。

myastro init      # 创建数据根与账本（幂等）
myastro doctor    # 自检；确实有问题时退出码 1

doctor 检查：依赖（含 transitleastsquares >= 2.0）、数据根与账本目录可写、账本 schema 版本、账本所在文件系统（NFS/CIFS → 失败）、已记录文件的抽样、索引是否已构建、平台能力。

pip install -U myastro     # 升级；账本会在下次打开时自动迁移
pip uninstall myastro      # 只删代码——数据根与账本不受影响

升级大账本之前先备份：

myastro backup --out ~/myastro-backup

只有三件事需要它——Legacy 砖块、ZTF 科学帧、YAML 清单。TESS、Gaia、ZTF 元数据/光变、 MPC、SIMBAD、VizieR、unWISE 都是纯 Python，不需要它。

brew install aria2          # macOS
sudo apt install aria2      # Debian/Ubuntu

通常不需要你自己启动守护进程：myastro 会在首次使用时自行拉起 aria2c --enable-rpc（脱离终端）并持续复用。配置项：

环境变量	默认	含义
`MYASTRO_ARIA2_SECRET`	`myastro-legacy`	RPC 密钥；必须与你 daemon 的 `--rpc-secret` 一致
`MYASTRO_ARIA2_PORT`	`6800`	RPC 端口

若你想自己起 daemon，myastro doctor 的 aria2 一行会打印出它期望的完整命令（含密钥）。

现象	原因 / 处理
`pip install 'myastro[asassn]'` 在编译 pyarrow 时失败	上游钉子（`pyasassn` 要求 `pyarrow==4.0.1`，无 Python 3.12+ 轮子）。改用 `pip install --no-deps pyasassn`。另注意 ASAS-SN v2 服务本身已下线（见 `myastro health asassn`）。
提示 aria2 未安装，但你只用 TESS/Gaia 等	无影响——这些源不需要它；需要 Legacy/ZTF 帧时再装。
`doctor` 报"账本文件系统: nfs"	账本在网络盘上。把 `MYASTRO_DB` 移到本地磁盘。
`doctor` 报缺少可选依赖	装对应 extra，例如 `pip install "myastro[ztfquery]"`。
获取在重试后仍失败	巡天端点在维护或不可达——用 `myastro health` 查看。
看到关于 lightkurve `tpfmodel`/`oktopus` 的警告	上游对可选子模块的提示，myastro 从不使用该子模块，可忽略（myastro 自身的导入路径已抑制它）。
`myastro test-map` / `doc-sync` 退出码 2	这两个命令只用于源码仓库，安装版不可用。