dsh-turtle-soup
Manifest validHosts turtle-soup puzzle games: draws from a 100-puzzle bank with type and difficulty filters, tracks hints, pause and stop, scores rounds with ranks, and collects puzzle ratings.
海龟汤题库(DSH 插件)
给 DeepSeek Harness 用的海龟汤插件:内置 100 道题,能主持一局(抽题点单、提示、暂停、计分段位、评分赞踩),也能管题库、审别人投的稿,还能接 QQ 机器人当嘴。
一句话卖点
- 开箱就有 100 道:首次运行自动铺开,不用手动导入;22 道是经典题(电梯、绿牙、三兄弟…),其余是过审的生成题。
- 能点单:红/黑/清汤、本格/变格、1–5 星,还能开「不限提问」「不限提示」。
- 有分数:按难度、推理完成度、省下的提问与提示、用时算分,十个段位带彩蛋(规则不公开)。
- 会记账:每局结束给汤面打分(1–10)+ 赞/踩,满分 4 人起算平均;低分题自动降权,低于 2 分提示下架。
- 能收稿:投稿码、GitHub/Gitee Issue 都能进待审队列,审核通过自动入库。
能力
| 工具 | 作用 |
|---|---|
turtle_draw | 抽题:按类型/难度筛,开局前可选「不限提问」「不限提示」模式;返回汤面 + 汤底 + 提示 + 提问上限 + 提示次数 |
turtle_bank / turtle_list / turtle_get | 概览、分页、看单题(不返回汤底) |
turtle_add / turtle_edit / turtle_delete | 加题、改题、删题(墓碑删除,同步时会传播) |
turtle_export / turtle_submit / turtle_review | 导出投稿码、收进待审、list/view 看队列与答案、通过或驳回 |
turtle_issues | 把 GitHub / Gitee 的 Issue 当投稿箱:pull 拉取、approve 通过并尝试关 issue(Gitee 关不掉,需手动)、reject 驳回 |
turtle_snapshot / turtle_sync | 导出整库 JSON、按 URL 或本地文件拉取并按「标题 + updated」合并 |
turtle_online | 对接 server/ 里的后端:交题、看待审、审稿、拉取 |
turtle_stats | 记战绩 |
turtle_score | 猜中后计分:按难度、推理完成度、剩余提问、剩余提示、用时算总分和段位(规则不公开) |
turtle_game | 局内控制:status 看进度、hint 要提示、asked 记句数、pause/resume 暂停恢复、end 结束(reveal=true 才揭汤底,带 completeness 就顺带算分) |
turtle_rate | 给汤面打分(1-10,默认 5)+ 赞/踩;满 4 人才算平均分,低分题降权、低于 2 分提示下架 |
数据存在 ~/.dsh/turtle-soup/,插件零依赖(不 import 任何 DSH 内部包)。
安装
插件市场:在 DSH 的 Plugins → Discover 里加一个 index 地址(见 market/),然后安装。
本地目录:Plugins → Add plugin → 选这个目录。
网页版 / 常驻引擎(可选)
engine/ 里是一个零依赖的常驻服务,把题库、计分、评分从 DSH 里拿出来,网页和聊天机器人都能连它:
ash node engine/server.mjs # 127.0.0.1:8800 PORT=9000 node engine/server.mjs # 换端口 PUBLIC=1 node engine/server.mjs # 监听 0.0.0.0(给隧道或 VPS 用)
打开 http://127.0.0.1:8800 就是手机友好的 H5:筛选开局、问答、提示、暂停、结算、评分。
- 汤底只留在服务端,/draw 不下发,猜中才一次性返回
- 会话按 userId 分开,多人可以同时玩
- 评分按 userId 去重,一个人只能评一次
- 判题和现编提示走 DeepSeek,key 从 DEEPSEEK_KEY 环境变量或 C:\dafeiyu\private\deepseek-key.txt 读
接口:/health /bank /list /draw /ask /hint /pause /resume /end /rate。
配置
cordis.patch.yml 的 config:
serverUrl: '' # 自建后端地址(不敏感,放这里没问题)
submitToken: '' # 投稿令牌(发给朋友)——建议留空,见下
adminToken: '' # 管理员令牌(自己用)——建议留空,见下
两个令牌别写进这个文件:它跟着仓库公开,写进去就等于公开。插件会优先读本机私有文件 ~/.dsh/turtle-soup/tokens.json(不在仓库里):
{ "adminToken": "…", "submitToken": "…" }
配置里那两项只是兜底;调用时传 token 也能临时覆盖。改完重启 DSH 生效。
开局模式与提示次数
开局前可以选两个模式(turtle_draw 的参数):
unlimitedQuestions: true—— 不限提问次数,问多少句都不算超;unlimitedHints: true—— 不限提示次数(题目自带几条就能要几条)。
两个都不选时,按难度给提示次数:
| 难度 | 提示次数 |
|---|---|
| ★☆☆☆☆ | 1 次 |
| ★★☆☆☆ / ★★★☆☆ | 2 次 |
| ★★★★☆ / ★★★★★ | 3 次 |
提问上限照旧:基础 10 句 + 每颗星 6 句(配置里的 baseQuestions / perStarQuestions 可调)。
「提示次数」指的是能问几次提示:题目自带的提示用完后,主持人手里有汤底,可以按汤底现说一条,次数由难度决定。
在线投稿:Issue 当投稿箱
不需要服务器,也不需要域名:
- 朋友在你仓库提一个 issue,正文贴一行
TS1.…投稿码(turtle_export导出的那种),打上turtle-submission标签; - 你调
turtle_issues,action=pull、provider=github→ 码解析后进待审; - 审核时用
turtle_review action=view看汤底; turtle_issues action=approve id=…→ 入库,并自动关闭 issue、回一句「已收录」;action=reject则关闭并写明理由。
Gitee 用同一套工具:provider=gitee,再配上 giteeRepo;Gitee 不需要建标签,pull 时传 label: "*" 跳过筛选。
但 Gitee 的 issue 关不掉,只能手动关。 Gitee 的 issue 写接口对个人令牌返回 404 Not Found Project,试过 JSON 体、form 体、令牌放查询串、数字仓库 ID、显式 repo 参数,全部一样;而读 issue 是正常的。
所以 Gitee 上的流程是:
pull、审核看汤底、通过入库 —— 都正常;- 通过或驳回后,结果会提示「关 issue 失败(请手动关闭 gitee #编号)」,你去网页点一下关闭即可;
- 如果你的朋友主要在 Gitee,建议直接告诉他们「收录后会手动关帖」。
读 issue 不需要令牌,关 issue 需要。 令牌放 ~/.dsh/turtle-soup/tokens.json:
{ "githubToken": "…", "giteeToken": "…" }
- GitHub:https://github.com/settings/tokens 建 fine-grained token,只授权这个仓库、勾
Issues: Read and write - Gitee:设置 → 私人令牌,勾
projects(+issues)
数据与备份
~/.dsh/turtle-soup/
├── bank.json 题库(含墓碑)
├── pending.json 待审投稿
└── stats.json 战绩
拷贝这三个文件就是备份;删掉整个目录会重新播种内置的 100 道题(bank-seed.json 随包发布:22 道是网络流传的经典题重写,51 道是过审的生成题,其余是内置题与大肥鱼题库)。
常见问题
- 审稿为什么看不到答案? 用
turtle_review的view动作,list只给汤面。 - 改了题怎么同步出去?
turtle_edit会刷新updated,别人turtle_sync时会覆盖旧版。 - 同步冲突了怎么办? 本地
updated更晚时保留本地,结果里会列出冲突标题,不会静默覆盖。 - 直链 404? GitHub 要用
raw.githubusercontent.com/...而不是仓库网页地址。
更细的说明(含故障排查表)见 docs/DETAIL.md。
目录
index.js— 插件本体(工具注册、题库读写、合并、在线投稿)bank-seed.json— 首次运行铺开的 100 道题cordis.patch.yml— 插件行与默认配置locale/{zh,en}.json— 插件页标题/描述docs/DETAIL.md— 插件详情页正文icon.svg/assets/icon-180.png— 图标(后者给市场卡片用)market/— 插件市场 index 的模板和生成脚本server/— 可选的 Cloudflare Workers 后端(在线投稿)
许可
MIT
Comments
Loading…
Similar plugins
by changer-changer
A polished local-first DSH Web teahouse: curated mini-games, resumable breaks, and Lanyin companion.
★ 0
MIT
TypeScript
Aug 20, 2026
dsh plugin --profile web add dsh-whale-cardsby wcytjy
A draggable bubble that picks three dishes at a time from a local 4,423-dish library; the first two are always well-known mains, and picking costs no tokens.
★ 0
MIT
JavaScript
Sep 16, 2026
dsh plugin --profile web add dsh-meal-pickerby Lindemellis
DSH Tavern plugin: send SillyTavern preset entries with their own role (system/user/assistant) instead of forcing system/user | 游玩时预设条目按自身 role 发送
★ 0
MIT
JavaScript
Oct 7, 2026
dsh plugin --profile web add dsh-tavern-preset-rolesby dingchenhui0618-arch
A social deduction game played against your own model configurations. A table has N seats (six by default, one of them yours) and some of the rest are played by agents bound to different provider, mod
★ 0
MIT
JavaScript
Oct 27, 2026
dsh plugin --profile web add dsh-turing-tableFive casual mini-games (sliding-number puzzle, Sudoku, snake, Schulte grid, number memory) that pop up when a turn starts, with auto-saved progress across sessions.
★ 0
dsh plugin --profile web add moyu-gamesby huangxn29
A top-down arena shooter that opens as a full panel from a left sidebar entry in DeepSeek Harness.
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-shooter