murdoku-teacher
DiscoveredMurdoku 陪玩:DSH 侧边栏插件 + 教学/考官 skill;内含「寻宝 The Treasure Hunt」24×24 竞赛关互动页(GitHub Pages 在线可玩,含 E2E 闭环检测)
Murdoku Companion
给 Murdoku(谋杀谜题 × 数独)用的 AI 陪玩:教学(Tutor) 一步一步带你推,考官(Examiner) 只审你的推理、不剧透答案。
当前唯一维护的方案是 集成进 DSH 的侧边栏插件(dsh-webpane/):离线站挂在 DSH 自己的 origin 上,右侧栏 iframe 与 agent 同源,agent 可直接读棋盘 DOM、落子、打笔记、打叉、提交,并把进度镜像到本地 progress/(不依赖登录)。
在线试玩(GitHub Pages)
寻宝 · The Treasure Hunt(24×24 竞赛关 · 单文件离线版镜像)
👉 https://colorlessboy.github.io/murdoku-teacher/
- 完整还原原题交互:24×24 棋盘、24 张角色立绘卡、中英切换、笔记 / X / 橡皮 / 撤销 / 重做 / 记录 / 隐藏 / 清空 / 提示 / 计时
- 线索→地图联动:点人物高亮相关物件(篝火 / 树 / 猪 / 鲨鱼)、区域(Cliff / Woods / Water …)与候选格
- 悬停气泡:鼠标放到格子上弹出「R15C13 点 · 椅子(chair)· CABIN B(小屋 B)」;已配对椅子/床/吊床/篝火/鲨鱼/花丛/木桶等
- 手动标注:Shift+点击格子可从图例选物件类型,本地保存、可导出 JSON 固化
- 棋盘本地缩放平移:触控板捏合只缩放棋盘、双指滑动平移地图;右侧「图例」按钮显示原题 PDF 图例图
- SUBMIT 判对:23 位人物 + 宝藏全部放对后提交,弹出「找到宝藏 · R4 · C11」
- 进度自动保存(localStorage),刷新不丢;响应式:电脑三栏、手机单栏(人物卡 4 列)
- 单文件离线页面,无外部请求;原题 by Manuel Garand(murdoku.com · Murdoku Contest #1),美术 by Valentyna Bezdushna & Manuel Garand,页面 About 内附署名与官方链接
- 源码在
docs/contest/;22 项 E2E 闭环检测(scripts/e2e-contest.mjs,含按内嵌全解走完整盘并提交判对),CI 每次推送自动跑
目录
dsh-webpane/ ⇐ DSH 插件本体(Host + Client + 自带指南/规则)
├── index.js Host:静态托管 /play /play_puzzles、SSE 桥、webpane 工具、系统提示片段、台账导出
├── client.js 侧边栏面板(每 session 一个「网页 · Murdoku」标签)
├── headless.js 面板不可见时的后台 headless Chromium(CDP)
├── history.js / locale/ / icon.svg / package.json / cordis.patch.yml
└── README.md 操作指南(含规则速查、DOM 契约、账本、排错)
.agents/skills/murdoku-webpane/ ⇐ 面板操作 skill + 教学流程
├── SKILL.md 架构/动作表/配方/坑位/交互三段式(前摇→接受→执行)
└── scripts/
├── webpane.sh 命令行桥(eval-file / cli)
├── teaching-step.mjs 每步台账:(state, action, state') + 教学记录
├── highlight-step.js 改动格子的高亮(方框/圆圈 + 坐标标签)
├── annotate-step.js 前摇板书渲染器(全部用格子坐标)
└── prelude.mjs 一条命令画板书
.agents/skills/live-logic-puzzle-coach/ tutor 工作流资料(CDP 旧路线,已弃用,仅历史参考)
.agents/skills/murdoku-exam-coach/ examiner 协议(仍可用)
scripts/ 插件路线的台账工具(murdoku-ledger / murdoku-state)+ 资源拉取(fetch-playwriter-extension.sh)
playwriter-extension/ Playwriter 浏览器扩展(Chrome「加载已解压」用;npm 包解出,不入库,丢了跑 scripts/fetch-playwriter-extension.sh 复原)
progress/ 本地存档
├── local-storage.json mrd_* 快照
├── history.json 通关记录
├── puzzles/<id>.json 每题盘面
├── state/<id>.json 插件导出的标准盘面
├── ledger/<id>-plugin.jsonl 每步 (state, action, state')
├── lessons/<id>.jsonl|md 可回放教学记录
└── archive/<id>.json 单文件归档(教完一局合并)
contest 互动页 竞赛关「寻宝」(24×24):官方单文件离线版(棋盘 + 立绘线索 + 笔记/打叉/撤销 + SUBMIT 判对)
(文件在 docs/contest/ 与 .worktree/original-app/public/play_puzzles/contest/,从右侧栏右下角金色按钮进入)
docs/ 产品与复盘
archive/ 已放弃的旧路线(Chrome 扩展 + Playwright/CDP),仅参考
.worktree/original-app/ 离线站源码 worktree(插件静态托管的 root,别删)
快速开始
# 一次性安装(profile 级;bundle 指向本目录下的插件)
plugin_manager install_bundle → target: /Users/penglingwei/Documents/murdoku/dsh-webpane
# 打开 DSH 右侧栏「网页 · Murdoku」标签即可;agent 用 webpane 工具操作
# 改 Host 代码后用 plugin_manager set_bundle 重载;改 Client 后刷新页面
教学交互(当前约定)
每步 = 前摇(板书:圈哪一行/哪几列/哪些格子 + 要做什么 + 理由)→ 用户接受 → 执行操作,执行后自动记 (state, action, state')。板书元素全部用格子坐标描述(行/列带、矩形区域、格子圆圈/方块、人物候选),像素与几何由渲染器算。
状态
- DSH 侧边栏路线可用:同源托管 + 每 session 隔离面板 + 本地存档(通关记录、
✓ 案件已破、progress/history.json不需要登录); - 已通关并归档:海滩篝火、读书俱乐部、猪圈、24小时送货、Fresh Paint、迷你高尔夫(含完整 65 步台账);
- 旧 Chrome 扩展 + Playwright 路线已归档到
archive/chrome-extension/(见archive/README.md),不再维护; - 竞赛关「寻宝」互动页已发布在 GitHub Pages:https://colorlessboy.github.io/murdoku-teacher/(源码
docs/contest/,CI 见.github/workflows/e2e-contest.yml); - 仓库不含游戏素材或答案文件;关卡数据来自
.worktree/original-app/public/play_puzzles/。
License
TBD.
Comments
Loading…
Similar plugins
by EricWang1358
StudyHub: a DeepSeek Harness (DSH) plugin that turns your own material into questions and spaced review · 把自己的资料变成题目与间隔复习的 DSH 学习插件
★ 193
↓ 428/wk
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add @ericwang1358/dsh-daily-flashcardby omdsh-dev
DSH Web UI 右侧小游戏面板:18 款离线小游戏(恐龙跳一跳 / 俄罗斯方块 / 坦克大战 / 扫雷 / 2048 / 数独 / 吃豆人 / 跟枪练习等),可扩展游戏注册表,等待模型回复或修 bug 时的摸鱼神器
★ 6
BSD-3-Clause
TypeScript
Sep 28, 2026
dsh plugin --profile web add @dsh-external/dsh-minigamesby lhh010
DSH Web UI 右侧小游戏面板:18 款离线小游戏(恐龙跳一跳 / 俄罗斯方块 / 坦克大战 / 扫雷 / 2048 / 数独 / 吃豆人 / 跟枪练习等),可扩展游戏注册表,等待模型回复或修 bug 时的摸鱼神器
★ 37
BSD-3-Clause
TypeScript
Nov 16, 2026
dsh plugin --profile web add @dsh-external/dsh-minigamesby ting-good
用于DeepSeek Harness的可爱小厨娘插件,展示任务状态,也可以点击互动
★ 3
↓ 50/wk
NOASSERTION
JavaScript
Oct 22, 2026
dsh plugin --profile web add dsh-cook-petby LeeGuanWei-a
🎮 DeepSeek Harness Web 端小游戏合集:俄罗斯方块 / 贪吃蛇 / 2048 / 扫雷,一个可拖动毛玻璃悬浮窗,支持深浅色主题与各游戏独立排行榜,一条命令安装。实测 @deepseek-ai/dsh 0.1.2-rc.1。
★ 0
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-mini-games-leeby Ame-Choo
DSH 学习教练插件:把一门课拆成知识地图,逐单元记掌握度、排每日任务,并给学生一个看得见进度的网页面板。
★ 4
↓ 172/wk
MIT
JavaScript
Oct 14, 2026
dsh plugin --profile web add dsh-study-coach