前言¶
在 DeepSeek Harness（DSH）裏做智能體時，工具往往只返回結構化文本，對話側缺少「抽牌、翻牌、看牌陣」這類可感知的過程。若想在同一套 Harness 裏既讓模型解讀牌意，又能在界面上看到真實牌面、事後翻查記錄，需要插件把 overlay、工具與本地存儲串起來。dsh-tarot-divination 由社區維護者 fask112 發佈，歸類爲趣味換裝，面向上述需求：牌桌 overlay、模型可調用的抽牌工具，以及可標註的歷史記錄。
這是什麼¶
dsh-tarot-divination 是在 DSH 內進行塔羅占卜的插件。它提供可觀看的牌桌 overlay（洗牌、切牌、面朝下發牌，點擊翻牌），兩個供模型使用的工具（抽牌與歷史），以及本地保存、最多保留 200 條的可回顧讀牌記錄。牌面爲 Rider-Waite-Smith 全套 78 張，正逆位圖以 base64 嵌入 bundle，離線可用、不依賴外站圖片請求。數據僅寫入本機 $DSH_HOME/tarot/readings.json，不上傳。
維護者：fask112。源碼與說明見 GitHub 倉庫；社區目錄頁：skillhub.cn/plugins/fask112/dsh-tarot-divination。DSH 生態強調「一切皆插件」；社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
牌桌 overlay¶
向助手請求一次占卜時，會打開 overlay：牌組洗牌、切牌並面朝下發牌。每張牌可點擊翻開；讀牌結束時展示已抽牌的位置、正逆位、含義，以及牌陣的 plain-language 摘要。未翻開的牌共用中性牌背，避免提前暴露已發牌；某張牌被抽出並翻開後，才顯示該牌自己的逆位圖。
工具 tarot_reading¶
負責抽牌並返回每張牌的位置、名稱、朝向、關鍵詞與含義；解讀由模型撰寫，工具只負責發牌。支持的牌陣：
single：單張three：過去 / 現在 / 未來（默認）cross5：五牌十字celtic：凱爾特十字
逆位約 35% 概率出現；若需關閉，可在插件配置中使用 allowReversed: false（README Notes 中說明）。
工具 tarot_history¶
管理歷史讀牌：list 按時間從新到舊列出；get 返回某次讀牌的完整牌陣；review 追加一條關於「實際發生了什麼」的備註，便於事後復盤。
客戶端 bundle¶
package.json 中聲明 dsh.bundle，以 profile bundle 安裝；overlay 與對話側卡片隨頁面加載。客戶端注入 @deepseek-ai/dsh-client-ui-conversation 與 @deepseek-ai/dsh-client-ui-tool，平臺爲 web，immediately: true。
安裝與啓用¶
在 DSH 環境中執行官方 README 給出的安裝命令：
dsh plugin add dsh-tarot-divination
也可將插件管理器指向本機 checkout 目錄進行本地安裝。安裝前建議瀏覽倉庫源碼並確認 MIT 許可證（當前 package 版本爲 1.32.0，以倉庫爲準）。插件以當前 dsh 進程權限運行，安裝前應自行審查代碼與許可。
典型用法¶
1、安裝插件後，在對話中向模型說明要做塔羅占卜（例如三牌陣或凱爾特十字）。模型會調用 tarot_reading 完成發牌；同時 overlay 展示洗牌與翻牌過程。
2、閱讀結束後，界面會彙總各位置牌名、正逆位與含義摘要；模型在工具結果基礎上給出文字解讀。
3、需要回顧時，讓模型調用 tarot_history：list 查看近期記錄，get 打開某次詳情，事後可用 review 寫下與現實對照的筆記。
牌陣類型在調用 tarot_reading 時通過 spread 參數指定（如 three、celtic）；默認三牌陣。
適用場景與注意¶
適合希望在 DSH 對話裏保留「儀式感」與可視化牌桌、又希望讀牌結果可本地留存、可標註復盤的開發者或使用者。分類爲趣味換裝，不宜當作醫療、法律或財務預測；README 明確說明插件只抽牌並引用牌義，不能替代專業人士建議。
注意：歷史最多保留 200 條；全部數據在本地 JSON，換機或清空 $DSH_HOME 會丟失記錄。社區目錄星標爲 0，不代表功能完整性，使用前仍以 README 與源碼爲準。
結尾¶
dsh-tarot-divination 把 Rider-Waite 牌桌、模型側 tarot_reading / tarot_history 與本地歷史串成一條鏈路：能看、能抽、能復盤，且離線可用。進一步瞭解可打開 社區目錄頁 與 GitHub 倉庫。
