Skip to content

DSH 插件(七):把游戏判定放在本地,不占模型回合 ​

前面六篇都在提升效率。飞花令不是。它解决的是另一个真实场景:模型在跑一个长任务,你盯着屏幕等,什么也做不了。

插件提供两种玩法:在会话里跟模型对诗,或者在浏览器面板里跟内置对手即时对战。后者完全在本机运行,不占模型回合——Agent 在后台跑构建,你照样可以开一局。

这篇讲它的判定为什么必须是纯函数、状态怎么按会话隔离,以及一个看起来和游戏无关的问题:什么时候自动暂停。

一、判定必须是纯函数 ​

同一句诗,在对话里和在面板里,必须得到完全相同的判定。否则用户会发现“刚才这么答算对,现在不算了”。

所以规则放在 src/shared/rules.ts,零平台依赖:不 import node:*,也不碰 DOM。Host 侧和浏览器侧都引它。

判定顺序固定为四步:

  1. 规范化后不含令字 → notPoem,当普通聊天忽略;
  2. 长度不在 4–48 字 → length;
  3. 与已用诗句重复 → duplicate;
  4. 古法模式下令字位置不对 → badPosition;
  5. 全过 → valid。

规范化只去空白和常见中英文标点,保留汉字、字母和数字。这样“春眠不觉晓,”和“春眠不觉晓”算同一句,, 不会让去重失效。

ts
export function normalizeLine(raw: string): string {
  return raw.replace(/[\s,。!?、;:""''()《》〈〉【】\[\]·,.!?;:'"()\-—…]+/gu, '')
}

这个正则看着琐碎,但它决定了“重复”的边界。少一个全角引号,用户就能用同一个句子反复得分。

古法模式:位置循环 ​

简易模式只要求“包含令字”。古法严格模式要求令字出现在本轮指定位置:

第 1 字 → 第 2 字 → … → 第 7 字 → 回到第 1 字

判定时先看长度够不够,再看 normalized[pos - 1] 是不是令字。位置推进只在 valid 之后发生,答错不推进。

二、状态按会话隔离 ​

游戏状态存在 Map<sessionId, GameState> 里,每个会话一份:

ts
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() 做了三重校验:

ts
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 安装”的保底做法。

本文阅读--次|全站访问--次|访客--人