DSH 插件(七):把游戏判定放在本地,不占模型回合
前面六篇都在提升效率。飞花令不是。它解决的是另一个真实场景:模型在跑一个长任务,你盯着屏幕等,什么也做不了。
插件提供两种玩法:在会话里跟模型对诗,或者在浏览器面板里跟内置对手即时对战。后者完全在本机运行,不占模型回合——Agent 在后台跑构建,你照样可以开一局。
这篇讲它的判定为什么必须是纯函数、状态怎么按会话隔离,以及一个看起来和游戏无关的问题:什么时候自动暂停。
一、判定必须是纯函数
同一句诗,在对话里和在面板里,必须得到完全相同的判定。否则用户会发现“刚才这么答算对,现在不算了”。
所以规则放在 src/shared/rules.ts,零平台依赖:不 import node:*,也不碰 DOM。Host 侧和浏览器侧都引它。
判定顺序固定为四步:
- 规范化后不含令字 →
notPoem,当普通聊天忽略; - 长度不在 4–48 字 →
length; - 与已用诗句重复 →
duplicate; - 古法模式下令字位置不对 →
badPosition; - 全过 →
valid。
规范化只去空白和常见中英文标点,保留汉字、字母和数字。这样“春眠不觉晓,”和“春眠不觉晓”算同一句,, 不会让去重失效。
export function normalizeLine(raw: string): string {
return raw.replace(/[\s,。!?、;:""''()《》〈〉【】\[\]·,.!?;:'"()\-—…]+/gu, '')
}这个正则看着琐碎,但它决定了“重复”的边界。少一个全角引号,用户就能用同一个句子反复得分。
古法模式:位置循环
简易模式只要求“包含令字”。古法严格模式要求令字出现在本轮指定位置:
第 1 字 → 第 2 字 → … → 第 7 字 → 回到第 1 字判定时先看长度够不够,再看 normalized[pos - 1] 是不是令字。位置推进只在 valid 之后发生,答错不推进。
二、状态按会话隔离
游戏状态存在 Map<sessionId, GameState> 里,每个会话一份:
type GamePhase = 'idle' | 'running' | 'paused' | 'finished'- 新会话第一次说话,状态是
idle; - 开始游戏后变
running,记录令字、模式、得分、已用诗句、剩余提示; - 手动暂停或检测到工具调用,变
paused; - 结束、认输或达到胜负条件,变
finished。
会话销毁时清理内存状态。浏览器面板是另一套状态,只存在页面里,关掉面板视同暂停,但不影响对话模式的对局。
为什么不做一个全局对局
两个会话同时在跑时,全局状态会串:你在 A 会话答到第 5 句,B 会话的模型输出也被拿去判定。按会话隔离之后,每个会话是一个独立牌桌,互不干扰。
三、自动暂停:解决的是误判,不是体验
插件默认开启 autoPause:检测到 tool/call 里的 shell 或文件写入类工具,就把当前对局暂停并保存现场。
表面上是“怕你切走”,实际原因是:工具调用的参数里可能包含令字。Agent 执行 echo "春" 或写一段含“春”的代码,如果插件把所有消息都拿去判定,就会被当成一次诗句尝试,甚至被判为重复。
暂停之后:
- 不再消费后续消息;
- 当前状态写入快照;
- 用户回来时说“继续飞花令”,从暂停处恢复。
这个设计把“游戏消息”和“工作消息”分开了,代价是频繁调用工具时要手动继续。所以它可配置,长任务场景可以关掉。
四、快照:路径校验比序列化重要
快照写在 <DSH_HOME>/data/dsh-plugin-feihualing/snapshot-<sessionId>.json。文件名里带会话 ID,就必须防路径穿越。
assertSnapshotPath() 做了三重校验:
if (!/^[A-Za-z0-9._-]{1,64}$/.test(sessionId)) throw new Error("非法会话 id")
const target = path.resolve(root, `snapshot-${sessionId}.json`)
if (target !== path.join(root, `snapshot-${sessionId}.json`)) throw new Error("越界")
if (!target.startsWith(root + path.sep)) throw new Error("不在白名单目录内")第一重挡住 ../、盘符和分隔符;第二重要求 resolve 后的结果和直接拼接完全一致;第三重再做一次目录前缀校验。三层看起来重复,但任何一层单独失效,另外两层仍能兜住。
读取时还有大小上限和结构校验:超过上限、JSON 损坏、sessionId 不匹配、字段类型不对,一律当作没有快照,不抛异常。快照是附属品,不能因为一个坏文件让插件加载失败。
五、浏览器面板:7 胜 3 负
面板从会话标题行的按钮打开,是一个浮层:
| 规则 | 值 |
|---|---|
| 局制 | 连对 7 题通关,超时 3 次惜败 |
| 限时 | 轻松 30s / 标准 20s / 困难 15s |
| 连击 | 连续答对加分,答错或超时断连 |
| 提示 | 每局 3 次,跟对只得 5 分并断连击 |
| 去重 | 双方用过的诗句都不能再用 |
| 战绩 | 胜 / 负 / 连胜 / 最佳,存本机 |
对手是内置诗库,不调用模型。诗句按令字和位置筛选,优先选没用过的;找不到就换一句提示。整个对局在浏览器里闭环,即使 DSH 的 Node 侧在跑重任务,面板也不受影响。
六、边界
诗库是内置的,覆盖常用令字,但不是全集。生僻令字可能只有几句,对手很快无句可出。
判定只看“含不含令字、位置对不对、重不重复”,不判断是不是真的古诗。你输入“春天来了真好啊”也能得分——它本来就是个游戏,不是诗词考试。
踩坑:别把工具输出当用户输入
最初只监听了用户消息,看起来没问题。但 Agent 的工具结果也会以消息形式进入会话,里面可能带令字。自动暂停挡的是工具调用阶段,工具结果返回后如果对局已恢复,仍可能误判。最后的规则是:只有 user/message 参与判定,助手和工具消息一律忽略。
下一篇是系列的最后一篇,回到工程本身:9 个插件怎么发布、怎么安装、版本号为什么会漂,以及一条“固定 commit 安装”的保底做法。