This paper introduces the Poker Hand History (PHH) file format, designed to standardize the recording of poker hands across different game variants. Despite poker's widespread popularity in the mainstream culture as a mind sport and its prominence in the field of artificial intelligence (AI) research as a benchmark for imperfect information AI agents, it lacks a consistent format that humans can use to document poker hands across different variants that can also easily be parsed by machines. To address this gap in the literature, we propose the PHH format which provides a concise human-readable machine-friendly representation of hand history that comprehensively captures various details of the hand, ranging from initial game parameters and actions to contextual parameters including but not limited to the venue, players, and time control information. In the supplementary, we provide over 10,000 hands covering 11 different variants in the PHH format. Building on our previous work on PokerKit, a premier poker hand simulation tool, we demonstrate the usages of our open-source Python implementation of the PHH parser. The source code of the parser is available on GitHub: https://github.com/uoftcprg/pokerkit

翻译：本文介绍了扑克牌局历史（PHH）文件格式，该格式旨在标准化不同游戏变体中的扑克牌局记录。尽管扑克作为智力运动在主流文化中广受欢迎，并且在人工智能（AI）研究领域作为不完全信息智能体基准测试的重要平台，但目前缺乏一种便于人类跨变体记录扑克牌局且能被机器轻松解析的统一格式。为填补这一研究空白，我们提出PHH格式，该格式提供一种简洁、人类可读且机器友好的牌局历史表示方法，全面捕获牌局的各类细节——从初始游戏参数、行动信息到包括场地、玩家和时间控制等在内的上下文参数。在补充材料中，我们提供了涵盖11种不同变体的超过10,000局PHH格式牌局数据。基于我们此前在PokerKit（领先的扑克牌局模拟工具）上的工作，我们展示了PHH解析器开源Python实现的实际应用。解析器源代码可通过GitHub获取：https://github.com/uoftcprg/pokerkit