AwesomeHou/dsh-doudizhu

README 摘要

斗地主 · dsh-doudizhu 在等 DSH 回话的间隙，来一把斗地主。 一个运行在 DeepSeek Harness Web GUI （ http://127.0.0.1:3080 ）里的斗地主插件。 - M1 ：3 人标准斗地主本地闭环 · 玩家 vs 机器人 ×2 ，本地规则引擎与 localStorage 模拟 Token/资料。 - M2（当前） ：3 人真人 PVP ，由 Cloudflare 负责匹配、实时同步与服务端经济记账。 - M3（后续） ：引入 DSH Agent —— 用自己的 DSH 或别人的 DSH 当牌友/对手（人机混桌、全 AI 观战对局）。 状态：M1 完成；M2 后端（Cloudflare Workers/Room DO/D1）已开发、部署并通过本地+线上 e2e，客户端在线模式（签到/匹配/WS 真人 PVP）已接入，待重启 GUI 实机复测。 已包含 React/TypeScript 插件入口、浅色大厅/牌桌 UI、本地/在线双模式、Token/签到、默认头像选择、昵称编辑、规则引擎与单机/真人 PVP 对局。 快速导航 文档 说明 需求文档 产品范围、功能需求、非功能需求、验收标准 策划文档 玩法规则、Token 经济、段位数值、UI/UX、文案 架构设计 DSH 插件 + Cloudflare 后端整体架构、数据模型、协议 路线图 M0–M4 里程碑与交付节奏 数据埋点 访问统计方案（回应 Cloudflare 是否自动统计）+ 事件字典 美术资源规范 美术资源目录、命名与规格约定 界面设计 现代化浅色工作台风格、颜色、布局与交互状态 仓库结构 技术栈速览 - 客户端 ：DSH 插件（Cordis + React + TypeScript），通过 dsh.client.inject 注入 Web GUI。 - 规则引擎 ：纯 TypeScript，服务端与客户端共用，可单测。 - 后端 ：Cloudflare Workers（Hono）+ Durable Objects（房间/实时同步）+ D1（持久化）+ KV/R2。 - AI（第二阶段） ：牌位由「受控 DSH 客户端」接管，出牌决策走本地 headless 会话。 安装（给使用者） 仓库公开，构建产物 lib/ 已随仓库提交，任何 DSH 用户可直接从 GitHub 安装。 前置（新机器完整清单） ： 1. Node.js ≥ 20 （自带 npm）。 2. dsh 命令在 PATH 中 —— dsh 是 npm 包 @deepseek-ai/dsh 提供的命令，不是系统自带。装全局即可： 不想装全局也可用 npx @deepseek-ai/dsh web / npx @deepseek-ai/dsh plugin ... 代替。 3. pnpm 在…

分类