DeepSeek Harness 的智能体在处理复杂任务时往往需要较长的思考周期。为了在等待期间保持工作流的活跃度，或为长时间运行的 Agent 提供一个状态观察窗口，dsh-doudizhu 插件将一张三人对战斗地主桌牌引入了 Harness 的界面体系。
该插件通过 shell.overlay 插槽在对话标题旁增加操作入口，展开一个可拖拽、可调整大小的浮动窗口。窗口内集成了游戏引擎、对手逻辑与工作提醒，与底层的 Agent 进程并行运行，互不干扰。
核心功能¶
- 三人对战与 AI 逻辑：支持三人座次，两名对手分别由 DeepSeek 模型（
deepseek-v4-pro）驱动或本地启发式策略控制。模型对手通过 Harness 自带的llm服务调用，不直接暴露 API Key。 - 完整规则支持：包含单张、对子、三带、顺子、连对、飞机、四带二、炸弹及火箭等所有斗地主组合规则。
- 本地与模型混合模式：当模型调用失败、超时或返回非法指令时，自动切换至本地策略接管；连续三次失败后自动停止模型调用，防止无休止的等待。
- 连续 300 Token 经济系统：每位玩家初始 100 Token，赢取的 Token 直接在玩家间转移，余额跨局保留。由于 Token 不涉及现实货币，不会出现负数余额，全押爆牌即结束本局。
- 交互式操作：支持点击或拖拽选牌，界面会实时校验合法性并提示合法出牌选项（上一手/下一手）。
- 快捷聊天：支持发送快捷语，对手会根据性格回复；同时会对抢地主、出炸弹、手牌少于 3 张等关键节点做出反应。
- 工作提醒浮层：在游戏窗口上方显示当前 Harness 的任务状态、待审批事项或完成提示，并提供一键返回对话的入口。
- 状态持久化：窗口布局、游戏 Token 余额、当前手牌等状态在页面刷新后依然保留。
- 实时状态指示：在对话标题旁显示 Agent 当前状态（思考中/空闲），在游戏窗口显示当前等待玩家出牌的提示点。
安装与启用¶
在已配置好 Harness Web Profile 的环境中执行以下命令安装：
dsh plugin --profile web add github:tongji-1/dsh-doudizhu
注意：如果使用 pnpm 10+，首次安装时可能会因 prepare 脚本被拦截而构建失败。请在 $DSH_HOME/profiles/web/pnpm-workspace.yaml 中添加对应的构建密钥到 allowBuilds 字段，然后重新运行安装命令。
dsh plugin --profile web install
dsh --profile web
典型用法¶
安装完成后，在对话列表中，当前活跃的对话标题旁会出现“斗地主”按钮，点击即可唤出游戏窗口。
- 指定版本安装：锁定特定版本以保持环境稳定：
dsh plugin --profile web add github:tongji-1/dsh-doudizhu#v0.5.0
- 本地开发安装：克隆仓库后直接指向本地路径：
git clone https://github.com/tongji-1/dsh-doudizhu.git
cd dsh-doudizhu
pnpm install
dsh plugin --profile web add "$PWD"
注意事项¶
- 娱乐性质：游戏 Token 为本地数字，仅供娱乐，无任何现实货币价值，也不支持充值、提现或多人竞技下注。
- 安全隔离：规则逻辑由浏览器端维护，模型路由被严格限制在回环地址（loopback），不可用作通用的模型代理。
- 离线游玩：如果不想消耗 Token 或网络环境不稳定，可在游戏窗口设置中关闭“对手由 DeepSeek 驱动”，切换至完全离线模式。
- 配置覆盖：插件默认使用
deepseek-v4-pro模型，配置为高推理强度（reasoningEffort: high）。该配置可在插件集成到其他 Profile 时被覆盖。
总结¶
dsh-doudizhu 是一款将即时游戏体验融入 DeepSeek Harness 工作流的实用插件。它通过悬浮窗的形式，在保证 Agent 任务正常运行的前提下，为开发者提供了一个观察 Agent 状态或打发等待时间的窗口，特别适合在长时间推理任务间隙使用。
