三牌塔罗 auwc/dsh-tarot

description: "为 DSH profile 添加固定三张牌的塔罗抽牌工具。"
kind: "package-bundle"

dsh-tarot

摘要

从 78 张韦特塔罗牌中抽取三张不重复的牌，依次对应过去影响、当前状况和未来趋势。网页把 78 张牌背铺满对话区，不使用牌堆内部滚动条。每次抽牌重新洗牌，每选一张就移走一张牌背。结果包含从塔罗网对应正逆位页面提取的牌义要点和图片。模型据此解释三张牌，并通过追问实际情况修订同一组牌的解读。

目录

- 使用此包
- 理解实现
- 模型体验
- 已知限制与后续工作
- 开发备注

使用此包

测试环境为 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 行。正常启动 Web profile，输入“抽三张塔罗牌看看我目前的状态”。模型调用 tarot_draw({ question: "My current situation" }) 后等待你点击三次牌背，再返回名称、牌位、正逆位、图片和牌义来源链接。模型访问仍使用该 profile 配置的服务商。关闭按钮按提问类型显示“收起选牌”或“取消抽牌”；收起界面不会取消工具请求。

组合包提供以下配置字段。覆盖 tarot 行的配置时，需要同时提供三个字段：

| 字段 | 组合包值 | 可接受的值 |
| reversedPermille | 500 | 0–1000 的整数；0 全为正位，1000 全为逆位 |
| maxQuestionChars | 500 | 1–10000 的整数；去除首尾空白后按 Unicode 码点计算 |
| sourceTimeoutMs | 5000 | 100–30000 的整数；每张已抽牌的来源页最长等待时间 |

空白问题和超过配置长度的问题会在抽牌前失败。牌数和位置固定，额外输入字段不能改变它们。

理解实现

实现与开发

Cordis 插件使用具名导出注册工具，注册随插件作用域释放。Node 的 crypto.randomInt 先洗乱全部 78 张牌，网页只展示它们的暗牌位置。工具通过 userQuestions.ask 等待用户依次选出三个不同的位置。回答后再独立随机确定正逆位。工具只读取抽中三张牌的牌义页，提取有长度上限的要点，并连同抽牌结果写入工具记录。普通工具结果保留可读文字和 meta.tarot，已保存结果不依赖重新抽牌。scripts/crawl-catalog.mjs 可从网站五个索引页更新 78 张牌的链接目录，不随包分发图片或文章正文。

在独立包目录中安装锁定依赖并运行检查：

pnpm install --frozen-lockfile --ignore-scripts
pnpm test
pnpm run build
pnpm pack

测试覆盖牌库、固定边界随机值、输入校验、取消、卸载，以及由脚本模型驱动的真实 Loader 和 agent-loop 组合。两份已记录会话无需 API key 即可回放全正位和全逆位抽牌。组合测试仅替换随机源，已发布的 DSH 运行时包正常执行。

模型体验

profile 新增一个工具 schema 和占卜对话指令。每次成功调用向模型上下文添加问题、三张牌的名称、牌位、正逆位、来源网址和提取的要点；其他牌不进入提示。模型先给初步解读，再用牌面引出一个具体猜测，请用户确认或纠正；需要时继续问实际发生了什么、哪一点令人为难。每轮只问一个主要问题，并根据回答修订原牌阵。要点是来源素材，最终措辞和追问由模型生成，不是固定文本。插件不改变模型缓存策略。

已知限制与后续工作

牌面图片和牌义要点依赖来源网站，需联网且可能随来源站变更。插件不随包分发图片和文章。来源页访问失败时，结果会标记该牌的要点不可用；模型不能将自己的推测说成来源内容。无用户提问应答器的无头运行不能抽牌。追问沿用原牌是模型指令，不是强制去重规则；新工具调用会重新抽牌。结果写入日志前崩溃时，没有可恢复的抽牌结果。嵌套 PTC 调用返回 JSON，但不保存专用展示元数据，外层程序必须返回需要保留的事实。

开发备注

录制测试不需要调用真实模型服务。兼容性限于锁定的运行时，安装到其他预发布版本需要另行验证。