- Home
- Plugin
- Miglioramenti UI
- dsh-sorceress-widget (plugin)
dsh-sorceress-widget (plugin)
cococo1ng/dsh-sorceress-widget/plugin
Sorceress — a tarot-reading witch in the bottom-right corner of the DSH Web UI, opening a panel with six tabs. Tarot covers four spreads (daily, single card, three card, ten-card Celtic Cross) with a meaning per position and upright/reversed readings for all 78 cards, plus a history replayable from its seed and a 78-card library. Divination adds a daily draw, a mood-based card, either/or, two-person card, a seven-card relationship spread, a three-minute breathing timer and a wish jar that opens on the next new or full moon, a birthday or after 30 days. The zodiac tab seeds today's card from sign, date and moon phase and lists Mercury/Venus/Mars retrograde. The billing tab reads the host's own usage: balance, the turn in progress, today / 7-day / all windows, peak and off-peak prices with a switch countdown, model share, and per-session and per-turn detail with search. Settings carry 5 tarot and 3 announcement sound tracks, 8 loopable ambient soundscapes, a daily-card reminder, balance and budget alerts, 18 fixed poses, 8 editable line groups, scale, corner, and export/import. The diary is password-locked and keeps period, mood and sleep entries encrypted in localStorage. Nineteen portraits, 78 card faces and 16 real sound recordings ship inline; the only network call is the account-balance lookup the host performs with your API key, and no agent tools are registered. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Installazione
dsh plugin --profile web add github:cococo1ng/dsh-sorceress-widgetQuesto plugin si trova nella sottodirectory plugin del repository.
README
Sorceress · 塔罗挂件
右下角一个会说话的女巫 Sorceress(女巫):抽塔罗、看每日星座与月相、记情绪、查计费账单。 素材全部内联在包里,不调外部进程;外网只出计费那一条余额查询(宿主代发,API key 不出宿主), 磁盘只写一份用量账本。
当前版本见 package.json(本文不再写死版本号,改版本只需改那一处)。
装法
DSH 桌面版:把本包放进 profile 的依赖里并加进 dsh.profile.bundles,重启后生效。
"dependencies": {
"dsh-sorceress-widget": "link:<你的路径>/sorceress-widget/plugin"
},
"dsh": { "profile": { "bundles": [ "…", "dsh-sorceress-widget" ] } }
装完在 profile 目录跑 pnpm install,然后重启 DSH(bundles 是启动时合成的,刷新页面不算)。
只改前端不用重启(python build.py 后 Ctrl+R);改了宿主 index.js 必须重启。
六个页面
页脚另有一个「关于」按钮(不属于六个页签):这是什么 / 六个页面 / 三条边界 / 数据在哪 / 怎么算的 / 素材与许可 / QQ 群 127879829 / 赞赏码 / 版本与反馈。
| 页 | 内容 |
|---|---|
| 塔罗 | 牌阵四选一(每日 / 单张 / 三张 / 凯尔特十张);洗牌 → 摊开 9(或凯尔特 10)张背面 → 自己点一张才翻牌;正逆位;三段判词(牌义 / 花色 · 元素 / 建议),「简 / 详」两档(详版补花色与横幅编号);抽牌历史(可按种子「重放」、给这一局命名、删单条、清空);回顾(这个月抽了几次、最常出现的三张、近 90 天反复出现的牌);牌库(78 张按花色分批,逐张看正逆牌义);「存图」导出 1080×1920、「小红书」导出 1080×1440 |
| 占卜 | 每日一签(当天锁定,换日解锁);情绪(8 档心情 → 按心情抽一张,给共情句,不判吉凶);二选一(5 张:A 路 / 关键 / A 结局 / B 路 / B 结局);双人牌(一人一张,写关系现状与可能 + 三件小事,不回答「他爱不爱你」);关系阵(7 张);安神 3 分钟(4 秒吸 / 2 秒停 / 6 秒呼,随时可停);许愿瓶(写一件事封存,到下一个新月 / 满月 / 生日 / 30 天后才开,封着时不显示内容) |
| 星座 | 12 星座切换;今日卡片按「星座 + 日期 + 数据版本」定种子,含月亮相位、水星 / 金星 / 火星逆行、幸运色 / 数字 / 时段、宜 / 忌、月相带与周期对照;今天怎么穿(主色 / 副色 / 点缀三格色卡 + 一句穿法);卡底「存图」导出运势卡、「今天想问什么?」直达抽牌 |
| 计费 | 余额(充值 / 赠送 / 来源)、低于告急线时页顶红字、今日已用 / 轮次 / 本月 / 平均每轮、今日预算进度、峰谷价与切档倒计时(高峰珊瑚橙 / 谷价薄荷青,一眼分得开)、进行中这一轮的实时金额、挂起等待提示、近 7 天、近 6 个月、模型占比、按会话、逐条明细 + 搜索框(模型 / 日期 / 金额);范围切今日 / 7 天 / 全部;刷新 |
| 配置 | 音效总开关、音量、5 条塔罗轨道(洗牌 / 抽牌 / 翻牌 / 收牌 / 结果铃)+ 3 条播报轨道(每轮记账 / 等你答话 / 等你授权,与塔罗分家、各自可试听与开关)+ 环境音景 8 套(雨 / 壁炉 / 夜风 / 翻书 / 夜虫 / 海浪 / 雷雨 / 鸟鸣,两列小格、可叠加混音、音量独立、默认全关、页面切走也照放、重启后不自动响(点一下总开关就恢复上次那几路),要停就在这里关)、每日一牌提醒(到点若今天还没抽,冒一句 + 一声铃;默认关,可 ±15 分钟调时间,有「现在就说一遍」试听)、计费提醒(余额告急线 ±5 元、余额告急冒一句、今日预算 ±5 元;各一天只提醒一次)、人物姿态(自动 + 18 张定格:静立 / 想事 / 发呆 / 洗牌 / 摊牌 / 抽牌 / 翻牌 / 笑 / 打盹 / 得意 / 骑帚 / 读牌 / 不高兴 / 告别 / 静候 / 远望 / 捧杯 / 伸腰;固定后不换姿势/不发呆/不睡着)、气泡台词开关、显示时长、说话档位(安静 / 正常 / 多话)、8 组台词(含「自我关怀」)可编辑、四档缩放、屏幕角左下 / 右下、只留水晶球、设置导出 / 导入、清空全部本地数据 |
| 档案 | 4–6 位数字密码锁,关菜单即锁档(解密内容与密码都清出内存,重开要重新输);经期 / 每天的情绪与睡眠(五档 + 三档)用 PBKDF2(12 万次)派生 + AES-GCM 加密后存本地,明文不落盘;生日 → 本命牌(年 + 月 + 日相加,超过 21 再逐位相加,落到大阿卡纳 0–21)、星座、四柱;周期日历(经期 / 排卵 / 易孕 / 黄体 / 安全五段着色,标第几天与下次日期);近 30 天月相对照(月相亮度 + 情绪柱 + 睡眠顶线 + 起 / 中 / 今天三段日期轴,附「一致 / 反着 / 看不出差别 / 样本还少」,不写医学结论);忘密码不可恢复;婚配(乾 / 坤 各填生日与时辰 → 分数 + 档位 + 双方四柱 + 五项分项〔生肖·年支 / 配偶宫·日支 ×1.5 / 日主五行 / 年柱纳音 / 五行互补〕+ 三条能做的建议;口径写在页面上:只给倾向与建议,不回答「他爱不爱你」;子时拆早子 00–01 算当日、晚子 23–24 算次日) |
交互
| 动作 | 结果 |
|---|---|
| 左键点她 | 冒一句随机台词 + 换姿势,不打开面板 |
| 右键 | 同左键(也只是搭一句话) |
| 悬停 / 点右上角水晶球 | 面板入口只有这一处:悬停人物时浮现,点开面板;点它只开面板,不冒台词(水晶球算她的道具) |
| 按住拖动 | 移动位置,松手记住;拖完不误触点击 |
| 闲置 | 四段:15 秒发呆、一分钟自语一句、久坐五分钟睡着、深夜多说一句关怀;动一下就醒 |
| 缩放 | 配置页四档(0.7 / 1.0 / 1.3 / 1.6),人物与面板同比 |
| 面板头部「今日 ¥x」 | 一眼看当天花了多少,点一下跳到计费页 |
| 拖动面板 | 按住标题栏把面板拖到任意位置,位置会记住;拖走后标题栏出现「复位」,点了回到人物头顶上方 |
| 收起面板 | 标题右侧「×」或底栏「收起 / 关闭」 |
| 底栏「关于」 | 打开关于页(介绍、隐私与算法口径、QQ 群 127879829、赞赏码);「返回」回到原页签 |
| 快捷键 | Alt+S 开合面板;Alt+Z 直接抽一张(只在带 Alt 时接,不影响正常输入) |
设置存 localStorage 的 srs.cfg.v1;抽牌历史存 srs.history.v1(最近 200 条,含种子与正逆位,可复现);
每日一牌提醒的「今天已经提醒过」标记单独存 srs.remind.v1(只有日期,不进设置导出)。
气泡播报(账)
她会在气泡里报两件事,都走 /srs/live.json(3 秒一轮),配置页「气泡」块里各有开关:
| 事件 | 气泡 | 停留 |
|---|---|---|
一轮账结完(seq 变大) | 「这一轮 ¥0.0321」+ 副行「12,438 tok · chat」 | 8 秒 |
有件事在等你(approval/asked) | 「等你点个头」+「会话名 在等你授权。」 | 20 秒 |
有件事在等你(ask_user_question) | 「等你说一句」+「会话名 在等你答话。」 | 20 秒 |
- 页面刚开、后端已经攒了多轮时只对齐基线不补播,不会刷你一脸历史
- 价表里没有的模型显示「这一轮没计价 · 只记 token」,不印
¥0.00(0 会被读成免费) - 同一件挂起只吵一次(按
kind:id去重);播报期间闲置自语与小动作让位,不会把她刚说的话顶掉 - 等待播报同时把姿势换成 想事(答话)/ 翻牌(授权),并敲一声铃
播报音效(与塔罗那五路分家)
气泡报账时响三声,各管一件事,都在配置页「播报音」里单独开关 / 试听:
| 事件 | 音效 | 听感 |
|---|---|---|
| 一轮账结完 | cost | 两声干爽点数(2.4k / 1.8k 短脉冲带泛音),0.4 秒,电平与铃同档但短得多 |
| 在等你答话 | ask | 两句上行木琴(587 → 880Hz),末尾上扬,像一句问话 |
| 在等你授权 | approve | 同一低音连敲两下(392 / 196Hz),三路里最沉、最催 |
塔罗那五路(洗牌 / 抽牌 / 翻牌 / 收牌 / 结果铃)只在抽牌流程里响;两边音源不同,可以一边关一边留。
计费口径(和 DSH 自己的「总消费」同源)
| 项 | 口径 |
|---|---|
| 记账源 | 宿主监听 session/event,按 (会话, 轮次) 聚合 assistant/message 与 compaction/summary 的真实 usage,turn/end 结算 |
| 计价 | 官价表(元 / 百万 token)× 当时的峰谷档;缓存写入按未命中价、缓存命中按 hit 价,输出含 reasoning |
| 峰谷 | 工作日 9–12 / 14–18 高峰,其余空闲;周末与法定节假日全天谷价。放假表覆盖到 2026 年,跨年要补表 |
| 未知模型 | 价表里没有的模型只记 token、不记钱,界面标「未计价」,页顶提示有几轮 |
| 余额 | API Key(DEEPSEEK_API_KEY)优先,失败退宿主账号;余额只作对照,不当今日已用 |
| 落盘 | DSH_HOME/.srs-usage.json:今日合计 / 逐日汇总 / 逐轮明细(含会话名)/ turnSeq;明细留 90 天 · 500 条,挤出去的进 .srs-usage-archive.json(上限 2 万条) |
路由(全部自身相对路径)
| 路由 | 说明 |
|---|---|
/srs/ping.json | 自检:版本、姿态数、牌数 |
/srs/deck.json · /srs/tarot.json | 78 张牌序 / 牌义数据 |
| `/srs/cards/big | thumb/…·/srs/cards/back.webp` |
/srs/sfx/amb-*.mp3 | 环境音景 8 套循环(雨 / 壁炉 / 夜风 / 翻书 / 夜虫 / 海浪 / 雷雨 / 鸟鸣),白名单 8 个名字,audio/mpeg + immutable |
/srs/billing.json | 余额 + 今日 + 本月 + 近 7 天 + 最近一笔 + 峰谷 + 挂起/忙碌(?refresh=1 强制刷新) |
/srs/live.json | 现在发生什么:最近一轮(seq / 金额 / token / 模型)、进行中金额、今日累计、挂起等待、忙碌、峰谷 |
/srs/turn.json | 只回最近一轮 + 今日(细粒度读取,给外部工具与路由自检用) |
/srs/usage.json | 用量窗口:`?range=today |
素材
- 立绘 19 张(idle-a/b · think · dazed · shuffle · spread · draw · flip · smile · sleep · smirk · fly(镜像)· reading · annoyed · bye · rest-hands 静候 · look-aside 远望 · hold-cup 捧杯 · stretch 伸腰)、78 张牌面(big + thumb 各一份)、牌背、UI 素材 7 件
- 立绘 / UI / 音效 全部在构建时内联成 data URI;牌面走路由(78×2 张,带 immutable 缓存)
client.js1716.0 KB(内联素材 984.5 KB,其中约 71 KB 是「关于」页的两张码),预算已随立绘增加放宽(0.54.0 从 1364 KB 涨到 1611 KB:四张新立绘内联各约 60 KB;0.56.0 再加两张码到 1716 KB)- 音效全部为真实录音(Mixkit Free License,清单与 id 见
NOTICE.md):塔罗五路 + 播报三路内联,环境音景八套走/srs/sfx路由。结果铃是服务铃一声叮(0.56 秒、尾巴 0.20 秒,0.52.0 换源);每轮记账 / 等你答话 / 等你授权三路取的是柔音档(谱重心 470–780 Hz、4kHz 以上能量 <4%;「等你授权」用起音 0.07 秒的尼龙弦单音,不拖前奏) - 牌面版式(深蓝底 + 细金边 + 四角八角星 + 米色卷轴横幅)78 张一致性已量化验证
目录
src/ client.template.js(唯一前端源)· hitboxes.json · layout.json
build.py 出 plugin/client.js + 镜像 assets/ data/
plugin/ 打包目录(index.js 宿主 · client.js 产物 · package.json · data/ assets/)
data/ 牌库与文案(deck / tarot / horoscope / empathy)
assets/ 立绘、牌面、UI、音效
tools/ gen_* 生成脚本 · make_hitboxes / prep_ui / make_icon · live-harness/ 实跑台
test-billing.mjs 账本口径自检
_verify/ 实跑台截图与日志(不进包)
改动铁律.md 每次改动前先看:版本号、inject、样式 id、面板定位、账本口径…
开发与验收
python build.py # 出产物 + 镜像素材(--no-assets 只出 client.js)
node plugin/test-routes.mjs # 44 项路由(含环境音景八套白名单)与 live/turn 字段形状
node test-billing.mjs # 账本口径全绿(计价 / 缓存 / 峰谷 / 跨天 / 按月 / 按会话)
python tools/live-harness/run_panel.py # 前端断言全绿(真 Chromium + 真 client.js)
python tools/live-harness/shot_bill.py bill # 计费页上下两屏截图
python tools/live-harness/shot_menubar.py bar # 菜单栏六态截图
改前端 → 升 plugin/package.json 的 patch 版本 → build.py --no-assets → 实跑台 → Ctrl+R。
实跑台用桩数据:billing_stub.json / usage_stub.json / live_stub.json,不需要真凭据;
run_panel.py 启动前会把 live_stub.json 归零(上一轮残留的挂起 wait 会把姿势断言带脏)。
现状总表(功能 / 路由 / 数据 / 素材 / 存储键 / 待办 / 版本线)见工作区
Sorceress-插件信息总表.md,那份是实况,本 README 只讲用法。
隐私
不上报、不读你的对话内容。本地写入三处:
localStorage里的界面设置(srs.cfg.v1)localStorage里的私密档案(经期 / 情绪 / 睡眠;PBKDF2 + AES-GCM 加密后)DSH_HOME/.srs-usage.json一份计费用量账本(时间 / 模型 / token / 金额 / 会话名,不含对话正文)
外网请求只有一处:/user/balance 余额查询(宿主代发,key 不进客户端)。
已知边界
- 计费只对价表内的模型计价;表外模型显示「未计价」,金额会小于真实(宁可少算不瞎算)
- 「按会话」只覆盖还留在账本里的明细(90 天 / 500 条);已结转进逐日汇总的那部分没有会话归属
- 峰谷与法定节假日表覆盖到 2026 年,之后按工作日/周末算,界面会提示
holidayOk=false - 每日一牌提醒不插队:她正播着账目(这一轮花了多少 / 有件事在等你)时会让一让,等下一轮 30 秒再响;同一天只响一次,当天已经抽过就不再响
- 塔罗解读、星座文案、共情句属于传统文化与娱乐参考,不做医疗、法律、投资判断
交流与赞赏
装插件、报问题、聊读牌都在 QQ 群:127879829。作者在群里;群里不做付费算命。

挂件免费,功能不设门槛。想请我喝碗茶,扫这张;不扫,功能一点不少。 赞赏不换功能、不解锁内容、不插队。

许可
- 代码:MIT,见
LICENSE。 - 立绘、牌面、UI、音效:本项目自建素材,不随 MIT 授权,见
LICENSE-ASSETS。
Plugin correlati
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
dsh-TUI
ccch1mneyyy/dsh-tui
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui