前言¶
在 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
