前言¶
DeepSeek Harness(DSH)把工具、界面和模型指令都做成可安裝的插件包。若你希望在 Web 對話裏做「選牌 → 展示結果 → 讓模型結合牌義解讀」,而不是自己寫 Cordis 工具、前端選牌 UI 和外鏈抓取,就需要一個現成的 bundle。dsh-tarot 由社區維護者 auwc 發佈,在 SkillHub 目錄中歸類爲趣味換裝;它把 Rider–Waite–Smith 78 張牌的三張牌陣(過去 / 現在 / 未來)固定下來,並接上 w.taluo.com 的正逆位釋義頁。下面介紹它做什麼、如何安裝,以及使用時要注意的限制。
這是什麼¶
dsh-tarot 是一個 DSH 的 package-bundle:向 profile 註冊 tarot_draw 工具、Web 端選牌界面,以及模型側的諮詢指令。牌庫爲 78 張互不重複的牌;每次調用會重新洗牌,用戶在頁面上按順序點選三個牌背,再確定正逆位,工具只抓取這三張牌對應來源頁的摘要說明,供當前會話中的模型解讀與追問。模型仍走你 profile 裏已配置的 provider,插件本身不替代推理服務。
維護與源碼:GitHub auwc/dsh-tarot;目錄頁:SkillHub auwc/dsh-tarot。
核心功能¶
固定三張牌陣¶
抽牌數量與位置不可通過工具參數修改:三張牌依次表示過去影響、當前處境、未來方向。工具參數主要是 question(字符串);空問題或超過配置長度會在抽牌前直接失敗。
Web 選牌界面¶
在 Web profile 下,78 張扣着的牌會橫向鋪滿對話區域寬度,內層不出現滾動條。每次展示時牌的身份隨機重排;每點一張,對應牌背從界面移除,共需三次點擊。關閉按鈕文案隨問題類型顯示「Hide card choices」或「Cancel draw」;若只是隱藏面板而未完成選牌,工具請求會保持 pending。
釋義與圖片來源¶
結果中包含所選牌名、位置、正逆位、圖片鏈接以及從來源頁提取的 bounded notes。圖片與正文不打包進插件,運行時從 w.taluo.com 拉取;某一頁超時或失敗時,結果會標記該條 notes 不可用,模型側指令要求不要把模型自己的發揮歸因於該頁。
模型側行爲(bundle 自帶指令)¶
成功調用後,上下文裏會有問題、三張牌的信息與摘錄 notes,未選中的牌不會進入 prompt。指令要求模型先給出初步解讀,再就牌面假設向用戶覈對,必要時逐條追問「發生了什麼、難點在哪」,並在同一副牌上根據回答修訂解讀,而不是每次追問都重新抽牌——後者是模型約定,不是工具層的強制去重;新的 tarot_draw 調用會重新洗牌抽牌。
安裝與啓用¶
README 寫明在 DSH 0.2.1-rc.2、Cordis 4.0.5、Node ^22.19.0 || >=24 下做過測試。將 GitHub Release 預構建包安裝到已有 Web profile:
dsh plugin --profile web add https://github.com/auwc/dsh-tarot/releases/download/v0.5.0/dsh-tarot-0.5.0.tgz
dsh --profile web --dump-config
合併後的配置裏會出現一行 tarot。若你要替換該行配置,需同時提供下列三個字段(缺一會不符合 bundle 約定):
| 字段 | bundle 默認值 | 取值說明 |
|---|---|---|
reversedPermille |
500 |
0–1000 的整數;0 全正位,1000 全逆位 |
maxQuestionChars |
500 |
1–10000;按 Unicode 碼點截斷 |
sourceTimeoutMs |
5000 |
100–30000;每張來源頁最長等待毫秒 |
許可證爲 MIT(見倉庫 package.json 與 LICENSE)。插件以當前 dsh 進程權限運行,安裝前建議自行審閱源碼與許可證;SkillHub 爲社區目錄站點,與 DeepSeek / 幻方無官方從屬關係。
典型用法¶
1、按上文命令把 bundle 裝進 web profile,確認 dump-config 裏已有 tarot 配置。
2、正常啓動 Web profile,在對話裏說明意圖,例如:「Draw three tarot cards for my current situation.」
3、模型會調用 tarot_draw({ question: "My current situation" }),頁面等待你依次點選三張牌背。
4、選牌完成後,工具結果展示牌面、正逆位、圖片鏈接與來源 URL;模型據此解讀,並按 bundle 指令向你提問、在同一副牌上 refinement。
無用戶問答能力的環境(例如缺少 userQuestions.ask 的無頭運行)無法完成抽牌。
適用場景與注意¶
適合誰: 想在 DSH Web 裏做輕量互動、又需要模型圍繞固定三張牌陣做結構化追問的開發者或自用 profile;分類上屬於趣味換裝類體驗,而非生產監控或數據管道類插件。
網絡與內容: 依賴訪問 w.taluo.com;來源站改版可能導致摘錄變化,插件不捆綁圖片與全文。
侷限(README 明確列出): 崩潰發生在結果寫入之前時無法恢復已選牌;嵌套 PTC 調用返回 JSON 但不會持久化專用展示元數據;跟進問題若模型再次調用工具則會重新抽牌。兼容性以 README 釘死的 runtime 爲準,裝到其他預發佈版 DSH 需自行驗證。
結尾¶
dsh-tarot 把「78 張扣牌 UI + 三張固定牌陣 + 外鏈釋義抓取 + 模型解讀指令」收成一條 Release 安裝命令,適合在 DSH「一切皆插件」的生態裏快速加一層塔羅互動。進一步細節與實現說明見倉庫 README(含 中文 README.zh.md)。
- 目錄頁:https://www.skillhub.cn/plugins/auwc/dsh-tarot
- GitHub:https://github.com/auwc/dsh-tarot