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