前言¶
DeepSeek Harness（DSH）的 Web 界面側欄可以掛社區插件，把日常小工具嵌進同一套 Host 裏。若你希望在本地 DSH 裏做一點「娛樂向自我觀照」——不另開網頁、又能可選地用到當前默認模型做輕量解讀——「今日好運」這類插件就是把星曆底盤、塔羅抽牌和可選 AI 分析收進一個全屏浮層裏的做法。下面介紹維護者 Maxim-Kerman-Lin 發佈的 dsh-daily-luck（社區分類：趣味換裝），以及安裝後的典型流程與邊界說明。
這是什麼¶
dsh-daily-luck（中文名：今日好運來臨）是面向 DSH Web UI 的客戶端插件：用戶填寫生日（出生年份必填），瀏覽器本地用近似星曆算出「基礎運勢」（界面不直接展示該層），再從 22 張大阿爾卡納中洗牌、自選一張（含正/逆位），兩層疊加後給出 事業 / 感情 / 財運 / 身心 / 交際 五維評分、綜合分與今日評語；若在抽牌前填寫問題，結果頁還會給出針對問題的結論與做法。可選地，抽牌時經本機 Host 端點調用你當前默認模型做輕量分析，失敗則回退本地確定性解讀。
- 維護者：Maxim-Kerman-Lin
- 社區目錄：https://www.skillhub.cn/plugins/Maxim-Kerman-Lin/dsh-daily-luck
- 源碼與說明：https://github.com/Maxim-Kerman-Lin/dsh-daily-luck
- 許可證：MIT（見倉庫
package.json，當前版本 1.2.0）
核心功能¶
入口與界面¶
裝好後刷新 DSH Web 頁面，側欄底部（設置旁）會出現 ✦ 今日好運 入口（塔羅牌 + 星芒的紫金漸變圖標）。點開爲全屏浮層：生日表單 → 洗牌 → 22 張牌背 → 翻開結果。
基礎運勢（隱藏層，本地計算）¶
排盤與評分主要在瀏覽器本地完成：
- 按生日月/日定太陽星座；結合出生年估算本命太陽黃經及月亮（正午估算，誤差約 ±6°）、水星、金星、火星、木星、土星。
- 計算當日太陽、月亮、水星、金星、火星、木星、土星的地心黃經與星座。
- 判定行運與本命太陽的合/六分/四分/三分/對分，以及行運與本命月亮/水星/金星/火星/木星/土星的同類相位；用黃經差識別逆行；由日—月黃經差算八相月相。
該層只參與評分，不出現在界面上；相同星座不同年份會因本命行星位置不同而得到不同基礎盤。無出生時間/地點時，不算上升、宮位與精確月亮，屬於「太陽 + 行星」級行運，不是完整本命盤。
星曆採用 JPL 近似軌道根數（1800–2050）與簡化 ELP 月亮公式，屬低精度星曆（太陽/行星約 0.1°–1°，月亮約 0.1°–0.3°），對相位判定足夠，非專業占星軟件精度。
抽牌與當日緩存¶
22 張全量大阿爾卡納，Fisher–Yates 洗牌，正逆各 50%；用戶自行點牌背，程序不再改牌。當日第一次抽牌結果寫入 localStorage，再次打開直接展示結果。
五維合成與檔位¶
每張牌在五維上有權重（以 0.58 爲中性軸），疊加牌勢、逆位「削峯 + 下壓」、牌元素與太陽元素的同元素/相生/相沖修正；綜合分由基礎盤均值打底（40 起）再加牌面加減，映射到 40–100。檔位示例：大吉 ≥86、順遂 ≥74、平穩 ≥62、留意 ≥50、蓄力 <50，並附一句話評語。結果頁按稱呼打招呼（未填則爲「Hi，今天好」）；逆位時整張卡面旋轉 180°。
AI 輕量分析（可選，經 Host 轉發）¶
抽牌時由本地 Host 端點 /dsh-daily-luck/analyze 調用當前默認模型：
- 對基礎運勢：五維各 −5..+5 小幅修正 + 60 字內總結（校準底盤）。
- 對提問：給出 verdict / 回答 / 2 條步驟 / 判斷標準，與本地解讀合併展示。
單次約 300–460 output token；同一天、同一生日、同一問題、同一張牌會緩存；失敗或超時回退本地解讀。不抽牌則不調用模型。
結果頁內容¶
牌面、分數、星級、評語；五維評分條、牌義與生活化解讀、「今天可以這樣用這張牌」；若抽牌前寫過問題，則出現提問答案區塊（沒寫問題則不顯示）；今日評語與兩條建議；重新抽卡、修改生日 兩個操作按鈕。
安裝與啓用¶
插件以當前 dsh 進程權限運行；安裝前建議在 GitHub 查看源碼與 MIT 許可證。在 dsh 裏執行官方安裝命令：
dsh plugin add github:Maxim-Kerman-Lin/dsh-daily-luck
裝好後刷新 Web UI，確認側欄底部出現 ✦ 今日好運。
典型用法¶
- 點擊側欄 ✦ 今日好運，填寫稱呼（可選）、生日（年份必填）、問題（可選）。
- 進入洗牌界面，在 22 張牌背中點選一張。
- 查看五維評分、綜合分、檔位評語；若有提問，閱讀合併後的提問答案與建議。
- 需要換牌或改生日時，使用結果頁的「重新抽卡」或「修改生日」。
倉庫提供 Node 自測（開發/維護者驗證用，非終端用戶必做步驟）：
node selftest.cjs # 引擎：星座、太陽黃經、滿月、水逆、相位、五維評分、AI 校準
node smoke3.cjs # 視圖：表單 / 22 張牌背 / 結果頁五維與 AI 合併
node host-test.cjs # Host：鑑權、JSON、純文本回退
適用場景與注意¶
適合誰：已在用 DSH Web UI、想要內置「每日塔羅 + 簡化行運評分」娛樂向小工具的開發者或日常用戶；希望在同一天內可選藉助默認模型做短分析、且接受失敗時本地回退的場景。
隱私：生日、稱呼、抽牌結果與 AI 緩存僅存本機 localStorage。抽牌時生日、問題與牌面摘要經本機 Host 轉發至當前默認模型；Host 端不持久化這些內容；插件 README 說明不另發往第三方。
娛樂邊界：評分與解讀爲簡化判定與可視化，屬娛樂向自我觀照，不構成醫療、投資、法律或婚姻建議。
生態說明：DSH 社區插件目錄（如 skillhub.cn）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令與行爲以倉庫 README 爲準。
結尾¶
dsh-daily-luck 把本地星曆底盤、22 張大阿爾卡納抽牌、五維評分與可選 Host 輕量 AI 分析收進 DSH Web 側欄的一個入口，適合作爲 Harness 裏的趣味換裝類日常插件。詳情與 issue 見 GitHub：https://github.com/Maxim-Kerman-Lin/dsh-daily-luck；目錄頁：https://www.skillhub.cn/plugins/Maxim-Kerman-Lin/dsh-daily-luck。
