前言¶
在 DeepSeek Harness（DSH）里做智能体时，天文拍摄类问题往往要跨好几块信息：某站到某夜目标是否够高、月相与光污染是否合适、近几天云层如何、焦段与曝光大概取多少。自己拼脚本或反复查星图、天气站，对话里很难一次给出可执行的排序结果。
下面介绍社区插件 dsh-astro-plan（星野计划）。它把 18 类天象与深空目标、全国 173 个站点库、最长一年的夜间检索，以及五维评分和 Stellarium 风格的 3D 天球画面模拟，收进 DSH 的会话 Tab、独立页面和 astro_plan 工具，适合在桌面版 DSH 里做拍摄规划或与模型联动查询。
这是什么¶
dsh-astro-plan 由维护者 Sirius YANG（GitHub：siriusyang91/dsh-astro-plan）发布，在 DSH 生态中归类为联网工具（逐时天气走 Open-Meteo；彗星库在每周首次启动时可联网重建，其余核心数据以构建期快照与 vendored 星历为主）。
一句话定位：按地点、日期与目标类型检索推荐拍摄窗口，给出排序、地景与拍摄参数，并为每条结果附带可交互的天球模拟（真实银河等值线、月相、实测天际线等）。
运行时对 npm 包自身声明零额外运行时依赖（星历用内置的 astronomy-engine；星表与银河为构建期快照）。package.json 要求 Node ≥ 20，DSH ≥ 0.2.1-rc.2 且 < 0.3.0-0。
核心功能¶
目标、站点与时间范围¶
| 能力 | 规模 / 说明 |
|---|---|
| 目标类型 | 18 类，两级菜单：星野 6（银河/流星雨/彗星/星轨/黄道光/极光）· 日月 2 · 行星 4 · 深空 5 |
| 站点库 | 173 个，覆盖 34 个省级行政区、8 个地区，含海拔、波特尔指数、实测天际线 |
| 时间跨度 | 单次最长 365 天（夜的定义：当日 15:00 至次日 09:00） |
| 天气 | 未来 7 天内接入 Open-Meteo 逐时预报；更远日期只按天文条件评估 |
深空目标库规模为 71 个（含星系、星云、星团、行星状星云等）；彗星 103 颗，轨道来自 MPC，每周首次启动自动重建。
评分与输出¶
五维加权推荐：天象 0.4 · 天气 0.2 · 地景 0.2 · 光污染 0.1 · 月相 0.1。某一维不适用时从分母去掉对应权重（不把缺失当 0 分）。换算为百分制后，文档约定 ≥80 条件很好、60–80 值得去、<60 建议换目标或日期。不同题材会省略部分维度（例如日食不算月相维度）。
每条推荐可展开便签：目标、时间月相、地点、方位构图、拍摄参数、天气、推荐度明细；右侧（或窄屏置顶）为 5°–180° 可缩放的立体投影天球模拟，播放可覆盖最佳时段（最多 72 帧）。
对话工具 astro_plan¶
| action | 作用 |
|---|---|
search |
按条件检索推荐（默认） |
window |
某站某夜逐小时时间轴 |
meta |
数据概览 |
events |
天象事件（流星雨、银河季节窗口等） |
params |
某目标拍摄参数（如 targetId 为 m42） |
常用参数包括：eventType、location（站点/城市/省份/lat,lon/「全国」）、region、province、dateStart、dateEnd、minAltitude、maxBortle、limit、originLat/originLon 等。
安装与启用¶
插件以当前 DSH 进程权限运行。安装前可在 GitHub 仓库 查看源码与 MIT 许可证；第三方数据与组件说明见仓库内 lib/data/NOTICE.md。
三种安装方式任选其一，装完后重启 DSH 桌面应用。
1）插件市场：侧边栏「插件」→「发现」→ 添加索引：
https://raw.githubusercontent.com/SiriusYANG91/dsh-astro-plan/main/docs/market-index.json
2）npm（资料记载版本 0.1.1）：
dsh plugin --profile desktop add dsh-astro-plan@0.1.1
3）本地目录（开发）：
dsh plugin --profile desktop add "<本目录绝对路径>"
验证插件元数据是否可达：
curl http://127.0.0.1:<端口>/astro-plan/api/meta
打开方式与页面参数¶
| 入口 | 位置 |
|---|---|
| 会话 Tab | 侧边栏「星野计划」 |
| 独立页面 | http://127.0.0.1:<端口>/astro-plan/ |
| 工具 | 对话里让模型调用 astro_plan |
独立页面支持：?theme=light|dark 强制配色、?withSim=0 关闭画面模拟。
自包含 Web 界面中，查询区为三行（日期、目的地与出发地三级联动、18 类目标与高度角/波特尔阈值）；结果列表按推荐度排序，20 条/页。打开页面不会自动检索，需点「查询」。
典型用法¶
在对话中可直接用自然语言提问，例如：
- 「这周末海坨山能拍什么？」
- 「今年 8 月英仙座流星雨，华北哪个站点最好？」
- 「明年 3 月去西藏拍深空，推荐 3 个目标，要星系」
- 「10 月 14 日北京日食能看到吗？」
- 「下个月有没有适合拍银河的暗夜窗口？」
- 「M42 和 M31 哪个更适合我这周去拍？」
- 「给我一条青海冷湖的整夜时间轴」
- 「这几个目标的焦距和曝光分别是多少？」
需要结构化调用时，让模型使用 astro_plan，按上节 action 与参数组合即可。
数据、联网与注意¶
除天气与未来 7 天 Open-Meteo 抓取（文档写明约 10 分钟缓存）外，页面说明除天气外插件运行时不联网；彗星重建在「每周首次启动」时可能联网。站点、目标、天际线等多为自建或与公开星表裁剪生成的快照。
DSH 社区插件目录站点（如 SkillHub 目录页）独立于 DeepSeek / 幻方，并非官方应用商店；安装与索引 URL 以仓库 README 为准。
更细的界面、评分与数据表说明见仓库 用户指南（README 称完整图文约 14 章）。
结尾¶
dsh-astro-plan 把全国性站点、天象事件、近一周天气与拍摄参数收进同一套检索与可视化流程，适合在 DSH 桌面环境里做星野与深空出行前的筛选与沟通。目录与源码：
- 目录页：https://www.skillhub.cn/plugins/siriusyang91/dsh-astro-plan
- GitHub：https://github.com/siriusyang91/dsh-astro-plan
